Web service client

Модуль Web service client позволяет работать с внешними веб-сервисами и взаимодействовать с удалёнными сайтами. Он сосредоточен на интеграции операций веб-сервисов как действий Rules, но также может использоваться как провайдер данных для других модулей.

Модуль имеет интерфейс, который позволяет управляющему сайтом создавать описания REST и SOAP сервисов с соответствующими им операциям и типами данных. Описания терминов могут быть отредактированы, клонированы и удалены, а также импортированы и экспортированы для обмена ими между сайтами.

Установка модуля

• Скачайте и установите модуль Entity API
• Скачайте и установите модуль Rules
• Скачайте и распакуйте этот проект в папку модулей
• Настройте модуль на странице «Конфигурация → Веб-сервисы → WSClient»
• Если вы используете REST-сервисы, скачайте и установите модуль Http Client, а также включите модуль Web service client REST
• Если вы используете SOAP-сервисы, включите модуль Web service client SOAP

Описание веб-сервиса

Перед тем, как использовать веб-сервис, его нужно описать. Посмотреть на пример описани, можно, включив модуль Web service client Examples (входит в состав пакета). URL веб-сервиса является базовым URL для REST-сервисов и ссылкой на WSDL-файл SOAP-сервисов. Каждый веб-сервис имеет операции с параметрами и результаты. Веб-сервисы могут иметь и свои типы данных, которые описывают сложные параметры и результаты.

Использование Rules

• Операция веб-сервиса может быть выполнена как действие Rules
• Перейдите на страницу «Конфигурация → Документооборот → Rules»
• Добавьте новое правило и выберите событие (например, «После добавления документа»)
• Добавьте действие и выберите группу веб-сервисов (например, «Google Ajax APIs: Translate text»)
• Заполните необходимые параметры операции напрямую или используйте выбор данных, для выбора других переменных (например, «node:title»)
• Добавьте другие последовательно выполняющиеся действия
• Если вам нужен сложный параметр операции, то создайте его заранее в действии «Create a data structure»

Использование разработчиками

• Можно создать описание веб-сервиса в коде. Для этого, смотрите пример в файле wsclient_examples.module
• Можно вызывать веб-сервисы загружая описание и выполняя его как операцию (данные могут формироваться динамически):
  • $service = wsclient_service_load('google');
  • $result = $service->translate('Hallo Welt', 'de|en');