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

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

Редактировал(а) Руслан Савельев 2025/12/01 05:03
От версии 22.1
отредактировано Руслан Савельев
на 2025/03/19 09:30
Изменить комментарий: К данной версии нет комментариев
К версии 37.1
отредактировано Руслан Савельев
на 2025/11/05 05:25
Изменить комментарий: Загрузить новое вложение 1762320317685-829.png

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -1,257 +1,86 @@
1 -= 1. Назначение =
1 +== **1. Назначение** ==
2 2  
3 3  Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ.
4 4  
5 -= 2. Информация и структурная схема =
5 +== **2. Запуск приложения** ==
6 6  
7 -[[image:1742371332756-574.png||data-xwiki-image-style-alignment="center" height="528" width="700"]]
7 +Для запуска приложения используйте один из вариантов:
8 8  
9 -= 3. Запуск программы =
9 +{{tabs idsToLabels="tabId1=Запуск ярлыка на рабочем столе, tabId2=Через интернет-браузер"/}}
10 10  
11 -[[image:1742371119337-637.png||data-xwiki-image-style-text-wrap="true" height="17" width="17"]]Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
12 -
13 -= 4. Интерфейс программы =
14 -
15 -Программа открывается в браузере и состоит из следующих элементов:
16 -
17 -* **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.
18 -* **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.
19 -* **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами //(на рисунке отмечено цифрой 3)//.
20 -* **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.
21 -
22 -[[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]
23 -
24 -= 5. Настройка параметров КС 5 =
25 -
26 -== 5.1. Используя конфигурационный файл ==
27 -
28 -Параметры настройки КС 5 сохранены в файле **##.\exchange\SncExchServer.cfg##**
29 -
30 -Описание параметров:
31 -
32 -* **abonent.id** – ID абонента (код абонента, для которого установлен КС5)
33 -* **archive.inbox.depth** – Глубина хранения входящих пакетов, дней.
34 -* **archive.outbox.depth** – Глубина хранения исходящих пакетов, дней.
35 -* **archive.packet.disable** – Отключить сохранение пакетов в архив (true), сохранять – false
36 -* **auth.token** – Токен, используется одинаковый токен для всех абонентов.
37 -* **http.port** – Порт для обмена с ПО СНК (Бэк-офис, СНК-Офис, СНК-ПЦ). Этот же порт используется для запуска веб-интерфейса в браузере (порт по умолчанию - 8000)
38 -* **nats.host** – IP адрес и порт сервера NATS. (порт по умолчанию - 7654)
39 -* **nats.timeout** – таймаут обращения к серверу NATS, мс.
40 -
41 -**Для изменения параметров** необходимо:
42 -
43 -* **остановить службу** КС 5, (см. раздел «Службы», п.9).
44 -* **изменить и сохранить параметры** в файле.
45 -* **запустить службу** КС 5, (см. раздел «Службы», п.9).
46 -
47 -== 5.2. Используя веб-интерфейс ==
48 -
49 -Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
50 -
51 -* Перейдите на страницу «Настройки», доступные параметры:
52 -** **ID абонента** - код абонента, для которого установлен КС5 (abonent.id в п. 5.1)
53 -** **Глубина хранения входящих пакетов, дней** – сколько дней хранить входящие пакеты (archive.inbox.depth в п. 5.1)
54 -** **Глубина хранения исходящих пакетов, дней** – сколько дней хранить исходящие пакеты (archive.outbox.depth в п. 5.1)
55 -** **Не сохранять пакеты в архив** – отметьте флажок, чтобы не хранить архивы пакетов (archive.packet.disable в п. 5.1)
56 -** **Токен **– значение токена должно совпадать у всех абонентов, участвующих в обмене (auth.token в п. 5.1)
57 -** **Строка подключения** – IP адрес и порт сервера NATS (nats.host в п. 5.1)
58 -** **Таймаут, мс.** – таймаут обращения к серверу NATS (nats.timeout в п. 5.1)
59 -* Нажмите кнопку «**Сохранить**» после изменения настроек.
60 -
61 -[[image:1742374859311-606.png||data-xwiki-image-style-alignment="center" height="355" width="600"]]
62 -
63 -= 6. Настройка СНК-АЗС для работы с КС 5 =
64 -
65 -== 6.1. Настройка в программе «Бэк-Офис СНК-АЗС» ==
66 -
67 -В «[[Бэк-Офис СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5).
68 -
69 -**6.1.1. Запуск окна настроек абонентов**
70 -
71 -* Запустите «[[**Бэк-офис СНК-АЗС**>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]».
72 -* В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
73 -
74 -[[image:1742375086353-686.png||data-xwiki-image-style-alignment="center" height="184" width="500"]]Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
75 -
76 -**6.1.2. Описание параметров таблицы абонентов**
77 -
78 -* **Код абонента** – код абонента, с которым производится обмен данными, код нельзя изменить у уже созданного абонента, его можно указать только при создании нового абонента.
79 -* **Имя **– наименование абонента, не влияет на обмен, используется только для обозначения абонента в «Бэк-офисе».
80 -* **Тип данных** – тип передаваемых абоненту данных («СНК-ПЦ» или «СНК-Офис»).
81 -* **Версия КС** – версия КС, используемая абонентом для обмена данными («КС 4» или «КС 5»).
82 -
83 -[[image:1742375171694-926.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**6.1.3. Настройка портов для связи «Бэк-Офиса» с КС**
84 -
85 -* **Порт для КС 4** – порт, по которому «Бэк-офис» связывается с КС 4 (по умолчанию 6000).
86 -* **Порт для КС 5** – порт, по которому «Бэк-офис» связывается с КС 5 (по умолчанию 8000).
87 -
88 -Для запуска веб-интерфейса КС 5, можно воспользоваться кнопкой «**Открыть КС 5**».
89 -
90 -(% class="box infomessage" %)
11 +(% id="tabId1" %)
91 91  (((
92 -**Внимание!**
93 -В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр http.port в файле SncExchServer.cfg, см. п. 5.1).
94 -)))
95 -
96 -**6.1.4. Добавление абонента**
97 -
98 -* В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
99 -
100 -[[image:1742375331377-333.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
101 -
102 -* В строке «**Добавить абонента**» укажите код добавляемого абонента и нажмите кнопку «**ОК**».
103 -
104 -[[image:1742375383319-279.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
105 -
106 -В таблицу будет добавлена новая строка
107 -
108 -* Заполните параметры **Имя**, **Тип данных**, **Версия КС** для созданного абонента (см. п. 6.1.2).
109 -
110 -[[image:1742375454496-878.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**6.1.5. Удаление абонента**
111 -
112 -* Нажмите правую кнопку мыши на строке с абонентом и выберите «**Удалить**»
113 -
114 -[[image:1742375709359-919.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
115 -
116 -== 6.2. Настройка конфигурационного файла СНК-АЗС ==
117 -
118 -Для работы «СНК-АЗС» с КС 5 необходимо настроить параметры в файле## .\SNC_AZS\backofficeapp\**bo_app.snc**##
119 -
120 -(% class="box infomessage" %)
13 +(% class="box" %)
121 121  (((
122 -**Внимание!**
123 -Закройте все программы «СНК-АЗС» и «Бэк-Офис» перед внесением изменений!
15 +[[image:1753872619186-150.png||data-xwiki-image-style-alignment="start"]]
124 124  )))
17 +)))
125 125  
126 -Описание параметров для настройки работы с КС 5:
127 -
128 -* **TransactionOnOpenShift** – передавать данные по текущей открытой смене (0 - не передавать, **1 - передавать**)
129 -* **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**)
130 -* **ExchangeList** – список абонентов с которыми обменивается СНК-АЗС и формат данных для обмена, заполняется автоматически, при настройке абонентов в «Бэк-Офисе» (см. п. 6.1)
131 -* **AutoReceiveData** – автоматический прием полученных в КС данных в «Бэк-Офис» (0 – автоматический прием выключен, **1 - включен**)
132 -* **AutoSendData** – автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 – всем абонентам, 07:00 – время отправки данных))
133 -* **SendOpenShift** – передача открытой смены в «СНК-Офис» (0 - не передавать, **1 - передавать**)
134 -* **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1)
135 -
136 -= 7. Настройка СНК-Офис для работы с КС 5 =
137 -
138 -== 7.1. Настройка конфигурационного файла СНК-Офис ==
139 -
140 -Для работы «СНК-Офис» с КС 5 необходимо настроить параметры в файле ##.\SNC_OFFICE\**bo_app.ini**##
141 -
142 -(% class="box infomessage" %)
19 +(% id="tabId2" %)
143 143  (((
144 -**Внимание!**
145 -Закройте программу «СНК-Офис» перед внесением изменений!
21 +(% class="box" %)
22 +(((
23 +Наберите в браузере ##**localhost:8000**## //(указан порт по-умолчанию)//
146 146  )))
25 +)))
147 147  
148 -Описание параметров для настройки работы с КС 5:
27 +== **3. Интерфейс программы** ==
149 149  
150 -* **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**)
151 -* **AutoReceiveData** – автоматический прием полученных в КС данных (0 – автоматический прием выключен, **1 - включен**)
152 -* **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1)
29 +Программа открывается в браузере и состоит из следующих элементов:
153 153  
154 -== 7.2. Настройка формата передачи данных для ТО ==
31 +* **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.
32 +* **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.
33 +* **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами и вкладка настроек //(на рисунке отмечено цифрой 3)//.
34 +* **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.
155 155  
156 -Для каждой ТО необходимо выбрать версию КС, используемую ТО для обмена данными. Для этого:
36 +[[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]
157 157  
158 -* Откройте раздел «**Справочники**».
159 -* Выберите «**Точки обслуживания**»
160 -* На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»
38 +== **4. Требования к ПО** ==
161 161  
162 -[[image:1742376031179-997.png||data-xwiki-image-style-alignment="center" height="312" width="600"]]
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]]»
163 163  
164 -Откроется окно «**Редактирование ТО**».
46 +== **5. Общая информация** ==
165 165  
166 -* Перейдите на вкладку «**Обмен данными**».
167 -* В параметре «**Использовать СНК-КС**» выберите «**КС 5**».
168 -* Нажмите кнопку «**ОК**» для сохранения параметров.
48 +Для обеспечения обмена точек обслуживания с инфраструктурой Офиса (СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн) при помощи СНК-КС5, необходимо соблюсти применение следующих пунктов:
169 169  
170 -[[image:1742376080218-224.png||data-xwiki-image-style-alignment="center" height="440" width="350"]]
50 +* Установленный сервер NATS для СНК-КС5 в инфраструктуре Офиса – данное приложение будет отвечать за коммуникацию между всеми экземплярами СНК-КС5
51 +* Отдельные экземпляры СНК-КС5 для каждой ТО
52 +* Отдельные экземпляры СНК-КС5 для каждого из следующих приложений - СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн
171 171  
172 -= 8. Настройка СНК-ПЦ для работы с КС 5 =
54 +Ниже приведена схема взаимодействия всех экземпляров СНК-КС5 и сервера NATS:
173 173  
174 -В СНК-ПЦ зайдите в меню – «**Настройка**» – «**Конфигурация**».
175 175  
176 -В разделе «**Приписка проекта**» добавьте параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**».
177 177  
178 -[[image:1742376299785-470.png||data-xwiki-image-style-alignment="center" height="333" width="700"]]
179 179  
180 -* Выберите заголовок проекта в конфигурации.
181 -* Слева нажмите кнопку «**Экспорт**». Из выпавшего списка выберите «Импорт выборочных настроек (с пополнением)»
182 182  
183 -[[image:1742376339853-759.png||data-xwiki-image-style-alignment="center" height="332" width="700"]]
184 184  
185 -Откроется окно файлового проводника.
186 186  
187 -* Зайдите в каталог «**sncPC**» и выберите файл «**IP-Адрес и порт КС5**»
188 -* Нажмите кнопку «**Открыть**»
189 189  
190 -[[image:1742376379869-231.png||data-xwiki-image-style-alignment="center" height="520" width="700"]]
191 191  
192 -* После добавления параметра укажите настройки КС5 в правом окне в строке «**Значение**» в формате ##ipv4:порт## (например ##localhost:8000##).
193 -* Нажмите кнопку «**Принять**» и перезапустите ПЦ.
194 -* После перезапуска ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**»
195 195  
196 -[[image:1742376449142-544.png||data-xwiki-image-style-alignment="center" height="353" width="700"]]
197 197  
198 -* Выберите нужную ТО и нажмите кнопку «**Ограничения**» слева.
199 199  
200 -[[image:1742376495608-296.png||data-xwiki-image-style-alignment="center" height="327" width="700"]]
201 201  
202 -* В открывшемся окне выберите строку «**Настройка**», и нажмите кнопку «**Значения**».
203 203  
204 -[[image:1742376541541-400.png||data-xwiki-image-style-alignment="center" height="256" width="700"]]
205 205  
206 -* В открывшемся окне раскройте раздел «Режим обмена данными», нажав на **+**.
207 -* Флажок «**Обмен СНК-КС ?**» должен быть **убран**.
208 -* Флажок «**Обмен СНК-КС 5?**» должен быть **установлен**.
209 -* Нажмите кнопку «**Принять**»
210 210  
211 -[[image:1742376578109-329.png||data-xwiki-image-style-alignment="center" height="362" width="500"]]
212 212  
213 -= 9. Службы КС 5 =
214 214  
215 -Существуют отдельные службы КС 5 для различных продуктов СНК:
216 216  
217 -* Для «**СНК-АЗС**» - «**СНК-Коммуникационный сервер v5**» (sncexchservice)
218 -* Для «**СНК-Офис**» - «**СНК-Коммуникационный сервер v5 СНК-ОФИС**» (sncexchservice.1000)
219 -* Для «**СНК-ПЦ**» - «**СНК-Коммуникационный сервер v5 СНК-ПЦ**» (sncexchservice.500)
220 -* Для «**СНК-Офис Онлайн**» - «**СНК-ОФИС Онлайн прием КС v5**» (sncexchprocessor)
221 -* **Служба сервера NATS** – «**СНК-Коммуникационный сервер v5 NATS**» (nats-server)
222 222  
223 223  
224 -= 10. Описание каталогов обмена =
225 225  
226 -== 10.1. Каталоги обмена КС 5 ==
227 227  
228 -Каталоги обмена КС 5 находятся в папке ##**Data**## и сгруппированы по абонентам. Внутри папки ##**Data**## находится папка с номером абонента, в которой находится папка ##**Packet**##, в которой находятся папки обмена:
229 229  
230 -* ##**Cache**## – для работы с принимаемым в данный момент пакетом.
231 -* ##**Inbox**## – для входящих пакетов, которые еще не приняты программами СНК.
232 -* ##**InboxArchive**## – архив входящих пакетов, сюда перемещаются пакеты из папки Inbox после их принятия в программу СНК.
233 -* ##**Outbox**## – для отправляемых в настоящее время пакетов.
234 -* ##**OutboxArchive**## – архив исходящих пакетов, сюда перемещаются пакеты из папки Outbox после их отправки другому абоненту.
235 235  
236 -[[image:1742374549161-794.png||data-xwiki-image-style-alignment="center"]]
237 237  
238 -== 10.2. Каталоги обмена в программах СНК ==
239 239  
240 -Каталоги обмена для «СНК-АЗС» находятся в папке **##SNC_AZS\backofficeapp##**.
241 241  
242 -Каталоги обмена для «СНК-Офис» находятся в папке **##SNC_OFFICE##**.
243 243  
244 -Описание каталогов:
245 245  
246 -* ##**OCIN**## – для входящих пакетов
247 -* ##**OCIN_W**## – для входящих пакетов, переданных в формате «WIN»
248 -* ##**OCIN_W.err**## – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки
249 -* ##**OCOUT_W**## – для исходящих пакетов, передаваемых в формате «WIN»
250 250  
251 -
252 -
253 -
254 -
255 -
256 -
257 257  
1744190452407-288.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.Admin_super
Размер
... ... @@ -1,0 +1,1 @@
1 +95.7 KB
Содержимое
1744190532730-583.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.Admin_super
Размер
... ... @@ -1,0 +1,1 @@
1 +239.9 KB
Содержимое
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
Содержимое
1762320317685-829.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.Admin_super
Размер
... ... @@ -1,0 +1,1 @@
1 +258.9 KB
Содержимое