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

== **1. Назначение** ==

Коммуникационный сервер версии 5 (далее СНК-КС5) – это распределённая система, предназначенная для обеспечения обмена данными в режиме реального времени между программными продуктами СНК: СНК-АЗС, СНК-Офис и СНК-ПЦ.

4

5

== **2. Запуск приложения** ==

6

7

Для запуска приложения используйте один из вариантов:

8

9

{{tabs idsToLabels="tabId1=Запуск ярлыка на рабочем столе, tabId2=Через интернет-браузер"/}}

(% id="tabId1" %)

(((

(% class="box" %)

(((

[[image:1753872619186-150.png||data-xwiki-image-style-alignment="start"]]

)))

)))

(% id="tabId2" %)

(((

(% class="box" %)

(((

Наберите в браузере

localhost:8000

//(указан порт по-умолчанию)//

)))

)))

== **3. Интерфейс программы** ==

34

35

Программа открывается в браузере и состоит из следующих элементов:

36

37

* **Адресная строка** - в ней должен быть набран адрес КС //(на рисунке отмечено цифрой 1)//.

38

* **Индикатор состояния подключения** - показывает, есть ли связь с сервером обмена //(на рисунке отмечено цифрой 2)//.

39

* **Вкладки слева** - переключение между вкладками с входящими и исходящими пакетами и вкладка настроек //(на рисунке отмечено цифрой 3)//.

40

* **Основное окно** - список пакетов в выбранной вкладке, а также настройки //(на рисунке отмечено цифрой 4)//.

41

42

[[Интерфейс программы>>image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]

43

44

== **4. Требования к ПО** ==

45

46

* «**СНК-КС**» - 5.2.0 и выше.

47

* «**СНК-АЗС**» - 1.37.37 и выше.

48

* «**СНК-Офис**» - 1.23.2 и выше.

49

* «**СНК-ПЦ**» - 1.113.30 и выше.

50

* Действующая лицензия «**СНК-КС**» на аппаратном или виртуальном HASP-ключе. Лицензия должна отображаться в программе «[[KeyInfo>>doc:Prilozheniia_SNK.SNK-AZS.Informatsiia_po_kliucham_HASP_SNK-AZS.WebHome||target="_blank"]]»

51

52

== **5. Общая информация** ==

53

54

Для обеспечения обмена точек обслуживания с инфраструктурой Офиса (СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн) при помощи СНК-КС5, необходимо соблюсти применение следующих пунктов:

55

56

* Установленный сервер NATS для СНК-КС5 в инфраструктуре Офиса – данное приложение будет отвечать за коммуникацию между всеми экземплярами СНК-КС5

57

* Отдельные экземпляры СНК-КС5 для каждой ТО

58

* Отдельные экземпляры СНК-КС5 для каждого из следующих приложений - СНК-Офис, СНК-ПЦ, СНК-Офис-Онлайн

59

60

Ниже приведена схема взаимодействия всех экземпляров СНК-КС5 и сервера NATS:

61

62

[[Схема работы СНК-КС5>>image:1762320317685-829.png||data-xwiki-image-style-alignment="center" height="610" width="800"]]

63

64

== **6. Установка СНК-КС5 в инфраструктуре Офиса** ==

65

66

Настройка СНК-КС5 начинается на сервере, где установлены СНК-Офис и/или СНК-ПЦ. Необходимо установить сервер NATS и отдельные экземпляры СНК-КС5 для СНК-Офис и СНК-ПЦ.

67

68

Для установки СНК-КС5 на стороне Офиса:

69

70

* Запустите установочный файл **snc_cs_update_5_4_0.exe** (или файл с более новой версией).

71

* Нажмите «**Далее**» на экранах мастера установки и списка изменений.

72

73

[[Окна начала установки и списка изменений>>image:1762320469682-529.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]

74

75

* На экране выбора компонентов выберите, для какой программы нужно установить СНК-КС5.

76

* Установите флажок установки сервера NATS, если он не был установлен ранее.

77

* На следующем экране выберите папку для установки СНК-КС и нажмите «**Далее**».

78

79

[[Выбор компонентов и папки установки СНК-КС5>>image:1762320855644-985.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]

80

81

* Дождитесь завершения установки и нажмите «**Готово**».

82

83

(% class="box infomessage" %)

84

(((

85

**Примечание!**

86

Если необходимо установить СНК-КС5 еще и для другого приложения (например «СНК-ПЦ»), то повторите действия по установке, выбрав установку СНК-КС5 для нужного приложения. Флажок «Установка сервера NATS» при повторной установке отмечать не нужно.

87

)))

88

89

== **7. Первоначальная настройка работы СНК-КС5 с СНК-Офис** ==

90

91

=== **7.1. Настройка конфигурационного файла СНК-КС5** ===

92

93

(% class="box warningmessage" %)

94

(((

95

Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.

96

)))

97

98

* Остановите службу «**СНК-Коммуникационный сервер v5 СНК-ОФИС**»

99

* Откройте файл **##.\SNC_OFFICE\exchange\SncExchServer.cfg##**

100

* Измените значения параметров:

101

102

|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**

103

|(%%)(% style="background-color:#f1c40f" %)**##abonent.id##**|Номер абонента СНК-Офис в сети СНК-КС5

104

|**##archive.inbox.depth##**|Хранение входящих пакетов, дней

105

|**##archive.outbox.depth##**|Хранение исходящих пакетов, дней

106

|**##archive.packet.disable##**|(((

107

Сохранение пакетов обмена в архив:

108

109

* true – НЕ сохранять

110

* false – сохранять

111

)))

