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

Версия 25.4 от Руслан Савельев на 2025/04/09 09:37

Скрыть последних авторов
Руслан Савельев 4.2 1 = 1. Назначение =
Руслан Савельев 1.1 2
Руслан Савельев 2.2 3 Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ.
Руслан Савельев 1.1 4
Руслан Савельев 25.3 5 = 2. Запуск программы =
Руслан Савельев 1.1 6
Руслан Савельев 25.3 7 [[image:1742371119337-637.png||data-xwiki-image-style-text-wrap="true" height="17" width="17"]]Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
8
9 = 3. Интерфейс программы =
10
11 Программа открывается в браузере и состоит из следующих элементов:
12
13 * **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.
14 * **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.
15 * **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами //(на рисунке отмечено цифрой 3)//.
16 * **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.
17
18 [[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]
19
20 = 4. Требования к ПО =
21
Руслан Савельев 23.2 22 * «СНК-КС» - 5.2.0 и выше.
23 * «СНК-АЗС» - 1.37.37 и выше.
24 * «СНК-Офис» - 1.23.2 и выше.
25 * «СНК-ПЦ» - 1.113.30 и выше.
26 * Действующая лицензия «СНК-КС» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «[[KeyInfo>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome]]»
27
Руслан Савельев 25.3 28 = 5. Информация и структурная схема =
Руслан Савельев 23.2 29
Руслан Савельев 3.2 30 [[image:1742371332756-574.png||data-xwiki-image-style-alignment="center" height="528" width="700"]]
31
Руслан Савельев 25.3 32 = 6. Установка СНК-КС-5 =
Руслан Савельев 23.2 33
Руслан Савельев 25.3 34 == 6.1. Установка на стороне СНК-АЗС ==
Руслан Савельев 23.2 35
36 Установка СНК-КС5 выполняется при начальной инсталляции СНК-АЗС или при его обновлении, для этого необходимо в окне выбора продуктов для установки или обновления установить флажок «Коммуникационный сервер v5».
37 По умолчанию, каталог установки КС5 - ##.\SNC_AZS\exchange##
38
39 [[image:1744190452407-288.png||data-xwiki-image-style-alignment="center"]]Если при установке или обновлении установить флажок «Создание ярлыков на рабочем столе», то на рабочем столе появится ярлык «КС СНК АЗС», который будет запускать веб-интерфейс СНК-КС5 (##http:~/~/localhost:8000/##):
40
Руслан Савельев 25.3 41 [[image:1744190595783-589.png||data-xwiki-image-style-alignment="center"]]
Руслан Савельев 23.2 42
Руслан Савельев 25.3 43 == 6.2. На стороне СНК-ПЦ, СНК-Офис, СНК-Офис онлайн ==
Руслан Савельев 23.2 44
Руслан Савельев 25.3 45 Воспользуйтесь мастером установки СНК-КС5:
Руслан Савельев 23.2 46
Руслан Савельев 25.3 47 * Закройте все программы СНК-АЗС, СНК-ПЦ, СНК-Офис.
48 * Запустите установочный файл (##snc_cs_update_5_2_2.exe## или файл с более новой версией).
Руслан Савельев 25.4 49 * Откроется окно мастера установки, нажмите кнопку «**Далее**».
Руслан Савельев 23.2 50
Руслан Савельев 25.4 51 [[image:1744190967012-923.png||data-xwiki-image-style-alignment="center"]]
Руслан Савельев 23.2 52
Руслан Савельев 25.4 53 * Следующее окно показывает список изменений для текущей версии программы, нажмите кнопку «**Далее**».
Руслан Савельев 23.2 54
Руслан Савельев 25.4 55 [[image:1744191021599-382.png||data-xwiki-image-style-alignment="center"]]
Руслан Савельев 23.2 56
Руслан Савельев 25.4 57 * В следующем окне выберите, для какой программы нужно установить КС 5 (СНК-ПЦ, СНК-Офис или СНК-Офис онлайн)
58 * Отметьте флажок установки сервера NATS, если он еще не был установлен.
59 * После выбора компонентов нажмите кнопку «Далее».
Руслан Савельев 3.2 60
Руслан Савельев 25.4 61 (% class="box infomessage" %)
62 (((
63 **ПК, на который устанавливается сервер NATS должен иметь статический IP-адрес!**
Руслан Савельев 1.1 64
Руслан Савельев 25.4 65 Этот адрес нужно указывать при настройке КС во всех программах. Параметр **nats.host (см. п. 7)**
66 )))
Руслан Савельев 1.1 67
68
69
70
71
72
Руслан Савельев 25.3 73
74
75
76
77
78
79
80
81
82
Руслан Савельев 25.4 83
Руслан Савельев 25.3 84 = 7. Настройка параметров КС 5 =
85
Руслан Савельев 25.4 86 Указанные параметры настраиваются в каждом установленном КС (например, если используется КС для СНК-АЗС и КС для СНК-Офис, нужно настроить оба КС)
87
Руслан Савельев 25.3 88 == 7.1. Используя конфигурационный файл ==
89
Руслан Савельев 5.2 90 Параметры настройки КС 5 сохранены в файле **##.\exchange\SncExchServer.cfg##**
Руслан Савельев 1.1 91
Руслан Савельев 5.2 92 Описание параметров:
Руслан Савельев 1.1 93
Руслан Савельев 5.2 94 * **abonent.id** – ID абонента (код абонента, для которого установлен КС5)
95 * **archive.inbox.depth** – Глубина хранения входящих пакетов, дней.
96 * **archive.outbox.depth** – Глубина хранения исходящих пакетов, дней.
97 * **archive.packet.disable** – Отключить сохранение пакетов в архив (true), сохранять – false
98 * **auth.token** – Токен, используется одинаковый токен для всех абонентов.
99 * **http.port** – Порт для обмена с ПО СНК (Бэк-офис, СНК-Офис, СНК-ПЦ). Этот же порт используется для запуска веб-интерфейса в браузере (порт по умолчанию - 8000)
100 * **nats.host** – IP адрес и порт сервера NATS. (порт по умолчанию - 7654)
101 * **nats.timeout** – таймаут обращения к серверу NATS, мс.
Руслан Савельев 1.1 102
Руслан Савельев 5.2 103 **Для изменения параметров** необходимо:
Руслан Савельев 1.1 104
Руслан Савельев 5.2 105 * **остановить службу** КС 5, (см. раздел «Службы», п.9).
106 * **изменить и сохранить параметры** в файле.
107 * **запустить службу** КС 5, (см. раздел «Службы», п.9).
Руслан Савельев 1.1 108
Руслан Савельев 25.3 109 == 7.2. Используя веб-интерфейс ==
Руслан Савельев 1.1 110
Руслан Савельев 5.2 111 Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
Руслан Савельев 4.2 112
Руслан Савельев 5.2 113 * Перейдите на страницу «Настройки», доступные параметры:
114 ** **ID абонента** - код абонента, для которого установлен КС5 (abonent.id в п. 5.1)
115 ** **Глубина хранения входящих пакетов, дней** – сколько дней хранить входящие пакеты (archive.inbox.depth в п. 5.1)
116 ** **Глубина хранения исходящих пакетов, дней** – сколько дней хранить исходящие пакеты (archive.outbox.depth в п. 5.1)
117 ** **Не сохранять пакеты в архив** – отметьте флажок, чтобы не хранить архивы пакетов (archive.packet.disable в п. 5.1)
118 ** **Токен **– значение токена должно совпадать у всех абонентов, участвующих в обмене (auth.token в п. 5.1)
119 ** **Строка подключения** – IP адрес и порт сервера NATS (nats.host в п. 5.1)
120 ** **Таймаут, мс.** – таймаут обращения к серверу NATS (nats.timeout в п. 5.1)
121 * Нажмите кнопку «**Сохранить**» после изменения настроек.
122
Руслан Савельев 6.2 123 [[image:1742374859311-606.png||data-xwiki-image-style-alignment="center" height="355" width="600"]]
Руслан Савельев 5.2 124
Руслан Савельев 25.3 125 = 8. Настройка СНК-АЗС для работы с КС 5 =
Руслан Савельев 5.2 126
Руслан Савельев 25.3 127 == 8.1. Настройка в программе «Бэк-Офис СНК-АЗС» ==
Руслан Савельев 5.2 128
Руслан Савельев 7.2 129 В «[[Бэк-Офис СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5).
Руслан Савельев 5.2 130
Руслан Савельев 25.3 131 **8.1.1. Запуск окна настроек абонентов**
Руслан Савельев 5.2 132
Руслан Савельев 7.2 133 * Запустите «[[**Бэк-офис СНК-АЗС**>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]».
134 * В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
Руслан Савельев 5.2 135
Руслан Савельев 7.2 136 [[image:1742375086353-686.png||data-xwiki-image-style-alignment="center" height="184" width="500"]]Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
Руслан Савельев 5.2 137
Руслан Савельев 25.3 138 **8.1.2. Описание параметров таблицы абонентов**
Руслан Савельев 5.2 139
Руслан Савельев 8.2 140 * **Код абонента** – код абонента, с которым производится обмен данными, код нельзя изменить у уже созданного абонента, его можно указать только при создании нового абонента.
141 * **Имя **– наименование абонента, не влияет на обмен, используется только для обозначения абонента в «Бэк-офисе».
142 * **Тип данных** – тип передаваемых абоненту данных («СНК-ПЦ» или «СНК-Офис»).
143 * **Версия КС** – версия КС, используемая абонентом для обмена данными («КС 4» или «КС 5»).
Руслан Савельев 5.2 144
Руслан Савельев 25.3 145 [[image:1742375171694-926.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.3. Настройка портов для связи «Бэк-Офиса» с КС**
Руслан Савельев 5.2 146
Руслан Савельев 11.2 147 * **Порт для КС 4** – порт, по которому «Бэк-офис» связывается с КС 4 (по умолчанию 6000).
148 * **Порт для КС 5** – порт, по которому «Бэк-офис» связывается с КС 5 (по умолчанию 8000).
Руслан Савельев 5.2 149
Руслан Савельев 11.2 150 Для запуска веб-интерфейса КС 5, можно воспользоваться кнопкой «**Открыть КС 5**».
Руслан Савельев 5.2 151
Руслан Савельев 11.2 152 (% class="box infomessage" %)
153 (((
154 **Внимание!**
155 В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр http.port в файле SncExchServer.cfg, см. п. 5.1).
156 )))
Руслан Савельев 5.2 157
Руслан Савельев 25.3 158 **8.1.4. Добавление абонента**
Руслан Савельев 5.2 159
Руслан Савельев 11.2 160 * В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
Руслан Савельев 5.2 161
Руслан Савельев 11.2 162 [[image:1742375331377-333.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
Руслан Савельев 5.2 163
Руслан Савельев 11.2 164 * В строке «**Добавить абонента**» укажите код добавляемого абонента и нажмите кнопку «**ОК**».
Руслан Савельев 5.2 165
Руслан Савельев 11.2 166 [[image:1742375383319-279.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
Руслан Савельев 5.2 167
Руслан Савельев 11.2 168 В таблицу будет добавлена новая строка
Руслан Савельев 5.2 169
Руслан Савельев 11.2 170 * Заполните параметры **Имя**, **Тип данных**, **Версия КС** для созданного абонента (см. п. 6.1.2).
Руслан Савельев 5.2 171
Руслан Савельев 25.3 172 [[image:1742375454496-878.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.5. Удаление абонента**
Руслан Савельев 11.2 173
Руслан Савельев 12.2 174 * Нажмите правую кнопку мыши на строке с абонентом и выберите «**Удалить**»
Руслан Савельев 11.2 175
Руслан Савельев 12.2 176 [[image:1742375709359-919.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
Руслан Савельев 11.2 177
Руслан Савельев 25.3 178 == 8.2. Настройка конфигурационного файла СНК-АЗС ==
Руслан Савельев 11.2 179
Руслан Савельев 23.2 180 Для работы «СНК-АЗС» с КС 5 необходимо настроить параметры в файле## .\SNC_AZS\backofficeapp\**bo_app.snc**##
Руслан Савельев 11.2 181
Руслан Савельев 12.2 182 (% class="box infomessage" %)
183 (((
184 **Внимание!**
185 Закройте все программы «СНК-АЗС» и «Бэк-Офис» перед внесением изменений!
186 )))
Руслан Савельев 11.2 187
Руслан Савельев 12.2 188 Описание параметров для настройки работы с КС 5:
Руслан Савельев 11.2 189
Руслан Савельев 12.2 190 * **TransactionOnOpenShift** – передавать данные по текущей открытой смене (0 - не передавать, **1 - передавать**)
191 * **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**)
192 * **ExchangeList** – список абонентов с которыми обменивается СНК-АЗС и формат данных для обмена, заполняется автоматически, при настройке абонентов в «Бэк-Офисе» (см. п. 6.1)
193 * **AutoReceiveData** – автоматический прием полученных в КС данных в «Бэк-Офис» (0 – автоматический прием выключен, **1 - включен**)
194 * **AutoSendData** – автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 – всем абонентам, 07:00 – время отправки данных))
195 * **SendOpenShift** – передача открытой смены в «СНК-Офис» (0 - не передавать, **1 - передавать**)
196 * **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1)
Руслан Савельев 11.2 197
Руслан Савельев 25.3 198 = 9. Настройка СНК-Офис для работы с КС 5 =
Руслан Савельев 11.2 199
Руслан Савельев 25.3 200 == 9.1. Настройка конфигурационного файла СНК-Офис ==
Руслан Савельев 11.2 201
Руслан Савельев 13.2 202 Для работы «СНК-Офис» с КС 5 необходимо настроить параметры в файле ##.\SNC_OFFICE\**bo_app.ini**##
Руслан Савельев 11.2 203
Руслан Савельев 13.2 204 (% class="box infomessage" %)
205 (((
206 **Внимание!**
207 Закройте программу «СНК-Офис» перед внесением изменений!
208 )))
Руслан Савельев 12.2 209
Руслан Савельев 13.2 210 Описание параметров для настройки работы с КС 5:
Руслан Савельев 12.2 211
Руслан Савельев 13.2 212 * **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**)
213 * **AutoReceiveData** – автоматический прием полученных в КС данных (0 – автоматический прием выключен, **1 - включен**)
214 * **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1)
Руслан Савельев 12.2 215
Руслан Савельев 25.3 216 == 9.2. Настройка формата передачи данных для ТО ==
Руслан Савельев 12.2 217
Руслан Савельев 13.2 218 Для каждой ТО необходимо выбрать версию КС, используемую ТО для обмена данными. Для этого:
Руслан Савельев 12.2 219
Руслан Савельев 13.2 220 * Откройте раздел «**Справочники**».
221 * Выберите «**Точки обслуживания**»
222 * На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»
Руслан Савельев 12.2 223
Руслан Савельев 13.2 224 [[image:1742376031179-997.png||data-xwiki-image-style-alignment="center" height="312" width="600"]]
Руслан Савельев 12.2 225
Руслан Савельев 15.2 226 Откроется окно «**Редактирование ТО**».
Руслан Савельев 12.2 227
Руслан Савельев 13.2 228 * Перейдите на вкладку «**Обмен данными**».
229 * В параметре «**Использовать СНК-КС**» выберите «**КС 5**».
230 * Нажмите кнопку «**ОК**» для сохранения параметров.
Руслан Савельев 12.2 231
Руслан Савельев 14.2 232 [[image:1742376080218-224.png||data-xwiki-image-style-alignment="center" height="440" width="350"]]
Руслан Савельев 12.2 233
Руслан Савельев 25.3 234 = 10. Настройка СНК-ПЦ для работы с КС 5 =
Руслан Савельев 12.2 235
Руслан Савельев 15.2 236 В СНК-ПЦ зайдите в меню – «**Настройка**» – «**Конфигурация**».
Руслан Савельев 12.2 237
Руслан Савельев 15.2 238 В разделе «**Приписка проекта**» добавьте параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**».
Руслан Савельев 12.2 239
Руслан Савельев 15.2 240 [[image:1742376299785-470.png||data-xwiki-image-style-alignment="center" height="333" width="700"]]
Руслан Савельев 13.2 241
Руслан Савельев 16.2 242 * Выберите заголовок проекта в конфигурации.
243 * Слева нажмите кнопку «**Экспорт**». Из выпавшего списка выберите «Импорт выборочных настроек (с пополнением)»
Руслан Савельев 13.2 244
Руслан Савельев 16.2 245 [[image:1742376339853-759.png||data-xwiki-image-style-alignment="center" height="332" width="700"]]
Руслан Савельев 13.2 246
Руслан Савельев 16.2 247 Откроется окно файлового проводника.
Руслан Савельев 13.2 248
Руслан Савельев 16.2 249 * Зайдите в каталог «**sncPC**» и выберите файл «**IP-Адрес и порт КС5**»
250 * Нажмите кнопку «**Открыть**»
Руслан Савельев 14.2 251
Руслан Савельев 18.2 252 [[image:1742376379869-231.png||data-xwiki-image-style-alignment="center" height="520" width="700"]]
Руслан Савельев 14.2 253
Руслан Савельев 18.2 254 * После добавления параметра укажите настройки КС5 в правом окне в строке «**Значение**» в формате ##ipv4:порт## (например ##localhost:8000##).
255 * Нажмите кнопку «**Принять**» и перезапустите ПЦ.
256 * После перезапуска ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**»
Руслан Савельев 14.2 257
Руслан Савельев 18.2 258 [[image:1742376449142-544.png||data-xwiki-image-style-alignment="center" height="353" width="700"]]
Руслан Савельев 14.2 259
Руслан Савельев 18.2 260 * Выберите нужную ТО и нажмите кнопку «**Ограничения**» слева.
Руслан Савельев 14.2 261
Руслан Савельев 19.2 262 [[image:1742376495608-296.png||data-xwiki-image-style-alignment="center" height="327" width="700"]]
Руслан Савельев 14.2 263
Руслан Савельев 19.2 264 * В открывшемся окне выберите строку «**Настройка**», и нажмите кнопку «**Значения**».
Руслан Савельев 14.2 265
Руслан Савельев 22.1 266 [[image:1742376541541-400.png||data-xwiki-image-style-alignment="center" height="256" width="700"]]
Руслан Савельев 14.2 267
Руслан Савельев 22.1 268 * В открывшемся окне раскройте раздел «Режим обмена данными», нажав на **+**.
269 * Флажок «**Обмен СНК-КС ?**» должен быть **убран**.
270 * Флажок «**Обмен СНК-КС 5?**» должен быть **установлен**.
271 * Нажмите кнопку «**Принять**»
Руслан Савельев 14.2 272
Руслан Савельев 22.1 273 [[image:1742376578109-329.png||data-xwiki-image-style-alignment="center" height="362" width="500"]]
Руслан Савельев 14.2 274
Руслан Савельев 25.3 275 = 11. Службы КС 5 =
Руслан Савельев 5.2 276
277 Существуют отдельные службы КС 5 для различных продуктов СНК:
278
279 * Для «**СНК-АЗС**» - «**СНК-Коммуникационный сервер v5**» (sncexchservice)
280 * Для «**СНК-Офис**» - «**СНК-Коммуникационный сервер v5 СНК-ОФИС**» (sncexchservice.1000)
281 * Для «**СНК-ПЦ**» - «**СНК-Коммуникационный сервер v5 СНК-ПЦ**» (sncexchservice.500)
282 * Для «**СНК-Офис Онлайн**» - «**СНК-ОФИС Онлайн прием КС v5**» (sncexchprocessor)
283 * **Служба сервера NATS** – «**СНК-Коммуникационный сервер v5 NATS**» (nats-server)
284
Руслан Савельев 25.3 285 = 12. Описание каталогов обмена =
Руслан Савельев 5.2 286
Руслан Савельев 25.3 287 == 12.1. Каталоги обмена КС 5 ==
Руслан Савельев 5.2 288
289 Каталоги обмена КС 5 находятся в папке ##**Data**## и сгруппированы по абонентам. Внутри папки ##**Data**## находится папка с номером абонента, в которой находится папка ##**Packet**##, в которой находятся папки обмена:
290
291 * ##**Cache**## – для работы с принимаемым в данный момент пакетом.
292 * ##**Inbox**## – для входящих пакетов, которые еще не приняты программами СНК.
293 * ##**InboxArchive**## – архив входящих пакетов, сюда перемещаются пакеты из папки Inbox после их принятия в программу СНК.
294 * ##**Outbox**## – для отправляемых в настоящее время пакетов.
295 * ##**OutboxArchive**## – архив исходящих пакетов, сюда перемещаются пакеты из папки Outbox после их отправки другому абоненту.
296
297 [[image:1742374549161-794.png||data-xwiki-image-style-alignment="center"]]
298
Руслан Савельев 25.3 299 == 12.2. Каталоги обмена в программах СНК ==
Руслан Савельев 5.2 300
301 Каталоги обмена для «СНК-АЗС» находятся в папке **##SNC_AZS\backofficeapp##**.
302
303 Каталоги обмена для «СНК-Офис» находятся в папке **##SNC_OFFICE##**.
304
305 Описание каталогов:
306
307 * ##**OCIN**## – для входящих пакетов
308 * ##**OCIN_W**## – для входящих пакетов, переданных в формате «WIN»
309 * ##**OCIN_W.err**## – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки
310 * ##**OCOUT_W**## – для исходящих пакетов, передаваемых в формате «WIN»
311
312
313
314
Руслан Савельев 1.1 315