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

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

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

Дистрибутив 

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

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

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




Примечание

CardServ необходим не ниже версии 7.25




Так как используется распределенная ПДС (подробнее в статье Установка и настройка системы ПДС), то подключать Сервер "CardServApi" необходимо только к центральному серверу ПДС "CardServ", который в свою очередь синхронизируется с локальными серверами с помощью SyncCard.

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

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

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

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

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

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

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

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

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

В менеджерской станции необходимо настроить доступ к серверу справочников через HTTPS. Подробнее читайте здесь https://tracker.ucs.ru/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. После сохранение изменений необходимо перезагрузить сервер.

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

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

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

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


 Для этой роли добавить работника, задать ему пароль. Название  и пароль данного работника будут использоваться для авторизации на сервере через 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-порт сервера справочников согласно рисункам Настройки на стороне R_Keeper v7. 
[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 должен быть настроен и запущен. Подробнее о настройках читайте в документации об IIS. и дополнительно в статье Настройка веб-интерфейса и Dashboard и Web-отчеты. Установка визуализатора Web-отчётов.

Так же можно найти информацию на сайте 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. Если не доступна данная версия, то обновить Фреймворк.

  6. В файле 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 цифр).

Примечание

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

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

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

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