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

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

Управление
- Копировать
Действия
- Экспорт
- Предварительный просмотр
Просмотр

version	line-number	content
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
3.2	48	[[image:1742371332756-574.png\|\|data-xwiki-image-style-alignment="center" height="528" width="700"]]
	49
34.1	50	== 6. Установка СНК-КС-5 ==
23.2	51
34.1	52	=== 6.1. Установка на стороне СНК-АЗС ===
23.2	53
36.1	54	Установка СНК-КС5 выполняется при начальной инсталляции СНК-АЗС или при его обновлении, для этого необходимо в окне выбора продуктов для установки или обновления установить флажок «Коммуникационный сервер v5».
23.2	55	По умолчанию, каталог установки КС5 - ##.\SNC_AZS\exchange##
	56
29.1	57	[[image:1744190452407-288.png\|\|data-xwiki-image-style-alignment="center"]]
23.2	58
29.1	59	Если при установке или обновлении установить флажок «Создание ярлыков на рабочем столе», то на рабочем столе появится ярлык «КС СНК АЗС», который будет запускать веб-интерфейс СНК-КС5 (##http:~/~/localhost:8000/##):
	60
25.3	61	[[image:1744190595783-589.png\|\|data-xwiki-image-style-alignment="center"]]
23.2	62
34.1	63	=== 6.2. На стороне СНК-ПЦ, СНК-Офис, СНК-Офис онлайн ===
23.2	64
36.1	65	(% class="box warningmessage" %)
	66	(((
	67	Если на ПК с СНК-ПЦ, и СНК-Офис КС5 уже был установлен и настроен для работы с некоторыми ТО, пропустите этот пункт!
	68	)))
	69
25.3	70	Воспользуйтесь мастером установки СНК-КС5:
23.2	71
25.3	72	* Закройте все программы СНК-АЗС, СНК-ПЦ, СНК-Офис.
	73	* Запустите установочный файл (##snc_cs_update_5_2_2.exe## или файл с более новой версией).
25.4	74	* Откроется окно мастера установки, нажмите кнопку «Далее».
23.2	75
25.4	76	[[image:1744190967012-923.png\|\|data-xwiki-image-style-alignment="center"]]
23.2	77
25.4	78	* Следующее окно показывает список изменений для текущей версии программы, нажмите кнопку «Далее».
23.2	79
25.4	80	[[image:1744191021599-382.png\|\|data-xwiki-image-style-alignment="center"]]
23.2	81
25.4	82	* В следующем окне выберите, для какой программы нужно установить КС 5 (СНК-ПЦ, СНК-Офис или СНК-Офис онлайн)
	83	* Отметьте флажок установки сервера NATS, если он еще не был установлен.
26.1	84	* После выбора компонентов нажмите кнопку «Далее».
3.2	85
25.4	86	(% class="box infomessage" %)
	87	(((
	88	ПК, на который устанавливается сервер NATS должен иметь статический IP-адрес!
1.1	89
32.1	90	Этот адрес нужно указывать при настройке КС во всех программах. Параметр ##nats.host##
25.4	91	)))
1.1	92
26.1	93	[[image:1744191487368-234.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	94
26.1	95	* Выберите папку для установки СНК-КС и нажмите кнопку «Далее».
1.1	96
26.1	97	[[image:1744191540621-656.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	98
34.1	99	== 7. Настройка параметров КС 5 ==
25.3	100
25.4	101	Указанные параметры настраиваются в каждом установленном КС (например, если используется КС для СНК-АЗС и КС для СНК-Офис, нужно настроить оба КС)
	102
34.1	103	=== 7.1. Используя конфигурационный файл ===
25.3	104
5.2	105	Параметры настройки КС 5 сохранены в файле ##.\exchange\SncExchServer.cfg##
1.1	106
5.2	107	Описание параметров:
1.1	108
5.2	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, мс.
1.1	117
5.2	118	Для изменения параметров необходимо:
1.1	119
32.1	120	* остановить службу КС 5, (см. раздел «Службы»).
5.2	121	* изменить и сохранить параметры в файле.
32.1	122	* запустить службу КС 5, (см. раздел «Службы»).
1.1	123
34.1	124	=== 7.2. Используя веб-интерфейс ===
1.1	125
5.2	126	Воспользуйтесь ярлыком «КС СНК АЗС» на рабочем столе или наберите в браузере ##localhost:8000##
4.2	127
5.2	128	* Перейдите на страницу «Настройки», доступные параметры:
32.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##)
5.2	136	* Нажмите кнопку «Сохранить» после изменения настроек.
	137
6.2	138	[[image:1742374859311-606.png\|\|data-xwiki-image-style-alignment="center" height="355" width="600"]]
5.2	139
34.1	140	== 8. Настройка СНК-АЗС для работы с КС 5 ==
5.2	141
33.1	142	{{id name="nastr_BO"/}}
	143
34.1	144	=== 8.1. Настройка в программе «Бэк-Офис СНК-АЗС» ===
5.2	145
7.2	146	В «[[Бэк-Офис СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5).
5.2	147
25.3	148	8.1.1. Запуск окна настроек абонентов
5.2	149
7.2	150	* Запустите «[[Бэк-офис СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]».
	151	* В строке меню нажмите – «Обработка» - «Обмен данными» - «Настройка списка абонентов».
5.2	152
7.2	153	[[image:1742375086353-686.png\|\|data-xwiki-image-style-alignment="center" height="184" width="500"]]Откроется окно «Абоненты», здесь находится список абонентов, с которыми производится обмен данными.
5.2	154
25.3	155	8.1.2. Описание параметров таблицы абонентов
5.2	156
8.2	157	* Код абонента – код абонента, с которым производится обмен данными, код нельзя изменить у уже созданного абонента, его можно указать только при создании нового абонента.
	158	* Имя – наименование абонента, не влияет на обмен, используется только для обозначения абонента в «Бэк-офисе».
	159	* Тип данных – тип передаваемых абоненту данных («СНК-ПЦ» или «СНК-Офис»).
	160	* Версия КС – версия КС, используемая абонентом для обмена данными («КС 4» или «КС 5»).
5.2	161
25.3	162	[[image:1742375171694-926.png\|\|data-xwiki-image-style-alignment="center" height="291" width="500"]]8.1.3. Настройка портов для связи «Бэк-Офиса» с КС
5.2	163
11.2	164	* Порт для КС 4 – порт, по которому «Бэк-офис» связывается с КС 4 (по умолчанию 6000).
	165	* Порт для КС 5 – порт, по которому «Бэк-офис» связывается с КС 5 (по умолчанию 8000).
5.2	166
11.2	167	Для запуска веб-интерфейса КС 5, можно воспользоваться кнопкой «Открыть КС 5».
5.2	168
11.2	169	(% class="box infomessage" %)
	170	(((
	171	Внимание!
32.1	172	В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр ##http.port## в файле ##SncExchServer.cfg##).
11.2	173	)))
5.2	174
25.3	175	8.1.4. Добавление абонента
5.2	176
11.2	177	* В окне «Абоненты» нажмите правую кнопку мыши в любом свободном месте окна и выберите «Добавить».
5.2	178
11.2	179	[[image:1742375331377-333.png\|\|data-xwiki-image-style-alignment="center" height="291" width="500"]]
5.2	180
11.2	181	* В строке «Добавить абонента» укажите код добавляемого абонента и нажмите кнопку «ОК».
5.2	182
11.2	183	[[image:1742375383319-279.png\|\|data-xwiki-image-style-alignment="center" height="291" width="500"]]
5.2	184
11.2	185	В таблицу будет добавлена новая строка
5.2	186
11.2	187	* Заполните параметры Имя, Тип данных, Версия КС для созданного абонента (см. п. 6.1.2).
5.2	188
25.3	189	[[image:1742375454496-878.png\|\|data-xwiki-image-style-alignment="center" height="291" width="500"]]8.1.5. Удаление абонента
11.2	190
12.2	191	* Нажмите правую кнопку мыши на строке с абонентом и выберите «Удалить»
11.2	192
12.2	193	[[image:1742375709359-919.png\|\|data-xwiki-image-style-alignment="center" height="291" width="500"]]
11.2	194
34.1	195	=== 8.2. Настройка конфигурационного файла СНК-АЗС ===
11.2	196
23.2	197	Для работы «СНК-АЗС» с КС 5 необходимо настроить параметры в файле## .\SNC_AZS\backofficeapp\bo_app.snc##
11.2	198
12.2	199	(% class="box infomessage" %)
	200	(((
	201	Внимание!
	202	Закройте все программы «СНК-АЗС» и «Бэк-Офис» перед внесением изменений!
	203	)))
11.2	204
12.2	205	Описание параметров для настройки работы с КС 5:
11.2	206
12.2	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 - передавать)
32.1	213	* ExchangeSrvPortExt –порт для связи с КС 5 (значение параметра http.port)
11.2	214
34.1	215	== 9. Настройка СНК-Офис для работы с КС 5 ==
11.2	216
34.1	217	=== 9.1. Настройка конфигурационного файла СНК-Офис ===
11.2	218
13.2	219	Для работы «СНК-Офис» с КС 5 необходимо настроить параметры в файле ##.\SNC_OFFICE\bo_app.ini##
11.2	220
13.2	221	(% class="box infomessage" %)
	222	(((
	223	Внимание!
	224	Закройте программу «СНК-Офис» перед внесением изменений!
	225	)))
12.2	226
13.2	227	Описание параметров для настройки работы с КС 5:
12.2	228
13.2	229	* UseExchangeServer – использовать КС для передачи данных (0 - не использовать, 1 - использовать)
	230	* AutoReceiveData – автоматический прием полученных в КС данных (0 – автоматический прием выключен, 1 - включен)
27.1	231	* ExchangeSrvPortExt –порт для связи с КС 5 (значение параметра http.port из п.5.1) (этот параметр нужно добавить, с номером порта, если его нет)
12.2	232
34.1	233	=== 9.2. Настройка формата передачи данных для ТО ===
12.2	234
13.2	235	Для каждой ТО необходимо выбрать версию КС, используемую ТО для обмена данными. Для этого:
12.2	236
13.2	237	* Откройте раздел «Справочники».
	238	* Выберите «Точки обслуживания»
	239	* На нужной ТО нажмите правой кнопкой мыши и выберите «Редактировать»
12.2	240
13.2	241	[[image:1742376031179-997.png\|\|data-xwiki-image-style-alignment="center" height="312" width="600"]]
12.2	242
15.2	243	Откроется окно «Редактирование ТО».
12.2	244
13.2	245	* Перейдите на вкладку «Обмен данными».
	246	* В параметре «Использовать СНК-КС» выберите «КС 5».
	247	* Нажмите кнопку «ОК» для сохранения параметров.
12.2	248
14.2	249	[[image:1742376080218-224.png\|\|data-xwiki-image-style-alignment="center" height="440" width="350"]]
12.2	250
34.1	251	== 10. Настройка СНК-ПЦ для работы с КС 5 ==
12.2	252
35.1	253	=== 10.1 Установка КС5 для ПЦ ===
12.2	254
35.1	255	=== В СНК-ПЦ зайдите в меню – «Настройка» – «Конфигурация». ===
	256
27.1	257	В разделе «Приписка проекта» добавьте параметр «IP-Адрес:порт Коммуникационного Сервера - 5», для этого:
12.2	258
15.2	259	[[image:1742376299785-470.png\|\|data-xwiki-image-style-alignment="center" height="333" width="700"]]
13.2	260
16.2	261	* Выберите заголовок проекта в конфигурации.
	262	* Слева нажмите кнопку «Экспорт». Из выпавшего списка выберите «Импорт выборочных настроек (с пополнением)»
13.2	263
16.2	264	[[image:1742376339853-759.png\|\|data-xwiki-image-style-alignment="center" height="332" width="700"]]
13.2	265
16.2	266	Откроется окно файлового проводника.
13.2	267
16.2	268	* Зайдите в каталог «sncPC» и выберите файл «IP-Адрес и порт КС5»
	269	* Нажмите кнопку «Открыть»
14.2	270
18.2	271	[[image:1742376379869-231.png\|\|data-xwiki-image-style-alignment="center" height="520" width="700"]]
14.2	272
18.2	273	* После добавления параметра укажите настройки КС5 в правом окне в строке «Значение» в формате ##ipv4:порт## (например ##localhost:8000##).
	274	* Нажмите кнопку «Принять» и перезапустите ПЦ.
35.1	275
	276	=== 10.2 Установка КС5 для определенной ТО ===
	277
18.2	278	* После перезапуска ПЦ выберите в меню «Справочники» - «Точки обслуживания»
14.2	279
18.2	280	[[image:1742376449142-544.png\|\|data-xwiki-image-style-alignment="center" height="353" width="700"]]
14.2	281
18.2	282	* Выберите нужную ТО и нажмите кнопку «Ограничения» слева.
14.2	283
19.2	284	[[image:1742376495608-296.png\|\|data-xwiki-image-style-alignment="center" height="327" width="700"]]
14.2	285
19.2	286	* В открывшемся окне выберите строку «Настройка», и нажмите кнопку «Значения».
14.2	287
22.1	288	[[image:1742376541541-400.png\|\|data-xwiki-image-style-alignment="center" height="256" width="700"]]
14.2	289
22.1	290	* В открывшемся окне раскройте раздел «Режим обмена данными», нажав на +.
	291	* Флажок «Обмен СНК-КС ?» должен быть убран.
	292	* Флажок «Обмен СНК-КС 5?» должен быть установлен.
	293	* Нажмите кнопку «Принять»
14.2	294
22.1	295	[[image:1742376578109-329.png\|\|data-xwiki-image-style-alignment="center" height="362" width="500"]]
14.2	296
34.1	297	== 11. Службы КС 5 ==
5.2	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
34.1	307	== 12. Описание каталогов обмена ==
5.2	308
34.1	309	=== 12.1. Каталоги обмена КС 5 ===
5.2	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
34.1	321	=== 12.2. Каталоги обмена в программах СНК ===
5.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
1.1	334

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

Навигация

Оглавление текущей страницы