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

Версия 35.1 от Руслан Савельев на 2025/09/10 07:45

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

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

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

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

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

Перед запуском программы, КС должен быть установлен на ПК! (см. п. 6)

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

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

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

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

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

5. Информация и структурная схема

6. Установка СНК-КС-5

6.1. Установка на стороне СНК-АЗС

Установка СНК-КС5 выполняется при начальной инсталляции СНК-АЗС или при его обновлении, для этого необходимо в окне выбора продуктов для установки или обновления установить флажок «Коммуникационный сервер v5».
По умолчанию, каталог установки КС5 - .\SNC_AZS\exchange

Если при установке или обновлении установить флажок «Создание ярлыков на рабочем столе», то на рабочем столе появится ярлык «КС СНК АЗС», который будет запускать веб-интерфейс СНК-КС5 (http://localhost:8000/):

6.2. На стороне СНК-ПЦ, СНК-Офис, СНК-Офис онлайн

Воспользуйтесь мастером установки СНК-КС5:

Закройте все программы СНК-АЗС, СНК-ПЦ, СНК-Офис.
Запустите установочный файл (snc_cs_update_5_2_2.exe или файл с более новой версией).
Откроется окно мастера установки, нажмите кнопку «Далее».

Следующее окно показывает список изменений для текущей версии программы, нажмите кнопку «Далее».

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

ПК, на который устанавливается сервер NATS должен иметь статический IP-адрес!

Этот адрес нужно указывать при настройке КС во всех программах. Параметр nats.host

Выберите папку для установки СНК-КС и нажмите кнопку «Далее».

7. Настройка параметров КС 5

Указанные параметры настраиваются в каждом установленном КС (например, если используется КС для СНК-АЗС и КС для СНК-Офис, нужно настроить оба КС)

7.1. Используя конфигурационный файл

Параметры настройки КС 5 сохранены в файле .\exchange\SncExchServer.cfg

Описание параметров:

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

Для изменения параметров необходимо:

остановить службу КС 5, (см. раздел «Службы»).
изменить и сохранить параметры в файле.
запустить службу КС 5, (см. раздел «Службы»).

7.2. Используя веб-интерфейс

Воспользуйтесь ярлыком «КС СНК АЗС» на рабочем столе или наберите в браузере localhost:8000

Перейдите на страницу «Настройки», доступные параметры:
- ID абонента - код абонента, для которого установлен КС5 (параметр abonent.id в файле SncExchServer.cfg)
- Глубина хранения входящих пакетов, дней – сколько дней хранить входящие пакеты (параметр archive.inbox.depth в файле SncExchServer.cfg)
- Глубина хранения исходящих пакетов, дней – сколько дней хранить исходящие пакеты (параметр archive.outbox.depth в файле SncExchServer.cfg)
- Не сохранять пакеты в архив – отметьте флажок, чтобы не хранить архивы пакетов (параметр archive.packet.disable в файле SncExchServer.cfg)
- Токен – значение токена должно совпадать у всех абонентов, участвующих в обмене (параметр auth.token в файле SncExchServer.cfg)
- Строка подключения – IP адрес и порт сервера NATS (параметр nats.host в файле SncExchServer.cfg)
- Таймаут, мс. – таймаут обращения к серверу NATS (параметр nats.timeout в файле SncExchServer.cfg)
Нажмите кнопку «Сохранить» после изменения настроек.

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

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

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

8.1.1. Запуск окна настроек абонентов

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

Откроется окно «Абоненты», здесь находится список абонентов, с которыми производится обмен данными.

8.1.2. Описание параметров таблицы абонентов

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

8.1.3. Настройка портов для связи «Бэк-Офиса» с КС

Порт для КС 4 – порт, по которому «Бэк-офис» связывается с КС 4 (по умолчанию 6000).
Порт для КС 5 – порт, по которому «Бэк-офис» связывается с КС 5 (по умолчанию 8000).

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

Внимание!
В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр http.port в файле SncExchServer.cfg).

8.1.4. Добавление абонента

В окне «Абоненты» нажмите правую кнопку мыши в любом свободном месте окна и выберите «Добавить».

В строке «Добавить абонента» укажите код добавляемого абонента и нажмите кнопку «ОК».

В таблицу будет добавлена новая строка

Заполните параметры Имя, Тип данных, Версия КС для созданного абонента (см. п. 6.1.2).

8.1.5. Удаление абонента

Нажмите правую кнопку мыши на строке с абонентом и выберите «Удалить»

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

