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

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

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

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
36.3	48	Для обеспечения обмена точек обслуживания с инфраструктурой Офиса (СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн) при помощи СНК-КС5, необходимо соблюсти применение следующих пунктов:
3.2	49
36.3	50	* Установленный сервер NATS для СНК-КС5 в инфраструктуре Офиса – данное приложение будет отвечать за коммуникацию между всеми экземплярами СНК-КС5
	51	* Отдельные экземпляры СНК-КС5 для каждой ТО
	52	* Отдельные экземпляры СНК-КС5 для каждого из следующих приложений - СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн
23.2	53
36.3	54	Ниже приведена схема взаимодействия всех экземпляров СНК-КС5 и сервера NATS:
23.2	55
48.2	56	[[Схема работы СНК-КС5>>image:1762320317685-829.png\|\|data-xwiki-image-style-alignment="center" height="610" width="800"]]
23.2	57
38.2	58	== 6. Установка СНК-КС5 в инфраструктуре Офиса ==
23.2	59
38.2	60	Настройка СНК-КС5 начинается на сервере, где установлены СНК-Офис и/или СНК-ПЦ. Необходимо установить сервер NATS и отдельные экземпляры СНК-КС5 для СНК-Офис и СНК-ПЦ.
29.1	61
38.2	62	Для установки СНК-КС5 на стороне Офиса:
23.2	63
38.2	64	* Запустите установочный файл snc_cs_update_5_4_0.exe (или файл с более новой версией).
	65	* Нажмите «Далее» на экранах мастера установки и списка изменений.
23.2	66
39.2	67	[[Окна начала установки и списка изменений>>image:1762320469682-529.png\|\|data-xwiki-image-style-alignment="center" height="317" width="800"]]
36.1	68
38.3	69	* На экране выбора компонентов выберите, для какой программы нужно установить СНК-КС5.
	70	* Установите флажок установки сервера NATS, если он не был установлен ранее.
	71	* На следующем экране выберите папку для установки СНК-КС и нажмите «Далее».
23.2	72
39.2	73	[[Название>>image:1762320855644-985.png\|\|data-xwiki-image-style-alignment="center" height="317" width="800"]]
23.2	74
39.2	75	* Дождитесь завершения установки и нажмите «Готово».
23.2	76
39.2	77	(% class="box infomessage" %)
	78	(((
39.3	79	Примечание!
39.2	80	Если необходимо установить СНК-КС5 еще и для другого приложения (например «СНК-ПЦ»), то повторите действия по установке, выбрав установку СНК-КС5 для нужного приложения. Флажок «Установка сервера NATS» при повторной установке отмечать не нужно.
	81	)))
23.2	82
39.3	83	== 7. Первоначальная настройка работы СНК-КС5 с СНК-Офис ==
23.2	84
39.3	85	=== 7.1. Настройка конфигурационного файла СНК-КС5 ===
3.2	86
39.3	87	(% class="box warningmessage" %)
	88	(((
	89	Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.
	90	)))
1.1	91
39.4	92	* Остановите службу «СНК-Коммуникационный сервер v5 СНК-ОФИС»
	93	* Откройте файл ##.\SNC_OFFICE\exchange\SncExchServer.cfg##
	94	* Измените значения параметров:
1.1	95
39.5	96	\|(% style="background-color:lightgray" %)Имя параметра\|(% style="background-color:lightgray" %)Описание значения параметра
39.7	97	\|(%%)(% style="background-color:#f1c40f" %)##abonent.id##\|Номер абонента СНК-Офис в сети СНК-КС5
39.5	98	\|##archive.inbox.depth##\|Хранение входящих пакетов, дней
	99	\|##archive.outbox.depth##\|Хранение исходящих пакетов, дней
	100	\|##archive.packet.disable##\|(((
39.4	101	Сохранение пакетов обмена в архив:
1.1	102
39.4	103	* true – НЕ сохранять
	104	* false – сохранять
	105	)))
39.5	106	\|##log.depth##\|Хранение логов СНК-КС5, дней
39.7	107	\|(%%)(% style="background-color:#3498db" %)##auth.token##\|Общий токен сети (одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ)
44.2	108	\|(%%)(% style="background-color:#2ecc71" %)##http.port##\|Порт для связи с СНК-Офис (по умолчанию: 8000) *
39.5	109	\|##nats.host##\|IP и порт сервера NATS (порт по умолчанию: 7654)
	110	\|##nats.timeout##\|Таймаут обращения к серверу NATS, мс
