Изменения документа Коммуникационный сервер

Редактировал(а) Руслан Савельев 2025/12/01 05:03

Управление
- Копировать
Действия
- Экспорт
- Предварительный просмотр
Просмотр

От 28.1 до 27.1 От 39.4 до 39.3

От версии 39.3

отредактировано Руслан Савельев
на 2025/11/05 05:37

Изменить комментарий: К данной версии нет комментариев

К версии 28.1

отредактировано Руслан Савельев
на 2025/04/29 09:07

Изменить комментарий: К данной версии нет комментариев

Необработанный
Обработанный

Сводка

Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Вложения (0 изменено, 0 добавлено, 4 удалено)

Подробности

Свойства страницы

Содержимое

@@ -1,138 +1,308 @@
--== **1. Назначение** ==
++= 1. Назначение =
  Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ.
--== **2. Запуск приложения** ==
++= 2. Запуск программы =
--Для запуска приложения используйте один из вариантов:
++[[image:1742371119337-637.png||data-xwiki-image-style-text-wrap="true" height="17" width="17"]]Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
--{{tabs idsToLabels="tabId1=Запуск ярлыка на рабочем столе, tabId2=Через интернет-браузер"/}}
--
--(% id="tabId1" %)
++(% class="box infomessage" %)
  (((
--(% class="box" %)
--(((
--[[image:1753872619186-150.png||data-xwiki-image-style-alignment="start"]]
++**Перед запуском программы, КС должен быть установлен на ПК! (см. п. 6)**
  )))
--)))
--(% id="tabId2" %)
--(((
--(% class="box" %)
--(((
--Наберите в браузере ##**localhost:8000**## //(указан порт по-умолчанию)//
--)))
--)))
++= 3. Интерфейс программы =
--== **3. Интерфейс программы** ==
--
  Программа открывается в браузере и состоит из следующих элементов:
  * **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.
  * **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.
