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

Редактировал(а) Руслан Савельев 2026/09/30 07:49

От версии 82.1
отредактировано Руслан Савельев
на 2026/09/30 05:51
Изменить комментарий: Update document after refactoring.
К версии 90.1
отредактировано Руслан Савельев
на 2026/09/30 06:49
Изменить комментарий: Update document after refactoring.

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -1,225 +223,3 @@
1 -== **1. Назначение** ==
2 -
3 -Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ.
4 -
5 -== **2. Запуск приложения** ==
6 -
7 -Для запуска приложения используйте один из вариантов:
8 -
9 -{{tabs idsToLabels="tabId1=Запуск ярлыка на рабочем столе, tabId2=Через интернет-браузер"/}}
10 -
11 -(% id="tabId1" %)
12 -(((
13 -(% class="box" %)
14 -(((
15 -[[image:1753872619186-150.png||data-xwiki-image-style-alignment="start"]]
16 -)))
17 -)))
18 -
19 -(% id="tabId2" %)
20 -(((
21 -(% class="box" %)
22 -(((
23 -Наберите в браузере
24 -
25 -{{code language="HTML"}}
26 -localhost:8000
27 -{{/code}}
28 -
29 -//(указан порт по-умолчанию)//
30 -)))
31 -)))
32 -
33 -== **3. Интерфейс программы** ==
34 -
35 -Программа открывается в браузере и состоит из следующих элементов:
36 -
37 -* **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.
38 -* **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.
39 -* **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами и вкладка настроек //(на рисунке отмечено цифрой 3)//.
40 -* **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.
41 -
42 -(% style="width: 600px;" %)
43 -[[Интерфейс программы>>image:1742373742661-488.png||data-xwiki-image-style-alignment="center"]]
44 -
45 -== **4. Требования к ПО** ==
46 -
47 -* «**СНК-КС**» - 5.2.0 и выше.
48 -* «**СНК-АЗС**» - 1.73.37 и выше.
49 -* «**СНК-Офис**» - 1.23.2 и выше.
50 -* «**СНК-ПЦ**» - 1.113.30 и выше.
51 -* Действующая лицензия «**СНК-КС**» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «[[Информация по ключам HASP СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome||target="_blank"]]»
52 -
53 -== **5. Общая информация** ==
54 -
55 -Для обеспечения обмена точек обслуживания с инфраструктурой Офиса (СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн) при помощи СНК-КС5, необходимо соблюсти применение следующих пунктов:
56 -
57 -* Установленный сервер NATS для СНК-КС5 в инфраструктуре Офиса – данное приложение будет отвечать за коммуникацию между всеми экземплярами СНК-КС5
58 -* Отдельные экземпляры СНК-КС5 для каждой ТО
59 -* Отдельные экземпляры СНК-КС5 для каждого из следующих приложений - СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн
60 -
61 -Ниже приведена схема взаимодействия всех экземпляров СНК-КС5 и сервера NATS:
62 -
63 -(% style="width: 800px;" %)
64 -[[Схема работы СНК-КС5>>image:1762320317685-829.png||data-xwiki-image-style-alignment="center"]]
65 -
66 -== **6. Установка СНК-КС5 в инфраструктуре Офиса** ==
67 -
68 -Настройка СНК-КС5 начинается на сервере, где установлены СНК-Офис и/или СНК-ПЦ. Необходимо установить сервер NATS и отдельные экземпляры СНК-КС5 для СНК-Офис и СНК-ПЦ.
69 -
70 -Для установки СНК-КС5 на стороне Офиса:
71 -
72 -* Запустите установочный файл ##**snc_cs_update_5_4_0.exe**## (или файл с более новой версией).
73 -* Нажмите «**Далее**» на экранах мастера установки и списка изменений.
74 -
75 -(% style="width: 800px;" %)
76 -[[Окна начала установки и списка изменений>>image:1762320469682-529.png||data-xwiki-image-style-alignment="center"]]
77 -
78 -* На экране выбора компонентов выберите, для какой программы нужно установить СНК-КС5.
79 -* Установите флажок установки сервера NATS, если он не был установлен ранее.
80 -* На следующем экране выберите папку для установки СНК-КС и нажмите «**Далее**».
81 -
82 -(% style="width: 800px;" %)
83 -[[Выбор компонентов и папки установки СНК-КС5>>image:1762320855644-985.png||data-xwiki-image-style-alignment="center"]]
84 -
85 -* Дождитесь завершения установки и нажмите «**Готово**».
86 -
87 -(% class="box infomessage" %)
88 -(((
89 -**Примечание!**
90 -Если необходимо установить СНК-КС5 еще и для другого приложения (например «СНК-ПЦ»), то повторите действия по установке, выбрав установку СНК-КС5 для нужного приложения. Флажок «Установка сервера NATS» при повторной установке отмечать не нужно.
91 -)))
92 -
93 -== **7. Первоначальная настройка работы СНК-КС5 с СНК-Офис** ==
94 -
95 -=== **7.1. Настройка конфигурационного файла СНК-КС5** ===
96 -
97 -(% class="box warningmessage" %)
98 -(((
99 -Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.
100 -)))
101 -
102 -* Остановите службу «**СНК-Коммуникационный сервер v5 СНК-ОФИС**»
103 -* Откройте файл **##.\SNC_OFFICE\exchange\SncExchServer.cfg##**
104 -* Измените значения параметров:
105 -
106 -|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**
107 -|(%%)(% style="background-color:#f1c40f" %)**##abonent.id##**|Номер абонента СНК-Офис в сети СНК-КС5
108 -|**##archive.inbox.depth##**|Хранение входящих пакетов, дней
109 -|**##archive.outbox.depth##**|Хранение исходящих пакетов, дней
110 -|**##archive.packet.disable##**|(((
111 -Сохранение пакетов обмена в архив:
112 -
113 -* true – НЕ сохранять
114 -* false – сохранять
115 -)))
116 -|**##log.depth##**|Хранение логов СНК-КС5, дней
117 -|(%%)(% style="background-color:#3498db" %)**##auth.token##**|Общий токен сети (одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ)
118 -|(%%)(% style="background-color:#2ecc71" %)**##http.port##**|Порт для связи с СНК-Офис (по умолчанию: 8000) *
119 -|**##nats.host##**|IP и порт сервера NATS (порт по умолчанию: 7654)
120 -|**##nats.timeout##**|Таймаут обращения к серверу NATS, мс
121 -
122 -* Сохраните изменения в файле и запустите службу «СНК-Коммуникационный сервер v5 СНК-ОФИС»
123 -
124 -(% class="box infomessage" %)
125 -(((
126 -**~* Примечание!**
127 -Если на одном ПК запущены СНК-Офис и СНК-ПЦ одновременно, используйте разные порты для каждого экземпляра СНК-КС5, например, для СНК-КС5, который используется для СНК- Офис используйте порт 8000, а для СНК-КС5, который используется для СНК-ПЦ используйте порт 8001
128 -)))
129 -
130 -=== **7.2. Настройка конфигурационного файла СНК-Офис** ===
131 -
132 -(% class="box warningmessage" %)
133 -(((
134 -Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.
135 -)))
136 -
137 -* Закройте приложение «СНК-Офис»
138 -* Откройте файл **##.\SNC_OFFICE\bo_app.ini##**
139 -* Измените значения параметров:
140 -
141 -|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**
142 -|**##UseExchangeServer##**|**1** – использовать КС для приема и передачи пакетов
143 -|**##AutoReceiveData##**|**1** – автоматический прием пакетов из КС в СНК-Офис
144 -|**##ExchangeSrvPortExt##**|Порт для связи с СНК-КС5 ((% style="background-color:#2ecc71" %)##http.port##(%%)## ##в файле настроек КС5 - **##exchange\SncExchServer.cfg##**)
145 -
146 -* Сохраните изменения в файле
147 -
148 -== **8. Настройка СНК-Офис для передачи данных на ТО через СНК-КС5** ==
149 -
150 -(% class="box warningmessage" %)
151 -(((
152 -Эта настройка выполняется для каждой ТО, которая будет использовать СНК-КС5 для обмена данными с СНК-Офис.
153 -)))
154 -
155 -* Запустите «**СНК-Офис**»
156 -* Откройте раздел «**Справочники**» и выберите «**Точки обслуживания**»
157 -* На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»
158 -
159 -(% style="width: 700px;" %)
160 -[[Вход в настройки карточки ТО>>image:1762321795143-494.png||data-xwiki-image-style-alignment="center"]]
161 -
162 -* Откроется окно «Редактирование ТО»
163 -* Перейдите на вкладку «**Обмен данными**»
164 -* В параметре «**Использовать СНК-КС**» выберите «**КС 5**»
165 -* Нажмите кнопку «**ОК**» для сохранения параметров
166 -
167 -(% style="width: 400px;" %)
168 -[[Параметры обмена с выбранной ТО>>image:1762321849558-674.png||data-xwiki-image-style-alignment="center"]]
169 -
170 -== **9. Установка и обновление СНК-КС5 на ТО** ==
171 -
172 -Установка и обновление СНК-КС5 на ТО выполняется при обновлении версии СНК-АЗС. Если СНК-КС5 не был установлен, то будет выполнена установка, если установка была произведена ранее, то СНК-КС5 будет обновлен до той версии, которая содержится в файле обновления.
173 -
174 -Для установки или обновления СНК-КС5 на стороне ТО:
175 -
176 -* Закройте все приложения СНК-АЗС (включая Бэк-Офис)
177 -* Запустите файл обновления ##**snc_azs_update_1_75_14.exe**## (пример названия файла)
178 -* На экране выбора компонентов отметьте флажок «**Коммуникационный сервер v5**» и нажмите «**Далее**»
179 -
180 -Дождитесь завершения обновления и нажмите «**Готово**»
181 -
182 -(% style="width: 500px;" %)
183 -[[Установка или обновление СНК-КС5>>image:1762321928267-778.png||data-xwiki-image-style-alignment="center"]]
184 -
185 -== **10. Настройка СНК-АЗС для работы через СНК-КС5** ==
186 -
187 -=== **10.1. Настройка конфигурационного файла СНК-АЗС** ===
188 -
189 -* Закройте все приложения [[СНК-АЗС >>doc:Prilozheniia_SNK.SNK-AZS.WebHome||target="_blank"]](включая [[Бэк-Офис>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome||target="_blank"]])
190 -* Откройте файл **##.\SNC_AZS\backofficeapp\bo_app.snc##**
191 -* Измените значения параметров в секции **##ExchangeModule##**:
192 -
193 -|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**
194 -|**##UseExchangeServer##**|**1** – использовать КС для приема и передачи пакетов
195 -|**##SendOpenShift##**|**1** – передавать текущую открытую смену
196 -|**##TransactionOnOpenShift##**|**1** – передавать данные по открытой смене
197 -|**##ExchangeList##**|Список абонентов, с которыми обменивается СНК-АЗС и формат данных для обмена, **заполняется автоматически**
198 -|**##AutoSendData##**|(((
199 -Автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 означает - всем абонентам, 07:00 – время отправки данных))
200 -
201 -(Также, автоматическую отправку данных можно настроить через «Планировщик заданий» Windows)
202 -)))
203 -|**##AutoReceiveData##**|**1** – автоматический прием пакетов из КС в СНК-АЗС
204 -|**##ExchangeSrvPortExt##**|Порт для связи с СНК-КС5 (http.port в файле настроек КС5 - **##exchange\SncExchServer.cfg##**) - добавьте этот параметр, если он отсутствует, в секцию **##ExchangeModule##**
205 -
206 -* Сохраните изменения в файле
207 -
208 -Пример указанныхнастроек в файле **##.\SNC_AZS\backofficeapp\bo_app.snc##**
209 -
210 -{{code language="ini"}}
211 -[ExchangeModule]
212 -TransactionOnOpenShift=1
213 -UseExchangeServer=1
214 -ExchangeList=1000,2,Офис,1
215 -AutoReceiveData=1
216 -AutoSendData=
217 -SendOpenShift=1
218 -ExchangeSrvPortExt=8000
219 -{{/code}}
220 -
221 -=== **10.2. Настройка в программе «Бэк-Офис СНК-АЗС»** ===
222 -
223 223  В «Бэк-Офис СНК-АЗС» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5), а также настроить параметры работы СНК-КС5.
224 224  
225 225  * Запустите «**Бэк-офис СНК-АЗС**».
... ... @@ -350,106 +350,4 @@
350 350  (% style="width: 500px;" %)
351 351  [[Включение режима обмена с КС 5 для ТО в СНК-ПЦ>>image:1762328795369-793.png||data-xwiki-image-style-alignment="center"]]
352 352  
353 -== **13. Установка онлайн режима передачи данных** ==
354 -
355 -Данный режим позволяет передавать данные от СНК-АЗС в СНК-Офис в режиме реального времени. Для включения этого режиме необходимо выполнить следующие действия:
356 -
357 -* Установить модуль «Онлайн режим передачи транзакций» для СНК-АЗС
358 -* Включить онлайн-передачу транзакций в СНК-АЗС в настройках
359 -* Установить отдельный экземпляр СНК-КС5 для онлайн транзакций на стороне Офиса
360 -* Установить службу «СНК-Офис Онлайн прием» для СНК-Офис
361 -
362 -=== **13.1. Установка модуля «Онлайн режим передачи транзакций» для СНК-АЗС** ===
363 -
364 -Для установки модуля онлайн передачи:
365 -
366 -* Закройте все приложения СНК-АЗС (включая Бэк-Офис)
367 -* Запустите файл обновления **snc_azs_update_1_75_14.exe** (пример названия файла)
368 -* На экране выбора компонентов отметьте флажок «**Онлайн режим передачи транзакций**» и нажмите «**Далее**»
369 -* Дождитесь завершения обновления и нажмите «**Готово**»
370 -
371 -(% style="width: 500px;" %)
372 -[[Установка онлайн передачи данных в СНК-АЗС>>image:1762328922501-650.png||data-xwiki-image-style-alignment="center"]]
373 -
374 -=== **13.2. Включение режима онлайн-передачи транзакций в СНК-АЗС** ===
375 -
376 -* Закройте все приложения [[СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.WebHome||target="_blank"]] (включая [[Бэк-Офис>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome||target="_blank"]])
377 -* Запустите приложение «[[Настройки СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Nastroiki_SNK-AZS.WebHome||target="_blank"]]»
378 -* Перейдите в раздел «Передача данных» и измените значения следующих параметров:
379 -
380 -|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**
381 -|**Включить передачу транзакций в СНК-Офис в режиме онлайн**|(((
382 -##Да## – включить онлайн передачу
383 -
384 -##Нет## – отключить онлайн передачу
385 -)))
386 -|**Адрес Коммуникационного сервера (КС5)**|IP-адрес ПК, на котором запущен СНК-КС5 для СНК-АЗС
387 -|**Порт Коммуникационного сервера (КС5)**|Порт, который используется для связи СНК-КС5 и Бэк-Офиса
388 -|**Код абонента на стороне СНК-Офиса**|##100000## – код абонента в СНК-офисе для онлайн транзакций
389 -
390 -(% style="width: 700px;" %)
391 -[[Включение режима онлайн передачи в настройках СНК-АЗС>>image:1762329041778-491.png||data-xwiki-image-style-alignment="center"]]
392 -
393 -=== **13.3. Установка отдельного экземпляра СНК-КС5 для онлайн режима** ===
394 -
395 -Для установки отдельного экземпляра СНК-КС5 для работы с онлайн транзакциями **на стороне Офиса**, выполните следующие действия:
396 -
397 -* Запустите файл ##**snc_cs_update_5_4_0.exe**## (или файл с более новой версией).
398 -* Нажмите «**Далее**» на экранах мастера установки и списка изменений.
399 -
400 -(% style="width: 800px;" %)
401 -[[Окна начала установки и списка изменений>>image:1762329116347-551.png||data-xwiki-image-style-alignment="center"]]
402 -
403 -* На экране выбора компонентов выберите «**СНК-Офис онлайн**».
404 -* На следующем экране выберите папку для установки СНК-КС и завершите установку.
405 -
406 -(% style="width: 800px;" %)
407 -[[Выбор компонентов и папки установки СНК-КС5>>image:1762329166354-881.png||data-xwiki-image-style-alignment="center"]]
408 -
409 -=== **13.4. Установка службы «СНК-Офис Онлайн прием» в СНК-Офис** ===
410 -
411 -Для установки службы онлайн приема:
412 -
413 -* Закройте СНК-офис
414 -* Запустите файл обновления **##snc_office_update_1_23_11.exe## **(пример названия файла)
415 -* На экране выбора компонентов отметьте флажок «**Установка службы СНК-Офис Онлайн прием КС v5**» и нажмите «**Далее**»
416 -* Дождитесь завершения обновления и нажмите «**Готово**»
417 -
418 -(% style="width: 500px;" %)
419 -[[Установка службы онлайн приема в СНК-Офис>>image:1762329233105-534.png||data-xwiki-image-style-alignment="center"]]
420 -
421 -== **14. Описание каталогов обмена** ==
422 -
423 -=== **14.1. Каталоги обмена КС 5** ===
424 -
425 -Каталоги обмена КС 5 находятся в папке ##**Data**## и сгруппированы по абонентам. Внутри папки ##**Data** ##находится папка с номером абонента, в которой находится папка ##**Packet**##, в которой находятся папки обмена:
426 -
427 -* ##**Cache**## – для работы с принимаемым в данный момент пакетом.
428 -* ##**Inbox** ##– для входящих пакетов, которые еще не приняты программами СНК.
429 -* ##**InboxArchive** ##– архив входящих пакетов, сюда перемещаются пакеты из папки Inbox после их принятия в программу СНК.
430 -* ##**Outbox** ##– для отправляемых в настоящее время пакетов.
431 -* ##**OutboxArchive** ##– архив исходящих пакетов, сюда перемещаются пакеты из папки ##**Outbox **##после их отправки другому абоненту.
432 -
433 -=== **14.2. Каталоги обмена в программах СНК** ===
434 -
435 -Каталоги обмена для «СНК-АЗС» находятся в папке ##SNC_AZS\backofficeapp##.
436 -
437 -Каталоги обмена для «СНК-Офис» находятся в папке SNC_OFFICE.
438 -
439 -Описание каталогов:
440 -
441 -* ##**OCIN** ##– для входящих пакетов
442 -* ##**OCIN_W** ##– для входящих пакетов, переданных в формате «WIN»
443 -* ##**OCIN_W.err**## – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки
444 -* ##**OCOUT_W** ##– для исходящих пакетов, передаваемых в формате «WIN»
445 -
446 -== **15. Описание служб для работы КС5** ==
447 -
448 -
449 -(% class="table-striped" %)
450 -|=(% style="width: 414px; background-color: rgb(52, 152, 219); text-align: center;" %)**Наименование службы**|=(% style="width: 913px; background-color: rgb(52, 152, 219); text-align: center;" %)**Описание**
451 -|(% style="width:414px" %)**##СНК-Коммуникационный сервер v5##**|(% style="width:913px" %)Служба КС5 для работы с СНК-АЗС
452 -|(% style="width:414px" %)**##СНК-Коммуникационный сервер v5 СНК-ОФИС##**|(% style="width:913px" %)Служба КС5 для работы с СНК-Офис
453 -|(% style="width:414px" %)**##СНК-Коммуникационный сервер v5 NATS##**|(% style="width:913px" %)Сервер NATS для осуществления связи между всеми RC5 организации
454 -
455 -
131 +== ==