# Выгрузка из Shelter 2 в SH5 **1. Выгрузка данных в SH5 с помощью QUSH.** **Внимание!** Для работы выгрузки данных из Shelter2 в SH5 на ключе должен быть прописан **Проект 5 Модуль 8**. 1.1. Для выгрузки данных из Shelter2 в StoreHouse5 используются утилиты **ExportData** (из поставки ПО "Абонемент") и **QUSH** (SH5). Загрузить ПО Абонемент можно здесь: [ftp://ftp.shelter.ru/Abonement/FullVersion/](ftp://ftp.shelter.ru/Abonement/FullVersion/) 1.2. Дистрибутив утилиты ExportData и скрипт для базы данных Shelter2 находится в архиве во вложении к статье: [ExportData\_1\_11\_0\_1\_shtr\_11.rar.](https://docs.shelter.ru/attachments/45) 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 :](https://docs.shelter.ru/attachments/46) \- Для этого необходимо запустить IBExpert. \- Зарегистрировать нужную БД Shelter2. \- Зайти в меню **Tools - Script Executive (Ctrl + F12)**. \- Выполнить скрипт на базе данных. Скрипт должен выполнится без ошибок (рис. 1). [![image-1630488521850.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630488521850.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630488521850.png) Рис. 1 - Применение скрипта export\_to\_storehouse5.sql. \- Если все же ошибки при применении скрипта возникли (рис. 2), то рекомендуется скопировать содержимое папки UDF из дистрибутива актуальной версии ПО Абонемент (Fullversion\\\_\_SERVER\\FireBird\_2\_5\\udf\\) в папку с установленным Firebird (например: C:\\Program Files (x86)\\Shelter\\Firebird\\udf). После перезапуска Firebird, снова подключаемся к базе и применяем скрипт.[![image-1630488557469.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630488557469.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630488557469.png) Рис. 2 - Возможная ошибка при выполнении скрипта. **3. Запуск и настройка Exportdata:** \- Распаковываем архив с **Exportdata** \- В файле **ExportData.ini** указываем путь к нашей БД Shelter2 (рис. 3) [![image-1630499223464.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630499223464.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630499223464.png) **Рис. 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 соответственно. В поле указывается цифра.
[![image-1630501883181.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630501883181.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630501883181.png) Рис. 4 - Настройки ExportData. **4. Настройка транспорта QUSH.** 4.1. В ПО **QUSH** необходимо создать связку с **Shelter2** (файл - **Связки с Абонемент** - правой кнопкой мыши по левой рабочей области - Создать. (На момент написания статьи **нет раздела Связки с Shelter2**). (см. рис. 5). [![image-1630502318121.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630502318121.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630502318121.png) Рис. 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. ](https://docs.shelter.ru/attachments/47) При нажатии на кнопку **Проверить**, мы должны получить сообщение о том, что **Подключение к серверу выполнено успешно**. После этого последовательно нажимаем кнопки **Сохранить** и **Обновить**. 4.3. Переходим на следующий подраздел **Клубы** (Организации) и ставим галочку на чекбоксе с доступной организацией (рис. 6). [![image-1630502962345.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630502962345.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630502962345.png) Рис. 6 - Клубы. 4.4. Переходим на следующий подраздел **Места реализации** и выбираем необходимые для выгрузки места реализации (рис. 7). [![image-1630502994213.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630502994213.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630502994213.png) Рис. 7 - Места реализации. 4.5. В подразделе **Справочники**, нам необходимо выбрать из списка или создать **Группу для товаров клуба** (например "**Услуги**" или "**Номерной фонд**"(рис. 8) [![image-1630503439083.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630503439083.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630503439083.png) Рис. 8 - Справочники. 4.6. В подразделе Автозапуск можно настраивать автоматический запуск импорта, а в подразделе Уведомления настраивать рассылку. Рекомендуем ознакомиться с их функционалом с помощью руководства пользователя SH5: [https://docs.rkeeper.ru/sh5/ru/pol-zovatel-skaya-dokumentatsiya](https://docs.rkeeper.ru/sh5/ru/pol-zovatel-skaya-dokumentatsiya). **5. Выгрузка данных. ** 5.1. Рассмотрим выгрузку данных на конкретном примере, когда необходимо выгрузить справочник услуг и продажи данных услуг: - Запускаем **ExportData,** добавляем новую конфигурацию как показано на рис. 9. [![image-1630504547195.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630504547195.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630504547195.png) Рис. 9 - Экспорт услуг. \- Теперь нам необходимо перейти из раздела **Параметры** в раздел **Услуги** и указать необходимые услуги, которые мы хотим выгружать (рис. 10) \- Происходит выгрузка услуг оказанных в данном периоде. Используется смена когда услуга была начислена. \- В данной интеграции связь сущностей ПО "Shelter2" и ПО SH5 происходит по уникальному идентификатору - guid. \- Для типа экспорта **«Услуги»** дополнительные опции недоступны. \- Если в данную смену были реализованы отмеченные услуги, то в SH5 будут сформированы заявки, по которым можно создать накладные. [![image-1630504777888.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630504777888.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630504777888.png) Рис. 10 - Раздел услуги. \- После добавления услуг обязательно сохраняем изменения по клавише **Ок**. \- Переходим в модуль **QUSH**, Создаем связку, указываем пути к **базам данных**, указываем **Клубы** и **Места реализации**, в **Справочниках** указываем **Группу для товаров клуба** - Услуги. \- После этого переходим в раздел **Задания**, указываем период выгрузки, ставим чекбокс "**Включая продажи за период**" если хотим выгрузить **Заявки** (расходный документ - продажи) и нажимаем **Запустить** (рис. 11). [![image-1630505349141.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630505349141.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630505349141.png) Рис. 11 - Запуск экспорта данных. \- После выполнения экспорта, в поле результат должен быть статус **Успешно**. Однако иногда результаты бывают со статусом **Ошибка**. Просмотреть подробную информацию о экспорте можно двойным щелчком по заданию. На рис. 12, мы видим некритичную ошибку при выгрузке данных - **Такая заявка уже существует**. Она свидетельствует о том, что данный документ уже был выгружен ранее и его повторная загрузка невозможна. Рекомендуем внимательнее изучать детализацию завершенных заданий экспорта. [![image-1630505617627.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630505617627.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630505617627.png) Рис. 12 - Детализация задания выгрузки. \- После выполнения экспорта мы можем зайти в Storehouse 5 и проверить выгруженные данные: 1\) На рис. 13 видно, что товары были выгружены успешно. [![image-1630506047722.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630506047722.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630506047722.png) Рис. 13 - Товары. 2\) На рис. 14, мы видим выгруженные заявки. [![image-1630506177142.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630506177142.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630506177142.png) Рис. 14 - Заявки. 5.2. Аналогично, но с некоторыми изменениями происходит выгрузка Номерного фонда (информация на рис. 15 - 19): \- Происходит выгрузка выездов из номеров. Данные типы экспорта нужны, например, для списания хозяйственных единиц на уборку номера. \- Если делать выгрузку без доп. опций, то каждый выезд из номера дает кол-во «единица», при этом не важно сколько гостей проживало в номере. [![image-1630507409885.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630507409885.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630507409885.png) Рис. 15 - Параметры экспорта. [![image-1630507419133.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630507419133.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630507419133.png) Рис. 16 - Типы номеров. [![image-1630507426809.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630507426809.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630507426809.png) Рис. 17 - Параметры выгрузки в QUSH. [![image-1630507432916.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630507432916.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630507432916.png) Рис. 18 - Выгрузка товаров и реализаций. [![image-1630507438387.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630507438387.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630507438387.png) Рис. 19 - Выгрузка заявок в StoreHouse5. **6. Проблема отображения иконок в приложении ExportData.** 6.1. Если вы столкнулись с проблемой, что при входе в ExportData у вас не отображаются иконки, вам нужно сделать следующее: \- Скачать папку **skins** с ftp.shelter.ru. Он находится в дистрибутиве ПО Абонемент **FullVersion** и во вложении к данной статье: [skins.7z](https://docs.shelter.ru/attachments/48) \- Папку **skins** из архива помещаем в любое удобное место. \- Файл ShelterIB.ini необходимо поместить по пути C:\\Windows \- В **ShelterIB.ini** нужно прописать путь до файла **skins.ini**, который располагается в ранее разархивированной папке **skins** (рис. 20) [![image-1630508607350.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630508607350.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630508607350.png) Рис. 20 - Skins.ini.