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

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

От версии 80.1
отредактировано Руслан Савельев
на 2026/08/11 07:41
Изменить комментарий: Update document after refactoring.
К версии 87.1
отредактировано Руслан Савельев
на 2026/09/30 06:33
Изменить комментарий: Update document after refactoring.

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -1,146 +144,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 -[[Интерфейс программы>>image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]
43 -
44 -== **4. Требования к ПО** ==
45 -
46 -* «**СНК-КС**» - 5.2.0 и выше.
47 -* «**СНК-АЗС**» - 1.73.37 и выше.
48 -* «**СНК-Офис**» - 1.23.2 и выше.
49 -* «**СНК-ПЦ**» - 1.113.30 и выше.
50 -* Действующая лицензия «**СНК-КС**» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «[[Информация по ключам HASP СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome||target="_blank"]]»
51 -
52 -== **5. Общая информация** ==
53 -
54 -Для обеспечения обмена точек обслуживания с инфраструктурой Офиса (СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн) при помощи СНК-КС5, необходимо соблюсти применение следующих пунктов:
55 -
56 -* Установленный сервер NATS для СНК-КС5 в инфраструктуре Офиса – данное приложение будет отвечать за коммуникацию между всеми экземплярами СНК-КС5
57 -* Отдельные экземпляры СНК-КС5 для каждой ТО
58 -* Отдельные экземпляры СНК-КС5 для каждого из следующих приложений - СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн
59 -
60 -Ниже приведена схема взаимодействия всех экземпляров СНК-КС5 и сервера NATS:
61 -
62 -[[Схема работы СНК-КС5>>image:1762320317685-829.png||data-xwiki-image-style-alignment="center" height="610" width="800"]]
63 -
64 -== **6. Установка СНК-КС5 в инфраструктуре Офиса** ==
65 -
66 -Настройка СНК-КС5 начинается на сервере, где установлены СНК-Офис и/или СНК-ПЦ. Необходимо установить сервер NATS и отдельные экземпляры СНК-КС5 для СНК-Офис и СНК-ПЦ.
67 -
68 -Для установки СНК-КС5 на стороне Офиса:
69 -
70 -* Запустите установочный файл ##**snc_cs_update_5_4_0.exe**## (или файл с более новой версией).
71 -* Нажмите «**Далее**» на экранах мастера установки и списка изменений.
72 -
73 -[[Окна начала установки и списка изменений>>image:1762320469682-529.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
74 -
75 -* На экране выбора компонентов выберите, для какой программы нужно установить СНК-КС5.
76 -* Установите флажок установки сервера NATS, если он не был установлен ранее.
77 -* На следующем экране выберите папку для установки СНК-КС и нажмите «**Далее**».
78 -
79 -[[Выбор компонентов и папки установки СНК-КС5>>image:1762320855644-985.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
80 -
81 -* Дождитесь завершения установки и нажмите «**Готово**».
82 -
83 -(% class="box infomessage" %)
84 -(((
85 -**Примечание!**
86 -Если необходимо установить СНК-КС5 еще и для другого приложения (например «СНК-ПЦ»), то повторите действия по установке, выбрав установку СНК-КС5 для нужного приложения. Флажок «Установка сервера NATS» при повторной установке отмечать не нужно.
87 -)))
88 -
89 -== **7. Первоначальная настройка работы СНК-КС5 с СНК-Офис** ==
90 -
91 -=== **7.1. Настройка конфигурационного файла СНК-КС5** ===
92 -
93 -(% class="box warningmessage" %)
94 -(((
95 -Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.
96 -)))
97 -
98 -* Остановите службу «**СНК-Коммуникационный сервер v5 СНК-ОФИС**»
99 -* Откройте файл **##.\SNC_OFFICE\exchange\SncExchServer.cfg##**
100 -* Измените значения параметров:
101 -
102 -|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**
103 -|(%%)(% style="background-color:#f1c40f" %)**##abonent.id##**|Номер абонента СНК-Офис в сети СНК-КС5
104 -|**##archive.inbox.depth##**|Хранение входящих пакетов, дней
105 -|**##archive.outbox.depth##**|Хранение исходящих пакетов, дней
106 -|**##archive.packet.disable##**|(((
107 -Сохранение пакетов обмена в архив:
108 -
109 -* true – НЕ сохранять
110 -* false – сохранять
111 -)))
112 -|**##log.depth##**|Хранение логов СНК-КС5, дней
113 -|(%%)(% style="background-color:#3498db" %)**##auth.token##**|Общий токен сети (одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ)
114 -|(%%)(% style="background-color:#2ecc71" %)**##http.port##**|Порт для связи с СНК-Офис (по умолчанию: 8000) *
115 -|**##nats.host##**|IP и порт сервера NATS (порт по умолчанию: 7654)
116 -|**##nats.timeout##**|Таймаут обращения к серверу NATS, мс
117 -
118 -* Сохраните изменения в файле и запустите службу «СНК-Коммуникационный сервер v5 СНК-ОФИС»
119 -
120 -(% class="box infomessage" %)
121 -(((
122 -**~* Примечание!**
123 -Если на одном ПК запущены СНК-Офис и СНК-ПЦ одновременно, используйте разные порты для каждого экземпляра СНК-КС5, например, для СНК-КС5, который используется для СНК- Офис используйте порт 8000, а для СНК-КС5, который используется для СНК-ПЦ используйте порт 8001
124 -)))
125 -
126 -=== **7.2. Настройка конфигурационного файла СНК-Офис** ===
127 -
128 -(% class="box warningmessage" %)
129 -(((
130 -Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.
131 -)))
132 -
133 -* Закройте приложение «СНК-Офис»
134 -* Откройте файл **##.\SNC_OFFICE\bo_app.ini##**
135 -* Измените значения параметров:
136 -
137 -|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**
138 -|**##UseExchangeServer##**|**1** – использовать КС для приема и передачи пакетов
139 -|**##AutoReceiveData##**|**1** – автоматический прием пакетов из КС в СНК-Офис
140 -|**##ExchangeSrvPortExt##**|Порт для связи с СНК-КС5 ((% style="background-color:#2ecc71" %)##http.port##(%%)## ##в файле настроек КС5 - **##exchange\SncExchServer.cfg##**)
141 -
142 -* Сохраните изменения в файле
143 -
144 144  == **8. Настройка СНК-Офис для передачи данных на ТО через СНК-КС5** ==
145 145  
146 146  (% class="box warningmessage" %)
... ... @@ -152,7 +152,8 @@
152 152  * Откройте раздел «**Справочники**» и выберите «**Точки обслуживания**»
153 153  * На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»
154 154  
155 -[[Вход в настройки карточки ТО>>image:1762321795143-494.png||data-xwiki-image-style-alignment="center" height="461" width="700"]]
12 +(% style="width: 700px;" %)
13 +[[Вход в настройки карточки ТО>>image:1762321795143-494.png||data-xwiki-image-style-alignment="center"]]
156 156  
157 157  * Откроется окно «Редактирование ТО»
158 158  * Перейдите на вкладку «**Обмен данными**»
... ... @@ -159,8 +159,10 @@
159 159  * В параметре «**Использовать СНК-КС**» выберите «**КС 5**»
160 160  * Нажмите кнопку «**ОК**» для сохранения параметров
161 161  
162 -[[Параметры обмена с выбранной ТО>>image:1762321849558-674.png||data-xwiki-image-style-alignment="center" height="499" width="400"]]
20 +(% style="width: 400px;" %)
21 +[[Параметры обмена с выбранной ТО>>image:1762321849558-674.png||data-xwiki-image-style-alignment="center"]]
163 163  
23 +
164 164  == **9. Установка и обновление СНК-КС5 на ТО** ==
165 165  
166 166  Установка и обновление СНК-КС5 на ТО выполняется при обновлении версии СНК-АЗС. Если СНК-КС5 не был установлен, то будет выполнена установка, если установка была произведена ранее, то СНК-КС5 будет обновлен до той версии, которая содержится в файле обновления.
... ... @@ -173,7 +173,8 @@
173 173  
174 174  Дождитесь завершения обновления и нажмите «**Готово**»
175 175  
176 -[[Установка или обновление СНК-КС5>>image:1762321928267-778.png||data-xwiki-image-style-alignment="center" height="394" width="500"]]
36 +(% style="width: 500px;" %)
37 +[[Установка или обновление СНК-КС5>>image:1762321928267-778.png||data-xwiki-image-style-alignment="center"]]
177 177  
178 178  == **10. Настройка СНК-АЗС для работы через СНК-КС5** ==
179 179  
... ... @@ -218,17 +218,20 @@
218 218  * Запустите «**Бэк-офис СНК-АЗС**».
219 219  * В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
220 220  
221 -[[ Запуск окна настроек абонентов>>image:1762322131024-259.png||data-xwiki-image-style-alignment="center" height="216" width="550"]]
82 +(% style="width: 550px;" %)
83 +[[ Запуск окна настроек абонентов>>image:1762322131024-259.png||data-xwiki-image-style-alignment="center"]]
222 222  
223 223  * Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
224 224  * Первоначально в списке абонентов заведен абонент для примера, удалите его. Для этого нажмите правой кнопкой мыши на строке абонента и выберите «Удалить»
225 225  * В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
226 226  
227 -[[Добавление абонента>>image:1762322184400-657.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]
89 +(% style="width: 600px;" %)
90 +[[Добавление абонента>>image:1762322184400-657.png||data-xwiki-image-style-alignment="center"]]
228 228  
229 229  * В строке «**Добавить абонента**» укажите код добавляемого абонента, например, код абонента «СНК-Офис» ((% style="background-color:#f1c40f" %)abonent.id(%%) в файле настроек КС5) и нажмите кнопку «**ОК**».
230 230  
231 -[[Окно ввода кода абонента>>image:1762322283984-102.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]
94 +(% style="width: 600px;" %)
95 +[[Окно ввода кода абонента>>image:1762322283984-102.png||data-xwiki-image-style-alignment="center"]]
232 232  
233 233  * Заполните значения параметров:
234 234  
... ... @@ -242,7 +242,8 @@
242 242  |**Тип данных**|СНК-ПЦ или СНК-Офис тип передаваемых абоненту данных
243 243  |**Версия КС**|КС 5 - версия КС, используемая абонентом для обмена данными.
244 244  
245 -[[Список абонентов>>image:1762322380071-667.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]
109 +(% style="width: 600px;" %)
110 +[[Список абонентов>>image:1762322380071-667.png||data-xwiki-image-style-alignment="center"]]
246 246  
247 247  * Аналогично создайте абонента для передачи данных в «СНК-ПЦ» при необходимости.
248 248  
... ... @@ -291,13 +291,15 @@
291 291  * Выберите заголовок проекта в конфигурации.
292 292  * Слева нажмите кнопку «**Экспорт**». Из выпавшего списка выберите «**Импорт выборочных настроек (с пополнением)**».
293 293  
294 -[[Меню импорта параметров>>image:1762328224115-730.png||data-xwiki-image-style-alignment="center" height="388" width="800"]]
159 +(% style="width: 800px;" %)
160 +[[Меню импорта параметров>>image:1762328224115-730.png||data-xwiki-image-style-alignment="center"]]
295 295  
296 296  * Откроется окно файлового проводника.
297 297  * Зайдите в каталог sncPC и выберите файл IP-Адрес и порт КС5
298 298  * Нажмите кнопку «**Открыть**»
299 299  
300 -[[Открытие файла с параметрами>>image:1762328290990-746.png||data-xwiki-image-style-alignment="center" height="449" width="800"]]
166 +(% style="width: 800px;" %)
167 +[[Открытие файла с параметрами>>image:1762328290990-746.png||data-xwiki-image-style-alignment="center"]]
301 301  
302 302  * В разделе «**Приписка проекта**» появится параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**», отметьте его флажком.
303 303  * Выберите этот параметр и укажите настройки КС5 в правом окне, в строке «Значение» в формате ipv4: порт (например localhost:8000), где
... ... @@ -304,7 +304,8 @@
304 304  ** ipv4 – адрес ПК на котором установлен экземпляр СНК-КС5 для СНК-ПЦ
305 305  ** порт – порт, который использует СНК-ПЦ для связи с СНК-КС5
306 306  
307 -[[Настройка параметров связи СНК-ПЦ с СНК-КС5>>image:1762328347603-678.png||data-xwiki-image-style-alignment="center" height="389" width="800"]]
174 +(% style="width: 800px;" %)
175 +[[Настройка параметров связи СНК-ПЦ с СНК-КС5>>image:1762328347603-678.png||data-xwiki-image-style-alignment="center"]]
308 308  
309 309  == **12. Настройка СНК-ПЦ для передачи данных на определенную ТО** ==
310 310  
... ... @@ -315,15 +315,18 @@
315 315  
316 316  * В СНК-ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**»
317 317  
318 -[[Меню "Справочники">>image:1762328642329-414.png||data-xwiki-image-style-alignment="center" height="231" width="800"]]
186 +(% style="width: 800px;" %)
187 +[[Меню "Справочники">>image:1762328642329-414.png||data-xwiki-image-style-alignment="center"]]
319 319  
320 320  * Выберите нужную ТО и нажмите кнопку «**Ограничения**» слева
321 321  
322 -[[Выбор ограничений для ТО>>image:1762328713186-281.png||data-xwiki-image-style-alignment="center" height="385" width="800"]]
191 +(% style="width: 800px;" %)
192 +[[Выбор ограничений для ТО>>image:1762328713186-281.png||data-xwiki-image-style-alignment="center"]]
323 323  
324 324  * В открывшемся окне выберите строку «**Настройка**», и нажмите кнопку «**Значения**»
325 325  
326 -[[Открытие настроек>>image:1762328755502-798.png||data-xwiki-image-style-alignment="center" height="303" width="800"]]
196 +(% style="width: 800px;" %)
197 +[[Открытие настроек>>image:1762328755502-798.png||data-xwiki-image-style-alignment="center"]]
327 327  
328 328  * В открывшемся окне раскройте раздел «Режим обмена данными», нажав на **+**.
329 329  * Флажок «**Обмен СНК-КС ?**» должен быть **убран**.
... ... @@ -330,7 +330,8 @@
330 330  * Флажок «**Обмен СНК-КС 5?**» должен быть **установлен**.
331 331  * Нажмите кнопку «**Принять**»
332 332  
333 -[[Включение режима обмена с КС 5 для ТО в СНК-ПЦ>>image:1762328795369-793.png||data-xwiki-image-style-alignment="center" height="369" width="500"]]
204 +(% style="width: 500px;" %)
205 +[[Включение режима обмена с КС 5 для ТО в СНК-ПЦ>>image:1762328795369-793.png||data-xwiki-image-style-alignment="center"]]
334 334  
335 335  == **13. Установка онлайн режима передачи данных** ==
336 336  
... ... @@ -350,7 +350,8 @@
350 350  * На экране выбора компонентов отметьте флажок «**Онлайн режим передачи транзакций**» и нажмите «**Далее**»
351 351  * Дождитесь завершения обновления и нажмите «**Готово**»
352 352  
353 -[[Установка онлайн передачи данных в СНК-АЗС>>image:1762328922501-650.png||data-xwiki-image-style-alignment="center" height="394" width="500"]]
225 +(% style="width: 500px;" %)
226 +[[Установка онлайн передачи данных в СНК-АЗС>>image:1762328922501-650.png||data-xwiki-image-style-alignment="center"]]
354 354  
355 355  === **13.2. Включение режима онлайн-передачи транзакций в СНК-АЗС** ===
356 356  
... ... @@ -368,7 +368,8 @@
368 368  |**Порт Коммуникационного сервера (КС5)**|Порт, который используется для связи СНК-КС5 и Бэк-Офиса
369 369  |**Код абонента на стороне СНК-Офиса**|##100000## – код абонента в СНК-офисе для онлайн транзакций
370 370  
371 -[[Включение режима онлайн передачи в настройках СНК-АЗС>>image:1762329041778-491.png||data-xwiki-image-style-alignment="center" height="527" width="700"]]
244 +(% style="width: 700px;" %)
245 +[[Включение режима онлайн передачи в настройках СНК-АЗС>>image:1762329041778-491.png||data-xwiki-image-style-alignment="center"]]
372 372  
373 373  === **13.3. Установка отдельного экземпляра СНК-КС5 для онлайн режима** ===
374 374  
... ... @@ -377,12 +377,14 @@
377 377  * Запустите файл ##**snc_cs_update_5_4_0.exe**## (или файл с более новой версией).
378 378  * Нажмите «**Далее**» на экранах мастера установки и списка изменений.
379 379  
380 -[[Окна начала установки и списка изменений>>image:1762329116347-551.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
254 +(% style="width: 800px;" %)
255 +[[Окна начала установки и списка изменений>>image:1762329116347-551.png||data-xwiki-image-style-alignment="center"]]
381 381  
382 382  * На экране выбора компонентов выберите «**СНК-Офис онлайн**».
383 383  * На следующем экране выберите папку для установки СНК-КС и завершите установку.
384 384  
385 -[[Выбор компонентов и папки установки СНК-КС5>>image:1762329166354-881.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
260 +(% style="width: 800px;" %)
261 +[[Выбор компонентов и папки установки СНК-КС5>>image:1762329166354-881.png||data-xwiki-image-style-alignment="center"]]
386 386  
387 387  === **13.4. Установка службы «СНК-Офис Онлайн прием» в СНК-Офис** ===
388 388  
... ... @@ -393,40 +393,8 @@
393 393  * На экране выбора компонентов отметьте флажок «**Установка службы СНК-Офис Онлайн прием КС v5**» и нажмите «**Далее**»
394 394  * Дождитесь завершения обновления и нажмите «**Готово**»
395 395  
396 -[[Установка службы онлайн приема в СНК-Офис>>image:1762329233105-534.png||data-xwiki-image-style-alignment="center" height="395" width="500"]]
272 +(% style="width: 500px;" %)
273 +[[Установка службы онлайн приема в СНК-Офис>>image:1762329233105-534.png||data-xwiki-image-style-alignment="center"]]
397 397  
398 -== **14. Описание каталогов обмена** ==
399 -
400 -=== **14.1. Каталоги обмена КС 5** ===
401 -
402 -Каталоги обмена КС 5 находятся в папке ##**Data**## и сгруппированы по абонентам. Внутри папки ##**Data** ##находится папка с номером абонента, в которой находится папка ##**Packet**##, в которой находятся папки обмена:
403 -
404 -* ##**Cache**## – для работы с принимаемым в данный момент пакетом.
405 -* ##**Inbox** ##– для входящих пакетов, которые еще не приняты программами СНК.
406 -* ##**InboxArchive** ##– архив входящих пакетов, сюда перемещаются пакеты из папки Inbox после их принятия в программу СНК.
407 -* ##**Outbox** ##– для отправляемых в настоящее время пакетов.
408 -* ##**OutboxArchive** ##– архив исходящих пакетов, сюда перемещаются пакеты из папки ##**Outbox **##после их отправки другому абоненту.
409 -
410 -=== **14.2. Каталоги обмена в программах СНК** ===
411 -
412 -Каталоги обмена для «СНК-АЗС» находятся в папке ##SNC_AZS\backofficeapp##.
413 -
414 -Каталоги обмена для «СНК-Офис» находятся в папке SNC_OFFICE.
415 -
416 -Описание каталогов:
417 -
418 -* ##**OCIN** ##– для входящих пакетов
419 -* ##**OCIN_W** ##– для входящих пакетов, переданных в формате «WIN»
420 -* ##**OCIN_W.err**## – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки
421 -* ##**OCOUT_W** ##– для исходящих пакетов, передаваемых в формате «WIN»
422 -
423 -== **15. Описание служб для работы КС5** ==
424 -
425 -
426 -(% class="table-striped" %)
427 -|=(% style="width: 414px; background-color: rgb(52, 152, 219); text-align: center;" %)**Наименование службы**|=(% style="width: 913px; background-color: rgb(52, 152, 219); text-align: center;" %)**Описание**
428 -|(% style="width:414px" %)**##СНК-Коммуникационный сервер v5##**|(% style="width:913px" %)Служба КС5 для работы с СНК-АЗС
429 -|(% style="width:414px" %)**##СНК-Коммуникационный сервер v5 СНК-ОФИС##**|(% style="width:913px" %)Служба КС5 для работы с СНК-Офис
430 -|(% style="width:414px" %)**##СНК-Коммуникационный сервер v5 NATS##**|(% style="width:913px" %)Сервер NATS для осуществления связи между всеми RC5 организации
431 -
275 +(% class="wikigeneratedid" id="H14.41E43F43844143043D43843543A43044243043B43E43343E43243E43143C43543D430" %)
432 432