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

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

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

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

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

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

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

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

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)
• Нажмите кнопку «Сохранить» после изменения настроек.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 после их отправки другому абоненту.

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

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

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

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

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