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

== **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. Интерфейс программы** ==

28

29

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

30

31

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

32

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

33

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

34

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

35

36

[[image:1742373742661-488.png||data-xwiki-image-style-alignment="center" height="437" width="600"]]

37

38

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

39

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]]»

45

46

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

47

48

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

49

50

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

51

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

52

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

53

54

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

55

56

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

57

58

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

59

60

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

61

62

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

63

64

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

65

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

66

67

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

68

69

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

70

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

71

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

72

73

[[Название>>image:1762320855644-985.png||data-xwiki-image-style-alignment="center" height="317" width="800"]]

74

75

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

76

77

(% class="box infomessage" %)

78

(((

79

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

80

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

81

)))

82

83

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

84

85

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

86

87

(% class="box warningmessage" %)

88

(((

89

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

90

)))

91

92

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

93

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

94

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

95

96

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

97

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

98

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

99

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

100

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

101

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

102

103

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

104

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

105

)))

106

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

107

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

108

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

109

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

110

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

111

112

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

113

114

(% class="box infomessage" %)

115

(((

116

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

117

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

118

)))

119

120

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

121

122

(% class="box warningmessage" %)

123

(((

124

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

125

)))

126

127

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

128

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

129

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

130

131

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

132

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

133

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

134

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

135

136

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

137

138

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

139

140

(% class="box warningmessage" %)

141

(((

142

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

143

)))

144

145

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

146

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

147

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

148

149

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

150

151

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

152

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

153

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

154

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

155

156

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

157

158

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

159

160

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

161

162

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

163

164

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

165

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

166

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

167

168

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

169

170

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

171

172

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

173

174

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

175

176

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

177

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

178

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

179

180

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

181

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

182

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

183

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

184

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

185

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

186

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

187

188

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

189

)))

190

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

191

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

192

193

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

194

195

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

196

197

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

198

199

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

200

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

201

202

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

203

204

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

205

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

206

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

207

208

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

209

210

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

211

212

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

213

214

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

215

216

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

217

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

218

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

219

220

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

221

)))

222

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

223

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

224

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

225

226

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

227

228

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

229

230

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

231

232

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

233

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

234

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

235

236

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

237

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

238

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

239

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

240

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

241

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

242

243

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

244

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

245

)))

246

|**Токен**|Общий токен сети, одинаковый для всех участников: все ТО, СНК-Офис, СНК-ПЦ, укажите значение auth.token из п. 5.1

247

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

248

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

249

250

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

251

252

(% class="box infomessage" %)

253

(((

254

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

255

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

)))

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

Навигация

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