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

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

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

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -1,3 +1,146 @@
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 +
1 1  == **8. Настройка СНК-Офис для передачи данных на ТО через СНК-КС5** ==
2 2  
3 3  (% class="box warningmessage" %)
... ... @@ -9,8 +9,7 @@
9 9  * Откройте раздел «**Справочники**» и выберите «**Точки обслуживания**»
10 10  * На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»
11 11  
12 -(% style="width: 700px;" %)
13 -[[Вход в настройки карточки ТО>>image:1762321795143-494.png||data-xwiki-image-style-alignment="center"]]
155 +[[Вход в настройки карточки ТО>>image:1762321795143-494.png||data-xwiki-image-style-alignment="center" height="461" width="700"]]
14 14  
15 15  * Откроется окно «Редактирование ТО»
16 16  * Перейдите на вкладку «**Обмен данными**»
... ... @@ -17,10 +17,8 @@
17 17  * В параметре «**Использовать СНК-КС**» выберите «**КС 5**»
18 18  * Нажмите кнопку «**ОК**» для сохранения параметров
19 19  
20 -(% style="width: 400px;" %)
21 -[[Параметры обмена с выбранной ТО>>image:1762321849558-674.png||data-xwiki-image-style-alignment="center"]]
162 +[[Параметры обмена с выбранной ТО>>image:1762321849558-674.png||data-xwiki-image-style-alignment="center" height="499" width="400"]]
22 22  
23 -
24 24  == **9. Установка и обновление СНК-КС5 на ТО** ==
25 25  
26 26  Установка и обновление СНК-КС5 на ТО выполняется при обновлении версии СНК-АЗС. Если СНК-КС5 не был установлен, то будет выполнена установка, если установка была произведена ранее, то СНК-КС5 будет обновлен до той версии, которая содержится в файле обновления.
... ... @@ -33,8 +33,7 @@
33 33  
34 34  Дождитесь завершения обновления и нажмите «**Готово**»
35 35  
36 -(% style="width: 500px;" %)
37 -[[Установка или обновление СНК-КС5>>image:1762321928267-778.png||data-xwiki-image-style-alignment="center"]]
176 +[[Установка или обновление СНК-КС5>>image:1762321928267-778.png||data-xwiki-image-style-alignment="center" height="394" width="500"]]
38 38  
39 39  == **10. Настройка СНК-АЗС для работы через СНК-КС5** ==
40 40  
... ... @@ -79,20 +79,17 @@
79 79  * Запустите «**Бэк-офис СНК-АЗС**».
80 80  * В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
81 81  
82 -(% style="width: 550px;" %)
83 -[[ Запуск окна настроек абонентов>>image:1762322131024-259.png||data-xwiki-image-style-alignment="center"]]
221 +[[ Запуск окна настроек абонентов>>image:1762322131024-259.png||data-xwiki-image-style-alignment="center" height="216" width="550"]]
84 84  
85 85  * Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
86 86  * Первоначально в списке абонентов заведен абонент для примера, удалите его. Для этого нажмите правой кнопкой мыши на строке абонента и выберите «Удалить»
87 87  * В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
88 88  
89 -(% style="width: 600px;" %)
90 -[[Добавление абонента>>image:1762322184400-657.png||data-xwiki-image-style-alignment="center"]]
227 +[[Добавление абонента>>image:1762322184400-657.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]
91 91  
92 92  * В строке «**Добавить абонента**» укажите код добавляемого абонента, например, код абонента «СНК-Офис» ((% style="background-color:#f1c40f" %)abonent.id(%%) в файле настроек КС5) и нажмите кнопку «**ОК**».
93 93  
94 -(% style="width: 600px;" %)
95 -[[Окно ввода кода абонента>>image:1762322283984-102.png||data-xwiki-image-style-alignment="center"]]
231 +[[Окно ввода кода абонента>>image:1762322283984-102.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]
96 96  
97 97  * Заполните значения параметров:
98 98  
... ... @@ -106,8 +106,7 @@
106 106  |**Тип данных**|СНК-ПЦ или СНК-Офис тип передаваемых абоненту данных
107 107  |**Версия КС**|КС 5 - версия КС, используемая абонентом для обмена данными.
108 108  
109 -(% style="width: 600px;" %)
110 -[[Список абонентов>>image:1762322380071-667.png||data-xwiki-image-style-alignment="center"]]
245 +[[Список абонентов>>image:1762322380071-667.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]
111 111  
112 112  * Аналогично создайте абонента для передачи данных в «СНК-ПЦ» при необходимости.
113 113  
... ... @@ -156,15 +156,13 @@
156 156  * Выберите заголовок проекта в конфигурации.
157 157  * Слева нажмите кнопку «**Экспорт**». Из выпавшего списка выберите «**Импорт выборочных настроек (с пополнением)**».
158 158  
159 -(% style="width: 800px;" %)
160 -[[Меню импорта параметров>>image:1762328224115-730.png||data-xwiki-image-style-alignment="center"]]
294 +[[Меню импорта параметров>>image:1762328224115-730.png||data-xwiki-image-style-alignment="center" height="388" width="800"]]
161 161  
162 162  * Откроется окно файлового проводника.
163 163  * Зайдите в каталог sncPC и выберите файл IP-Адрес и порт КС5
164 164  * Нажмите кнопку «**Открыть**»
165 165  
166 -(% style="width: 800px;" %)
167 -[[Открытие файла с параметрами>>image:1762328290990-746.png||data-xwiki-image-style-alignment="center"]]
300 +[[Открытие файла с параметрами>>image:1762328290990-746.png||data-xwiki-image-style-alignment="center" height="449" width="800"]]
168 168  
169 169  * В разделе «**Приписка проекта**» появится параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**», отметьте его флажком.
170 170  * Выберите этот параметр и укажите настройки КС5 в правом окне, в строке «Значение» в формате ipv4: порт (например localhost:8000), где
... ... @@ -171,8 +171,7 @@
171 171  ** ipv4 – адрес ПК на котором установлен экземпляр СНК-КС5 для СНК-ПЦ
172 172  ** порт – порт, который использует СНК-ПЦ для связи с СНК-КС5
173 173  
174 -(% style="width: 800px;" %)
175 -[[Настройка параметров связи СНК-ПЦ с СНК-КС5>>image:1762328347603-678.png||data-xwiki-image-style-alignment="center"]]
307 +[[Настройка параметров связи СНК-ПЦ с СНК-КС5>>image:1762328347603-678.png||data-xwiki-image-style-alignment="center" height="389" width="800"]]
176 176  
177 177  == **12. Настройка СНК-ПЦ для передачи данных на определенную ТО** ==
178 178  
... ... @@ -183,18 +183,15 @@
183 183  
184 184  * В СНК-ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**»
185 185  
186 -(% style="width: 800px;" %)
187 -[[Меню "Справочники">>image:1762328642329-414.png||data-xwiki-image-style-alignment="center"]]
318 +[[Меню "Справочники">>image:1762328642329-414.png||data-xwiki-image-style-alignment="center" height="231" width="800"]]
188 188  
189 189  * Выберите нужную ТО и нажмите кнопку «**Ограничения**» слева
190 190  
191 -(% style="width: 800px;" %)
192 -[[Выбор ограничений для ТО>>image:1762328713186-281.png||data-xwiki-image-style-alignment="center"]]
322 +[[Выбор ограничений для ТО>>image:1762328713186-281.png||data-xwiki-image-style-alignment="center" height="385" width="800"]]
193 193  
194 194  * В открывшемся окне выберите строку «**Настройка**», и нажмите кнопку «**Значения**»
195 195  
196 -(% style="width: 800px;" %)
197 -[[Открытие настроек>>image:1762328755502-798.png||data-xwiki-image-style-alignment="center"]]
326 +[[Открытие настроек>>image:1762328755502-798.png||data-xwiki-image-style-alignment="center" height="303" width="800"]]
198 198  
199 199  * В открывшемся окне раскройте раздел «Режим обмена данными», нажав на **+**.
200 200  * Флажок «**Обмен СНК-КС ?**» должен быть **убран**.
... ... @@ -201,8 +201,7 @@
201 201  * Флажок «**Обмен СНК-КС 5?**» должен быть **установлен**.
202 202  * Нажмите кнопку «**Принять**»
203 203  
204 -(% style="width: 500px;" %)
205 -[[Включение режима обмена с КС 5 для ТО в СНК-ПЦ>>image:1762328795369-793.png||data-xwiki-image-style-alignment="center"]]
333 +[[Включение режима обмена с КС 5 для ТО в СНК-ПЦ>>image:1762328795369-793.png||data-xwiki-image-style-alignment="center" height="369" width="500"]]
206 206  
207 207  == **13. Установка онлайн режима передачи данных** ==
208 208  
... ... @@ -222,8 +222,7 @@
222 222  * На экране выбора компонентов отметьте флажок «**Онлайн режим передачи транзакций**» и нажмите «**Далее**»
223 223  * Дождитесь завершения обновления и нажмите «**Готово**»
224 224  
225 -(% style="width: 500px;" %)
226 -[[Установка онлайн передачи данных в СНК-АЗС>>image:1762328922501-650.png||data-xwiki-image-style-alignment="center"]]
353 +[[Установка онлайн передачи данных в СНК-АЗС>>image:1762328922501-650.png||data-xwiki-image-style-alignment="center" height="394" width="500"]]
227 227  
228 228  === **13.2. Включение режима онлайн-передачи транзакций в СНК-АЗС** ===
229 229  
... ... @@ -241,8 +241,7 @@
241 241  |**Порт Коммуникационного сервера (КС5)**|Порт, который используется для связи СНК-КС5 и Бэк-Офиса
242 242  |**Код абонента на стороне СНК-Офиса**|##100000## – код абонента в СНК-офисе для онлайн транзакций
243 243  
244 -(% style="width: 700px;" %)
245 -[[Включение режима онлайн передачи в настройках СНК-АЗС>>image:1762329041778-491.png||data-xwiki-image-style-alignment="center"]]
371 +[[Включение режима онлайн передачи в настройках СНК-АЗС>>image:1762329041778-491.png||data-xwiki-image-style-alignment="center" height="527" width="700"]]
246 246  
247 247  === **13.3. Установка отдельного экземпляра СНК-КС5 для онлайн режима** ===
248 248  
... ... @@ -251,14 +251,12 @@
251 251  * Запустите файл ##**snc_cs_update_5_4_0.exe**## (или файл с более новой версией).
252 252  * Нажмите «**Далее**» на экранах мастера установки и списка изменений.
253 253  
254 -(% style="width: 800px;" %)
255 -[[Окна начала установки и списка изменений>>image:1762329116347-551.png||data-xwiki-image-style-alignment="center"]]
380 +[[Окна начала установки и списка изменений>>image:1762329116347-551.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
256 256  
257 257  * На экране выбора компонентов выберите «**СНК-Офис онлайн**».
258 258  * На следующем экране выберите папку для установки СНК-КС и завершите установку.
259 259  
260 -(% style="width: 800px;" %)
261 -[[Выбор компонентов и папки установки СНК-КС5>>image:1762329166354-881.png||data-xwiki-image-style-alignment="center"]]
385 +[[Выбор компонентов и папки установки СНК-КС5>>image:1762329166354-881.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
262 262  
263 263  === **13.4. Установка службы «СНК-Офис Онлайн прием» в СНК-Офис** ===
264 264  
... ... @@ -269,8 +269,41 @@
269 269  * На экране выбора компонентов отметьте флажок «**Установка службы СНК-Офис Онлайн прием КС v5**» и нажмите «**Далее**»
270 270  * Дождитесь завершения обновления и нажмите «**Готово**»
271 271  
272 -(% style="width: 500px;" %)
273 -[[Установка службы онлайн приема в СНК-Офис>>image:1762329233105-534.png||data-xwiki-image-style-alignment="center"]]
396 +[[Установка службы онлайн приема в СНК-Офис>>image:1762329233105-534.png||data-xwiki-image-style-alignment="center" height="395" width="500"]]
274 274  
275 -(% class="wikigeneratedid" id="H14.41E43F43844143043D43843543A43044243043B43E43343E43243E43143C43543D430" %)
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 +|=(% style="width: 414px; background-color: rgb(52, 152, 219); text-align: center;" %)**Наименование службы**|=(% style="width: 913px; background-color: rgb(52, 152, 219); text-align: center;" %)**Описание**
427 +|(% style="width:414px" %)##СНК-Коммуникационный сервер v5##|(% style="width:913px" %)Служба КС5 для работы с СНК-АЗС
428 +|(% style="width:414px" %)##СНК-Коммуникационный сервер v5 СНК-ОФИС##|(% style="width:913px" %)Служба КС5 для работы с СНК-Офис
429 +|(% style="width:414px" %)##СНК-Коммуникационный сервер v5 NATS##|(% style="width:913px" %)Сервер NATS для р
430 +
431 +
432 +
276 276