1.1	111
39.5	112	* Сохраните изменения в файле и запустите службу «СНК-Коммуникационный сервер v5 СНК-ОФИС»
1.1	113
39.8	114	(% class="box infomessage" %)
	115	(((
	116	*~ Примечание!**
	117	Если на одном ПК запущены СНК-Офис и СНК-ПЦ одновременно, используйте разные порты для каждого экземпляра СНК-КС5, например, для СНК-КС5, который используется для СНК- Офис используйте порт 8000, а для СНК-КС5, который используется для СНК-ПЦ используйте порт 8001
	118	)))
	119
39.6	120	=== 7.2. Настройка конфигурационного файла СНК-Офис ===
25.3	121
39.6	122	(% class="box warningmessage" %)
	123	(((
	124	Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.
	125	)))
25.4	126
39.6	127	* Закройте приложение «СНК-Офис»
	128	* Откройте файл ##.\SNC_OFFICE\bo_app.ini##
	129	* Измените значения параметров:
25.3	130
39.6	131	\|(% style="background-color:lightgray" %)Имя параметра\|(% style="background-color:lightgray" %)Описание значения параметра
	132	\|##UseExchangeServer##\|1 – использовать КС для приема и передачи пакетов
	133	\|##AutoReceiveData##\|1 – автоматический прием пакетов из КС в СНК-Офис
39.7	134	\|##ExchangeSrvPortExt##\|Порт для связи с СНК-КС5 ((% style="background-color:#2ecc71" %)##http.port##(%%)## ##в файле настроек КС5)
1.1	135
39.7	136	* Сохраните изменения в файле
1.1	137
39.9	138	== 8. Настройка СНК-Офис для передачи данных на ТО через СНК-КС5 ==
1.1	139
39.10	140	(% class="box warningmessage" %)
	141	(((
	142	Эта настройка выполняется для каждой ТО, которая будет использовать СНК-КС5 для обмена данными с СНК-Офис.
	143	)))
1.1	144
41.2	145	* Запустите «СНК-Офис»
	146	* Откройте раздел «Справочники» и выберите «Точки обслуживания»
	147	* На нужной ТО нажмите правой кнопкой мыши и выберите «Редактировать»
1.1	148
41.2	149	[[Вход в настройки карточки ТО>>image:1762321795143-494.png\|\|data-xwiki-image-style-alignment="center" height="461" width="700"]]
1.1	150
41.2	151	* Откроется окно «Редактирование ТО»
	152	* Перейдите на вкладку «Обмен данными»
	153	* В параметре «Использовать СНК-КС» выберите «КС 5»
	154	* Нажмите кнопку «ОК» для сохранения параметров
4.2	155
42.2	156	[[Параметры обмена с выбранной ТО>>image:1762321849558-674.png\|\|data-xwiki-image-style-alignment="center" height="499" width="400"]]
5.2	157
42.2	158	== 9. Установка и обновление СНК-КС5 на ТО ==
5.2	159
42.2	160	Установка и обновление СНК-КС5 на ТО выполняется при обновлении версии СНК-АЗС. Если СНК-КС5 не был установлен, то будет выполнена установка, если установка была произведена ранее, то СНК-КС5 будет обновлен до той версии, которая содержится в файле обновления.
5.2	161
42.2	162	Для установки или обновления СНК-КС5 на стороне ТО:
37.2	163
42.2	164	* Закройте все приложения СНК-АЗС (включая Бэк-Офис)
	165	* Запустите файл обновления snc_azs_update_1_75_14.exe (пример названия файла)
	166	* На экране выбора компонентов отметьте флажок «Коммуникационный сервер v5» и нажмите «Далее»
37.2	167
42.2	168	Дождитесь завершения обновления и нажмите «Готово»
37.2	169
42.3	170	[[Установка или обновление СНК-КС5>>image:1762321928267-778.png\|\|data-xwiki-image-style-alignment="center" height="394" width="500"]]
37.2	171
42.3	172	== 10. Настройка СНК-АЗС для работы через СНК-КС5 ==
37.2	173
42.3	174	=== 10.1. Настройка конфигурационного файла СНК-АЗС ===
37.2	175
42.3	176	* Закройте все приложения СНК-АЗС (включая Бэк-Офис)
	177	* Откройте файл ##.\SNC_AZS\backofficeapp\bo_app.snc##
	178	* Измените значения параметров:
