Коммуникационный сервер

Версия 47.1 от Руслан Савельев на 2025/11/05 05:59

1. Назначение

Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ.

2. Запуск приложения

Для запуска приложения используйте один из вариантов:

Наберите в браузере localhost:8000 (указан порт по-умолчанию)

3. Интерфейс программы

Программа открывается в браузере и состоит из следующих элементов:

Адресная строка - в ней должен быть набран адрес КС (на рисунке отмечено цифрой 1).
Индикатор состояния подключения - показывает, есть ли связь с сервером обмена (на рисунке отмечено цифрой 2).
Вкладки слева - переключение между вкладками с входящими и исходящими пакетами и вкладка настроек (на рисунке отмечено цифрой 3).
Основное окно - список пакетов в выбранной вкладке, а также настройки (на рисунке отмечено цифрой 4).

4. Требования к ПО

«СНК-КС» - 5.2.0 и выше.
«СНК-АЗС» - 1.37.37 и выше.
«СНК-Офис» - 1.23.2 и выше.
«СНК-ПЦ» - 1.113.30 и выше.
Действующая лицензия «СНК-КС» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «KeyInfo»

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

Для обеспечения обмена точек обслуживания с инфраструктурой Офиса (СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн) при помощи СНК-КС5, необходимо соблюсти применение следующих пунктов:

Установленный сервер NATS для СНК-КС5 в инфраструктуре Офиса – данное приложение будет отвечать за коммуникацию между всеми экземплярами СНК-КС5
Отдельные экземпляры СНК-КС5 для каждой ТО
Отдельные экземпляры СНК-КС5 для каждого из следующих приложений - СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн

Ниже приведена схема взаимодействия всех экземпляров СНК-КС5 и сервера NATS:

6. Установка СНК-КС5 в инфраструктуре Офиса

Настройка СНК-КС5 начинается на сервере, где установлены СНК-Офис и/или СНК-ПЦ. Необходимо установить сервер NATS и отдельные экземпляры СНК-КС5 для СНК-Офис и СНК-ПЦ.

Для установки СНК-КС5 на стороне Офиса:

Запустите установочный файл snc_cs_update_5_4_0.exe (или файл с более новой версией).
Нажмите «Далее» на экранах мастера установки и списка изменений.

Окна начала установки и списка изменений

На экране выбора компонентов выберите, для какой программы нужно установить СНК-КС5.
Установите флажок установки сервера NATS, если он не был установлен ранее.
На следующем экране выберите папку для установки СНК-КС и нажмите «Далее».

Дождитесь завершения установки и нажмите «Готово».

Примечание!
Если необходимо установить СНК-КС5 еще и для другого приложения (например «СНК-ПЦ»), то повторите действия по установке, выбрав установку СНК-КС5 для нужного приложения. Флажок «Установка сервера NATS» при повторной установке отмечать не нужно.

7. Первоначальная настройка работы СНК-КС5 с СНК-Офис

7.1. Настройка конфигурационного файла СНК-КС5

Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.

Остановите службу «СНК-Коммуникационный сервер v5 СНК-ОФИС»
Откройте файл .\SNC_OFFICE\exchange\SncExchServer.cfg
Измените значения параметров:

Имя параметра	Описание значения параметра
abonent.id	Номер абонента СНК-Офис в сети СНК-КС5
archive.inbox.depth	Хранение входящих пакетов, дней
archive.outbox.depth	Хранение исходящих пакетов, дней
archive.packet.disable	Сохранение пакетов обмена в архив: true – НЕ сохранять false – сохранять
log.depth	Хранение логов СНК-КС5, дней
auth.token	Общий токен сети (одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ)
http.port	Порт для связи с СНК-Офис (по умолчанию: 8000) *
nats.host	IP и порт сервера NATS (порт по умолчанию: 7654)
nats.timeout	Таймаут обращения к серверу NATS, мс

Сохраните изменения в файле и запустите службу «СНК-Коммуникационный сервер v5 СНК-ОФИС»

