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

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

Редактировал(а) Руслан Савельев 2025/12/01 05:03
От версии 38.3
отредактировано Руслан Савельев
на 2025/11/05 05:29
Изменить комментарий: К данной версии нет комментариев
К версии 36.2
отредактировано Руслан Савельев
на 2025/11/05 05:23
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -45,83 +45,290 @@
45 45  
46 46  == **5. Общая информация** ==
47 47  
48 -Для обеспечения обмена точек обслуживания с инфраструктурой Офиса (СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн) при помощи СНК-КС5, необходимо соблюсти применение следующих пунктов:
48 +[[image:1742371332756-574.png||data-xwiki-image-style-alignment="center" height="528" width="700"]]
49 49  
50 -* Установленный сервер NATS для СНК-КС5 в инфраструктуре Офиса – данное приложение будет отвечать за коммуникацию между всеми экземплярами СНК-КС5
51 -* Отдельные экземпляры СНК-КС5 для каждой ТО
52 -* Отдельные экземпляры СНК-КС5 для каждого из следующих приложений - СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн
50 +== **6. Установка СНК-КС-5** ==
53 53  
54 -Ниже приведена схема взаимодействия всех экземпляров СНК-КС5 и сервера NATS:
52 +=== **6.1. Установка на стороне СНК-АЗС** ===
55 55  
56 -[[Схема работы СНК-КС5>>image:1762320317685-829.png||data-xwiki-image-style-alignment="center" height="534" width="700"]]
54 +Установка СНК-КС5 выполняется при начальной инсталляции СНК-АЗС **или при его обновлении**, для этого необходимо в окне выбора продуктов для установки или обновления установить флажок «Коммуникационный сервер v5».
55 +По умолчанию, каталог установки КС5 - ##.\SNC_AZS\exchange##
57 57  
58 -== **6. Установка СНК-КС5 в инфраструктуре Офиса** ==
57 +[[image:1744190452407-288.png||data-xwiki-image-style-alignment="center"]]
59 59  
60 -Настройка СНК-КС5 начинается на сервере, где установлены СНК-Офис и/или СНК-ПЦ. Необходимо установить сервер NATS и отдельные экземпляры СНК-КС5 для СНК-Офис и СНК-ПЦ.
59 +Если при установке или обновлении установить флажок «Создание ярлыков на рабочем столе», то на рабочем столе появится ярлык «КС СНК АЗС», который будет запускать веб-интерфейс СНК-КС5 (##http:~/~/localhost:8000/##):
61 61  
62 -Для установки СНК-КС5 на стороне Офиса:
61 +[[image:1744190595783-589.png||data-xwiki-image-style-alignment="center"]]
63 63  
64 -* Запустите установочный файл **snc_cs_update_5_4_0.exe** (или файл с более новой версией).
65 -* Нажмите «**Далее**» на экранах мастера установки и списка изменений.
63 +=== **6.2. На стороне СНК-ПЦ, СНК-Офис, СНК-Офис онлайн** ===
66 66  
67 -[[Окна начала установки и списка изменений>>image:1762320469682-529.png||data-xwiki-image-style-alignment="center" height="277" width="700"]]
65 +(% class="box warningmessage" %)
66 +(((
67 +**Если на ПК с СНК-ПЦ, и СНК-Офис КС5 уже был установлен и настроен для работы с некоторыми ТО, пропустите этот пункт!**
68 +)))
68 68  
69 -* На экране выбора компонентов выберите, для какой программы нужно установить СНК-КС5.
70 -* Установите флажок установки сервера NATS, если он не был установлен ранее.
71 -* На следующем экране выберите папку для установки СНК-КС и нажмите «**Далее**».
70 +Воспользуйтесь мастером установки СНК-КС5:
72 72  
72 +* Закройте все программы СНК-АЗС, СНК-ПЦ, СНК-Офис.
73 +* Запустите установочный файл (##snc_cs_update_5_2_2.exe## или файл с более новой версией).
74 +* Откроется окно мастера установки, нажмите кнопку «**Далее**».
73 73  
76 +[[image:1744190967012-923.png||data-xwiki-image-style-alignment="center"]]
74 74  
78 +* Следующее окно показывает список изменений для текущей версии программы, нажмите кнопку «**Далее**».
75 75  
80 +[[image:1744191021599-382.png||data-xwiki-image-style-alignment="center"]]
76 76  
82 +* В следующем окне выберите, для какой программы нужно установить КС 5 (СНК-ПЦ, СНК-Офис или СНК-Офис онлайн)
83 +* Отметьте флажок установки сервера NATS, если он еще не был установлен.
84 +* После выбора компонентов нажмите кнопку «**Далее**».
77 77  
86 +(% class="box infomessage" %)
87 +(((
88 +**ПК, на который устанавливается сервер NATS должен иметь статический IP-адрес!**
78 78  
90 +Этот адрес нужно указывать при настройке КС во всех программах. Параметр **##nats.host##**
91 +)))
79 79  
93 +[[image:1744191487368-234.png||data-xwiki-image-style-alignment="center"]]
80 80  
95 +* Выберите папку для установки СНК-КС и нажмите кнопку «**Далее**».
81 81  
97 +[[image:1744191540621-656.png||data-xwiki-image-style-alignment="center"]]
82 82  
99 +== **7. Настройка параметров КС 5** ==
83 83  
101 +Указанные параметры настраиваются в каждом установленном КС (например, если используется КС для СНК-АЗС и КС для СНК-Офис, нужно настроить оба КС)
84 84  
103 +=== **7.1. Используя конфигурационный файл** ===
85 85  
105 +Параметры настройки КС 5 сохранены в файле **##.\exchange\SncExchServer.cfg##**
86 86  
107 +Описание параметров:
87 87  
109 +* **abonent.id** – ID абонента (код абонента, для которого установлен КС5)
110 +* **archive.inbox.depth** – Глубина хранения входящих пакетов, дней.
111 +* **archive.outbox.depth** – Глубина хранения исходящих пакетов, дней.
112 +* **archive.packet.disable** – Отключить сохранение пакетов в архив (true), сохранять – false
113 +* **auth.token** – Токен, используется одинаковый токен для всех абонентов.
114 +* **http.port** – Порт для обмена с ПО СНК (Бэк-офис, СНК-Офис, СНК-ПЦ). Этот же порт используется для запуска веб-интерфейса в браузере (порт по умолчанию - 8000)
115 +* **nats.host** – IP адрес и порт сервера NATS. (порт по умолчанию - 7654)
116 +* **nats.timeout** – таймаут обращения к серверу NATS, мс.
88 88  
118 +**Для изменения параметров** необходимо:
89 89  
120 +* **остановить службу** КС 5, (см. раздел «Службы»).
121 +* **изменить и сохранить параметры** в файле.
122 +* **запустить службу** КС 5, (см. раздел «Службы»).
90 90  
124 +=== **7.2. Используя веб-интерфейс** ===
91 91  
126 +Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
92 92  
128 +* Перейдите на страницу «Настройки», доступные параметры:
129 +** **ID абонента** - код абонента, для которого установлен КС5 (параметр ##abonent.id ##в файле ##SncExchServer.cfg##)
130 +** **Глубина хранения входящих пакетов, дней** – сколько дней хранить входящие пакеты (параметр ##archive.inbox.depth ##в файле ##SncExchServer.cfg##)
131 +** **Глубина хранения исходящих пакетов, дней** – сколько дней хранить исходящие пакеты (параметр ##archive.outbox.depth ##в файле ##SncExchServer.cfg##)
132 +** **Не сохранять пакеты в архив** – отметьте флажок, чтобы не хранить архивы пакетов (параметр ##archive.packet.disable ##в файле ##SncExchServer.cfg##)
133 +** **Токен **– значение токена должно совпадать у всех абонентов, участвующих в обмене (параметр ##auth.token ##в файле ##SncExchServer.cfg##)
134 +** **Строка подключения** – IP адрес и порт сервера NATS (параметр ##nats.host ##в файле ##SncExchServer.cfg##)
135 +** **Таймаут, мс.** – таймаут обращения к серверу NATS (параметр ##nats.timeout ##в файле ##SncExchServer.cfg##)
136 +* Нажмите кнопку «**Сохранить**» после изменения настроек.
93 93  
138 +[[image:1742374859311-606.png||data-xwiki-image-style-alignment="center" height="355" width="600"]]
94 94  
140 +== **8. Настройка СНК-АЗС для работы с КС 5** ==
95 95  
142 +**{{id name="nastr_BO"/}}**
96 96  
144 +=== **8.1. Настройка в программе «Бэк-Офис СНК-АЗС»** ===
97 97  
146 +В «[[Бэк-Офис СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5).
98 98  
148 +**8.1.1. Запуск окна настроек абонентов**
99 99  
150 +* Запустите «[[**Бэк-офис СНК-АЗС**>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]».
151 +* В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
100 100  
153 +[[image:1742375086353-686.png||data-xwiki-image-style-alignment="center" height="184" width="500"]]Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
101 101  
155 +**8.1.2. Описание параметров таблицы абонентов**
102 102  
157 +* **Код абонента** – код абонента, с которым производится обмен данными, код нельзя изменить у уже созданного абонента, его можно указать только при создании нового абонента.
158 +* **Имя **– наименование абонента, не влияет на обмен, используется только для обозначения абонента в «Бэк-офисе».
159 +* **Тип данных** – тип передаваемых абоненту данных («СНК-ПЦ» или «СНК-Офис»).
160 +* **Версия КС** – версия КС, используемая абонентом для обмена данными («КС 4» или «КС 5»).
103 103  
162 +[[image:1742375171694-926.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.3. Настройка портов для связи «Бэк-Офиса» с КС**
104 104  
164 +* **Порт для КС 4** – порт, по которому «Бэк-офис» связывается с КС 4 (по умолчанию 6000).
165 +* **Порт для КС 5** – порт, по которому «Бэк-офис» связывается с КС 5 (по умолчанию 8000).
105 105  
167 +Для запуска веб-интерфейса КС 5, можно воспользоваться кнопкой «**Открыть КС 5**».
106 106  
169 +(% class="box infomessage" %)
170 +(((
171 +**Внимание!**
172 +В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр ##http.port## в файле ##SncExchServer.cfg##).
173 +)))
107 107  
175 +**8.1.4. Добавление абонента**
108 108  
177 +* В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
109 109  
179 +[[image:1742375331377-333.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
110 110  
181 +* В строке «**Добавить абонента**» укажите код добавляемого абонента и нажмите кнопку «**ОК**».
111 111  
183 +[[image:1742375383319-279.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
112 112  
185 +В таблицу будет добавлена новая строка
113 113  
187 +* Заполните параметры **Имя**, **Тип данных**, **Версия КС** для созданного абонента (см. п. 6.1.2).
114 114  
189 +[[image:1742375454496-878.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.5. Удаление абонента**
115 115  
191 +* Нажмите правую кнопку мыши на строке с абонентом и выберите «**Удалить**»
116 116  
193 +[[image:1742375709359-919.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
117 117  
195 +=== **8.2. Настройка конфигурационного файла СНК-АЗС** ===
118 118  
197 +Для работы «СНК-АЗС» с КС 5 необходимо настроить параметры в файле## .\SNC_AZS\backofficeapp\**bo_app.snc**##
119 119  
199 +(% class="box infomessage" %)
200 +(((
201 +**Внимание!**
202 +Закройте все программы «СНК-АЗС» и «Бэк-Офис» перед внесением изменений!
203 +)))
120 120  
205 +Описание параметров для настройки работы с КС 5:
121 121  
207 +* **TransactionOnOpenShift** – передавать данные по текущей открытой смене (0 - не передавать, **1 - передавать**)
208 +* **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**)
209 +* **ExchangeList** – список абонентов с которыми обменивается СНК-АЗС и формат данных для обмена, заполняется автоматически, при настройке абонентов в «Бэк-Офисе» (см. п. 6.1)
210 +* **AutoReceiveData** – автоматический прием полученных в КС данных в «Бэк-Офис» (0 – автоматический прием выключен, **1 - включен**)
211 +* **AutoSendData** – автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 – всем абонентам, 07:00 – время отправки данных))
212 +* **SendOpenShift** – передача открытой смены в «СНК-Офис» (0 - не передавать, **1 - передавать**)
213 +* **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port**)
122 122  
215 +== **9. Настройка СНК-Офис для работы с КС 5** ==
123 123  
217 +=== **9.1. Настройка конфигурационного файла СНК-Офис** ===
124 124  
219 +Для работы «СНК-Офис» с КС 5 необходимо настроить параметры в файле ##.\SNC_OFFICE\**bo_app.ini**##
125 125  
221 +(% class="box infomessage" %)
222 +(((
223 +**Внимание!**
224 +Закройте программу «СНК-Офис» перед внесением изменений!
225 +)))
126 126  
227 +Описание параметров для настройки работы с КС 5:
228 +
229 +* **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**)
230 +* **AutoReceiveData** – автоматический прием полученных в КС данных (0 – автоматический прием выключен, **1 - включен**)
231 +* **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1) (**этот параметр нужно добавить, с номером порта, если его нет**)
232 +
233 +=== **9.2. Настройка формата передачи данных для ТО** ===
234 +
235 +Для каждой ТО необходимо выбрать версию КС, используемую ТО для обмена данными. Для этого:
236 +
237 +* Откройте раздел «**Справочники**».
238 +* Выберите «**Точки обслуживания**»
239 +* На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»
240 +
241 +[[image:1742376031179-997.png||data-xwiki-image-style-alignment="center" height="312" width="600"]]
242 +
243 +Откроется окно «**Редактирование ТО**».
244 +
245 +* Перейдите на вкладку «**Обмен данными**».
246 +* В параметре «**Использовать СНК-КС**» выберите «**КС 5**».
247 +* Нажмите кнопку «**ОК**» для сохранения параметров.
248 +
249 +[[image:1742376080218-224.png||data-xwiki-image-style-alignment="center" height="440" width="350"]]
250 +
251 +== **10. Настройка СНК-ПЦ для работы с КС 5** ==
252 +
253 +=== **10.1 Установка КС5 для ПЦ** ===
254 +
255 +=== В СНК-ПЦ зайдите в меню – «**Настройка**» – «**Конфигурация**». ===
256 +
257 +В разделе «**Приписка проекта**» добавьте параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**», для этого:
258 +
259 +[[image:1742376299785-470.png||data-xwiki-image-style-alignment="center" height="333" width="700"]]
260 +
261 +* Выберите заголовок проекта в конфигурации.
262 +* Слева нажмите кнопку «**Экспорт**». Из выпавшего списка выберите «Импорт выборочных настроек (с пополнением)»
263 +
264 +[[image:1742376339853-759.png||data-xwiki-image-style-alignment="center" height="332" width="700"]]
265 +
266 +Откроется окно файлового проводника.
267 +
268 +* Зайдите в каталог «**sncPC**» и выберите файл «**IP-Адрес и порт КС5**»
269 +* Нажмите кнопку «**Открыть**»
270 +
271 +[[image:1742376379869-231.png||data-xwiki-image-style-alignment="center" height="520" width="700"]]
272 +
273 +* После добавления параметра укажите настройки КС5 в правом окне в строке «**Значение**» в формате ##ipv4:порт## (например ##localhost:8000##).
274 +* Нажмите кнопку «**Принять**» и перезапустите ПЦ.
275 +
276 +=== **10.2 Установка КС5 для определенной ТО** ===
277 +
278 +* После перезапуска ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**»
279 +
280 +[[image:1742376449142-544.png||data-xwiki-image-style-alignment="center" height="353" width="700"]]
281 +
282 +* Выберите нужную ТО и нажмите кнопку «**Ограничения**» слева.
283 +
284 +[[image:1742376495608-296.png||data-xwiki-image-style-alignment="center" height="327" width="700"]]
285 +
286 +* В открывшемся окне выберите строку «**Настройка**», и нажмите кнопку «**Значения**».
287 +
288 +[[image:1742376541541-400.png||data-xwiki-image-style-alignment="center" height="256" width="700"]]
289 +
290 +* В открывшемся окне раскройте раздел «Режим обмена данными», нажав на **+**.
291 +* Флажок «**Обмен СНК-КС ?**» должен быть **убран**.
292 +* Флажок «**Обмен СНК-КС 5?**» должен быть **установлен**.
293 +* Нажмите кнопку «**Принять**»
294 +
295 +[[image:1742376578109-329.png||data-xwiki-image-style-alignment="center" height="362" width="500"]]
296 +
297 +== **11. Службы КС 5** ==
298 +
299 +Существуют отдельные службы КС 5 для различных продуктов СНК:
300 +
301 +* Для «**СНК-АЗС**» - «**СНК-Коммуникационный сервер v5**» (sncexchservice)
302 +* Для «**СНК-Офис**» - «**СНК-Коммуникационный сервер v5 СНК-ОФИС**» (sncexchservice.1000)
303 +* Для «**СНК-ПЦ**» - «**СНК-Коммуникационный сервер v5 СНК-ПЦ**» (sncexchservice.500)
304 +* Для «**СНК-Офис Онлайн**» - «**СНК-ОФИС Онлайн прием КС v5**» (sncexchprocessor)
305 +* **Служба сервера NATS** – «**СНК-Коммуникационный сервер v5 NATS**» (nats-server)
306 +
307 +== **12. Описание каталогов обмена** ==
308 +
309 +=== **12.1. Каталоги обмена КС 5** ===
310 +
311 +Каталоги обмена КС 5 находятся в папке ##**Data**## и сгруппированы по абонентам. Внутри папки ##**Data**## находится папка с номером абонента, в которой находится папка ##**Packet**##, в которой находятся папки обмена:
312 +
313 +* ##**Cache**## – для работы с принимаемым в данный момент пакетом.
314 +* ##**Inbox**## – для входящих пакетов, которые еще не приняты программами СНК.
315 +* ##**InboxArchive**## – архив входящих пакетов, сюда перемещаются пакеты из папки Inbox после их принятия в программу СНК.
316 +* ##**Outbox**## – для отправляемых в настоящее время пакетов.
317 +* ##**OutboxArchive**## – архив исходящих пакетов, сюда перемещаются пакеты из папки Outbox после их отправки другому абоненту.
318 +
319 +[[image:1742374549161-794.png||data-xwiki-image-style-alignment="center"]]
320 +
321 +=== **12.2. Каталоги обмена в программах СНК** ===
322 +
323 +Каталоги обмена для «СНК-АЗС» находятся в папке **##SNC_AZS\backofficeapp##**.
324 +
325 +Каталоги обмена для «СНК-Офис» находятся в папке **##SNC_OFFICE##**.
326 +
327 +Описание каталогов:
328 +
329 +* ##**OCIN**## – для входящих пакетов
330 +* ##**OCIN_W**## – для входящих пакетов, переданных в формате «WIN»
331 +* ##**OCIN_W.err**## – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки
332 +* ##**OCOUT_W**## – для исходящих пакетов, передаваемых в формате «WIN»
333 +
127 127  
1762320317685-829.png
Автор
... ... @@ -1,1 +1,0 @@
1 -XWiki.Admin_super
Размер
... ... @@ -1,1 +1,0 @@
1 -258.9 KB
Содержимое
1762320469682-529.png
Автор
... ... @@ -1,1 +1,0 @@
1 -XWiki.Admin_super
Размер
... ... @@ -1,1 +1,0 @@
1 -173.2 KB
Содержимое