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

Версия 6.2 от Руслан Савельев на 2025/03/19 09:01

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

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

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

1742371332756-574.png

3. Запуск программы

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

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

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

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

1742373742661-488.png

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

5.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, (см. раздел «Службы», п.9).
  • изменить и сохранить параметры в файле.
  • запустить службу КС 5, (см. раздел «Службы», п.9).

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

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

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

1742374859311-606.png

9. Службы КС 5

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

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

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

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

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

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

1742374549161-794.png

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

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

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

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

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