37.2	179
43.1	180	\|(% style="background-color:lightgray" %)Имя параметра\|(% style="background-color:lightgray" %)Описание значения параметра
	181	\|##UseExchangeServer##\|1 – использовать КС для приема и передачи пакетов
	182	\|##SendOpenShift##\|1 – передавать текущую открытую смену
	183	\|##TransactionOnOpenShift##\|1 – передавать данные по открытой смене
	184	\|##ExchangeList##\|Список абонентов, с которыми обменивается СНК-АЗС и формат данных для обмена, заполняется автоматически
	185	\|##AutoSendData##\|(((
42.3	186	Автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 означает - всем абонентам, 07:00 – время отправки данных))
37.2	187
42.3	188	(Также, автоматическую отправку данных можно настроить через «Планировщик заданий» Windows)
	189	)))
43.1	190	\|##AutoReceiveData##\|1 – автоматический прием пакетов из КС в СНК-АЗС
	191	\|##ExchangeSrvPortExt##\|Порт для связи с СНК-КС5 (http.port в файле настроек КС5)
37.2	192
43.1	193	* Сохраните изменения в файле
37.2	194
44.2	195	=== 10.2. Настройка в программе «Бэк-Офис СНК-АЗС» ===
37.2	196
44.2	197	В «Бэк-Офис СНК-АЗС» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5), а также настроить параметры работы СНК-КС5.
37.2	198
44.2	199	* Запустите «Бэк-офис СНК-АЗС».
	200	* В строке меню нажмите – «Обработка» - «Обмен данными» - «Настройка списка абонентов».
37.2	201
44.2	202	[[ Запуск окна настроек абонентов>>image:1762322131024-259.png\|\|data-xwiki-image-style-alignment="center" height="216" width="550"]]
37.2	203
44.2	204	* Откроется окно «Абоненты», здесь находится список абонентов, с которыми производится обмен данными.
	205	* Первоначально в списке абонентов заведен абонент для примера, удалите его. Для этого нажмите правой кнопкой мыши на строке абонента и выберите «Удалить»
	206	* В окне «Абоненты» нажмите правую кнопку мыши в любом свободном месте окна и выберите «Добавить».
37.2	207
46.2	208	[[Добавление абонента>>image:1762322184400-657.png\|\|data-xwiki-image-style-alignment="center" height="360" width="600"]]
37.2	209
46.2	210	* В строке «Добавить абонента» укажите код добавляемого абонента, например, код абонента «СНК-Офис» ((% style="background-color:#f1c40f" %)abonent.id(%%) в файле настроек КС5) и нажмите кнопку «ОК».
37.2	211
47.2	212	[[Окно ввода кода абонента>>image:1762322283984-102.png\|\|data-xwiki-image-style-alignment="center" height="360" width="600"]]
37.2	213
47.2	214	* Заполните значения параметров:
37.2	215
47.2	216	\|(% style="background-color:lightgray" %)Имя параметра\|(% style="background-color:lightgray" %)Описание значения параметра
48.1	217	\|Код абонента\|(((
47.2	218	Код абонента, с которым производится обмен данными.
37.2	219
47.2	220	Может быть указан только при создании абонента.
	221	)))
48.1	222	\|Имя\|Имя абонента, параметр используется только для обозначения абонента, можно вписать любое удобное имя.
	223	\|Тип данных\|СНК-ПЦ или СНК-Офис тип передаваемых абоненту данных
	224	\|Версия КС\|КС 5 - версия КС, используемая абонентом для обмена данными.
37.2	225
48.1	226	[[Список абонентов>>image:1762322380071-667.png\|\|data-xwiki-image-style-alignment="center" height="360" width="600"]]
37.2	227
48.1	228	* Аналогично создайте абонента для передачи данных в «СНК-ПЦ» при необходимости.
37.2	229
48.1	230	Теперь, когда абоненты созданы, необходимо настроить СНК-КС5 для корректной работы в сети обмена с сервером NATS, для этого:
37.2	231
48.1	232	* В окне «Абоненты» нажмите на кнопку «Открыть КС 5».
	233	* Откроется окно веб-интерфейса «СНК-КС5», перейдите в нем на вкладку «Настройки»
	234	* Измените значения параметров:
