Базовые действия. СПИК

Обратите внимание! 
Для работы СПИК требуется корректная настройка ПО «СКАУТ-Платформа: Ядро». Ознакомьтесь подробнее с корректной настройкой «СКАУТ-Платформа: Ядро». 

• 1 Получение базового адреса Сервера Приложений
• 2 Формирование адреса метода для обращения через REST
• 3 Получение адреса сервиса в SOAP
• 4 Получение описания сервиса на языке WSDL (его метаданных)
• 5 Упаковка данных для POST запроса в СПИК через REST
• 5.1 Пример на JS.

Получение базового адреса Сервера Приложений

Базовый адрес Сервера Приложений – http://login.scout-gps.ru:8081/

Если данный адрес недоступен, обратитесь в техническую поддержку СКАУТ. 

Формирование адреса метода для обращения через REST

Если необходимо вызвать у сервиса с названием ServiceName метод с названием MethodName, следует выполнить следующий порядок действий:

1. Получить базовый адрес Сервера Приложений – BaseAddress.
2. Найти в таблице Адреса сервисов в REST и SOAP ServiceAddress, соответствующий ServiceName.
3. Составить строку BaseAddress/spic/ServiceAddress/rest/MethodName

Строка, полученная в заключительном действии, является адресом для обращения через REST.

Получение адреса сервиса в SOAP

Чтобы получить адрес сервиса с названием ServiceName в SOAP, необходимо выполнить следующие действия:

1. Получить базовый адрес Сервера Приложений – BaseAddress.
2. Найти в таблице Адреса сервисов в REST и SOAP ServiceAddress, соответствующий ServiceName.
3. Составить строку BaseAddress/spic/ServiceAddress/soap

Строка, полученная в заключительном действии, является адресом для обращения через SOAP.

Получение описания сервиса на языке WSDL (его метаданных)

Чтобы получить метаданные о сервисе с названием ServiceName, необходимо описание сервиса на языке WSDL (его метаданные) с помощью следующих действий:

1. Получить базовый адрес Сервера Приложений – BaseAddress.
2. Найти в таблице Адреса сервисов в REST и SOAP ServiceAddress, соответствующий ServiceName.
3. Составить строку BaseAddress/spic/ServiceAddress/soap?wsdl
4. Перейти в браузере по составленной в пункте 3 ссылке. В ответ будет получен WSDL документ с описанием сервиса с названием ServiceName.

Упаковка данных для POST запроса в СПИК через REST

Если определённый объект необходимо отправить в качестве передаваемого параметра в какой- либо метод, следует сериализовать его в объект в формате JSON, так как при взаимодействии через REST сервер принимает параметры в этом формате.

Пример на JS.

Для подготовки объекта sendData к пересылке необходимо выполнить следующее:

//если sendData не строка, то делаем из нее или пустого объекта строку 
if (!(typeof sendData == 'string' || sendData instanceof String)) { 
    sendData = JSON.stringify(sendData || {});