Введение

DocsInbox - сервис для электронного документооборота. Умеет выгружать номенклатуру и документы, читать/создавать накладные в StoreHouse 4 через WhiteServer (через OLE API SH). Имеет Веб-интерфейс, который токже позволяет работать с документами.

Подробнее о возможностях DocsInbox на сайте http://docsinbox.ru/.

Интеграция DocsInbox с системой StoreHouse 4 осуществляется через WhiteServer, расположенным в DataCentre компании UCS.

Схема взаимосвязи модулей

Схема взаимосвязи модулей отображена ниже:

Дистрибутив

WSAgent доступен по следующей ссылке: ftp://ftp.ucs.ru/WS/WSAgent/versions/.

Утилиты для лицензирования и регистрации кассовых серверов на стороне WS доступны по ссылке: ftp://ftp.ucs.ru/WS/WSAgent/tools/

Лицензирование

Для работы данной схемы необходимо наличие следующих лицензий на l.ucs.ru:

  1. Мастер лицензия « Интерфейс White Server» на работу WSA в этом ресторане;;
  2. Мастер лицензия на доступ агрегатора, в данном случае агрегатором выступает внешняя система DocsInbox (R-Keeper модуль Интерфейс к DocsInBox RK7 ПО)

Если мастер лицензий нет, то её необходимо запросить как любое другое ПО через создание Заявки на ПО. После подтверждения заявки проверить в карточке объекта и сгенерировать новую лицензию.

Запрос лицензии происходит в Конфигураторе на вкладке "Лицензирование"(подробнее в разделе Настройка ниже). Информация запишется в файл WSA.dat. После в l.ucs.ru появится лицензия WSClient.

Если мастер лицензии есть, но они просрочены (или истекает срок действия), то необходимо выполнить заявку на «Продление ПО».  Далее необходимо перегенерировать лицензию.

После продления лицензии необходимо повторно запросить лицензию на агента в Конфигураторе (вкладка Лицензирование).

После продления лицензии необходимо перезапустить Windows службы“WhiteServerAgent Service”, “WhiteServerAgentMonitor Service”. Об установке читайте ниже в разделе "Настройка". 

Настройка

Настройка WSAgent

Примечание: после обновления агента, конфигуратор импортирует настройки из старого формата wsa.ini в новый wsa.config (закодированный).

  1. Скачать последнюю версию WSAgent с фтп: ftp://WS/WSAgent/versions/1.0.5.19/wsa.rar

  2. Папку с с агентом добавить в исключения антивирусной программы, иначе возможно блокировка агента, соответственно не будут работать все запросы. Кроме того не будет работать автоматическое обновление и перезапуск агента. Т.е. Инженерам нужно будет вручную мониторить и обновлять агентов.

  3. Запустить WhiteServerAgentConf.exe и залогиниться под дилерским ID.

  4. На вкладке "Общее" выбрать одну из систем, с которой будет осуществлена связь. В нашем случае это "SH4". При использовании прокси-сервера, прописать параметры прокси.

  1. На вкладке "SH4" прописать параметры соединения с сервером StoreHouse. Проверит связь, нажав Check connection.

  1. На вкладке "Лицензирование" выбрать объект и запросить лицензию. На l.ucs.ru должна предварительно быть получена мастер-лицензия для объекта и активирована.

  1. На вкладке "White Server" прописать путь к White Server (по-умолчанию http://ws.ucs.ru/WSServerLP) и проверить соединение кнопкой "Check connection".

  1. На вкладке "Служба" конфигуратор позволяет установить WhiteServerAgent как службу.

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

В ресторанах, в которых WSAgent подключается к WS через файрвол с проверкой по IP адресу, нужно будет сделать изменения в настройках

  • Изменить IP адрес дополнительного сервера ws-p02.ucs.ru - 185.110.56.30
  • Изменить IP адрес основного сервера ws.ucs.ru - 185.110.56.24

На стороне клиентов (ресторанов):

  • Нужно разрешить исходящее соединение на адрема (ws-p02.ucs.ru - 185.110.56.30 и ws.ucs.ru - 185.110.56.24)

Примечание: Для выполнения API-процедур на стороне складского сервера необходимо добавить все файлы из Sh4Ole.rar (ftp://WS/WSAgent/tools/Sh4Ole.rar) в папку с WSA и зарегистрировать SH4ole.dll (в консоли под администратором regsvr32 Sh4Ole.dll). Помните, что WSagent требует дополнительной лицензии для склада в момент выполнения запросов DocsInbox (считается доп.местом).

Примечание: в sh4 должна быть разрешена и настроена связь через tcp/ip и указан порт по которому работает соединение с базой.

Рис. Включение Tcp/ip протокола в свойствах сервера SH4.