ECSS Address Book - Сервис Address Book предназначен для предоставления конечному пользователю информации о контактах адресной книги в заданном формате. Устанавливается на выделенном хосте.

Новый сервис сможет импортировать данные из MySQL. В пакете ecss-mysql также добавился пользователь и маска для сервиса Address Book:


Для подключения между SSW и ECSS Address Book нужно настроить конфигурацию.

выполняется в CoCon
/system/address-book/service/properties/info 
┌────────┬─────────┐
│Property│  Value  │
├────────┼─────────┤
│api_key │         │
│enabled │false    │
│host    │localhost│
│port    │4000     │
└────────┴─────────┘
/system/address-book/service/properties/set api_key eyJhbGcioiJIUzI1NiIsInRpcCI6IkpXVCJ9.eyjhdWQiOijmB29iYXIiLCJzdWIiOiIyMjIyMjIyMjIyIn0.EogjEYmoBVKuEQPa12mRZTxWuDDblpzX13Wjmt84fBc 
Property "api_key" successfully changed from: 

   to
eyJhbGcioiJIUzI1NiIsInRpcCI6IkpXVCJ9.eyjhdWQiOijmB29iYXIiLCJzdWIiOiIyMjIyMjIyMjIyIn0.EogjEYmoBVKuEQPa12mRZTxWuDDblpzX13Wjmt84fBc.
/system/address-book/service/properties/set host 10.20.149.8
Property "host" successfully changed from: 
localhost
   to
10.20.149.8.
/system/address-book/service/properties/set enabled true    
Property "enabled" successfully changed from: 
false
   to
true.
/system/address-book/service/properties/info
┌────────┬────────────────────────────────────────────────────────────────────────────────┐
│Property│                                     Value                                      │
├────────┼────────────────────────────────────────────────────────────────────────────────┤
│api_key │eyJhbGcioiJIUzI1NiIsInRpcCI6IkpXVCJ9.eyjhdWQiOijmB29iYXIiLCJzdWIiOiIyMjIyMjIyMjI│
│        │yIn0.EogjEYmoBVKuEQPa12mRZTxWuDDblpzX13Wjmt84fBc                                │
│enabled │true                                                                            │
│host    │10.20.149.8                                                                     │
│port    │4000                                                                            │
└────────┴────────────────────────────────────────────────────────────────────────────────┘

где:
enabled    - включение сервиса на SSW для нотификаций до Address Book
host, port - IP адрес и порт Address Book
api_key    - JWT для авторизации на Address Book. (как сгенерировать api_key указано здесь)

 

Проверить соединение между SSW и сервисом  Address Book можно следующей командой:

выполняется в CoCon
/system/address-book/service/check-connection   
Connection successful

После успешного подключения нотификации отправляются уже на новый сервис Address Book. 
При необходимости можно выполнить команду принудительного обновления контактов, для этого выполнить команду:

выполняется в CoCon

/system/address-book/service/force-update-info test_domain 42007 
Success: sent 1 notifications.
CODE

Обновление контактов (синхронизацию) можно выполнить так же через web интерфейс:

Добавлены команды редактирования данных в базе MySQL:

info
/system/address-book/info test_domain 42009                     
┌──────┬───────────┬──────────────────────────┐
│Number│ Property  │          Value           │
├──────┼───────────┼──────────────────────────┤
│42009 │Uuid       │06da42f375cf1b56          │
│      │First Name │undefined                 │
│      │Middle Name│undefined                 │
│      │Last Name  │undefined                 │
│      │Company    │undefined                 │
│      │Position   │undefined                 │
│      │Description│Auto-created by CoCon user│
│      │Photo      │undefined                 │
└──────┴───────────┴──────────────────────────┘

и 

set
/system/address-book/set test_domain 42009 42009@test_domain first_name Василий      
Contact with uid 06da42f375cf1b56 updated!
info
/system/address-book/info test_domain 42009                                    
┌──────┬───────────┬──────────────────────────┐
│Number│ Property  │          Value           │
├──────┼───────────┼──────────────────────────┤
│42009 │Uuid       │06da42f375cf1b56          │
│      │First Name │Василий                   │
│      │Middle Name│undefined                 │
│      │Last Name  │undefined                 │
│      │Company    │undefined                 │
│      │Position   │undefined                 │
│      │Description│Auto-created by CoCon user│
│      │Photo      │undefined                 │
└──────┴───────────┴──────────────────────────┘

Модификация через Web так же доступна:

/system/address-book/info test_domain 42009
┌──────┬───────────┬───────────────────────────────────────────────────────┐
│Number│ Property  │                         Value                         │
├──────┼───────────┼───────────────────────────────────────────────────────┤
│42009 │Uuid       │06da42f375cf1b56                                       │
│      │First Name │Василий                                                │
│      │Middle Name│Васильевич                                             │
│      │Last Name  │Васильев                                               │
│      │Company    │Тест и Ко                                              │
│      │Position   │начальника                                             │
│      │Description│Компания для тестирования всех услуг сервисов и функций│
│      │Photo      │undefined                                              │
└──────┴───────────┴───────────────────────────────────────────────────────┘