Перейти к содержимому

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

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

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -1,3 +1,91 @@
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 +
1 1  == **7. Первоначальная настройка работы СНК-КС5 с СНК-Офис** ==
2 2  
3 3  === **7.1. Настройка конфигурационного файла СНК-КС5** ===
... ... @@ -64,8 +64,7 @@
64 64  * Откройте раздел «**Справочники**» и выберите «**Точки обслуживания**»
65 65  * На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»
66 66  
67 -(% style="width: 700px;" %)
68 -[[Вход в настройки карточки ТО>>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"]]
69 69  
70 70  * Откроется окно «Редактирование ТО»
71 71  * Перейдите на вкладку «**Обмен данными**»
... ... @@ -72,8 +72,7 @@
72 72  * В параметре «**Использовать СНК-КС**» выберите «**КС 5**»
73 73  * Нажмите кнопку «**ОК**» для сохранения параметров
74 74  
75 -(% style="width: 400px;" %)
76 -[[Параметры обмена с выбранной ТО>>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"]]
77 77  
78 78  == **9. Установка и обновление СНК-КС5 на ТО** ==
79 79  
... ... @@ -87,8 +87,7 @@
87 87  
88 88  Дождитесь завершения обновления и нажмите «**Готово**»
89 89  
90 -(% style="width: 500px;" %)
91 -[[Установка или обновление СНК-КС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"]]
92 92  
93 93  == **10. Настройка СНК-АЗС для работы через СНК-КС5** ==
94 94  
... ... @@ -133,20 +133,17 @@
133 133  * Запустите «**Бэк-офис СНК-АЗС**».
134 134  * В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
135 135  
136 -(% style="width: 550px;" %)
137 -[[ Запуск окна настроек абонентов>>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"]]
138 138  
139 139  * Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
140 140  * Первоначально в списке абонентов заведен абонент для примера, удалите его. Для этого нажмите правой кнопкой мыши на строке абонента и выберите «Удалить»
141 141  * В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
142 142  
143 -(% style="width: 600px;" %)
144 -[[Добавление абонента>>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"]]
145 145  
146 146  * В строке «**Добавить абонента**» укажите код добавляемого абонента, например, код абонента «СНК-Офис» ((% style="background-color:#f1c40f" %)abonent.id(%%) в файле настроек КС5) и нажмите кнопку «**ОК**».
147 147  
148 -(% style="width: 600px;" %)
149 -[[Окно ввода кода абонента>>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"]]
150 150  
151 151  * Заполните значения параметров:
152 152  
... ... @@ -160,8 +160,7 @@
160 160  |**Тип данных**|СНК-ПЦ или СНК-Офис тип передаваемых абоненту данных
161 161  |**Версия КС**|КС 5 - версия КС, используемая абонентом для обмена данными.
162 162  
163 -(% style="width: 600px;" %)
164 -[[Список абонентов>>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"]]
165 165  
166 166  * Аналогично создайте абонента для передачи данных в «СНК-ПЦ» при необходимости.
167 167  
... ... @@ -210,15 +210,13 @@
210 210  * Выберите заголовок проекта в конфигурации.
211 211  * Слева нажмите кнопку «**Экспорт**». Из выпавшего списка выберите «**Импорт выборочных настроек (с пополнением)**».
212 212  
213 -(% style="width: 800px;" %)
214 -[[Меню импорта параметров>>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"]]
215 215  
216 216  * Откроется окно файлового проводника.
217 217  * Зайдите в каталог sncPC и выберите файл IP-Адрес и порт КС5
218 218  * Нажмите кнопку «**Открыть**»
219 219  
220 -(% style="width: 800px;" %)
221 -[[Открытие файла с параметрами>>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"]]
222 222  
223 223  * В разделе «**Приписка проекта**» появится параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**», отметьте его флажком.
224 224  * Выберите этот параметр и укажите настройки КС5 в правом окне, в строке «Значение» в формате ipv4: порт (например localhost:8000), где
... ... @@ -225,8 +225,7 @@
225 225  ** ipv4 – адрес ПК на котором установлен экземпляр СНК-КС5 для СНК-ПЦ
226 226  ** порт – порт, который использует СНК-ПЦ для связи с СНК-КС5
227 227  
228 -(% style="width: 800px;" %)
229 -[[Настройка параметров связи СНК-ПЦ с СНК-КС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"]]
230 230  
231 231  == **12. Настройка СНК-ПЦ для передачи данных на определенную ТО** ==
232 232  
... ... @@ -237,18 +237,15 @@
237 237  
238 238  * В СНК-ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**»
239 239  
240 -(% style="width: 800px;" %)
241 -[[Меню "Справочники">>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"]]
242 242  
243 243  * Выберите нужную ТО и нажмите кнопку «**Ограничения**» слева
244 244  
245 -(% style="width: 800px;" %)
246 -[[Выбор ограничений для ТО>>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"]]
247 247  
248 248  * В открывшемся окне выберите строку «**Настройка**», и нажмите кнопку «**Значения**»
249 249  
250 -(% style="width: 800px;" %)
251 -[[Открытие настроек>>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"]]
252 252  
253 253  * В открывшемся окне раскройте раздел «Режим обмена данными», нажав на **+**.
254 254  * Флажок «**Обмен СНК-КС ?**» должен быть **убран**.
... ... @@ -255,8 +255,7 @@
255 255  * Флажок «**Обмен СНК-КС 5?**» должен быть **установлен**.
256 256  * Нажмите кнопку «**Принять**»
257 257  
258 -(% style="width: 500px;" %)
259 -[[Включение режима обмена с КС 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"]]
260 260  
261 261  == **13. Установка онлайн режима передачи данных** ==
262 262  
... ... @@ -276,8 +276,7 @@
276 276  * На экране выбора компонентов отметьте флажок «**Онлайн режим передачи транзакций**» и нажмите «**Далее**»
277 277  * Дождитесь завершения обновления и нажмите «**Готово**»
278 278  
279 -(% style="width: 500px;" %)
280 -[[Установка онлайн передачи данных в СНК-АЗС>>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"]]
281 281  
282 282  === **13.2. Включение режима онлайн-передачи транзакций в СНК-АЗС** ===
283 283  
... ... @@ -295,8 +295,7 @@
295 295  |**Порт Коммуникационного сервера (КС5)**|Порт, который используется для связи СНК-КС5 и Бэк-Офиса
296 296  |**Код абонента на стороне СНК-Офиса**|##100000## – код абонента в СНК-офисе для онлайн транзакций
297 297  
298 -(% style="width: 700px;" %)
299 -[[Включение режима онлайн передачи в настройках СНК-АЗС>>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"]]
300 300  
301 301  === **13.3. Установка отдельного экземпляра СНК-КС5 для онлайн режима** ===
302 302  
... ... @@ -305,14 +305,12 @@
305 305  * Запустите файл ##**snc_cs_update_5_4_0.exe**## (или файл с более новой версией).
306 306  * Нажмите «**Далее**» на экранах мастера установки и списка изменений.
307 307  
308 -(% style="width: 800px;" %)
309 -[[Окна начала установки и списка изменений>>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"]]
310 310  
311 311  * На экране выбора компонентов выберите «**СНК-Офис онлайн**».
312 312  * На следующем экране выберите папку для установки СНК-КС и завершите установку.
313 313  
314 -(% style="width: 800px;" %)
315 -[[Выбор компонентов и папки установки СНК-КС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"]]
316 316  
317 317  === **13.4. Установка службы «СНК-Офис Онлайн прием» в СНК-Офис** ===
318 318  
... ... @@ -323,8 +323,40 @@
323 323  * На экране выбора компонентов отметьте флажок «**Установка службы СНК-Офис Онлайн прием КС v5**» и нажмите «**Далее**»
324 324  * Дождитесь завершения обновления и нажмите «**Готово**»
325 325  
326 -(% style="width: 500px;" %)
327 -[[Установка службы онлайн приема в СНК-Офис>>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"]]
328 328  
329 -(% 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 +(% 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 +
330 330