Выгрузка из Shelter 2 в SH5

1. Выгрузка данных в SH5 с помощью QUSH.

Внимание! Для работы выгрузки данных из Shelter2 в SH5 на ключе должен быть прописан Проект 5 Модуль 8. 

1.1. Для выгрузки данных из Shelter2 в StoreHouse5 используются утилиты ExportData (из поставки ПО "Абонемент") и QUSH (SH5). Загрузить ПО Абонемент можно здесь:

ftp://ftp.shelter.ru/Abonement/FullVersion/

1.2. Дистрибутив утилиты ExportData и скрипт для базы данных Shelter2 находится в архиве во вложении к статье: ExportData_1_11_0_1_shtr_11.rar.

1.3. Актуальный дистрибутив ПО Storehouse5 можно загрузить здесь:

ftp://ftp.ucs.ru/

2. Функционал выгрузки тестировался на версиях Shelter2 2.12.142.4100 и ExportData 1.11.0.1.

2.1. Для работы с QUSH, на базе Shelter необходимо применить скрипт export_to_storehouse5.sql из поставки утилиты ExportData: export_to_storehouse5.sql :

- Для этого необходимо запустить IBExpert.

- Зарегистрировать нужную БД Shelter2.

- Зайти в меню Tools - Script Executive (Ctrl + F12).

- Выполнить скрипт на базе данных. Скрипт должен выполнится без ошибок (рис. 1).

Рис. 1 - Применение скрипта export_to_storehouse5.sql.

- Если все же ошибки при применении скрипта возникли (рис. 2), то рекомендуется скопировать содержимое папки UDF из дистрибутива актуальной версии ПО Абонемент (Fullversion\__SERVER\FireBird_2_5\udf\) в папку с установленным Firebird (например: C:\Program Files (x86)\Shelter\Firebird\udf). После перезапуска Firebird, снова подключаемся к базе и применяем скрипт.

Рис. 2 - Возможная ошибка при выполнении скрипта. 

3. Запуск и настройка Exportdata:

- Распаковываем архив с Exportdata 

- В файле ExportData.ini указываем путь к нашей БД Shelter2 (рис. 3)

Рис. 3 - Exportdata.ini.

3.1. Общие настройки.

- Запускаем ExportData.exe, желательно от имени Администратора.

- Для добавления параметров выгрузки, в главном меню программы нажимаем кнопку Добавить. 

- Заполняем условия выгрузки. На текущий момент на ExportData 1.11.0.1 актуальны следующие условия:

Код	уникальный код для данного условия выгрузки.
Наименование	Наименование товарной группы в справочнике товаров SH5
Место реализации	Наименование места реализации. В SH5 - Словари - Доп. словари - Места реализации.
Префикс для элементов	Для SH5 неактуально
Префикс	Для SH5 неактуально
Внешний ID	Для SH5 неактуально
Тип экспорта	"Услуги"/"Номерной фонд"
Доп. опции экспорта	Задает аналитику выгрузки. Предопределенные варианты.
Включен	Если данный флаг установлен, то условие выгрузки активно.
Смещение внешнего ID (для совместимости со старыми версиями)	Для SH5 неактуально
Выгружать коррекции	Чекбокс по выбору. О коррекциях смотрите в руководстве пользователя SH5: https://docs.rkeeper.ru/sh5/ru/pol-zovatel-skaya-dokumentatsiya
Версия Storehouse	"Storehouse4"/"Storehouse5"
Место реализации	Количественный номер Места реализации в Справочнике SH4/SH5. Если в справочнике 2 места реализации, значит первое по списку 1, второе 2 соответственно. В поле указывается цифра.

Рис. 4 - Настройки ExportData.

4. Настройка транспорта QUSH.

