Исходный код вики Коммуникационный сервер
Версия 25.3 от Руслан Савельев на 2025/04/09 09:28
Скрыть последних авторов
| author | version | line-number | content |
|---|---|---|---|
 |
4.2 | 1 | = 1. Назначение = |
| |
1.1 | 2 | |
| |
2.2 | 3 | Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ. |
| |
1.1 | 4 | |
| |
25.3 | 5 | = 2. Запуск программы = |
| |
1.1 | 6 | |
| |
25.3 | 7 | [[image:1742371119337-637.png||data-xwiki-image-style-text-wrap="true" height="17" width="17"]]Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**## |
| 8 | |||
| 9 | = 3. Интерфейс программы = | ||
| 10 | |||
| 11 | Программа открывается в браузере и состоит из следующих элементов: | ||
| 12 | |||
| 13 | * **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//. | ||
| 14 | * **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//. | ||
| 15 | * **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами //(на рисунке отмечено цифрой 3)//. | ||
| 16 | * **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//. | ||
| 17 | |||
| 18 | [[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]] | ||
| 19 | |||
| 20 | = 4. Требования к ПО = | ||
| 21 | |||
| |
23.2 | 22 | * «СНК-КС» - 5.2.0 и выше. |
| 23 | * «СНК-АЗС» - 1.37.37 и выше. | ||
| 24 | * «СНК-Офис» - 1.23.2 и выше. | ||
| 25 | * «СНК-ПЦ» - 1.113.30 и выше. | ||
| 26 | * Действующая лицензия «СНК-КС» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «[[KeyInfo>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome]]» | ||
| 27 | |||
| |
25.3 | 28 | = 5. Информация и структурная схема = |
| |
23.2 | 29 | |
| |
3.2 | 30 | [[image:1742371332756-574.png||data-xwiki-image-style-alignment="center" height="528" width="700"]] |
| 31 | |||
| |
25.3 | 32 | = 6. Установка СНК-КС-5 = |
| |
23.2 | 33 | |
| |
25.3 | 34 | == 6.1. Установка на стороне СНК-АЗС == |
| |
23.2 | 35 | |
| 36 | Установка СНК-КС5 выполняется при начальной инсталляции СНК-АЗС или при его обновлении, для этого необходимо в окне выбора продуктов для установки или обновления установить флажок «Коммуникационный сервер v5». | ||
| 37 | По умолчанию, каталог установки КС5 - ##.\SNC_AZS\exchange## | ||
| 38 | |||
| 39 | [[image:1744190452407-288.png||data-xwiki-image-style-alignment="center"]]Если при установке или обновлении установить флажок «Создание ярлыков на рабочем столе», то на рабочем столе появится ярлык «КС СНК АЗС», который будет запускать веб-интерфейс СНК-КС5 (##http:~/~/localhost:8000/##): | ||
| 40 | |||
| |
25.3 | 41 | [[image:1744190595783-589.png||data-xwiki-image-style-alignment="center"]] |
| |
23.2 | 42 | |
| |
25.3 | 43 | == 6.2. На стороне СНК-ПЦ, СНК-Офис, СНК-Офис онлайн == |
| |
23.2 | 44 | |
| |
25.3 | 45 | Воспользуйтесь мастером установки СНК-КС5: |
| |
23.2 | 46 | |
| |
25.3 | 47 | * Закройте все программы СНК-АЗС, СНК-ПЦ, СНК-Офис. |
| 48 | * Запустите установочный файл (##snc_cs_update_5_2_2.exe## или файл с более новой версией). | ||
| 49 | * Откроется окно мастера установки, нажмите кнопку «Далее». | ||
| |
23.2 | 50 | |
| 51 | |||
| 52 | |||
| 53 | |||
| |
3.2 | 54 | |
| |
1.1 | 55 | |
| 56 | |||
| 57 | |||
| 58 | |||
| 59 | |||
| 60 | |||
| 61 | |||
| |
25.3 | 62 | |
| 63 | |||
| 64 | |||
| 65 | |||
| 66 | |||
| 67 | |||
| 68 | |||
| 69 | = = | ||
| 70 | |||
| 71 | = = | ||
| 72 | |||
| 73 | |||
| 74 | = 7. Настройка параметров КС 5 = | ||
| 75 | |||
| 76 | == 7.1. Используя конфигурационный файл == | ||
| 77 | |||
| |
5.2 | 78 | Параметры настройки КС 5 сохранены в файле **##.\exchange\SncExchServer.cfg##** |
| |
1.1 | 79 | |
| |
5.2 | 80 | Описание параметров: |
| |
1.1 | 81 | |
| |
5.2 | 82 | * **abonent.id** – ID абонента (код абонента, для которого установлен КС5) |
| 83 | * **archive.inbox.depth** – Глубина хранения входящих пакетов, дней. | ||
| 84 | * **archive.outbox.depth** – Глубина хранения исходящих пакетов, дней. | ||
| 85 | * **archive.packet.disable** – Отключить сохранение пакетов в архив (true), сохранять – false | ||
| 86 | * **auth.token** – Токен, используется одинаковый токен для всех абонентов. | ||
| 87 | * **http.port** – Порт для обмена с ПО СНК (Бэк-офис, СНК-Офис, СНК-ПЦ). Этот же порт используется для запуска веб-интерфейса в браузере (порт по умолчанию - 8000) | ||
| 88 | * **nats.host** – IP адрес и порт сервера NATS. (порт по умолчанию - 7654) | ||
| 89 | * **nats.timeout** – таймаут обращения к серверу NATS, мс. | ||
| |
1.1 | 90 | |
| |
5.2 | 91 | **Для изменения параметров** необходимо: |
| |
1.1 | 92 | |
| |
5.2 | 93 | * **остановить службу** КС 5, (см. раздел «Службы», п.9). |
| 94 | * **изменить и сохранить параметры** в файле. | ||
| 95 | * **запустить службу** КС 5, (см. раздел «Службы», п.9). | ||
| |
1.1 | 96 | |
| |
25.3 | 97 | == 7.2. Используя веб-интерфейс == |
| |
1.1 | 98 | |
| |
5.2 | 99 | Воспользуйтесь ярлыком «**КС СНК АЗС**» на рабочем столе или наберите в браузере ##**localhost:8000**## |
| |
4.2 | 100 | |
| |
5.2 | 101 | * Перейдите на страницу «Настройки», доступные параметры: |
| 102 | ** **ID абонента** - код абонента, для которого установлен КС5 (abonent.id в п. 5.1) | ||
| 103 | ** **Глубина хранения входящих пакетов, дней** – сколько дней хранить входящие пакеты (archive.inbox.depth в п. 5.1) | ||
| 104 | ** **Глубина хранения исходящих пакетов, дней** – сколько дней хранить исходящие пакеты (archive.outbox.depth в п. 5.1) | ||
| 105 | ** **Не сохранять пакеты в архив** – отметьте флажок, чтобы не хранить архивы пакетов (archive.packet.disable в п. 5.1) | ||
| 106 | ** **Токен **– значение токена должно совпадать у всех абонентов, участвующих в обмене (auth.token в п. 5.1) | ||
| 107 | ** **Строка подключения** – IP адрес и порт сервера NATS (nats.host в п. 5.1) | ||
| 108 | ** **Таймаут, мс.** – таймаут обращения к серверу NATS (nats.timeout в п. 5.1) | ||
| 109 | * Нажмите кнопку «**Сохранить**» после изменения настроек. | ||
| 110 | |||
| |
6.2 | 111 | [[image:1742374859311-606.png||data-xwiki-image-style-alignment="center" height="355" width="600"]] |
| |
5.2 | 112 | |
| |
25.3 | 113 | = 8. Настройка СНК-АЗС для работы с КС 5 = |
| |
5.2 | 114 | |
| |
25.3 | 115 | == 8.1. Настройка в программе «Бэк-Офис СНК-АЗС» == |
| |
5.2 | 116 | |
| |
7.2 | 117 | В «[[Бэк-Офис СНК-АЗС>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5). |
| |
5.2 | 118 | |
| |
25.3 | 119 | **8.1.1. Запуск окна настроек абонентов** |
| |
5.2 | 120 | |
| |
7.2 | 121 | * Запустите «[[**Бэк-офис СНК-АЗС**>>doc:Prilozheniia_SNK.SNK-AZS.Bek-ofis_SNK-AZS.WebHome]]». |
| 122 | * В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**. | ||
| |
5.2 | 123 | |
| |
7.2 | 124 | [[image:1742375086353-686.png||data-xwiki-image-style-alignment="center" height="184" width="500"]]Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными. |
| |
5.2 | 125 | |
| |
25.3 | 126 | **8.1.2. Описание параметров таблицы абонентов** |
| |
5.2 | 127 | |
| |
8.2 | 128 | * **Код абонента** – код абонента, с которым производится обмен данными, код нельзя изменить у уже созданного абонента, его можно указать только при создании нового абонента. |
| 129 | * **Имя **– наименование абонента, не влияет на обмен, используется только для обозначения абонента в «Бэк-офисе». | ||
| 130 | * **Тип данных** – тип передаваемых абоненту данных («СНК-ПЦ» или «СНК-Офис»). | ||
| 131 | * **Версия КС** – версия КС, используемая абонентом для обмена данными («КС 4» или «КС 5»). | ||
| |
5.2 | 132 | |
| |
25.3 | 133 | [[image:1742375171694-926.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.3. Настройка портов для связи «Бэк-Офиса» с КС** |
| |
5.2 | 134 | |
| |
11.2 | 135 | * **Порт для КС 4** – порт, по которому «Бэк-офис» связывается с КС 4 (по умолчанию 6000). |
| 136 | * **Порт для КС 5** – порт, по которому «Бэк-офис» связывается с КС 5 (по умолчанию 8000). | ||
| |
5.2 | 137 | |
| |
11.2 | 138 | Для запуска веб-интерфейса КС 5, можно воспользоваться кнопкой «**Открыть КС 5**». |
| |
5.2 | 139 | |
| |
11.2 | 140 | (% class="box infomessage" %) |
| 141 | ((( | ||
| 142 | **Внимание!** | ||
| 143 | В настройках КС 5 должен быть указан тот же номер порта, что и в «Бэк-офисе» (параметр http.port в файле SncExchServer.cfg, см. п. 5.1). | ||
| 144 | ))) | ||
| |
5.2 | 145 | |
| |
25.3 | 146 | **8.1.4. Добавление абонента** |
| |
5.2 | 147 | |
| |
11.2 | 148 | * В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**». |
| |
5.2 | 149 | |
| |
11.2 | 150 | [[image:1742375331377-333.png||data-xwiki-image-style-alignment="center" height="291" width="500"]] |
| |
5.2 | 151 | |
| |
11.2 | 152 | * В строке «**Добавить абонента**» укажите код добавляемого абонента и нажмите кнопку «**ОК**». |
| |
5.2 | 153 | |
| |
11.2 | 154 | [[image:1742375383319-279.png||data-xwiki-image-style-alignment="center" height="291" width="500"]] |
| |
5.2 | 155 | |
| |
11.2 | 156 | В таблицу будет добавлена новая строка |
| |
5.2 | 157 | |
| |
11.2 | 158 | * Заполните параметры **Имя**, **Тип данных**, **Версия КС** для созданного абонента (см. п. 6.1.2). |
| |
5.2 | 159 | |
| |
25.3 | 160 | [[image:1742375454496-878.png||data-xwiki-image-style-alignment="center" height="291" width="500"]]**8.1.5. Удаление абонента** |
| |
11.2 | 161 | |
| |
12.2 | 162 | * Нажмите правую кнопку мыши на строке с абонентом и выберите «**Удалить**» |
| |
11.2 | 163 | |
| |
12.2 | 164 | [[image:1742375709359-919.png||data-xwiki-image-style-alignment="center" height="291" width="500"]] |
| |
11.2 | 165 | |
| |
25.3 | 166 | == 8.2. Настройка конфигурационного файла СНК-АЗС == |
| |
11.2 | 167 | |
| |
23.2 | 168 | Для работы «СНК-АЗС» с КС 5 необходимо настроить параметры в файле## .\SNC_AZS\backofficeapp\**bo_app.snc**## |
| |
11.2 | 169 | |
| |
12.2 | 170 | (% class="box infomessage" %) |
| 171 | ((( | ||
| 172 | **Внимание!** | ||
| 173 | Закройте все программы «СНК-АЗС» и «Бэк-Офис» перед внесением изменений! | ||
| 174 | ))) | ||
| |
11.2 | 175 | |
| |
12.2 | 176 | Описание параметров для настройки работы с КС 5: |
| |
11.2 | 177 | |
| |
12.2 | 178 | * **TransactionOnOpenShift** – передавать данные по текущей открытой смене (0 - не передавать, **1 - передавать**) |
| 179 | * **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**) | ||
| 180 | * **ExchangeList** – список абонентов с которыми обменивается СНК-АЗС и формат данных для обмена, заполняется автоматически, при настройке абонентов в «Бэк-Офисе» (см. п. 6.1) | ||
| 181 | * **AutoReceiveData** – автоматический прием полученных в КС данных в «Бэк-Офис» (0 – автоматический прием выключен, **1 - включен**) | ||
| 182 | * **AutoSendData** – автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 – всем абонентам, 07:00 – время отправки данных)) | ||
| 183 | * **SendOpenShift** – передача открытой смены в «СНК-Офис» (0 - не передавать, **1 - передавать**) | ||
| 184 | * **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1) | ||
| |
11.2 | 185 | |
| |
25.3 | 186 | = 9. Настройка СНК-Офис для работы с КС 5 = |
| |
11.2 | 187 | |
| |
25.3 | 188 | == 9.1. Настройка конфигурационного файла СНК-Офис == |
| |
11.2 | 189 | |
| |
13.2 | 190 | Для работы «СНК-Офис» с КС 5 необходимо настроить параметры в файле ##.\SNC_OFFICE\**bo_app.ini**## |
| |
11.2 | 191 | |
| |
13.2 | 192 | (% class="box infomessage" %) |
| 193 | ((( | ||
| 194 | **Внимание!** | ||
| 195 | Закройте программу «СНК-Офис» перед внесением изменений! | ||
| 196 | ))) | ||
| |
12.2 | 197 | |
| |
13.2 | 198 | Описание параметров для настройки работы с КС 5: |
| |
12.2 | 199 | |
| |
13.2 | 200 | * **UseExchangeServer** – использовать КС для передачи данных (0 - не использовать, **1 - использовать**) |
| 201 | * **AutoReceiveData** – автоматический прием полученных в КС данных (0 – автоматический прием выключен, **1 - включен**) | ||
| 202 | * **ExchangeSrvPortExt** –порт для связи с КС 5 (значение параметра **http.port** из п.5.1) | ||
| |
12.2 | 203 | |
| |
25.3 | 204 | == 9.2. Настройка формата передачи данных для ТО == |
| |
12.2 | 205 | |
| |
13.2 | 206 | Для каждой ТО необходимо выбрать версию КС, используемую ТО для обмена данными. Для этого: |
| |
12.2 | 207 | |
| |
13.2 | 208 | * Откройте раздел «**Справочники**». |
| 209 | * Выберите «**Точки обслуживания**» | ||
| 210 | * На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**» | ||
| |
12.2 | 211 | |
| |
13.2 | 212 | [[image:1742376031179-997.png||data-xwiki-image-style-alignment="center" height="312" width="600"]] |
| |
12.2 | 213 | |
| |
15.2 | 214 | Откроется окно «**Редактирование ТО**». |
| |
12.2 | 215 | |
| |
13.2 | 216 | * Перейдите на вкладку «**Обмен данными**». |
| 217 | * В параметре «**Использовать СНК-КС**» выберите «**КС 5**». | ||
| 218 | * Нажмите кнопку «**ОК**» для сохранения параметров. | ||
| |
12.2 | 219 | |
| |
14.2 | 220 | [[image:1742376080218-224.png||data-xwiki-image-style-alignment="center" height="440" width="350"]] |
| |
12.2 | 221 | |
| |
25.3 | 222 | = 10. Настройка СНК-ПЦ для работы с КС 5 = |
| |
12.2 | 223 | |
| |
15.2 | 224 | В СНК-ПЦ зайдите в меню – «**Настройка**» – «**Конфигурация**». |
| |
12.2 | 225 | |
| |
15.2 | 226 | В разделе «**Приписка проекта**» добавьте параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**». |
| |
12.2 | 227 | |
| |
15.2 | 228 | [[image:1742376299785-470.png||data-xwiki-image-style-alignment="center" height="333" width="700"]] |
| |
13.2 | 229 | |
| |
16.2 | 230 | * Выберите заголовок проекта в конфигурации. |
| 231 | * Слева нажмите кнопку «**Экспорт**». Из выпавшего списка выберите «Импорт выборочных настроек (с пополнением)» | ||
| |
13.2 | 232 | |
| |
16.2 | 233 | [[image:1742376339853-759.png||data-xwiki-image-style-alignment="center" height="332" width="700"]] |
| |
13.2 | 234 | |
| |
16.2 | 235 | Откроется окно файлового проводника. |
| |
13.2 | 236 | |
| |
16.2 | 237 | * Зайдите в каталог «**sncPC**» и выберите файл «**IP-Адрес и порт КС5**» |
| 238 | * Нажмите кнопку «**Открыть**» | ||
| |
14.2 | 239 | |
| |
18.2 | 240 | [[image:1742376379869-231.png||data-xwiki-image-style-alignment="center" height="520" width="700"]] |
| |
14.2 | 241 | |
| |
18.2 | 242 | * После добавления параметра укажите настройки КС5 в правом окне в строке «**Значение**» в формате ##ipv4:порт## (например ##localhost:8000##). |
| 243 | * Нажмите кнопку «**Принять**» и перезапустите ПЦ. | ||
| 244 | * После перезапуска ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**» | ||
| |
14.2 | 245 | |
| |
18.2 | 246 | [[image:1742376449142-544.png||data-xwiki-image-style-alignment="center" height="353" width="700"]] |
| |
14.2 | 247 | |
| |
18.2 | 248 | * Выберите нужную ТО и нажмите кнопку «**Ограничения**» слева. |
| |
14.2 | 249 | |
| |
19.2 | 250 | [[image:1742376495608-296.png||data-xwiki-image-style-alignment="center" height="327" width="700"]] |
| |
14.2 | 251 | |
| |
19.2 | 252 | * В открывшемся окне выберите строку «**Настройка**», и нажмите кнопку «**Значения**». |
| |
14.2 | 253 | |
| |
22.1 | 254 | [[image:1742376541541-400.png||data-xwiki-image-style-alignment="center" height="256" width="700"]] |
| |
14.2 | 255 | |
| |
22.1 | 256 | * В открывшемся окне раскройте раздел «Режим обмена данными», нажав на **+**. |
| 257 | * Флажок «**Обмен СНК-КС ?**» должен быть **убран**. | ||
| 258 | * Флажок «**Обмен СНК-КС 5?**» должен быть **установлен**. | ||
| 259 | * Нажмите кнопку «**Принять**» | ||
| |
14.2 | 260 | |
| |
22.1 | 261 | [[image:1742376578109-329.png||data-xwiki-image-style-alignment="center" height="362" width="500"]] |
| |
14.2 | 262 | |
| |
25.3 | 263 | = 11. Службы КС 5 = |
| |
5.2 | 264 | |
| 265 | Существуют отдельные службы КС 5 для различных продуктов СНК: | ||
| 266 | |||
| 267 | * Для «**СНК-АЗС**» - «**СНК-Коммуникационный сервер v5**» (sncexchservice) | ||
| 268 | * Для «**СНК-Офис**» - «**СНК-Коммуникационный сервер v5 СНК-ОФИС**» (sncexchservice.1000) | ||
| 269 | * Для «**СНК-ПЦ**» - «**СНК-Коммуникационный сервер v5 СНК-ПЦ**» (sncexchservice.500) | ||
| 270 | * Для «**СНК-Офис Онлайн**» - «**СНК-ОФИС Онлайн прием КС v5**» (sncexchprocessor) | ||
| 271 | * **Служба сервера NATS** – «**СНК-Коммуникационный сервер v5 NATS**» (nats-server) | ||
| 272 | |||
| |
25.3 | 273 | = 12. Описание каталогов обмена = |
| |
5.2 | 274 | |
| |
25.3 | 275 | == 12.1. Каталоги обмена КС 5 == |
| |
5.2 | 276 | |
| 277 | Каталоги обмена КС 5 находятся в папке ##**Data**## и сгруппированы по абонентам. Внутри папки ##**Data**## находится папка с номером абонента, в которой находится папка ##**Packet**##, в которой находятся папки обмена: | ||
| 278 | |||
| 279 | * ##**Cache**## – для работы с принимаемым в данный момент пакетом. | ||
| 280 | * ##**Inbox**## – для входящих пакетов, которые еще не приняты программами СНК. | ||
| 281 | * ##**InboxArchive**## – архив входящих пакетов, сюда перемещаются пакеты из папки Inbox после их принятия в программу СНК. | ||
| 282 | * ##**Outbox**## – для отправляемых в настоящее время пакетов. | ||
| 283 | * ##**OutboxArchive**## – архив исходящих пакетов, сюда перемещаются пакеты из папки Outbox после их отправки другому абоненту. | ||
| 284 | |||
| 285 | [[image:1742374549161-794.png||data-xwiki-image-style-alignment="center"]] | ||
| 286 | |||
| |
25.3 | 287 | == 12.2. Каталоги обмена в программах СНК == |
| |
5.2 | 288 | |
| 289 | Каталоги обмена для «СНК-АЗС» находятся в папке **##SNC_AZS\backofficeapp##**. | ||
| 290 | |||
| 291 | Каталоги обмена для «СНК-Офис» находятся в папке **##SNC_OFFICE##**. | ||
| 292 | |||
| 293 | Описание каталогов: | ||
| 294 | |||
| 295 | * ##**OCIN**## – для входящих пакетов | ||
| 296 | * ##**OCIN_W**## – для входящих пакетов, переданных в формате «WIN» | ||
| 297 | * ##**OCIN_W.err**## – для входящих пакетов, переданных в формате «WIN», в процессе распаковки которых произошли ошибки | ||
| 298 | * ##**OCOUT_W**## – для исходящих пакетов, передаваемых в формате «WIN» | ||
| 299 | |||
| 300 | |||
| 301 | |||
| 302 | |||
| 303 | |||
| |
1.1 | 304 |