Введение

Некоторые продукты, например r_k Reports, требуют, чтобы в White Server Agent было наcтроено SQL-подключение к БД r_keeper.

В последних версиях реализована автоматическая настройка SQL-подключения:

  • WSA 2.5.3.18 и выше
  • r_keeper 7.07.00.169 и выше

Если версия r_keeper ниже 7.07.00.169, то необходимо провести ручную настройку

Если версия r_keeper равна или выше 7.07.00.169, то система выполнит автоматическую настройку и вам достаточно только проверить результат.


Важно: для работы r_k Reports используется WSA, который установлен на сервере, где настроено подключение к накопительной SQL базе данных. Например, это может быть сервер справочников или сервер отчетов.

Если на рефе имеются несколько кассовых серверов которые необходимо подключить, то в конфигурации подключения RKeeperReportService должны быть добавлены строчки подключения по каждому объекту, пример

Ручная настройка SQL-подключения

Важно: данную инструкцию следует выполнять только если версия r_keeper ниже 7.07.00.169 при LT-установке White Server Agent.

Для настройки подключения агента WS к SQL базе, необходимо прописать ConnectionString в разделе Конфигурация агента. Для этого:

  1. Перейдите и авторизуйтесь в административной панели WSA
  2. В боковом меню перейдите в раздел Рестораны и найдите нужный ресторан
  3. Нажмите на кнопку , чтобы попасть в карточку ресторана
  4. На вкладке Общая информация перейдите к разделу Агенты V2 и нажмите на кнопку
    Если у вас подключено несколько агентов, выберите тот, у которого есть следующие подключенные системы:
    • RKMid: RKMid_wsclient
    • RKRef: RKRef_wsclient
  5. Перейдите на вкладку Конфигурация
  6. Нажмите на кнопку Загрузить с агента
  7. Добавьте секцию с параметрами подключения к SQL. Учетная запись для подключения RKeeperReportService должна иметь права на запись в БД

    "ConnectionStrings": {
        "RKeeperReportService": "Server=[IP, port];Database=[name];User ID=[login];Password=[password]",
        "RKeeperReferenceService": "Server=[IP, port];Database=[name];User ID=[login];Password=[password]"
      },
    CODE

    где [IP, port] — IP и TCP-порт SQL сервера
    [name] — название базы данных
    [login] — логин от SQL
    [password] — пароль от SQL 

    Если агент ниже 2.5.0.19 версии, необходимо прописать секцию RKeeperReportService для совместимости со старыми агентами и конфигурациями. 
    Обратите внимание, вам необходимо вставить свои значения.

  8. Нажмите кнопку Применить настройки
  9. Вернитесь в карточку ресторана и перейдите на вкладку Общая информация
  10. Убедитесь, что ваш агент подключен к верной базе Sql — Sql_wsclient
  11. Настройки завершены.

Для проверки подключения агента к SQL-серверу перейдите в карточку агента и на вкладке Общая информация нажмите на кнопку Получить информацию о системе

Убедитесь, что подключение успешно произошло:

{
        "name": "SQL-подключение",
        "version": "Microsoft SQL Server 2012 (SP1) - 11.0.3156.0 (X64)  \tMay  4 2015 18:48:09  \tCopyright (c) Microsoft Corporation \tExpress Edition (64-bit) on Windows NT 6.2 <X64> (Build 9200: ) (Hypervisor) ",
        "instanceName": "Sql_wsclient",
        "objectIdList": [
          код объекта
        ],
        "isAvailable": true
      },
CODE

Автоматическая настройка SQL-подключения

Если версия r_keeper равна или выше 7.07.00.169, то система выполнит автоматическую настройку SQL-подключения. Вы можете проверить, что агент успешно подключился к SQL-серверу. Для этого:

  1. Перейдите и авторизуйтесь в административной панели WSA
  2. В боковом меню перейдите в раздел Рестораны и найдите нужный ресторан
  3. Нажмите на кнопку , чтобы попасть в карточку ресторана
  4. Убедитесь, что ваш агент подключен к верной системе Sql — система SQL с кодом ресторана
  5. Подключение завершено.

Для проверки подключения агента к SQL-серверу перейдите в карточку агента с помощью кнопки  и на вкладке Общая информация нажмите на кнопку Получить информацию о системе

Убедитесь, что подключение прошло успешно:

{
        "name": "SQL-подключение",
        "version": "Microsoft SQL Server 2012 (SP1) - 11.0.3156.0 (X64)  \tMay  4 2015 18:48:09  \tCopyright (c) Microsoft Corporation \tExpress Edition (64-bit) on Windows NT 6.2 <X64> (Build 9200: ) (Hypervisor) ",
        "instanceName": "199999999: 127.0.0.1&_RK7",
        "objectIdList": [
          199999999
        ],
        "isAvailable": true
      },
CODE