В этой инструкции описано подключение WSA в standalone версиям r_keeper. Облачная установка описана в другой статье.

Введение

Инструкция по установке r_keeper 7.6.5+ вместе с WSA v2. 
Начиная с версии r_keeper 7.6.5.452.6, в комплекте с установщиком ркипера идет White Server Agent v2. Это упрощает процесс внедрения Лояльности в ресторане.

Это означает, что при установке r_keeper версии 7.6.5.452.6 и выше r_keeper Loyality будет работает "из коробки" и не требовать дополнительных настроек для запуска.

Отличия от стандартного дистрибутива

Настройка лояльности в r_keeper раньше

Настройка лояльности в r_keeper с версии 7.6.5.452.6

Версии продуктов

В дистрибутив r_keeper входят следующие продукты:

  • Версия WSA v2 - 2.2.1.42
  • Версия RK7 - 7.6.5.452.6

Если требуется установка WSA отдельно от r_keeper 7, то воспользуйтесь статьей об установке WSA v2.

Системные требования

Минимальные системные требования для работы WSA v2:

Операционная система
  • Windows 7 Home (32/64)

Процессор

Intel Core i3 1 ГГц

Оперативная память

4 Гб

Место на жестком диске

20 Гб

Интернет-соединение

1 Мбит/с, стабильный канал связи

Для работы на старых операционных системах требуются следующие обновления:

Также подойдёт любая операционная система новее Windows 7 SP2.

Установка r_keeper

Установка новой версии делается аналогично предыдущим. Детальное описание есть в статье Инструкция по установке RK7 через инсталятор 

WSA после установки автоматически подключается к серверу. Лицензирование агента тоже происходит автоматически при установке.
Настройка агента происходит по схеме ниже:

Настройка в менеджерской станции

Для настройки подключения к rk_loyalty:

  1. В менеджерской станции перейдите в Настройки > OLAP отчеты > Серверы отчетов 
  2. Выберите желаемый сервер отчетов или справочников
  3. В разделе XML интерфейс укажите порт привязки. Порт должен быть свободен и доступен по сети
  4. В разделе HTTP Server укажите свободный порт в поле HTTP Data Port, при этом настройка Use Free Listen Port должна быть отключена
  5. Сохраните изменения и согласитесь с предупреждениями о том, что сервер должен быть перезагружен
  6. В разделе HTTP Ограничения укажите во всех полях право HTTP Access

    Если привилегия HTTP Access отсутствует, то создайте новую привилегию с таким именем.

  7. Перезагрузите сервер справочников/отчетов.
    После перезагрузки сервера настройки в json-файле WSAv2 обновятся.

После перезапуска сервера справочников, WSA подключится к серверу и появится в административной панели.

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

Через 15 минут после подключения WSA, начнет происходит активация Лояльности
Если этого не происходит, перезапустите службу White Server Agent.

  1. На кассовом сервере появятся XML и PDS интерфейсы
  2. Активировались все предустановки — валюты, работники и другие
  3. Если все в порядке, переходите к заполнению данных для онбординга.

Обратите внимание

В данный момент активация лояльности не поддерживает 2 ФР. В будущем ситуацию планируется исправить.

Настройка ресторана для онбординга

Базовый процесс внедрения

Изменение настроек агента

Если требуется изменить настройки агента:

  1. Перейдите в административную панель 
  2. Авторизуйтесь с дилерским логином и паролем
  3. Перейдите в раздел Рестораны
  4. Укажите полный код ресторана в поле Objectid и нажмите кнопку Найти
  5. Откройте настройки ресторана, нажав на шестеренку 
  6. Откроется список агентов ресторана:

    По последней активности можно судить о работоспособности агента.
  7. Выберите желаемый агент и нажмите на шестеренку для настройки

  8. Перейдите на вкладку Конфигурация

  9. Укажите желаемые настройки агента. Доступные параметры конфигураций агента описаны в отдельной статье.
    Пример конфигурации:

    {
        "RKeeper": {
            "TcpConnetion": {
                "IP": "127.0.0.1",
                "Port": 10233,
                "CryptKey": ""
            },
            "RefServer": {
                "TcpConnetion": {
                    "IP": "127.0.0.1",
                    "Port": 1788
                }
            }
        }
    }
    YML
  10. Нажмите Применить настройки

  11. Новые настройки применятся для агента.

Обновление агента

Обновление агента возможно только удаленно через административную панель.

Чтобы обновить White Server Agent:

  1. Перейдите в административную панель
  2. Найдите желаемый агент. Это можно сделать с помощью списка агентов или ресторанов. Принцип одинаковый, покажем на примере ресторана.
    1. Перейдите в раздел Рестораны
    2. Укажите в поле Objectid код своего объекта
    3. Нажмите кнопку Найти
    4. Система отфильтрует список и найдет ваш ресторан:

  3. Нажмите на кнопку шестеренки чтобы перейти в настройки ресторана
  4. Выберите желаемый агент и нажмите на шестеренку. Откроются настройки агента.
  5. Перейдите на вкладку Задачи
  6. В меню выберите кнопку Выполнить команду
  7. В выпадающем списке выберите желаемую команду. Команд обновления 3:
    1. UpdateAgent — обновить агент
    2. UpdateMonitor — обновить монитор
    3. UpdatePlugin — обновить плагин
  8. Выберите желаемую версию и нажмите Ок

  9. Начнется обновление агента.