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

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

Скрыть последних авторов
Руслан Савельев 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##**|Общий токен сети (одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ)
Руслан Савельев 44.2 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
Руслан Савельев 43.1 181 |(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**
182 |**##UseExchangeServer##**|**1** – использовать КС для приема и передачи пакетов
183 |**##SendOpenShift##**|**1** – передавать текущую открытую смену
184 |**##TransactionOnOpenShift##**|**1** – передавать данные по открытой смене
185 |**##ExchangeList##**|Список абонентов, с которыми обменивается СНК-АЗС и формат данных для обмена, **заполняется автоматически**
186 |**##AutoSendData##**|(((
Руслан Савельев 42.3 187 Автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 означает - всем абонентам, 07:00 – время отправки данных))
Руслан Савельев 37.2 188
Руслан Савельев 42.3 189 (Также, автоматическую отправку данных можно настроить через «Планировщик заданий» Windows)
190 )))
Руслан Савельев 43.1 191 |**##AutoReceiveData##**|**1** – автоматический прием пакетов из КС в СНК-АЗС
192 |**##ExchangeSrvPortExt##**|Порт для связи с СНК-КС5 (http.port в файле настроек КС5)
Руслан Савельев 37.2 193
Руслан Савельев 43.1 194 * Сохраните изменения в файле
Руслан Савельев 37.2 195
Руслан Савельев 44.2 196 === **10.2. Настройка в программе «Бэк-Офис СНК-АЗС»** ===
Руслан Савельев 37.2 197
Руслан Савельев 44.2 198 В «Бэк-Офис СНК-АЗС» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5), а также настроить параметры работы СНК-КС5.
Руслан Савельев 37.2 199
Руслан Савельев 44.2 200 * Запустите «**Бэк-офис СНК-АЗС**».
201 * В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
Руслан Савельев 37.2 202
Руслан Савельев 44.2 203 [[ Запуск окна настроек абонентов>>image:1762322131024-259.png||data-xwiki-image-style-alignment="center" height="216" width="550"]]
Руслан Савельев 37.2 204
Руслан Савельев 44.2 205 * Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
206 * Первоначально в списке абонентов заведен абонент для примера, удалите его. Для этого нажмите правой кнопкой мыши на строке абонента и выберите «Удалить»
207 * В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
Руслан Савельев 37.2 208
Руслан Савельев 46.2 209 [[Добавление абонента>>image:1762322184400-657.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]
Руслан Савельев 37.2 210
Руслан Савельев 46.2 211 * В строке «**Добавить абонента**» укажите код добавляемого абонента, например, код абонента «СНК-Офис» ((% style="background-color:#f1c40f" %)abonent.id(%%) в файле настроек КС5) и нажмите кнопку «**ОК**».
Руслан Савельев 37.2 212
Руслан Савельев 46.2 213 [[image:1762322283984-102.png]]
Руслан Савельев 37.2 214
215
216
217
218
219
220
221
222
223
Руслан Савельев 38.2 224
Руслан Савельев 39.4 225
Руслан Савельев 42.2 226
227
228
Руслан Савельев 42.3 229
230
Руслан Савельев 43.1 231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
Руслан Савельев 1.1 254