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

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

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

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -1,55 +1,107 @@
1 -= 1. Назначение =
1 +== **1. Назначение** ==
2 2  
3 3  Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ.
4 4  
5 -= 2. Требования к ПО =
5 +== **2. Запуск приложения** ==
6 6  
7 -* «СНК-КС» - 5.2.0 и выше.
8 -* «СНК-АЗС» - 1.37.37 и выше.
9 -* «СНК-Офис» - 1.23.2 и выше.
10 -* «СНК-ПЦ» - 1.113.30 и выше.
11 -* Действующая лицензия «СНК-КС» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «[[KeyInfo>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome]]»
7 +Для запуска приложения используйте один из вариантов:
12 12  
13 -= 3. Информация и структурная схема =
9 +{{tabs idsToLabels="tabId1=Запуск ярлыка на рабочем столе, tabId2=Через интернет-браузер"/}}
14 14  
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 +
27 +== **3. Интерфейс программы** ==
28 +
29 +Программа открывается в браузере и состоит из следующих элементов:
30 +
31 +* **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.
32 +* **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.
33 +* **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами и вкладка настроек //(на рисунке отмечено цифрой 3)//.
34 +* **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.
35 +
36 +[[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]
37 +
38 +== **4. Требования к ПО** ==
39 +
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]]»
45 +
46 +== **5. Общая информация** ==
47 +
15 15  [[image:1742371332756-574.png||data-xwiki-image-style-alignment="center" height="528" width="700"]]
16 16  
17 -= 4. Установка СНК-КС-5 =
50 +== **6. Установка СНК-КС-5** ==
18 18  
19 -== 4.1. Установка на стороне СНК-АЗС ==
52 +=== **6.1. Установка на стороне СНК-АЗС** ===
20 20  
21 -Установка СНК-КС5 выполняется при начальной инсталляции СНК-АЗС или при его обновлении, для этого необходимо в окне выбора продуктов для установки или обновления установить флажок «Коммуникационный сервер v5».
54 +Установка СНК-КС5 выполняется при начальной инсталляции СНК-АЗС **или при его обновлении**, для этого необходимо в окне выбора продуктов для установки или обновления установить флажок «Коммуникационный сервер v5».
22 22  По умолчанию, каталог установки КС5 - ##.\SNC_AZS\exchange##
23 23  
24 -[[image:1744190452407-288.png||data-xwiki-image-style-alignment="center"]]Если при установке или обновлении установить флажок «Создание ярлыков на рабочем столе», то на рабочем столе появится ярлык «КС СНК АЗС», который будет запускать веб-интерфейс СНК-КС5 (##http:~/~/localhost:8000/##):
57 +[[image:1744190452407-288.png||data-xwiki-image-style-alignment="center"]]
25 25  
26 -[[image:1744190532730-583.png]]
59 +Если при установке или обновлении установить флажок «Создание ярлыков на рабочем столе», то на рабочем столе появится ярлык «КС СНК АЗС», который будет запускать веб-интерфейс СНК-КС5 (##http:~/~/localhost:8000/##):
27 27  
61 +[[image:1744190595783-589.png||data-xwiki-image-style-alignment="center"]]
28 28  
63 +=== **6.2. На стороне СНК-ПЦ, СНК-Офис, СНК-Офис онлайн** ===
29 29  
65 +(% class="box warningmessage" %)
66 +(((
67 +**Если на ПК с СНК-ПЦ, и СНК-Офис КС5 уже был установлен и настроен для работы с некоторыми ТО, пропустите этот пункт!**
68 +)))
30 30  
70 +Воспользуйтесь мастером установки СНК-КС5:
31 31  
72 +* Закройте все программы СНК-АЗС, СНК-ПЦ, СНК-Офис.
73 +* Запустите установочный файл (##snc_cs_update_5_2_2.exe## или файл с более новой версией).
74 +* Откроется окно мастера установки, нажмите кнопку «**Далее**».
32 32  
76 +[[image:1744190967012-923.png||data-xwiki-image-style-alignment="center"]]
33 33  
34 -= 3. Запуск программы =
78 +* Следующее окно показывает список изменений для текущей версии программы, нажмите кнопку «**Далее**».
35 35  
36 -[[image:1742371119337-637.png||data-xwiki-image-style-text-wrap="true" height="17" width="17"]]Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
80 +[[image:1744191021599-382.png||data-xwiki-image-style-alignment="center"]]
37 37  
38 -= 4. Интерфейс программы =
82 +* В следующем окне выберите, для какой программы нужно установить КС 5 (СНК-ПЦ, СНК-Офис или СНК-Офис онлайн)
83 +* Отметьте флажок установки сервера NATS, если он еще не был установлен.
84 +* После выбора компонентов нажмите кнопку «**Далее**».
39 39  
40 -Программа открывается в браузере и состоит из следующих элементов:
86 +(% class="box infomessage" %)
87 +(((
88 +**ПК, на который устанавливается сервер NATS должен иметь статический IP-адрес!**
41 41  
42 -* **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.
43 -* **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.
44 -* **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами //(на рисунке отмечено цифрой 3)//.
45 -* **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.
90 +Этот адрес нужно указывать при настройке КС во всех программах. Параметр **##nats.host##**
91 +)))
46 46  
47 -[[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]
93 +[[image:1744191487368-234.png||data-xwiki-image-style-alignment="center"]]
48 48  
49 -= 5. Настройка параметров КС 5 =
95 +* Выберите папку для установки СНК-КС и нажмите кнопку «**Далее**».
50 50  
51 -== 5.1. Используя конфигурационный файл ==
97 +[[image:1744191540621-656.png||data-xwiki-image-style-alignment="center"]]
52 52  
99 +== **7. Настройка параметров КС 5** ==
100 +
101 +Указанные параметры настраиваются в каждом установленном КС (например, если используется КС для СНК-АЗС и КС для СНК-Офис, нужно настроить оба КС)
102 +
103 +=== **7.1. Используя конфигурационный файл** ===
104 +
53 53  Параметры настройки КС 5 сохранены в файле **##.\exchange\SncExchServer.cfg##**
54 54  
55 55  Описание параметров:
... ... @@ -65,33 +65,35 @@
65 65  
66 66  **Для изменения параметров** необходимо:
67 67  
68 -* **остановить службу** КС 5, (см. раздел «Службы», п.9).
120 +* **остановить службу** КС 5, (см. раздел «Службы»).
69 69  * **изменить и сохранить параметры** в файле.
70 -* **запустить службу** КС 5, (см. раздел «Службы», п.9).
122 +* **запустить службу** КС 5, (см. раздел «Службы»).
71 71  
72 -== 5.2. Используя веб-интерфейс ==
124 +=== **7.2. Используя веб-интерфейс** ===
73 73  
74 74  Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
75 75  
76 76  * Перейдите на страницу «Настройки», доступные параметры:
77 -** **ID абонента** - код абонента, для которого установлен КС5 (abonent.id в п. 5.1)
78 -** **Глубина хранения входящих пакетов, дней** – сколько дней хранить входящие пакеты (archive.inbox.depth в п. 5.1)
79 -** **Глубина хранения исходящих пакетов, дней** – сколько дней хранить исходящие пакеты (archive.outbox.depth в п. 5.1)
80 -** **Не сохранять пакеты в архив** – отметьте флажок, чтобы не хранить архивы пакетов (archive.packet.disable в п. 5.1)
81 -** **Токен **– значение токена должно совпадать у всех абонентов, участвующих в обмене (auth.token в п. 5.1)
82 -** **Строка подключения** – IP адрес и порт сервера NATS (nats.host в п. 5.1)
83 -** **Таймаут, мс.** – таймаут обращения к серверу NATS (nats.timeout в п. 5.1)
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##)
84 84  * Нажмите кнопку «**Сохранить**» после изменения настроек.
85 85  
86 86  [[image:1742374859311-606.png||data-xwiki-image-style-alignment="center" height="355" width="600"]]
87 87  
88 -= 6. Настройка СНК-АЗС для работы с КС 5 =
140 +== **8. Настройка СНК-АЗС для работы с КС 5** ==
89 89  
90 -== 6.1. Настройка в программе «Бэк-Офис СНК-АЗС» ==
142 +**{{id name="nastr_BO"/}}**
91 91  
144 +=== **8.1. Настройка в программе «Бэк-Офис СНК-АЗС»** ===
145 +
92 92  В «[[Бэк-Офис СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5).
93 93  
94 -**6.1.1. Запуск окна настроек абонентов**
148 +**8.1.1. Запуск окна настроек абонентов**
95 95  
96 96  * Запустите «[[**Бэк-офис СНК-АЗС**>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]».
97 97  * В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
... ... @@ -98,7 +98,7 @@
98 98  
99 99  [[image:1742375086353-686.png||data-xwiki-image-style-alignment="center" height="184" width="500"]]Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
100 100  
101 -**6.1.2. Описание параметров таблицы абонентов**
155 +**8.1.2. Описание параметров таблицы абонентов**
102 102  
103 103  * **Код абонента** – код абонента, с которым производится обмен данными, код нельзя изменить у уже созданного абонента, его можно указать только при создании нового абонента.
104 104  * **Имя **– наименование абонента, не влияет на обмен, используется только для обозначения абонента в «Бэк-офисе».
... ... @@ -105,7 +105,7 @@
105 105  * **Тип данных** – тип передаваемых абоненту данных («СНК-ПЦ» или «СНК-Офис»).
106 106  * **Версия КС** – версия КС, используемая абонентом для обмена данными («КС 4» или «КС 5»).
107 107  
108 -[[image:1742375171694-926.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**6.1.3. Настройка портов для связи «Бэк-Офиса» с КС**
162 +[[image:1742375171694-926.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.3. Настройка портов для связи «Бэк-Офиса» с КС**
109 109  
110 110  * **Порт для КС 4** – порт, по которому «Бэк-офис» связывается с КС 4 (по умолчанию 6000).
111 111  * **Порт для КС 5** – порт, по которому «Бэк-офис» связывается с КС 5 (по умолчанию 8000).
... ... @@ -115,10 +115,10 @@
115 115  (% class="box infomessage" %)
116 116  (((
117 117  **Внимание!**
118 -В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр http.port в файле SncExchServer.cfg, см. п. 5.1).
172 +В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр ##http.port## в файле ##SncExchServer.cfg##).
119 119  )))
120 120  
121 -**6.1.4. Добавление абонента**
175 +**8.1.4. Добавление абонента**
122 122  
123 123  * В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
124 124  
... ... @@ -132,13 +132,13 @@
132 132  
133 133  * Заполните параметры **Имя**, **Тип данных**, **Версия КС** для созданного абонента (см. п. 6.1.2).
134 134  
135 -[[image:1742375454496-878.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**6.1.5. Удаление абонента**
189 +[[image:1742375454496-878.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.5. Удаление абонента**
136 136  
137 137  * Нажмите правую кнопку мыши на строке с абонентом и выберите «**Удалить**»
138 138  
139 139  [[image:1742375709359-919.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
140 140  
141 -== 6.2. Настройка конфигурационного файла СНК-АЗС ==
195 +=== **8.2. Настройка конфигурационного файла СНК-АЗС** ===
142 142  
143 143  Для работы «СНК-АЗС» с КС 5 необходимо настроить параметры в файле## .\SNC_AZS\backofficeapp\**bo_app.snc**##
144 144  
... ... @@ -156,11 +156,11 @@
156 156  * **AutoReceiveData** – автоматический прием полученных в КС данных в «Бэк-Офис» (0 – автоматический прием выключен, **1 - включен**)
157 157  * **AutoSendData** – автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 – всем абонентам, 07:00 – время отправки данных))
158 158  * **SendOpenShift** – передача открытой смены в «СНК-Офис» (0 - не передавать, **1 - передавать**)
159 -* **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1)
213 +* **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port**)
160 160  
161 -= 7. Настройка СНК-Офис для работы с КС 5 =
215 +== **9. Настройка СНК-Офис для работы с КС 5** ==
162 162  
163 -== 7.1. Настройка конфигурационного файла СНК-Офис ==
217 +=== **9.1. Настройка конфигурационного файла СНК-Офис** ===
164 164  
165 165  Для работы «СНК-Офис» с КС 5 необходимо настроить параметры в файле ##.\SNC_OFFICE\**bo_app.ini**##
166 166  
... ... @@ -174,9 +174,9 @@
174 174  
175 175  * **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**)
176 176  * **AutoReceiveData** – автоматический прием полученных в КС данных (0 – автоматический прием выключен, **1 - включен**)
177 -* **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1)
231 +* **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1) (**этот параметр нужно добавить, с номером порта, если его нет**)
178 178  
179 -== 7.2. Настройка формата передачи данных для ТО ==
233 +=== **9.2. Настройка формата передачи данных для ТО** ===
180 180  
181 181  Для каждой ТО необходимо выбрать версию КС, используемую ТО для обмена данными. Для этого:
182 182  
... ... @@ -194,12 +194,14 @@
194 194  
195 195  [[image:1742376080218-224.png||data-xwiki-image-style-alignment="center" height="440" width="350"]]
196 196  
197 -= 8. Настройка СНК-ПЦ для работы с КС 5 =
251 +== **10. Настройка СНК-ПЦ для работы с КС 5** ==
198 198  
199 -В СНК-ПЦ зайдите в меню – «**Настройка**» – «**Конфигурация**».
253 +=== **10.1 Установка КС5 для ПЦ** ===
200 200  
201 -В разделе «**Приписка проекта**» добавьте параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**».
255 +=== В СНК-ПЦ зайдите в меню – «**Настройка**» – «**Конфигурация**». ===
202 202  
257 +В разделе «**Приписка проекта**» добавьте параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**», для этого:
258 +
203 203  [[image:1742376299785-470.png||data-xwiki-image-style-alignment="center" height="333" width="700"]]
204 204  
205 205  * Выберите заголовок проекта в конфигурации.
... ... @@ -216,6 +216,9 @@
216 216  
217 217  * После добавления параметра укажите настройки КС5 в правом окне в строке «**Значение**» в формате ##ipv4:порт## (например ##localhost:8000##).
218 218  * Нажмите кнопку «**Принять**» и перезапустите ПЦ.
275 +
276 +=== **10.2 Установка КС5 для определенной ТО** ===
277 +
219 219  * После перезапуска ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**»
220 220  
221 221  [[image:1742376449142-544.png||data-xwiki-image-style-alignment="center" height="353" width="700"]]
... ... @@ -235,7 +235,7 @@
235 235  
236 236  [[image:1742376578109-329.png||data-xwiki-image-style-alignment="center" height="362" width="500"]]
237 237  
238 -= 9. Службы КС 5 =
297 +== **11. Службы КС 5** ==
239 239  
240 240  Существуют отдельные службы КС 5 для различных продуктов СНК:
241 241  
... ... @@ -245,9 +245,9 @@
245 245  * Для «**СНК-Офис Онлайн**» - «**СНК-ОФИС Онлайн прием КС v5**» (sncexchprocessor)
246 246  * **Служба сервера NATS** – «**СНК-Коммуникационный сервер v5 NATS**» (nats-server)
247 247  
248 -= 10. Описание каталогов обмена =
307 +== **12. Описание каталогов обмена** ==
249 249  
250 -== 10.1. Каталоги обмена КС 5 ==
309 +=== **12.1. Каталоги обмена КС 5** ===
251 251  
252 252  Каталоги обмена КС 5 находятся в папке ##**Data**## и сгруппированы по абонентам. Внутри папки ##**Data**## находится папка с номером абонента, в которой находится папка ##**Packet**##, в которой находятся папки обмена:
253 253  
... ... @@ -259,7 +259,7 @@
259 259  
260 260  [[image:1742374549161-794.png||data-xwiki-image-style-alignment="center"]]
261 261  
262 -== 10.2. Каталоги обмена в программах СНК ==
321 +=== **12.2. Каталоги обмена в программах СНК** ===
263 263  
264 264  Каталоги обмена для «СНК-АЗС» находятся в папке **##SNC_AZS\backofficeapp##**.
265 265  
... ... @@ -272,9 +272,4 @@
272 272  * ##**OCIN_W.err**## – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки
273 273  * ##**OCOUT_W**## – для исходящих пакетов, передаваемых в формате «WIN»
274 274  
275 -
276 -
277 -
278 -
279 -
280 280  
1744190595783-589.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.Admin_super
Размер
... ... @@ -1,0 +1,1 @@
1 +94.2 KB
Содержимое
1744190967012-923.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.Admin_super
Размер
... ... @@ -1,0 +1,1 @@
1 +77.1 KB
Содержимое
1744191021599-382.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.Admin_super
Размер
... ... @@ -1,0 +1,1 @@
1 +53.8 KB
Содержимое
1744191487368-234.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.Admin_super
Размер
... ... @@ -1,0 +1,1 @@
1 +75.8 KB
Содержимое
1744191540621-656.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.Admin_super
Размер
... ... @@ -1,0 +1,1 @@
1 +72.4 KB
Содержимое
1753872619186-150.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.Admin_super
Размер
... ... @@ -1,0 +1,1 @@
1 +6.7 KB
Содержимое