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

Введение

Некоторые продукты требуют, чтобы в 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]"
     },

   Copy

   CODE

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

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

8. Нажмите кнопку Применить настройки
   

   

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

    

11. Настройки завершены.

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

{
        "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
      },

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

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

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

   

5. Подключение завершено.

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

{
        "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
      },