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

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

Версия 12.2 от Руслан Савельев на 2025/03/19 09:17
Скрыть последних авторов
Руслан Савельев 4.2 1 = 1. Назначение =
Руслан Савельев 1.1 2
Руслан Савельев 2.2 3 Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ.
Руслан Савельев 1.1 4
Руслан Савельев 4.2 5 = 2. Информация и структурная схема =
Руслан Савельев 1.1 6
Руслан Савельев 3.2 7 [[image:1742371332756-574.png||data-xwiki-image-style-alignment="center" height="528" width="700"]]
8
Руслан Савельев 4.2 9 = 3. Запуск программы =
Руслан Савельев 3.2 10
Руслан Савельев 2.2 11 [[image:1742371119337-637.png||data-xwiki-image-style-text-wrap="true" height="17" width="17"]]Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
Руслан Савельев 1.1 12
Руслан Савельев 4.2 13 = 4. Интерфейс программы =
Руслан Савельев 1.1 14
Руслан Савельев 4.2 15 Программа открывается в браузере и состоит из следующих элементов:
Руслан Савельев 1.1 16
Руслан Савельев 4.2 17 * **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.
18 * **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.
19 * **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами //(на рисунке отмечено цифрой 3)//.
20 * **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.
Руслан Савельев 1.1 21
Руслан Савельев 4.2 22 [[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]
Руслан Савельев 1.1 23
Руслан Савельев 4.2 24 = 5. Настройка параметров КС 5 =
Руслан Савельев 1.1 25
Руслан Савельев 5.2 26 == 5.1. Используя конфигурационный файл ==
Руслан Савельев 1.1 27
Руслан Савельев 5.2 28 Параметры настройки КС 5 сохранены в файле **##.\exchange\SncExchServer.cfg##**
Руслан Савельев 1.1 29
Руслан Савельев 5.2 30 Описание параметров:
Руслан Савельев 1.1 31
Руслан Савельев 5.2 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, мс.
Руслан Савельев 1.1 40
Руслан Савельев 5.2 41 **Для изменения параметров** необходимо:
Руслан Савельев 1.1 42
Руслан Савельев 5.2 43 * **остановить службу** КС 5, (см. раздел «Службы», п.9).
44 * **изменить и сохранить параметры** в файле.
45 * **запустить службу** КС 5, (см. раздел «Службы», п.9).
Руслан Савельев 1.1 46
Руслан Савельев 5.2 47 == 5.2. Используя веб-интерфейс ==
Руслан Савельев 1.1 48
Руслан Савельев 5.2 49 Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**##
Руслан Савельев 4.2 50
Руслан Савельев 5.2 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
Руслан Савельев 6.2 61 [[image:1742374859311-606.png||data-xwiki-image-style-alignment="center" height="355" width="600"]]
Руслан Савельев 5.2 62
Руслан Савельев 7.2 63 = 6. Настройка СНК-АЗС для работы с КС 5 =
Руслан Савельев 5.2 64
Руслан Савельев 7.2 65 == 6.1. Настройка в программе «Бэк-Офис СНК-АЗС» ==
Руслан Савельев 5.2 66
Руслан Савельев 7.2 67 В «[[Бэк-Офис СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5).
Руслан Савельев 5.2 68
Руслан Савельев 7.2 69 **6.1.1. Запуск окна настроек абонентов**
Руслан Савельев 5.2 70
Руслан Савельев 7.2 71 * Запустите «[[**Бэк-офис СНК-АЗС**>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]».
72 * В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.
Руслан Савельев 5.2 73
Руслан Савельев 7.2 74 [[image:1742375086353-686.png||data-xwiki-image-style-alignment="center" height="184" width="500"]]Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.
Руслан Савельев 5.2 75
Руслан Савельев 7.2 76 **6.1.2. Описание параметров таблицы абонентов**
Руслан Савельев 5.2 77
Руслан Савельев 8.2 78 * **Код абонента** – код абонента, с которым производится обмен данными, код нельзя изменить у уже созданного абонента, его можно указать только при создании нового абонента.
79 * **Имя **– наименование абонента, не влияет на обмен, используется только для обозначения абонента в «Бэк-офисе».
80 * **Тип данных** – тип передаваемых абоненту данных («СНК-ПЦ» или «СНК-Офис»).
81 * **Версия КС** – версия КС, используемая абонентом для обмена данными («КС 4» или «КС 5»).
Руслан Савельев 5.2 82
Руслан Савельев 11.2 83 [[image:1742375171694-926.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**6.1.3. Настройка портов для связи «Бэк-Офиса» с КС**
Руслан Савельев 5.2 84
Руслан Савельев 11.2 85 * **Порт для КС 4** – порт, по которому «Бэк-офис» связывается с КС 4 (по умолчанию 6000).
86 * **Порт для КС 5** – порт, по которому «Бэк-офис» связывается с КС 5 (по умолчанию 8000).
Руслан Савельев 5.2 87
Руслан Савельев 11.2 88 Для запуска веб-интерфейса КС 5, можно воспользоваться кнопкой «**Открыть КС 5**».
Руслан Савельев 5.2 89
Руслан Савельев 11.2 90 (% class="box infomessage" %)
91 (((
92 **Внимание!**
93 В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр http.port в файле SncExchServer.cfg, см. п. 5.1).
94 )))
Руслан Савельев 5.2 95
Руслан Савельев 11.2 96 **6.1.4. Добавление абонента**
Руслан Савельев 5.2 97
Руслан Савельев 11.2 98 * В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».
Руслан Савельев 5.2 99
Руслан Савельев 11.2 100 [[image:1742375331377-333.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
Руслан Савельев 5.2 101
Руслан Савельев 11.2 102 * В строке «**Добавить абонента**» укажите код добавляемого абонента и нажмите кнопку «**ОК**».
Руслан Савельев 5.2 103
Руслан Савельев 11.2 104 [[image:1742375383319-279.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
Руслан Савельев 5.2 105
Руслан Савельев 11.2 106 В таблицу будет добавлена новая строка
Руслан Савельев 5.2 107
Руслан Савельев 11.2 108 * Заполните параметры **Имя**, **Тип данных**, **Версия КС** для созданного абонента (см. п. 6.1.2).
Руслан Савельев 5.2 109
Руслан Савельев 12.2 110 [[image:1742375454496-878.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**6.1.5. Удаление абонента**
Руслан Савельев 11.2 111
Руслан Савельев 12.2 112 * Нажмите правую кнопку мыши на строке с абонентом и выберите «**Удалить**»
Руслан Савельев 11.2 113
Руслан Савельев 12.2 114 [[image:1742375709359-919.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]
Руслан Савельев 11.2 115
Руслан Савельев 12.2 116 == 6.2. Настройка конфигурационного файла СНК-АЗС ==
Руслан Савельев 11.2 117
Руслан Савельев 12.2 118 Для работы «СНК-АЗС» с КС 5 необходимо настроить параметры в файле## .\SNC_AZS\backofficeapp\**bo_app.snc**##
Руслан Савельев 11.2 119
Руслан Савельев 12.2 120 (% class="box infomessage" %)
121 (((
122 **Внимание!**
123 Закройте все программы «СНК-АЗС» и «Бэк-Офис» перед внесением изменений!
124 )))
Руслан Савельев 11.2 125
Руслан Савельев 12.2 126 Описание параметров для настройки работы с КС 5:
Руслан Савельев 11.2 127
Руслан Савельев 12.2 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)
Руслан Савельев 11.2 135
136
137
138
Руслан Савельев 12.2 139
140
141
142
143
144
145
146
147
148
149
150
151
Руслан Савельев 5.2 152 = 9. Службы КС 5 =
153
154 Существуют отдельные службы КС 5 для различных продуктов СНК:
155
156 * Для «**СНК-АЗС**» - «**СНК-Коммуникационный сервер v5**» (sncexchservice)
157 * Для «**СНК-Офис**» - «**СНК-Коммуникационный сервер v5 СНК-ОФИС**» (sncexchservice.1000)
158 * Для «**СНК-ПЦ**» - «**СНК-Коммуникационный сервер v5 СНК-ПЦ**» (sncexchservice.500)
159 * Для «**СНК-Офис Онлайн**» - «**СНК-ОФИС Онлайн прием КС v5**» (sncexchprocessor)
160 * **Служба сервера NATS** – «**СНК-Коммуникационный сервер v5 NATS**» (nats-server)
161
162
163 = 10. Описание каталогов обмена =
164
165 == 10.1. Каталоги обмена КС 5 ==
166
167 Каталоги обмена КС 5 находятся в папке ##**Data**## и сгруппированы по абонентам. Внутри папки ##**Data**## находится папка с номером абонента, в которой находится папка ##**Packet**##, в которой находятся папки обмена:
168
169 * ##**Cache**## – для работы с принимаемым в данный момент пакетом.
170 * ##**Inbox**## – для входящих пакетов, которые еще не приняты программами СНК.
171 * ##**InboxArchive**## – архив входящих пакетов, сюда перемещаются пакеты из папки Inbox после их принятия в программу СНК.
172 * ##**Outbox**## – для отправляемых в настоящее время пакетов.
173 * ##**OutboxArchive**## – архив исходящих пакетов, сюда перемещаются пакеты из папки Outbox после их отправки другому абоненту.
174
175 [[image:1742374549161-794.png||data-xwiki-image-style-alignment="center"]]
176
177 == 10.2. Каталоги обмена в программах СНК ==
178
179 Каталоги обмена для «СНК-АЗС» находятся в папке **##SNC_AZS\backofficeapp##**.
180
181 Каталоги обмена для «СНК-Офис» находятся в папке **##SNC_OFFICE##**.
182
183 Описание каталогов:
184
185 * ##**OCIN**## – для входящих пакетов
186 * ##**OCIN_W**## – для входящих пакетов, переданных в формате «WIN»
187 * ##**OCIN_W.err**## – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки
188 * ##**OCOUT_W**## – для исходящих пакетов, передаваемых в формате «WIN»
189
190
191
192
193
194
195
Руслан Савельев 1.1 196