Технический Писатель 10 января, 2017 - 18:59 Последняя редакция: 11 декабря, 2019 - 12:34 Автор редакции: Волик Евгений

Содержание

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

Данное приложение позволяет работать с базой ПДС и производить редактирование справочников, а также является расширенным инструментом по сегментированию гостей, выставлению тэгов гостей и организации коммуникации с гостями по средством 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.

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

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

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

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

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

Создать роль с правами на привилегию из п.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

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

[RTcp]

Server1 = 192.168.101.82

Port1 = 3055

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

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

[Main]

HttpPort=9988

UCSPassword=ucs

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

[RK7]

ip=192.168.101.82

port=3355

username=http_User45

password=45

ShowMarkups=0

Выполнить CardServApi.exe /install. Запустить службу CardServApiService
Логи служба пишет в папку Logs.

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

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

Установить Postgres 9.6, создать базу данных.
Задать настройки коннекта к Postgres в CardServApi.ini:

[PG]

ip=127.0.0.1

port=5432

dbname=cardserv

username=user

password=1

В корневой папке с Cardservapi для связи с Postgres должны быть файлы:

libiconv-2.dll
libintl-8.dll
libpq.dll

Если используется RK6, то в секции [Main] выставить параметр UseRk6Image в 1. По умолчанию 0.

[Main]

UseRk6Image = 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 выполняем следующее:

Запускаем "Диспетчер служб IIS";
Распаковываем архив marketingDesktop.zip в любой каталог на диске (например, D:\UCS\Marketing_desktop\web_v7\);
В "Диспетчере служб IIS" добавить новый сайт (приложение), где в качестве физического пути к приложению выбрать папку из пункта выше (D:\UCS\Marketing_desktop\web_v7\);
Прописать свободный порт для данного сайта, например 8002; Нажать кнопку "OK";
В свойствах пула выбрать версию Фреймворка 4. Если не доступна данная версия, то обновить Фреймворк.

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

В файле Web.config изменить следующие параметры:

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

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

...

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

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

...

При изменении файла Web.config приложение IIS необходимо перезагрузить, чтобы новые настройки вступили в силу.
После в браузере открыть страницу 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 цифр).