--* **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами и вкладка настроек //(на рисунке отмечено цифрой 3)//.
++* **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами //(на рисунке отмечено цифрой 3)//.
  * **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.
  [[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]
--== **4. Требования к ПО** ==
++= 4. Требования к ПО =
--* «**СНК-КС**» - 5.2.0 и выше.
--* «**СНК-АЗС**» - 1.37.37 и выше.
--* «**СНК-Офис**» - 1.23.2 и выше.
--* «**СНК-ПЦ**» - 1.113.30 и выше.
--* Действующая лицензия «**СНК-КС**» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «[[KeyInfo>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome]]»
++* «СНК-КС» - 5.2.0 и выше.
++* «СНК-АЗС» - 1.37.37 и выше.
++* «СНК-Офис» - 1.23.2 и выше.
++* «СНК-ПЦ» - 1.113.30 и выше.
++* Действующая лицензия «СНК-КС» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «[[KeyInfo>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome]]»
--== **5. Общая информация** ==
++= 5. Информация и структурная схема =
--Для обеспечения обмена точек обслуживания с инфраструктурой Офиса (СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн) при помощи СНК-КС5, необходимо соблюсти применение следующих пунктов:
++[[image:1742371332756-574.png||data-xwiki-image-style-alignment="center" height="528" width="700"]]
--* Установленный сервер NATS для СНК-КС5 в инфраструктуре Офиса – данное приложение будет отвечать за коммуникацию между всеми экземплярами СНК-КС5
--* Отдельные экземпляры СНК-КС5 для каждой ТО
--* Отдельные экземпляры СНК-КС5 для каждого из следующих приложений - СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн
++= 6. Установка СНК-КС-5 =
--Ниже приведена схема взаимодействия всех экземпляров СНК-КС5 и сервера NATS:
++== 6.1. Установка на стороне СНК-АЗС ==
--[[Схема работы СНК-КС5>>image:1762320317685-829.png||data-xwiki-image-style-alignment="center" height="534" width="700"]]
++Установка СНК-КС5 выполняется при начальной инсталляции СНК-АЗС или при его обновлении, для этого необходимо в окне выбора продуктов для установки или обновления установить флажок «Коммуникационный сервер v5».
++По умолчанию, каталог установки КС5 - ##.\SNC_AZS\exchange##
--== **6. Установка СНК-КС5 в инфраструктуре Офиса** ==
++[[image:1744190452407-288.png||data-xwiki-image-style-alignment="center"]]Если при установке или обновлении установить флажок «Создание ярлыков на рабочем столе», то на рабочем столе появится ярлык «КС СНК АЗС», который будет запускать веб-интерфейс СНК-КС5 (##http:~/~/localhost:8000/##):
--Настройка СНК-КС5 начинается на сервере, где установлены СНК-Офис и/или СНК-ПЦ. Необходимо установить сервер NATS и отдельные экземпляры СНК-КС5 для СНК-Офис и СНК-ПЦ.
++[[image:1744190595783-589.png||data-xwiki-image-style-alignment="center"]]
--Для установки СНК-КС5 на стороне Офиса:
++== 6.2. На стороне СНК-ПЦ, СНК-Офис, СНК-Офис онлайн ==
--* Запустите установочный файл **snc_cs_update_5_4_0.exe** (или файл с более новой версией).
--* Нажмите «**Далее**» на экранах мастера установки и списка изменений.
++Воспользуйтесь мастером установки СНК-КС5:
--[[Окна начала установки и списка изменений>>image:1762320469682-529.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
++* Закройте все программы СНК-АЗС, СНК-ПЦ, СНК-Офис.
++* Запустите установочный файл (##snc_cs_update_5_2_2.exe## или файл с более новой версией).
++* Откроется окно мастера установки, нажмите кнопку «**Далее**».
--* На экране выбора компонентов выберите, для какой программы нужно установить СНК-КС5.
--* Установите флажок установки сервера NATS, если он не был установлен ранее.
--* На следующем экране выберите папку для установки СНК-КС и нажмите «**Далее**».
++[[image:1744190967012-923.png||data-xwiki-image-style-alignment="center"]]
--[[Название>>image:1762320855644-985.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
++* Следующее окно показывает список изменений для текущей версии программы, нажмите кнопку «**Далее**».
--* Дождитесь завершения установки и нажмите «**Готово**».
++[[image:1744191021599-382.png||data-xwiki-image-style-alignment="center"]]
++* В следующем окне выберите, для какой программы нужно установить КС 5 (СНК-ПЦ, СНК-Офис или СНК-Офис онлайн)
++* Отметьте флажок установки сервера NATS, если он еще не был установлен.
++* После выбора компонентов нажмите кнопку «**Далее**».
++
  (% class="box infomessage" %)
  (((
--**Примечание!**
--Если необходимо установить СНК-КС5 еще и для другого приложения (например «СНК-ПЦ»), то повторите действия по установке, выбрав установку СНК-КС5 для нужного приложения. Флажок «Установка сервера NATS» при повторной установке отмечать не нужно.
++**ПК, на который устанавливается сервер NATS должен иметь статический IP-адрес!**
++
++Этот адрес нужно указывать при настройке КС во всех программах. Параметр **##nats.host## (см. п. 7)**
  )))
--== **7. Первоначальная настройка работы СНК-КС5 с СНК-Офис** ==
++[[image:1744191487368-234.png||data-xwiki-image-style-alignment="center"]]
--=== **7.1. Настройка конфигурационного файла СНК-КС5** ===
++* Выберите папку для установки СНК-КС и нажмите кнопку «**Далее**».
--(% class="box warningmessage" %)
++[[image:1744191540621-656.png||data-xwiki-image-style-alignment="center"]]
++
++= 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, (см. раздел «Службы», п.9).
++* **изменить и сохранить параметры** в файле.
++* **запустить службу** КС 5, (см. раздел «Службы», п.9).
++
++== 7.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)
++* Нажмите кнопку «**Сохранить**» после изменения настроек.
++
++[[image:1742374859311-606.png||data-xwiki-image-style-alignment="center" height="355" width="600"]]
++
++= 8. Настройка СНК-АЗС для работы с КС 5 =
++
++== 8.1. Настройка в программе «Бэк-Офис СНК-АЗС» ==
++
++В «[[Бэк-Офис СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5).
++
++**8.1.1. Запуск окна настроек абонентов**
++
++* Запустите «[[**Бэк-офис СНК-АЗС**>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]».
++* В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
++
++[[image:1742375086353-686.png||data-xwiki-image-style-alignment="center" height="184" width="500"]]Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
++
++**8.1.2. Описание параметров таблицы абонентов**
++
++* **Код абонента** – код абонента, с которым производится обмен данными, код нельзя изменить у уже созданного абонента, его можно указать только при создании нового абонента.
++* **Имя **– наименование абонента, не влияет на обмен, используется только для обозначения абонента в «Бэк-офисе».
++* **Тип данных** – тип передаваемых абоненту данных («СНК-ПЦ» или «СНК-Офис»).
++* **Версия КС** – версия КС, используемая абонентом для обмена данными («КС 4» или «КС 5»).
++
++[[image:1742375171694-926.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.3. Настройка портов для связи «Бэк-Офиса» с КС**
++
++* **Порт для КС 4** – порт, по которому «Бэк-офис» связывается с КС 4 (по умолчанию 6000).
++* **Порт для КС 5** – порт, по которому «Бэк-офис» связывается с КС 5 (по умолчанию 8000).
++
++Для запуска веб-интерфейса КС 5, можно воспользоваться кнопкой «**Открыть КС 5**».
++
++(% class="box infomessage" %)
  (((
--Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.
++**Внимание!**
++В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр http.port в файле SncExchServer.cfg, см. п. 5.1).
  )))
++**8.1.4. Добавление абонента**
++* В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
++[[image:1742375331377-333.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
++* В строке «**Добавить абонента**» укажите код добавляемого абонента и нажмите кнопку «**ОК**».
++[[image:1742375383319-279.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
++В таблицу будет добавлена новая строка
++* Заполните параметры **Имя**, **Тип данных**, **Версия КС** для созданного абонента (см. п. 6.1.2).
++[[image:1742375454496-878.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.5. Удаление абонента**
++* Нажмите правую кнопку мыши на строке с абонентом и выберите «**Удалить**»
++[[image:1742375709359-919.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
++== 8.2. Настройка конфигурационного файла СНК-АЗС ==
++Для работы «СНК-АЗС» с КС 5 необходимо настроить параметры в файле## .\SNC_AZS\backofficeapp\**bo_app.snc**##
++(% class="box infomessage" %)
++(((
++**Внимание!**
++Закройте все программы «СНК-АЗС» и «Бэк-Офис» перед внесением изменений!
++)))
++Описание параметров для настройки работы с КС 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** из п.5.1)
++= 9. Настройка СНК-Офис для работы с КС 5 =
++== 9.1. Настройка конфигурационного файла СНК-Офис ==
++Для работы «СНК-Офис» с КС 5 необходимо настроить параметры в файле ##.\SNC_OFFICE\**bo_app.ini**##
++(% class="box infomessage" %)
++(((
++**Внимание!**
++Закройте программу «СНК-Офис» перед внесением изменений!
++)))
++Описание параметров для настройки работы с КС 5:
++* **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**)
++* **AutoReceiveData** – автоматический прием полученных в КС данных (0 – автоматический прием выключен, **1 - включен**)
++* **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1) (**этот параметр нужно добавить, с номером порта, если его нет**)
++== 9.2. Настройка формата передачи данных для ТО ==
++Для каждой ТО необходимо выбрать версию КС, используемую ТО для обмена данными. Для этого:
++* Откройте раздел «**Справочники**».
++* Выберите «**Точки обслуживания**»
++* На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»
++[[image:1742376031179-997.png||data-xwiki-image-style-alignment="center" height="312" width="600"]]
++Откроется окно «**Редактирование ТО**».
++* Перейдите на вкладку «**Обмен данными**».
++* В параметре «**Использовать СНК-КС**» выберите «**КС 5**».
++* Нажмите кнопку «**ОК**» для сохранения параметров.
++[[image:1742376080218-224.png||data-xwiki-image-style-alignment="center" height="440" width="350"]]
++= 10. Настройка СНК-ПЦ для работы с КС 5 =
++В СНК-ПЦ зайдите в меню – «**Настройка**» – «**Конфигурация**».
++В разделе «**Приписка проекта**» добавьте параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**», для этого:
++[[image:1742376299785-470.png||data-xwiki-image-style-alignment="center" height="333" width="700"]]
++* Выберите заголовок проекта в конфигурации.
++* Слева нажмите кнопку «**Экспорт**». Из выпавшего списка выберите «Импорт выборочных настроек (с пополнением)»
++[[image:1742376339853-759.png||data-xwiki-image-style-alignment="center" height="332" width="700"]]
++Откроется окно файлового проводника.
++* Зайдите в каталог «**sncPC**» и выберите файл «**IP-Адрес и порт КС5**»
++* Нажмите кнопку «**Открыть**»
++[[image:1742376379869-231.png||data-xwiki-image-style-alignment="center" height="520" width="700"]]
++* После добавления параметра укажите настройки КС5 в правом окне в строке «**Значение**» в формате ##ipv4:порт## (например ##localhost:8000##).
++* Нажмите кнопку «**Принять**» и перезапустите ПЦ.
++* После перезапуска ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**»
++[[image:1742376449142-544.png||data-xwiki-image-style-alignment="center" height="353" width="700"]]
++* Выберите нужную ТО и нажмите кнопку «**Ограничения**» слева.
++[[image:1742376495608-296.png||data-xwiki-image-style-alignment="center" height="327" width="700"]]
++* В открывшемся окне выберите строку «**Настройка**», и нажмите кнопку «**Значения**».
++[[image:1742376541541-400.png||data-xwiki-image-style-alignment="center" height="256" width="700"]]
++* В открывшемся окне раскройте раздел «Режим обмена данными», нажав на **+**.
++* Флажок «**Обмен СНК-КС ?**» должен быть **убран**.
++* Флажок «**Обмен СНК-КС 5?**» должен быть **установлен**.
++* Нажмите кнопку «**Принять**»
++[[image:1742376578109-329.png||data-xwiki-image-style-alignment="center" height="362" width="500"]]
++= 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 после их отправки другому абоненту.
++
++[[image:1742374549161-794.png||data-xwiki-image-style-alignment="center"]]
++
++== 12.2. Каталоги обмена в программах СНК ==
++
++Каталоги обмена для «СНК-АЗС» находятся в папке **##SNC_AZS\backofficeapp##**.
++
++Каталоги обмена для «СНК-Офис» находятся в папке **##SNC_OFFICE##**.
++
++Описание каталогов:
++
++* ##**OCIN**## – для входящих пакетов
++* ##**OCIN_W**## – для входящих пакетов, переданных в формате «WIN»
++* ##**OCIN_W.err**## – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки
++* ##**OCOUT_W**## – для исходящих пакетов, передаваемых в формате «WIN»
++
++

1753872619186-150.png

Автор

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Admin_super

Размер

...	...	@@ -1,1 +1,0 @@
1		-6.7 KB

Содержимое

1762320317685-829.png

Автор

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Admin_super

Размер

...	...	@@ -1,1 +1,0 @@
1		-258.9 KB

Содержимое

1762320469682-529.png

Автор

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Admin_super

Размер

...	...	@@ -1,1 +1,0 @@
1		-173.2 KB

Содержимое

1762320855644-985.png

Автор

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Admin_super

Размер

...	...	@@ -1,1 +1,0 @@
1		-165.7 KB

Содержимое

Изменения документа Коммуникационный сервер

Сводка

Подробности

Навигация

Оглавление текущей страницы