37.2	235
48.1	236	\|(% style="background-color:lightgray" %)Имя параметра\|(% style="background-color:lightgray" %)Описание значения параметра
	237	\|ID абонента\|Номер ТО
	238	\|Глубина хранения входящих пакетов, дней\|Хранение входящих пакетов, дней
	239	\|Глубина хранения исходящих пакетов, дней\|Хранение исходящих пакетов, дней
	240	\|Не сохранять пакеты в архив\|(((
	241	Сохранение пакетов обмена в архив:
37.2	242
48.1	243	* Флажок установлен – НЕ сохранять архивные пакеты
	244	* Флажок не установлен – сохранять архивные пакеты
	245	)))
48.3	246	\|Токен\|Общий токен сети, одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ, укажите значение (% style="background-color:#3498db" %)auth.token (%%) из файла настроек КС5
48.1	247	\|Строка подключения\|IP и порт сервера NATS (порт по умолчанию: 7654)
	248	\|Таймаут, мс.\|Таймаут обращения к серверу NATS, мс
37.2	249
48.1	250	* Сохраните изменения, нажав на кнопку «Сохранить»
38.2	251
48.1	252	(% class="box infomessage" %)
	253	(((
	254	Примечание!
	255	Если окно веб-интерфейса «СНК-КС5» не отображается в браузере, то проверьте, что служба «СНК-Коммуникационный сервер v5» запущена.
	256	)))
39.4	257
49.2	258	== 11. Первоначальная настройка работы СНК-КС5 с СНК-ПЦ ==
42.2	259
49.2	260	Для работы СНК-КС5 с СНК-ПЦ необходимо выполнить следующие действия:
42.2	261
49.2	262	* Установить отдельный экземпляр СНК-КС5 для СНК-ПЦ (аналогично как в п. 6)
	263	* Настроить конфигурационный файл СНК-КС5 (аналогично как в п. 7.1)
	264	* Установить поддержку СНК-КС5 для СНК-ПЦ
	265	* Настроить передачу данных определенной ТО в СНК-ПЦ через СНК-КС5
42.2	266
42.3	267
	268
49.2	269	Для установки поддержки СНК-КС5 в СНК-ПЦ выполните следующие действия:
43.1	270
49.2	271	* В СНК-ПЦ зайдите в меню – «Настройка» – «Конфигурация».
	272	* Выберите заголовок проекта в конфигурации.
	273	* Слева нажмите кнопку «Экспорт». Из выпавшего списка выберите «Импорт выборочных настроек (с пополнением)».
43.1	274
50.2	275	[[Меню импорта параметров>>image:1762328224115-730.png\|\|data-xwiki-image-style-alignment="center" height="388" width="800"]]
43.1	276
50.2	277	* Откроется окно файлового проводника.
	278	* Зайдите в каталог sncPC и выберите файл IP-Адрес и порт КС5
	279	* Нажмите кнопку «Открыть»
43.1	280
50.2	281	[[Открытие файла с параметрами>>image:1762328290990-746.png\|\|data-xwiki-image-style-alignment="center" height="449" width="800"]]
43.1	282
50.2	283	* В разделе «Приписка проекта» появится параметр «IP-Адрес:порт Коммуникационного Сервера - 5», отметьте его флажком.
	284	* Выберите этот параметр и укажите настройки КС5 в правом окне, в строке «Значение» в формате ipv4: порт (например localhost:8000), где
	285	** ipv4 – адрес ПК на котором установлен экземпляр СНК-КС5 для СНК-ПЦ
	286	** порт – порт, который использует СНК-ПЦ для связи с СНК-КС5
43.1	287
51.3	288	[[Настройка параметров связи СНК-ПЦ с СНК-КС5>>image:1762328347603-678.png\|\|data-xwiki-image-style-alignment="center" height="389" width="800"]]
43.1	289
51.3	290	== 12. Настройка СНК-ПЦ для передачи данных на ТО через СНК-КС5 ==
43.1	291
51.3	292	(% class="box warningmessage" %)
	293	(((
	294	Эта настройка выполняется для каждой ТО, которая будет использовать СНК-КС5 для обмена данными с СНК-ПЦ.
	295	)))
43.1	296
51.3	297	* В СНК-ПЦ выберите в меню «Справочники» - «Точки обслуживания»
43.1	298
	299
	300
	301
	302
	303
	304
	305
	306
	307
	308
	309
	310
47.2	311
48.1	312
	313
	314
	315
49.2	316
	317
	318
	319
50.2	320
51.3	321
1.1	322

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

Навигация

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