112

|**##log.depth##**|Хранение логов СНК-КС5, дней

113

|(%%)(% style="background-color:#3498db" %)**##auth.token##**|Общий токен сети (одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ)

114

|(%%)(% style="background-color:#2ecc71" %)**##http.port##**|Порт для связи с СНК-Офис (по умолчанию: 8000) *

115

|**##nats.host##**|IP и порт сервера NATS (порт по умолчанию: 7654)

116

|**##nats.timeout##**|Таймаут обращения к серверу NATS, мс

117

118

* Сохраните изменения в файле и запустите службу «СНК-Коммуникационный сервер v5 СНК-ОФИС»

119

120

(% class="box infomessage" %)

121

(((

122

**~* Примечание!**

123

Если на одном ПК запущены СНК-Офис и СНК-ПЦ одновременно, используйте разные порты для каждого экземпляра СНК-КС5, например, для СНК-КС5, который используется для СНК- Офис используйте порт 8000, а для СНК-КС5, который используется для СНК-ПЦ используйте порт 8001

124

)))

125

126

=== **7.2. Настройка конфигурационного файла СНК-Офис** ===

127

128

(% class="box warningmessage" %)

129

(((

130

Эта настройка выполняется при первоначальной установке СНК-КС5 для СНК-Офис.

131

)))

132

133

* Закройте приложение «СНК-Офис»

134

* Откройте файл **##.\SNC_OFFICE\bo_app.ini##**

135

* Измените значения параметров:

136

137

|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**

138

|**##UseExchangeServer##**|**1** – использовать КС для приема и передачи пакетов

139

|**##AutoReceiveData##**|**1** – автоматический прием пакетов из КС в СНК-Офис

140

|**##ExchangeSrvPortExt##**|Порт для связи с СНК-КС5 ((% style="background-color:#2ecc71" %)##http.port##(%%)## ##в файле настроек КС5 - **##exchange\SncExchServer.cfg##**)

141

142

* Сохраните изменения в файле

143

144

== **8. Настройка СНК-Офис для передачи данных на ТО через СНК-КС5** ==

145

146

(% class="box warningmessage" %)

147

(((

148

Эта настройка выполняется для каждой ТО, которая будет использовать СНК-КС5 для обмена данными с СНК-Офис.

149

)))

150

151

* Запустите «**СНК-Офис**»

152

