Общая информация

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

В данной статье описано как настроить MarketingDesktop.

Дистрибутив 

Важно: Система предоставляется только в облачном исполнении, отдельный дистрибутив недоступен.

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

Взаимосвязь модулей отображена ниже

Рис. Простейшая схема взаимосвязи модулей

Примечание: CardServ необходим не ниже версии 7.25

Так как используется распределенная ПДС (подробнее в статье http://support.ucs.ru/ru/node/6673#header-29), то подключать Сервер "CardServApi" необходимо только к центральному серверу ПДС "CardServ", который в свою очередь синхронизируется с локальными серверами с помощью SyncCard.

Рис. Взаимодействие модулей MarketingDesktop

Для работы с менеджерской частью MarketingDesktop требуется подключение к Internet.

При этом потеря связи с центральным сервером не критична для предоставления лояльности на кассах и система лояльности продолжит функционировать на локальном CardServ. Но синхронизируется как появится связь с центральным сервером.

База данных хранится в облаке на мощностях UCS. Бэкап базы предоставляется по требованию.

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

Название ПО в системе лицензирования "R-Keeper модуль MarketingDesktop ПО".

На данный момент MarketingDesktop распространяется:

  • в составе RKCloud (базовый пакет MarketingDesktop);

  • отдельно в облачном исполнении.

Настройки на стороне R_Keeper v7

В менеджерской станции необходимо настроить доступ к серверу справочников через HTTPS. Подробнее читайте здесь http://tracker.ucs.ru:8080/redmine/projects/-helpdesk-/wiki/r-keeper-7-xmlinterface-ru.

Кратко порядок действий будет следующий:

  1. В справочнике "Сервис - Менеджерская станция - Привилегии на объекты" добавить новую привилегию, например HTTP_порт.

Рис. Создание привилегии

  1. В свойствах сервера справочников прописать порт (параметр HTTP Data Port) в секции HTTP Server. Флаг Use Free Listen Port необходим, чтобы программа выбрала другой порт в случае, когда заданный в свойстве HTTP Data Port порт занят. Поэтому проверьте сразу свободен ли порт, который вы задаете. В блоке HTTP Ограничения выбрать ограничение, созданное в п 1. После сохранение изменений необходимо перезагрузить сервер.

Рис. Задание порта "HTTP Data Port" в свойствах сервера справочников.

  1. Создать роль с правами на привилегию из п.1.

Также у данной роли должны быть следующие права:

  • Менеджерская станция - доступ к MarketingDesktop (по указанному email проивзодится авторизация);

  • Системные конфигурации - доступ к настройкам MarketingDesktop (например, SMS шлюз).

Рис. Создание новой роли
 
 
Рис. Дополнительные привилегии
  1. Для этой роли добавить работника, задать ему пароль. Название  и пароль данного работника будут использоваться для авторизации на сервере через HTTPS.
 
Рис. Создание нового пользователя
 
Для проверки успешной авторизации по протоколу HTTPS откройте браузер и в адресной строке вбейте следующую строку: https://127.0.0.1:3355/rk7api/v1/serverstatus.xml. 127.0.0.1:3355 - адрес и порт сервера справочников.
Появится окно авторизации - введите название работника и пароль (п.4), далее в окне браузера должен отобразиться результат выполнения запроса serverstatus.xml:
 

Настройка CardServApi.exe

  1. В файле \srcbin\rkeeper.ini в секции [RTcp] прописать IP-адрес и порт Сервера карт - CardServ.exe
[RTcp]

Server1 = 192.168.101.82

Port1 = 3055
  1. В файле .\CardServApi.ini в секции [Main] прописать свободный порт, который будет слушать сервер API. Его нужно будет так же ввести в файле Web.Config (пункт ниже "Настройка IIS"). Для параметра UCSPassword прописать пароль пользователя ucs из системы ПДС (по-умолчанию пароль = "ucs").

Примечание: если в ПДС пользователь "ucs" был единственный в группе "Administrator", то рекомендуется создать еще одного пользователя в данной группе(роли) до запуска CardServApi.exe.

[Main]

HttpPort=9988

UCSPassword=ucs
  1. В том же файле, но в секции [RK7] прописать IP-адрес и HTTP-порт сервера справочников согласно рис 2 и логин/пароль согласно рис 4
[RK7]

ip=192.168.101.82

port=3355

username=http_User45

password=45

ShowMarkups=0
  1. Выполнить CardServApi.exe /install. Запустить службу CardServApiService

  2. Логи служба пишет в папку Logs.

Интерграция CardServApi с Postgres

Поддержано в версии CardServApi 1.0.0.16 и выше.

  1. Установить Postgres 9.6, создать базу данных.

  2. Задать настройки коннекта к Postgres в CardServApi.ini:

[PG]

ip=127.0.0.1

port=5432

dbname=cardserv

username=user

password=1
  1. В корневой папке с Cardservapi для связи с Postgres должны быть файлы:
  • libiconv-2.dll
  • libintl-8.dll
  • libpq.dll
  1. Если используется RK6, то в секции [Main] выставить параметр UseRk6Image в 1. По умолчанию 0. 
[Main]

UseRk6Image = 1
  1. Если служба не запускается, установить MS Visual C++ 2013

Настройка Web-интерфейса

Для работы Web-интерфейса необходим сервер IIS.

Сервер IIS должен быть настроен и запущен. Подробнее о настройках читайте в  статье http://support.ucs.ru/ru/node/8649  и дополнительно в статье http://support.ucs.ru/ru/node/7888 и http://support.ucs.ru/ru/node/7889.

Так же можно найти информацию на сайте https://technet.microsoft.com/en-us/library/hh831515(v=ws.11).aspx.

После включения сервера IIS выполняем следующее:

  1. Запускаем "Диспетчер служб IIS";

  2. Распаковываем архив marketingDesktop.zip в любой каталог на диске (например, D:\UCS\Marketing_desktop\web_v7\);

  3. В "Диспетчере служб IIS" добавить новый сайт (приложение), где в качестве физического пути к приложению выбрать папку из пункта выше (D:\UCS\Marketing_desktop\web_v7\);

  4. Прописать свободный порт для данного сайта, например 8002; Нажать кнопку "OK";

  5. В свойствах пула выбрать версию Фреймворка 4. Если не доступна данная версия, то обновить Фреймворк.

Рис. Основные настройки пула

 
  1. В файле Web.config изменить следующие параметры:
  • ApiHost - URL сервера CardServApi

  • ApiTimeout - таймаут выполнения запросов к серверу Api

Фрагмент файла:

...

<add key="ApiHost" value="http://127.0.0.1:9988/" />

<add key="ApiTimeout" value="10000" />

...
  1. При изменении файла Web.config приложение IIS необходимо перезагрузить, чтобы новые настройки вступили в силу.

  2. После в браузере открыть страницу http://127.0.0.1:8002/ и ввести логин и пароль пользователя из РК7. Для пользователей RK-Cloud ссылка будет иметь вид http://rkcloud.ucs.ru/code_rest/MD/login, где code_rest - полный код ресторана (9 цифр).

Рис. Окно авторизации

Примечание: при доступе из RK-Cloud необходимо в меню выбрать ПДС -> Marketing_Desktop. Веб-интерфейс доступен по ссылке http://rkcloud.ucs.ru/code_rest/Home/Login, где code_rest - это полный код ресторана (9 цифр). 

  1. В качестве логина использовать значение свойства EmployeeEMail работника (см.рис ниже).

Рис. Свойства работника

  1. Как выглядит интерфейс, можно посмотреть на рисунке ниже.

Рис. Web-интерфейс MarketingDesktop