Для работы «СНК-АЗС» с КС 5 необходимо настроить параметры в файле .\SNC_AZS\backofficeapp\bo_app.snc

Внимание!
Закройте все программы «СНК-АЗС» и «Бэк-Офис» перед внесением изменений!

Описание параметров для настройки работы с КС 5:

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

9. Настройка СНК-Офис для работы с КС 5

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

Для работы «СНК-Офис» с КС 5 необходимо настроить параметры в файле .\SNC_OFFICE\bo_app.ini

Внимание!
Закройте программу «СНК-Офис» перед внесением изменений!

Описание параметров для настройки работы с КС 5:

UseExchangeServer – использовать КС для передачи данных (0 - не использовать, 1 - использовать)
AutoReceiveData – автоматический прием полученных в КС данных (0 – автоматический прием выключен, 1 - включен)
ExchangeSrvPortExt –порт для связи с КС 5 (значение параметра http.port из п.5.1) (этот параметр нужно добавить, с номером порта, если его нет)

9.2. Настройка формата передачи данных для ТО

Для каждой ТО необходимо выбрать версию КС, используемую ТО для обмена данными. Для этого:

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

Откроется окно «Редактирование ТО».

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

10. Настройка СНК-ПЦ для работы с КС 5

10.1 Установка КС5 для ПЦ

В СНК-ПЦ зайдите в меню – «Настройка» – «Конфигурация».

В разделе «Приписка проекта» добавьте параметр «IP-Адрес:порт Коммуникационного Сервера - 5», для этого:

Выберите заголовок проекта в конфигурации.
Слева нажмите кнопку «Экспорт». Из выпавшего списка выберите «Импорт выборочных настроек (с пополнением)»

Откроется окно файлового проводника.

Зайдите в каталог «sncPC» и выберите файл «IP-Адрес и порт КС5»
Нажмите кнопку «Открыть»

После добавления параметра укажите настройки КС5 в правом окне в строке «Значение» в формате ipv4:порт (например localhost:8000).
Нажмите кнопку «Принять» и перезапустите ПЦ.

10.2 Установка КС5 для определенной ТО

После перезапуска ПЦ выберите в меню «Справочники» - «Точки обслуживания»

Выберите нужную ТО и нажмите кнопку «Ограничения» слева.

В открывшемся окне выберите строку «Настройка», и нажмите кнопку «Значения».

В открывшемся окне раскройте раздел «Режим обмена данными», нажав на +.
Флажок «Обмен СНК-КС ?» должен быть убран.
Флажок «Обмен СНК-КС 5?» должен быть установлен.
Нажмите кнопку «Принять»

11. Службы КС 5

Существуют отдельные службы КС 5 для различных продуктов СНК:

Для «СНК-АЗС» - «СНК-Коммуникационный сервер v5» (sncexchservice)
Для «СНК-Офис» - «СНК-Коммуникационный сервер v5 СНК-ОФИС» (sncexchservice.1000)
Для «СНК-ПЦ» - «СНК-Коммуникационный сервер v5 СНК-ПЦ» (sncexchservice.500)
Для «СНК-Офис Онлайн» - «СНК-ОФИС Онлайн прием КС v5» (sncexchprocessor)
Служба сервера NATS – «СНК-Коммуникационный сервер v5 NATS» (nats-server)

12. Описание каталогов обмена

12.1. Каталоги обмена КС 5

Каталоги обмена КС 5 находятся в папке Data и сгруппированы по абонентам. Внутри папки Data находится папка с номером абонента, в которой находится папка Packet, в которой находятся папки обмена:

Cache – для работы с принимаемым в данный момент пакетом.
Inbox – для входящих пакетов, которые еще не приняты программами СНК.
InboxArchive – архив входящих пакетов, сюда перемещаются пакеты из папки Inbox после их принятия в программу СНК.
Outbox – для отправляемых в настоящее время пакетов.
OutboxArchive – архив исходящих пакетов, сюда перемещаются пакеты из папки Outbox после их отправки другому абоненту.

12.2. Каталоги обмена в программах СНК

Каталоги обмена для «СНК-АЗС» находятся в папке SNC_AZS\backofficeapp.

Каталоги обмена для «СНК-Офис» находятся в папке SNC_OFFICE.

Описание каталогов:

OCIN – для входящих пакетов
OCIN_W – для входящих пакетов, переданных в формате «WIN»
OCIN_W.err – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки
OCOUT_W – для исходящих пакетов, передаваемых в формате «WIN»