Общее

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

Данное ПО представляет собой мобильную версию модуля Экспедитор из состава r_keeper_Delivery7. Работает на устройствах с ОС Android.

Примечание: Для версии моб агента 3.xx.xx и выше минимальная версия ОС Android 7.0

Данное ПО состоит из двух частей: сервера и клиентского приложения (apk) для Android-устройства.

Данное ПО доступно для скачивания на ФТП сервере: ftp://ftp.ucs.ru/Delivery/RkExpeditor/.

В последних версиях есть возможность использовать либо сервер для развертывания на базе IIS (MagSrvIIS), либо как службы Windows (MagSrvWS).

Особенности работы сервера MagSrv

  • Сервер должен быть доступен для работы с мобильными приложениями из вне, поэтому необходимо позаботиться о том, чтобы порт сервера был открыт и доступен IP-адрес машины, на которой установлен сервер.

  • Сервер через кассовый сервер получает путь к БД доставки и считывает из нее состояние о принятых заказах.

  • Для сети ресторанов, в которой настроена распределенная доставка (прием в центре - обработка в филиале) возможны следующие конфигурации:

    • Один сервер MagSrv, который настроен на кассовый сервер центрального офиса. В таком случае, MagSrv будет опрашивать все рестораны, вернее локальные БД доставки, прописанные в расширенном свойстве DeliveryPath. Это в любом случае будет занимать некоторое время.

    • В каждом ресторане поднять свой MagSrv, связать его с локальным кассовым сервером. Но Экспедиторы, работающие с этим сервером, не будут видеть заказы, падающие на другие рестораны.

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

Мобильный экспедитор требует лицензии. Для этого необходимо приобрести мастер-лицензию "R-Keeper модуль DeliveryAgent ПО" (одна мастер-лицензия на одно устройство).

После подтверждения мастер-лицензии на объекте во вкладке "Устройства" необходимо добавить GUID устройства, на котором установлено приложение DeliveryAgent.

Для этого нажать кнопку  "Добавить новую запись", в открывшемся окне ввести GUID устройства, название, тип девайса - "DeliveryAgent".

GUID устройства можно посмотреть в настройках Мобильного экспедитора на Android-устройстве.

 

Рис. Добавление устройства на l.ucs.ru

 

Рис. Настройки Мобильного экспедитора

 

Примечание: Если не получается добавить GUID устройства на вкладку "Устройства", возможно у вас нет на это прав. Следует связаться с мастер пользователем вашей дилерской организации.

Подробную информацию про лицензирование читайте здесь http://support.ucs.ru/ru/node/7161#header-34.

Настройка

Настройка в менеджерской станции R-Keeper v.7

В справочнике Настройки - Расширенные свойства создать новое расширенное свойство DeliveryPath. Тип - tkString. В списке типов - выбрать Ресторан.

Рис. Расширенное свойство DeliveryPath

В свойстве для каждого ресторана, указывается полный путь к базе данных "DELIVERY" на филиале, имя пользователя БД и его пароль (по-умолчанию SYSDBA и masterkey),

например: 172.22.4.83:c:\WORK\DeliveryRK7\DB\F2DELIVERYRK7.FDB -U:SYSDBA -P:masterkey.

Если используются пользователь БД и его пароль по умолчанию, то можно не указывать эти параметры, например:  172.22.4.83:c:\WORK\DeliveryRK7\DB\F2DELIVERYRK7.FDB.

Настройка сервера системы на базе IIS

Подразумевается, что у вас настроен и запущен сервер IIS.

Важно: настройки для сервера IIS сделать такие же, как в следующих статьях статьях:

http://support.ucs.ru/ru/node/8649

http://support.ucs.ru/ru/node/7888

http://support.ucs.ru/ru/node/7889

http://support.ucs.ru/ru/node/6912

Основное, на что следует обратить внимание в данных статьях - это:

  • Установка Net Framework 4.0;

  • Включение  поддержки ASP.NET и регистрация в ASP.NET;

  • Включение поддержки 32-битных приложений;

  • Создание и запуск приложения в IIS.

Далее создаем сайт, связываем с каталогом сервера (MagSrvIIS), редактируем Settings.ini и запускаем сайт в Диспетчере служб IIS.

Описание параметров файла Settings.ini

[MAIN]

ObjectId = 199990001          ;; идентификатор ресторана

GpxUrl=http://gpx.ucs.ru      ;; адрес сервера GPX

GpsUpdateTime=1               ;; время обновления координат gps на устройствах с RkExpeditor (в минутах. Минимально 1 минута, по-умолчанию 5 минут)

ReturnTimeInterval=3          ;; интервал, по истечении которого, можно повторно отправить запрос "вернулся" (в минутах). Минимум - 3 минуты, по-умолчанию - 15  

[DELIVERY]

UseCallCentre=0               ;; используется ли схема "Колл-центр" (1-да, 0-нет). По-умолчанию 0 - нет.

User = SYSDBA                 ;; пользователь БД (по-умолчанию SYSDBA)

Password=                     ;; пароль пользователя БД (по-умолчанию masterkey)

Charset=                      ;; кодировка БД

ControlReadinessOrder=0       ;; контроль готовности заказа (1-да, 0-нет);  1 - выбираются заказы со статусом 7 ["Готов(кухня)"] ;  0 - выбираются заказы со статусом 2 ["Производство"] ; По-умолчанию: 0

ChooseOrdersPermission=1      ;; Право мобильного экспедитора назначать на себя заказы. Значения 1-да, 0-нет (по-умолчанию 1-да)

[GEOCODER] 

UseGeocoder=1                  ;; использовать геокодирование 1 - да, 0 - нет (по-умолчанию 0 - нет)

UseFirst=Y                     ;; использовать вначале геокодирование Y - Yandex, G - Google (по-умолчанию Yandex) 

[RK7] 

MidIP = 172.22.4.83:2233      ;; IP адрес и порт XML-интерфейса на кассовом сервере RK7 

MidPwd =                      ;; пароль = CryptKey 

UpdateTime = 2                ;; время обновления справочников (в минутах) 

[SERVICE] 

Lang=RUS                      ;; язык интерфейса

Настройка сервера системы как службы Windows

Скачать с фтп и распокавать папку MagSrvWS_Версия.zip.

В файле settings.ini прописать http-порт, который будет слушать сервис, работая как служба. Остальные параметры, такие же как и в предыдущем разделе.

[MAIN]

Port=8086   ;; порт, на котором будет запущен http-сервис. Если порт не указан, то используется порт 7777.

<!-- вырезано --!>

1. Установка и запуск сервиса
 
От имени администратора запускаем cmd.exe и внутри пишем:
  magsrvws.exe install
  magsrvws.exe start
  
2. Остановка и удаление сервиса
 
От имени администратора запускаем cmd.exe и внутри пишем:
  magsrvws.exe stop
  magsrvws.exe uninstall

Запуск

Установить на мобильное устройство приложение (скачать с Google-Play или взять на ФТП сервере файл DeliveryAgent_НомерВерсии.apk).

Для входа в приложение используется код и пароль работника из справочника Персонал - Работники менеджерской станции РК7.

В настройках приложения прописать адрес к веб-серверу MagSrv - IP:port.

Примечание: порт зависит от того какой сервер используется - на базе IIS или работающий как служба Windows.

Рис. Настройка подключения к серверу под управлением IIS