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

Версия 42.3 от Руслан Савельев на 2025/11/05 05:53

Скрыть последних авторов
Руслан Савельев 34.1 1 == **1. Назначение** ==
Руслан Савельев 1.1 2
Руслан Савельев 2.2 3 Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ.
Руслан Савельев 1.1 4
Руслан Савельев 34.1 5 == **2. Запуск приложения** ==
Руслан Савельев 1.1 6
Руслан Савельев 31.1 7 Для запуска приложения используйте один из вариантов:
Руслан Савельев 25.3 8
Руслан Савельев 31.1 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 Наберите в браузере ##**localhost:8000**## //(указан порт по-умолчанию)//
24 )))
25 )))
26
Руслан Савельев 34.1 27 == **3. Интерфейс программы** ==
Руслан Савельев 25.3 28
29 Программа открывается в браузере и состоит из следующих элементов:
30
31 * **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.
32 * **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.
Руслан Савельев 36.2 33 * **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами и вкладка настроек //(на рисунке отмечено цифрой 3)//.
Руслан Савельев 25.3 34 * **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.
35
36 [[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]
37
Руслан Савельев 34.1 38 == **4. Требования к ПО** ==
Руслан Савельев 25.3 39
Руслан Савельев 29.1 40 * «**СНК-КС**» - 5.2.0 и выше.
41 * «**СНК-АЗС**» - 1.37.37 и выше.
42 * «**СНК-Офис**» - 1.23.2 и выше.
43 * «**СНК-ПЦ**» - 1.113.30 и выше.
44 * Действующая лицензия «**СНК-КС**» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «[[KeyInfo>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome]]»
Руслан Савельев 23.2 45
Руслан Савельев 36.2 46 == **5. Общая информация** ==
Руслан Савельев 23.2 47
Руслан Савельев 36.3 48 Для обеспечения обмена точек обслуживания с инфраструктурой Офиса (СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн) при помощи СНК-КС5, необходимо соблюсти применение следующих пунктов:
Руслан Савельев 3.2 49
Руслан Савельев 36.3 50 * Установленный сервер NATS для СНК-КС5 в инфраструктуре Офиса – данное приложение будет отвечать за коммуникацию между всеми экземплярами СНК-КС5
51 * Отдельные экземпляры СНК-КС5 для каждой ТО
52 * Отдельные экземпляры СНК-КС5 для каждого из следующих приложений - СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн
Руслан Савельев 23.2 53
Руслан Савельев 36.3 54 Ниже приведена схема взаимодействия всех экземпляров СНК-КС5 и сервера NATS:
Руслан Савельев 23.2 55
Руслан Савельев 37.2 56 [[Схема работы СНК-КС5>>image:1762320317685-829.png||data-xwiki-image-style-alignment="center" height="534" width="700"]]
Руслан Савельев 23.2 57
Руслан Савельев 38.2 58 == **6. Установка СНК-КС5 в инфраструктуре Офиса** ==
Руслан Савельев 23.2 59
Руслан Савельев 38.2 60 Настройка СНК-КС5 начинается на сервере, где установлены СНК-Офис и/или СНК-ПЦ. Необходимо установить сервер NATS и отдельные экземпляры СНК-КС5 для СНК-Офис и СНК-ПЦ.
Руслан Савельев 29.1 61
Руслан Савельев 38.2 62 Для установки СНК-КС5 на стороне Офиса:
Руслан Савельев 23.2 63
Руслан Савельев 38.2 64 * Запустите установочный файл **snc_cs_update_5_4_0.exe** (или файл с более новой версией).
65 * Нажмите «**Далее**» на экранах мастера установки и списка изменений.
Руслан Савельев 23.2 66
Руслан Савельев 39.2 67 [[Окна начала установки и списка изменений>>image:1762320469682-529.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
Руслан Савельев 36.1 68
Руслан Савельев 38.3 69 * На экране выбора компонентов выберите, для какой программы нужно установить СНК-КС5.
70 * Установите флажок установки сервера NATS, если он не был установлен ранее.
71 * На следующем экране выберите папку для установки СНК-КС и нажмите «**Далее**».
Руслан Савельев 23.2 72
Руслан Савельев 39.2 73 [[Название>>image:1762320855644-985.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]
Руслан Савельев 23.2 74
Руслан Савельев 39.2 75 * Дождитесь завершения установки и нажмите «**Готово**».
Руслан Савельев 23.2 76
Руслан Савельев 39.2 77 (% class="box infomessage" %)
78 (((
Руслан Савельев 39.3 79 **Примечание!**
Руслан Савельев 39.2 80 Если необходимо установить СНК-КС5 еще и для другого приложения (например «СНК-ПЦ»), то повторите действия по установке, выбрав установку СНК-КС5 для нужного приложения. Флажок «Установка сервера NATS» при повторной установке отмечать не нужно.
81 )))
Руслан Савельев 23.2 82
Руслан Савельев 39.3 83 == **7. Первоначальная настройка работы СНК-КС5 с СНК-Офис** ==
Руслан Савельев 23.2 84
Руслан Савельев 39.3 85 === **7.1. Настройка конфигурационного файла СНК-КС5** ===
Руслан Савельев 3.2 86
Руслан Савельев 39.3 87 (% class="box warningmessage" %)
88 (((
89 Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.
90 )))
Руслан Савельев 1.1 91
Руслан Савельев 39.4 92 * Остановите службу «**СНК-Коммуникационный сервер v5 СНК-ОФИС**»
93 * Откройте файл ##.\SNC_OFFICE\exchange\SncExchServer.cfg##
94 * Измените значения параметров:
Руслан Савельев 1.1 95
Руслан Савельев 39.5 96 |(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**
Руслан Савельев 39.7 97 |(%%)(% style="background-color:#f1c40f" %)**##abonent.id##**|Номер абонента СНК-Офис в сети СНК-КС5
Руслан Савельев 39.5 98 |**##archive.inbox.depth##**|Хранение входящих пакетов, дней
99 |**##archive.outbox.depth##**|Хранение исходящих пакетов, дней
100 |**##archive.packet.disable##**|(((
Руслан Савельев 39.4 101 Сохранение пакетов обмена в архив:
Руслан Савельев 1.1 102
Руслан Савельев 39.4 103 * true – НЕ сохранять
104 * false – сохранять
105 )))
Руслан Савельев 39.5 106 |**##log.depth##**|Хранение логов СНК-КС5, дней
Руслан Савельев 39.7 107 |(%%)(% style="background-color:#3498db" %)**##auth.token##**|Общий токен сети (одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ)
108 |(%%)(% style="background-color:#2ecc71" %)**##http.port##**|Порт для связи с СНК-Офис (по умолчанию: 8000) *****
Руслан Савельев 39.5 109 |**##nats.host##**|IP и порт сервера NATS (порт по умолчанию: 7654)
110 |**##nats.timeout##**|Таймаут обращения к серверу NATS, мс
Руслан Савельев 1.1 111
Руслан Савельев 39.5 112 * Сохраните изменения в файле и запустите службу «СНК-Коммуникационный сервер v5 СНК-ОФИС»
Руслан Савельев 1.1 113
Руслан Савельев 39.8 114 (% class="box infomessage" %)
115 (((
116 **~* Примечание!**
117 Если на одном ПК запущены СНК-Офис и СНК-ПЦ одновременно, используйте разные порты для каждого экземпляра СНК-КС5, например, для СНК-КС5, который используется для СНК- Офис используйте порт 8000, а для СНК-КС5, который используется для СНК-ПЦ используйте порт 8001
118 )))
119
Руслан Савельев 39.6 120 === **7.2. Настройка конфигурационного файла СНК-Офис** ===
Руслан Савельев 25.3 121
Руслан Савельев 39.6 122 (% class="box warningmessage" %)
123 (((
124 Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.
125 )))
Руслан Савельев 25.4 126
Руслан Савельев 39.6 127 * Закройте приложение «СНК-Офис»
128 * Откройте файл ##.\SNC_OFFICE\bo_app.ini##
129 * Измените значения параметров:
Руслан Савельев 25.3 130
Руслан Савельев 39.6 131 |(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**
132 |**##UseExchangeServer##**|**1** – использовать КС для приема и передачи пакетов
133 |**##AutoReceiveData##**|**1** – автоматический прием пакетов из КС в СНК-Офис
Руслан Савельев 39.7 134 |**##ExchangeSrvPortExt##**|Порт для связи с СНК-КС5 ((% style="background-color:#2ecc71" %)##http.port##(%%)## ##в файле настроек КС5)
Руслан Савельев 1.1 135
Руслан Савельев 39.7 136 * Сохраните изменения в файле
Руслан Савельев 1.1 137
Руслан Савельев 39.9 138 == **8. Настройка СНК-Офис для передачи данных на ТО через СНК-КС5** ==
Руслан Савельев 1.1 139
Руслан Савельев 39.10 140 (% class="box warningmessage" %)
141 (((
142 Эта настройка выполняется для каждой ТО, которая будет использовать СНК-КС5 для обмена данными с СНК-Офис.
143 )))
Руслан Савельев 1.1 144
Руслан Савельев 41.2 145 * Запустите «**СНК-Офис**»
146 * Откройте раздел «**Справочники**» и выберите «**Точки обслуживания**»
147 * На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»
Руслан Савельев 1.1 148
Руслан Савельев 41.2 149 [[Вход в настройки карточки ТО>>image:1762321795143-494.png||data-xwiki-image-style-alignment="center" height="461" width="700"]]
Руслан Савельев 1.1 150
Руслан Савельев 41.2 151 * Откроется окно «Редактирование ТО»
152 * Перейдите на вкладку «**Обмен данными**»
153 * В параметре «**Использовать СНК-КС**» выберите «**КС 5**»
154 * Нажмите кнопку «**ОК**» для сохранения параметров
Руслан Савельев 4.2 155
Руслан Савельев 42.2 156 [[Параметры обмена с выбранной ТО>>image:1762321849558-674.png||data-xwiki-image-style-alignment="center" height="499" width="400"]]
Руслан Савельев 5.2 157
Руслан Савельев 42.2 158 == **9. Установка и обновление СНК-КС5 на ТО** ==
Руслан Савельев 5.2 159
Руслан Савельев 42.2 160 Установка и обновление СНК-КС5 на ТО выполняется при обновлении версии СНК-АЗС. Если СНК-КС5 не был установлен, то будет выполнена установка, если установка была произведена ранее, то СНК-КС5 будет обновлен до той версии, которая содержится в файле обновления.
Руслан Савельев 5.2 161
Руслан Савельев 42.2 162 Для установки или обновления СНК-КС5 на стороне ТО:
Руслан Савельев 37.2 163
Руслан Савельев 42.2 164 * Закройте все приложения СНК-АЗС (включая Бэк-Офис)
165 * Запустите файл обновления **snc_azs_update_1_75_14.exe** (пример названия файла)
166 * На экране выбора компонентов отметьте флажок «**Коммуникационный сервер v5**» и нажмите «**Далее**»
Руслан Савельев 37.2 167
Руслан Савельев 42.2 168 Дождитесь завершения обновления и нажмите «**Готово**»
Руслан Савельев 37.2 169
170
Руслан Савельев 42.3 171 [[Установка или обновление СНК-КС5>>image:1762321928267-778.png||data-xwiki-image-style-alignment="center" height="394" width="500"]]
Руслан Савельев 37.2 172
Руслан Савельев 42.3 173 == **10. Настройка СНК-АЗС для работы через СНК-КС5** ==
Руслан Савельев 37.2 174
Руслан Савельев 42.3 175 === **10.1. Настройка конфигурационного файла СНК-АЗС** ===
Руслан Савельев 37.2 176
Руслан Савельев 42.3 177 * Закройте все приложения СНК-АЗС (включая Бэк-Офис)
178 * Откройте файл ##.\SNC_AZS\backofficeapp\bo_app.snc##
179 * Измените значения параметров:
Руслан Савельев 37.2 180
Руслан Савельев 42.3 181 |**Имя параметра**|**Описание значения параметра**
182 |UseExchangeServer|**1** – использовать КС для приема и передачи пакетов
183 |SendOpenShift|**1** – передавать текущую открытую смену
184 |TransactionOnOpenShift|**1** – передавать данные по открытой смене
185 |ExchangeList|Список абонентов, с которыми обменивается СНК-АЗС и формат данных для обмена, **заполняется автоматически**
186 |AutoSendData|(((
187 Автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 означает - всем абонентам, 07:00 – время отправки данных))
Руслан Савельев 37.2 188
Руслан Савельев 42.3 189 (Также, автоматическую отправку данных можно настроить через «Планировщик заданий» Windows)
190 )))
191 |AutoReceiveData|**1** – автоматический прием пакетов из КС в СНК-АЗС
192 |ExchangeSrvPortExt|Порт для связи с СНК-КС5 (http.port в файле настроек КС5)
Руслан Савельев 37.2 193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
Руслан Савельев 38.2 212
Руслан Савельев 39.4 213
Руслан Савельев 42.2 214
215
216
Руслан Савельев 42.3 217
218
Руслан Савельев 1.1 219