Сервис доступен для использования одновременно по двум протоколам: SOAP и JSON-RPC. Используемый протокол указывается с помощью параметра Content-Type в заголовке http-запроса:
application/json. Используется протокол JSON-RPC.
text/xml. Используется протокол SOAP.
На базе веб-сервиса PP.SOM организована работа BI-сервера и сервера безопасности продукта «Форсайт. Аналитическая платформа». В зависимости от того, с чем осуществляется работа (BI-сервер или сервер безопасности), имеются две конечных точки подключения. Адреса конечных точек имеют следующий формат:
http://<ServerName | IP-address>[:<Port>][/<VirtualCatalog>]/axis2/services/PP.SOM.Som. Адрес для работы с BI-сервером;
http://<ServerName | IP-address>[:<Port>][/<VirtualCatalog>]/axis2/services/PP.SOM.SomSec. Адрес для работы с сервером безопасности.
Примечание. На x64 компьютерах наименование виртуального каталога может содержать суффикс - x64.
В зависимости от того, как предполагается организация работы, должен использоваться соответствующий дистрибутив для установки BI-сервера и сервера безопасности. Более подробно читайте в подразделах «Установка и настройка BI-сервера» и «Установка сервера безопасности».
Список операций и их параметров можно получить из сгенерированного wsdl-файла, доступного по адресу: http://<BIServer>/axis2/services/PP.SOM.Som?wsdl (при работе с сервером безопасности http://<BIServer>/axis2/services/PP.SOM.SomSec?wsdl). Все JSON-структуры аналогичны XML-структурам, используемым при работе с протоколом SOAP.
Важно. Следующие
части ссылок являются регистрозависимыми и должны быть указаны в соответствующем
виде:
1) services/PP.SOM.Som или services/PP.SOM.SomSec.
2) wsdl.
При работе через сервер безопасности наименования и параметры операций совпадают с операциями BI-сервера, но список доступных операций будет ограничен: будут доступны операции для работы с репозиторием, метаданными объектов и для работы с SQL-объектами.
См. также:
Использование веб-сервиса в Microsoft Visual Studio | Подключение к репозиторию