SetLoyalty ◾️ Модуль "Покупатели" ◾️ Подключение к сервису

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

Настройку подключения осуществляют функциональные консультанты или инженеры.

Начиная с версии 10.3.2.0 можно использовать единый сервис для обработки транзакций /wiki/spaces/SR10SUPPORT/pages/3081535562.

1. Разверните раздел Интеграция → кликните Внешние процессинги → кликните .

2. Наберите в поле для поиска покупатели → кликните Внешние процессинги лояльности → установите флажок  SLS Customers, Приложение Покупатели → кликните 

3. Кликните два раза мышкой по оператору SLS Customers, Приложение Покупатели.

4. Установите тип распространения данной настройки:

  •  Настраивается в магазине - настройка подключения к модулю "Покупатели" будет производиться на каждом сервере SetRetail в магазине.
  •  Для всей сети - настройка будет загружена на все серверы и кассы торговой сети. Настройка на каждом магазине не требуется.
    •  Для все сети - если флажок не установлен, тогда выберите те магазины, на которые будет отправлена настройка с подключением к модулю "Покупатели".

5. Введите данные для подключения к сервису модуля "Покупатели" → кликните .

  • URL приложения - вводится IP-адрес для подключения к серверу модуля "Покупатели" в формате http://XXX.XXX.XXX.XXX:8888.
    • Если экземпляр сервиса покупателей находится за пределами домена, или покрывается прокси-адресами, которые изменяют роутинг, то URL-адрес здесь должен выглядеть также http://XXX.XXX.XXX.XXX:8888.
  • Таймаут соединения с в миллисекундах - время в миллисекундах для обращения к сервису модуля "Покупатели".
  • Таумаут запись/чтение в миллисекундах - время на запси и чтение данных из базы модуля "Покупатели".
  • Префиксы дисконтных карт (через запятую) - вводятся префиксы, используемых дисконтых карт.

6. Появится сообщение о сохранении настроек.

7. Откройте на редактирование файл ServerRegisterModules-config.xml → добавьте необходимые параметры → сохраните файл.

  • Windows: {Диск}:\{Папка SetRetail}\standalone\configuration\modules\register\ServerRegisterModules-config.xml
  • Linux: /var/lib/jboss/standalone/configuration/modules/register/ServerRegisterModules-config.xml

В конец файла добавьте следующий код, указав в соответствующих тегах IP-адрес визуализации сервера модуля "Покупатели" и актуальную версию сервера SetCentrum/SetRetail:

  • <Version>...</Version> - указывается актуальная версия сервера SetCentrum/SetRetail.
  • <ServiceForVisualizationURL>...</ServiceForVisualizationURL> - указывается адрес для доступа к визуализации сервера модуля "Покупатели" в формате http://XXX.XXX.XXX.XXX:8008/api.
  • <ModuleTopologyAddress>...</ModuleTopologyAddress>для сервера SetRetail обязательно указывается номер магазина, например: 1.0.1687.0.
    <Module name="SLS-Customers" external="true">
	<Jar>jar</Jar>
	<Version>10.2.94.0</Version>
	<ModuleTopologyAddress>1.0.0.0</ModuleTopologyAddress>
	<TopologyNotify>No</TopologyNotify>
	<ServiceForVisualizationURL>http://172.29.17.27:8008/api</ServiceForVisualizationURL>
	<BlazeDSURL/>
	<WidgetURL/>
	<WidgetOrder/>
	<LocaleNames>
		<LocaleName>
			<Language>ru_RU</Language>
			<Name>SLS-Покупатели</Name>
		</LocaleName>
		<LocaleName>
			<Language>en_EN</Language>
			<Name>SLS-Покупатели</Name>
		</LocaleName>
	</LocaleNames>
	<Plugins>
	</Plugins>
    </Module>

8. Также, используя Notepad++ добавьте следующую секцию в конфигурационный файл standalone.xml → добавьте необходимые параметры → сохраните файл.

Начиная с версии сервера 10.3.14.0 эти параметры не нужно настраивать в standalone.xml, только в БД (п.9).

  • Windows: {Диск}:\{Папка SetRetail}\standalone\configuration\standalone.xml
  • Linux: /var/lib/jboss/standalone/configuration/standalone.xml

В начало файла после закрывающего тега </extension> добавьте следующий код, указав в соответствующих тегах IP-адрес номер экземпляра сервера KAFKA (устанавливается разработчиками):

  • KAFKA_EXTENSION - указывается номер экземпляра сервера KAFKA (по умолчанию всегда 0).
  • KAFKA_SERVERS - указывается IP-адрес сервера KAFKA.
    <system-properties>
        <property name="sun.net.client.defaultConnectTimeout" value="30000"/>
        <property name="sun.net.client.defaultReadTimeout" value="30000"/>
        <property name="sun.jnu.encoding" value="UTF-8"/>
        <property name="KAFKA_EXTENSION" value="0"/>
        <property name="KAFKA_SERVERS" value="172.29.17.27:9092"/>
    </system-properties>

9. Выполните два скрипта в базе данных set сервера SetCentrum/SetRetail включения возможности создания карт в категориях,

UPDATE
       sales_management_properties
SET    property_value = 'hostname kafka', send_status = 0
WHERE
       module_name      ='SET_ESB'
       AND property_key ='kafka.servers';
UPDATE
       sales_management_properties
SET    property_value = true, send_status = 0
WHERE
       module_name      = 'SET_ESB'
       AND plugin_name  = 'CONSUMER.CARD_CATEGORY_EXPORT'
       AND property_key = 'enabled';

10. После сохранения файла настроек и выполнения скриптов, перезапустите службу сервера:

ОС Windows:

ОС Linux:

service JBOSS_SVC restart

Подключение внешнего бонусного процессинга модуля

1. Для работы с бонусными баллами и вкладкой БОНУСЫ перейдите Интеграция → Внешние процессинги → кликните .

2. Начните ввод в строку поиска со слов Bon → кликните Внешние проссинги лояльности → установите флажок BonusProcessing. Приложение Бонусный процессинг → кликните .

3. Кликните по процессингу BonusProcessing. Приложение Бонусный процессинг.

4. Установите флажок на тех магазинах, где требуется работа процесснга или для всех → введите параметры подключения к бонусному процессингу → кликните .

  • URL подключения - указывается адрес бонусного процессинга модуля SLS в формате http://XXX.XXX.XXX.XXX:ПОРТ
  • Таймаут соединения с в миллисекундах - время соединения/запроса к бонусному процессингу. Рекомендуемое: 4000.
  • Таймаут запись/чтение в миллисекунадах - время ответа от бонусного процессинга. Рекомендуемое: 4000.