* Примечание!
Если на одном ПК запущены СНК-Офис и СНК-ПЦ одновременно, используйте разные порты для каждого экземпляра СНК-КС5, например, для СНК-КС5, который используется для СНК- Офис используйте порт 8000, а для СНК-КС5, который используется для СНК-ПЦ используйте порт 8001

7.2. Настройка конфигурационного файла СНК-Офис

Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.

Закройте приложение «СНК-Офис»
Откройте файл .\SNC_OFFICE\bo_app.ini
Измените значения параметров:

Имя параметра	Описание значения параметра
UseExchangeServer	1 – использовать КС для приема и передачи пакетов
AutoReceiveData	1 – автоматический прием пакетов из КС в СНК-Офис
ExchangeSrvPortExt	Порт для связи с СНК-КС5 (http.port в файле настроек КС5)

Сохраните изменения в файле

8. Настройка СНК-Офис для передачи данных на ТО через СНК-КС5

Эта настройка выполняется для каждой ТО, которая будет использовать СНК-КС5 для обмена данными с СНК-Офис.

Запустите «СНК-Офис»
Откройте раздел «Справочники» и выберите «Точки обслуживания»
На нужной ТО нажмите правой кнопкой мыши и выберите «Редактировать»

Откроется окно «Редактирование ТО»
Перейдите на вкладку «Обмен данными»
В параметре «Использовать СНК-КС» выберите «КС 5»
Нажмите кнопку «ОК» для сохранения параметров

9. Установка и обновление СНК-КС5 на ТО

Установка и обновление СНК-КС5 на ТО выполняется при обновлении версии СНК-АЗС. Если СНК-КС5 не был установлен, то будет выполнена установка, если установка была произведена ранее, то СНК-КС5 будет обновлен до той версии, которая содержится в файле обновления.

Для установки или обновления СНК-КС5 на стороне ТО:

Закройте все приложения СНК-АЗС (включая Бэк-Офис)
Запустите файл обновления snc_azs_update_1_75_14.exe (пример названия файла)
На экране выбора компонентов отметьте флажок «Коммуникационный сервер v5» и нажмите «Далее»

Дождитесь завершения обновления и нажмите «Готово»

10. Настройка СНК-АЗС для работы через СНК-КС5

10.1. Настройка конфигурационного файла СНК-АЗС

Закройте все приложения СНК-АЗС (включая Бэк-Офис)
Откройте файл .\SNC_AZS\backofficeapp\bo_app.snc
Измените значения параметров:

Имя параметра	Описание значения параметра
UseExchangeServer	1 – использовать КС для приема и передачи пакетов
SendOpenShift	1 – передавать текущую открытую смену
TransactionOnOpenShift	1 – передавать данные по открытой смене
ExchangeList	Список абонентов, с которыми обменивается СНК-АЗС и формат данных для обмена, заполняется автоматически
AutoSendData	Автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 означает - всем абонентам, 07:00 – время отправки данных)) (Также, автоматическую отправку данных можно настроить через «Планировщик заданий» Windows)
AutoReceiveData	1 – автоматический прием пакетов из КС в СНК-АЗС
ExchangeSrvPortExt	Порт для связи с СНК-КС5 (http.port в файле настроек КС5)

Сохраните изменения в файле

10.2. Настройка в программе «Бэк-Офис СНК-АЗС»

В «Бэк-Офис СНК-АЗС» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5), а также настроить параметры работы СНК-КС5.

Запустите «Бэк-офис СНК-АЗС».
В строке меню нажмите – «Обработка» - «Обмен данными» - «Настройка списка абонентов».

Откроется окно «Абоненты», здесь находится список абонентов, с которыми производится обмен данными.
Первоначально в списке абонентов заведен абонент для примера, удалите его. Для этого нажмите правой кнопкой мыши на строке абонента и выберите «Удалить»
В окне «Абоненты» нажмите правую кнопку мыши в любом свободном месте окна и выберите «Добавить».

В строке «Добавить абонента» укажите код добавляемого абонента, например, код абонента «СНК-Офис» (abonent.id в файле настроек КС5) и нажмите кнопку «ОК».