4.1. В ПО QUSH необходимо создать связку с Shelter2 (файл - Связки с Абонемент - правой кнопкой мыши по левой рабочей области - Создать. (На момент написания статьи нет раздела Связки с Shelter2). (см. рис. 5).

Рис. 5 - Соединение с БД.

4.2. Переходим в раздел Настройки и подраздел Базы данных. Указываем данные подключения к базе SH5 и базе Shelter2. Для подключения QUSH к БД ПО Shelter необходим провайдер LCPI OLE DB Provider for InterBase [v3]. Загрузить его можно на ftp.ucs.ru в разделе (/rk7/INSTALL/OTHER/IBProvider/) или во вложении к данной статье: IBProvider_prof_32-64_3[1].6.0.12057.exe.

При нажатии на кнопку Проверить, мы должны получить сообщение о том, что Подключение к серверу выполнено успешно. После этого последовательно нажимаем кнопки Сохранить и Обновить.

 4.3. Переходим на следующий подраздел Клубы (Организации) и ставим галочку на чекбоксе с доступной организацией (рис. 6).

Рис. 6 - Клубы.

4.4. Переходим на следующий подраздел Места реализации и выбираем необходимые для выгрузки места реализации (рис. 7).

Рис. 7 - Места реализации.

4.5. В подразделе Справочники, нам необходимо выбрать из списка или создать Группу для товаров клуба (например "Услуги" или "Номерной фонд"(рис. 8)

Рис. 8 - Справочники.

4.6. В подразделе Автозапуск можно настраивать автоматический запуск импорта, а в подразделе Уведомления настраивать рассылку. Рекомендуем ознакомиться с их функционалом с помощью руководства пользователя SH5: https://docs.rkeeper.ru/sh5/ru/pol-zovatel-skaya-dokumentatsiya.

5. Выгрузка данных.

5.1. Рассмотрим выгрузку данных на конкретном примере, когда необходимо выгрузить справочник услуг и продажи данных услуг:

- Запускаем ExportData, добавляем новую конфигурацию как показано на рис. 9. 

Рис. 9 - Экспорт услуг.

- Теперь нам необходимо перейти из раздела Параметры в раздел Услуги и указать необходимые услуги, которые мы хотим выгружать (рис. 10)

- Происходит выгрузка услуг оказанных в данном периоде. Используется смена когда услуга была начислена.

 - В данной интеграции связь сущностей ПО "Shelter2" и ПО SH5 происходит по уникальному идентификатору - guid.

- Для типа экспорта «Услуги» дополнительные опции недоступны.

- Если в данную смену были реализованы отмеченные услуги, то в SH5 будут сформированы заявки, по которым можно создать накладные.

Рис. 10 - Раздел услуги.

- После добавления услуг обязательно сохраняем изменения по клавише Ок.

- Переходим в модуль QUSH, Создаем связку, указываем пути к базам данных, указываем Клубы и Места реализации, в Справочниках указываем Группу для товаров клуба - Услуги. 

- После этого переходим в раздел Задания, указываем период выгрузки, ставим чекбокс "Включая продажи за период" если хотим выгрузить Заявки (расходный документ - продажи) и нажимаем Запустить (рис. 11).

Рис. 11 - Запуск экспорта данных. 

- После выполнения экспорта, в поле результат должен быть статус Успешно. Однако иногда результаты бывают со статусом Ошибка. Просмотреть подробную информацию о экспорте можно двойным щелчком по заданию. На рис. 12, мы видим некритичную ошибку при выгрузке данных - Такая заявка уже существует. Она свидетельствует о том, что данный документ уже был выгружен ранее и его повторная загрузка невозможна. Рекомендуем внимательнее изучать детализацию завершенных заданий экспорта. 

Рис. 12 - Детализация задания выгрузки. 

- После выполнения экспорта мы можем зайти в Storehouse 5 и проверить выгруженные данные:

1) На рис. 13 видно, что товары были выгружены успешно.

Рис. 13 - Товары. 

2) На рис. 14, мы видим выгруженные заявки.

Рис. 14 - Заявки. 

5.2. Аналогично, но с некоторыми изменениями происходит выгрузка Номерного фонда (информация на рис. 15 - 19):

- Происходит выгрузка выездов из номеров. Данные типы экспорта нужны, например, для списания хозяйственных единиц на уборку номера.

- Если делать выгрузку без доп. опций, то каждый выезд из номера дает кол-во «единица», при этом не важно сколько гостей проживало в номере.

Рис. 15 - Параметры экспорта.

Рис. 16 - Типы номеров. 

Рис. 17 - Параметры выгрузки в QUSH.

Рис. 18 - Выгрузка товаров и реализаций. 

Рис. 19 - Выгрузка заявок в StoreHouse5. 

6. Проблема отображения иконок в приложении ExportData.

6.1. Если вы столкнулись с проблемой, что при входе в ExportData у вас не отображаются иконки, вам нужно сделать следующее:

  -  Скачать папку skins с ftp.shelter.ru. Он находится в дистрибутиве ПО Абонемент FullVersion и во вложении к данной статье: skins.7z

  - Папку skins из архива помещаем в любое удобное место.

   - Файл ShelterIB.ini необходимо поместить по пути C:\Windows

   - В ShelterIB.ini нужно прописать путь до файла skins.ini, который располагается в ранее разархивированной папке skins (рис. 20)

Рис. 20 - Skins.ini.