* Откройте раздел «**Справочники**» и выберите «**Точки обслуживания**»

153

* На нужной ТО нажмите правой кнопкой мыши и выберите «**Редактировать**»

154

155

[[Вход в настройки карточки ТО>>image:1762321795143-494.png||data-xwiki-image-style-alignment="center" height="461" width="700"]]

156

157

* Откроется окно «Редактирование ТО»

158

* Перейдите на вкладку «**Обмен данными**»

159

* В параметре «**Использовать СНК-КС**» выберите «**КС 5**»

160

* Нажмите кнопку «**ОК**» для сохранения параметров

161

162

[[Параметры обмена с выбранной ТО>>image:1762321849558-674.png||data-xwiki-image-style-alignment="center" height="499" width="400"]]

163

164

== **9. Установка и обновление СНК-КС5 на ТО** ==

165

166

Установка и обновление СНК-КС5 на ТО выполняется при обновлении версии СНК-АЗС. Если СНК-КС5 не был установлен, то будет выполнена установка, если установка была произведена ранее, то СНК-КС5 будет обновлен до той версии, которая содержится в файле обновления.

167

168

Для установки или обновления СНК-КС5 на стороне ТО:

169

170

* Закройте все приложения СНК-АЗС (включая Бэк-Офис)

171

* Запустите файл обновления **snc_azs_update_1_75_14.exe** (пример названия файла)

172

* На экране выбора компонентов отметьте флажок «**Коммуникационный сервер v5**» и нажмите «**Далее**»

173

174

Дождитесь завершения обновления и нажмите «**Готово**»

175

176

[[Установка или обновление СНК-КС5>>image:1762321928267-778.png||data-xwiki-image-style-alignment="center" height="394" width="500"]]

177

178

== **10. Настройка СНК-АЗС для работы через СНК-КС5** ==

179

180

=== **10.1. Настройка конфигурационного файла СНК-АЗС** ===

181

182

* Закройте все приложения СНК-АЗС (включая Бэк-Офис)

183

* Откройте файл **##.\SNC_AZS\backofficeapp\bo_app.snc##**

184

* Измените значения параметров:

185

186

|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**

187

|**##UseExchangeServer##**|**1** – использовать КС для приема и передачи пакетов

188

|**##SendOpenShift##**|**1** – передавать текущую открытую смену

189

|**##TransactionOnOpenShift##**|**1** – передавать данные по открытой смене

190

|**##ExchangeList##**|Список абонентов, с которыми обменивается СНК-АЗС и формат данных для обмена, **заполняется автоматически**

191

|**##AutoSendData##**|(((

192

Автоматически отправлять данные указанным абонентам в указанное время (-1,07:00;-1,08:00; (-1 означает - всем абонентам, 07:00 – время отправки данных))

193

194

(Также, автоматическую отправку данных можно настроить через «Планировщик заданий» Windows)

195

)))

196

|**##AutoReceiveData##**|**1** – автоматический прием пакетов из КС в СНК-АЗС

197

|**##ExchangeSrvPortExt##**|Порт для связи с СНК-КС5 (http.port в файле настроек КС5 - **##exchange\SncExchServer.cfg##**)

198

199

* Сохраните изменения в файле

200

201

=== **10.2. Настройка в программе «Бэк-Офис СНК-АЗС»** ===

202

203

В «Бэк-Офис СНК-АЗС» необходимо добавить список абонентов, с которыми будет совершаться обмен, настроить тип передаваемых и принимаемых данных для этих абонентов (СНК-Офис или СНК-ПЦ) и выбрать версию КС, используемую для обмена данными для каждого абонента (КС 4 или КС 5), а также настроить параметры работы СНК-КС5.

204

205

* Запустите «**Бэк-офис СНК-АЗС**».

206

* В строке меню нажмите – «**Обработка**» - «**Обмен данными**» - «**Настройка списка абонентов»**.

207

208

[[ Запуск окна настроек абонентов>>image:1762322131024-259.png||data-xwiki-image-style-alignment="center" height="216" width="550"]]

209

210

* Откроется окно «**Абоненты**», здесь находится список абонентов, с которыми производится обмен данными.

211

* Первоначально в списке абонентов заведен абонент для примера, удалите его. Для этого нажмите правой кнопкой мыши на строке абонента и выберите «Удалить»

212

* В окне «**Абоненты**» нажмите правую кнопку мыши в любом свободном месте окна и выберите «**Добавить**».

213

214

[[Добавление абонента>>image:1762322184400-657.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]

215

216

* В строке «**Добавить абонента**» укажите код добавляемого абонента, например, код абонента «СНК-Офис» ((% style="background-color:#f1c40f" %)abonent.id(%%) в файле настроек КС5) и нажмите кнопку «**ОК**».

217

218

[[Окно ввода кода абонента>>image:1762322283984-102.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]

219

220

* Заполните значения параметров:

221

222

|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**

223

|**Код абонента**|(((

224

Код абонента, с которым производится обмен данными.

225

226

**Может быть указан только при создании абонента.**

227

)))

228

|**Имя**|Имя абонента, параметр используется только для обозначения абонента, можно вписать любое удобное имя.

229

|**Тип данных**|СНК-ПЦ или СНК-Офис тип передаваемых абоненту данных

230

|**Версия КС**|КС 5 - версия КС, используемая абонентом для обмена данными.

231

232

[[Список абонентов>>image:1762322380071-667.png||data-xwiki-image-style-alignment="center" height="360" width="600"]]

233

234

* Аналогично создайте абонента для передачи данных в «СНК-ПЦ» при необходимости.

235

236

Теперь, когда абоненты созданы, необходимо настроить СНК-КС5 для корректной работы в сети обмена с сервером NATS, для этого:

237

238

* В окне «**Абоненты**» нажмите на кнопку «**Открыть КС 5**».

239

* Откроется окно веб-интерфейса «СНК-КС5», перейдите в нем на вкладку «**Настройки**»

240

* Измените значения параметров:

241

242

|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**

243

|**ID абонента**|Номер ТО

244

|**Глубина хранения входящих пакетов, дней**|Хранение входящих пакетов, дней

245

|**Глубина хранения исходящих пакетов, дней**|Хранение исходящих пакетов, дней

246

|**Не сохранять пакеты в архив**|(((

247

Сохранение пакетов обмена в архив:

248

249

* Флажок установлен – НЕ сохранять архивные пакеты

250

* Флажок не установлен – сохранять архивные пакеты

251

)))

252

|**Токен**|Общий токен сети, одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ, укажите значение (% style="background-color:#3498db" %)auth.token (%%) из файла настроек КС5 (**##exchange\SncExchServer.cfg##**)

253

|**Строка подключения**|IP и порт сервера NATS (порт по умолчанию: 7654)

254

|**Таймаут, мс.**|Таймаут обращения к серверу NATS, мс

255

256

* Сохраните изменения, нажав на кнопку «**Сохранить**»

257

258

(% class="box infomessage" %)

259

(((

260

**Примечание!**

261

Если окно веб-интерфейса «СНК-КС5» не отображается в браузере, то проверьте, что служба «**СНК-Коммуникационный сервер v5**» запущена.

262

)))

263

264

== **11. Первоначальная настройка работы СНК-КС5 с СНК-ПЦ** ==

265

266

Для работы СНК-КС5 с СНК-ПЦ необходимо выполнить следующие действия:

267

268

* Установить отдельный экземпляр СНК-КС5 для СНК-ПЦ (аналогично как в п. 6)

269

* Настроить конфигурационный файл СНК-КС5 (аналогично как в п. 7.1)

270

* Установить поддержку СНК-КС5 для СНК-ПЦ

271

* Настроить передачу данных определенной ТО в СНК-ПЦ через СНК-КС5

**Для установки поддержки СНК-КС5 в СНК-ПЦ выполните следующие действия:**

276

277

* В СНК-ПЦ зайдите в меню – «**Настройка**» – «**Конфигурация**».

278

* Выберите заголовок проекта в конфигурации.

279

* Слева нажмите кнопку «**Экспорт**». Из выпавшего списка выберите «**Импорт выборочных настроек (с пополнением)**».

280

281

[[Меню импорта параметров>>image:1762328224115-730.png||data-xwiki-image-style-alignment="center" height="388" width="800"]]

282

283

* Откроется окно файлового проводника.

284

* Зайдите в каталог sncPC и выберите файл IP-Адрес и порт КС5

285

* Нажмите кнопку «**Открыть**»

286

287

[[Открытие файла с параметрами>>image:1762328290990-746.png||data-xwiki-image-style-alignment="center" height="449" width="800"]]

288

289

* В разделе «**Приписка проекта**» появится параметр «**IP-Адрес:порт Коммуникационного Сервера - 5**», отметьте его флажком.

290

* Выберите этот параметр и укажите настройки КС5 в правом окне, в строке «Значение» в формате ipv4: порт (например localhost:8000), где

291

** ipv4 – адрес ПК на котором установлен экземпляр СНК-КС5 для СНК-ПЦ

292

** порт – порт, который использует СНК-ПЦ для связи с СНК-КС5

293

294

[[Настройка параметров связи СНК-ПЦ с СНК-КС5>>image:1762328347603-678.png||data-xwiki-image-style-alignment="center" height="389" width="800"]]

295

296

== **12. Настройка СНК-ПЦ для передачи данных на определенную ТО** ==

297

298

(% class="box warningmessage" %)

299

(((

300

Эта настройка выполняется для каждой ТО, которая будет использовать СНК-КС5 для обмена данными с СНК-ПЦ.

301

)))

302

303

* В СНК-ПЦ выберите в меню «**Справочники**» - «**Точки обслуживания**»

304

305

[[Меню "Справочники">>image:1762328642329-414.png||data-xwiki-image-style-alignment="center" height="231" width="800"]]

306

307

* Выберите нужную ТО и нажмите кнопку «**Ограничения**» слева

308

309

[[Выбор ограничений для ТО>>image:1762328713186-281.png||data-xwiki-image-style-alignment="center" height="385" width="800"]]

310

311

* В открывшемся окне выберите строку «**Настройка**», и нажмите кнопку «**Значения**»

312

313

[[Открытие настроек>>image:1762328755502-798.png||data-xwiki-image-style-alignment="center" height="303" width="800"]]

314

315

* В открывшемся окне раскройте раздел «Режим обмена данными», нажав на **+**.

316

* Флажок «**Обмен СНК-КС ?**» должен быть **убран**.

317

* Флажок «**Обмен СНК-КС 5?**» должен быть **установлен**.

318

* Нажмите кнопку «**Принять**»

319

320

[[Включение режима обмена с КС 5 для ТО в СНК-ПЦ>>image:1762328795369-793.png||data-xwiki-image-style-alignment="center" height="369" width="500"]]

321

322

== **13. Установка онлайн режима передачи данных** ==

323

324

Данный режим позволяет передавать данные от СНК-АЗС в СНК-Офис в режиме реального времени. Для включения этого режиме необходимо выполнить следующие действия:

325

326

* Установить модуль «Онлайн режим передачи транзакций» для СНК-АЗС

327

* Включить онлайн-передачу транзакций в СНК-АЗС в настройках

328

* Установить отдельный экземпляр СНК-КС5 для онлайн транзакций на стороне Офиса

329

* Установить службу «СНК-Офис Онлайн прием» для СНК-Офис

330

331

=== **13.1. Установка модуля «Онлайн режим передачи транзакций» для СНК-АЗС** ===

332

333

Для установки модуля онлайн передачи:

334

335

* Закройте все приложения СНК-АЗС (включая Бэк-Офис)

336

* Запустите файл обновления **snc_azs_update_1_75_14.exe** (пример названия файла)

337

* На экране выбора компонентов отметьте флажок «**Онлайн режим передачи транзакций**» и нажмите «**Далее**»

338

* Дождитесь завершения обновления и нажмите «**Готово**»

339

340

[[Установка онлайн передачи данных в СНК-АЗС>>image:1762328922501-650.png||data-xwiki-image-style-alignment="center" height="394" width="500"]]

341

342

=== **13.2. Включение режима онлайн-передачи транзакций в СНК-АЗС** ===

343

344

* Закройте все приложения СНК-АЗС (включая Бэк-Офис)

345

* Запустите приложение «Настройки СНК-АЗС» (.\SNC_AZS\server\Settings.exe)

346

* Перейдите в раздел «Передача данных» и измените значения следующих параметров:

347

348

|(% style="background-color:lightgray" %)**Имя параметра**|(% style="background-color:lightgray" %)**Описание значения параметра**

349

|**Включить передачу транзакций в СНК-Офис в режиме онлайн**|(((

350

Да – включить онлайн передачу

351

352

Нет – отключить онлайн передачу

353

)))

354

|**Адрес Коммуникационного сервера (КС5)**|IP-адрес ПК, на котором запущен СНК-КС5 для СНК-АЗС

355

|**Порт Коммуникационного сервера (КС5)**|Порт, который используется для связи СНК-КС5 и Бэк-Офиса

356

|**Код абонента на стороне СНК-Офиса**|100000 – код абонента в СНК-офисе для онлайн транзакций

357

358

[[Включение режима онлайн передачи в настройках СНК-АЗС>>image:1762329041778-491.png||data-xwiki-image-style-alignment="center" height="527" width="700"]]

359

360

=== **13.3. Установка отдельного экземпляра СНК-КС5 для онлайн режима** ===

361

362

Для установки отдельного экземпляра СНК-КС5 для работы с онлайн транзакциями **на стороне Офиса**, выполните следующие действия:

363

364

* Запустите файл **snc_cs_update_5_4_0.exe** (или файл с более новой версией).

365

* Нажмите «**Далее**» на экранах мастера установки и списка изменений.

366

367

[[Окна начала установки и списка изменений>>image:1762329116347-551.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]

368

369

* На экране выбора компонентов выберите «**СНК-Офис онлайн**».

370

* На следующем экране выберите папку для установки СНК-КС и завершите установку.

371

372

[[Выбор компонентов и папки установки СНК-КС5>>image:1762329166354-881.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]

373

374

=== **13.4. Установка службы «СНК-Офис Онлайн прием» в СНК-Офис** ===

375

376

Для установки службы онлайн приема:

377

378

* Закройте СНК-офис

379

* Запустите файл обновления snc_office_update_1_23_11.exe** **(пример названия файла)

380

* На экране выбора компонентов отметьте флажок «**Установка службы СНК-Офис Онлайн прием КС v5**» и нажмите «**Далее**»

381

* Дождитесь завершения обновления и нажмите «**Готово**»

382

383

[[Установка службы онлайн приема в СНК-Офис>>image:1762329233105-534.png||data-xwiki-image-style-alignment="center" height="395" width="500"]]

384

385

== **14. Описание каталогов обмена** ==

386

387

=== **14.1. Каталоги обмена КС 5** ===

388

389

Каталоги обмена КС 5 находятся в папке **Data** и сгруппированы по абонентам. Внутри папки **Data** находится папка с номером абонента, в которой находится папка **Packet**, в которой находятся папки обмена:

390

391

* **Cache** – для работы с принимаемым в данный момент пакетом.

392

* **Inbox** – для входящих пакетов, которые еще не приняты программами СНК.

393

* **InboxArchive** – архив входящих пакетов, сюда перемещаются пакеты из папки Inbox после их принятия в программу СНК.

394

* **Outbox** – для отправляемых в настоящее время пакетов.

395

* **OutboxArchive** – архив исходящих пакетов, сюда перемещаются пакеты из папки Outbox после их отправки другому абоненту.

396