Web-сервисы

Добавление Web-сервиса
Иерархическая структура Web-сервиса
Свойства Web-сервиса
Свойства операции Web-сервиса
Свойства параметра

Механизм Web-сервисов позволяет использовать 1С:Предприятие 8 как набор сервисов в сложных распределенных и гетерогенных системах, а также позволяет интегрировать 1С:Предприятие 8 с другими промышленными системами использованием сервисно-ориентированной архитектуры.

Подготовленные Web-сервисы публикуют в соответствующем каталоге на веб-сервере.

Добавление Web-сервиса

Для того чтобы добавить Web-сервис в дерево конфигурации следует выделить ветку "Общие - Web-сервисы" и выполнить команду контекстного меню "Добавить".

В результате выполнения команды будет открыто окно редактирования модуля Web-сервиса и палитра свойств, содержащая свойства нового Web-сервиса.

Иерархическая структура Web-сервиса

Каждый Web-сервис, описываемый в дереве конфигурации, может содержать набор операций. Каждой операции должна соответствовать экспортная процедура, описанная в модуле Web-сервиса.

В свою очередь каждая операция может содержать набор параметров, имена которых должны соответствовать именам параметров процедуры, описывающей данную операцию.

Свойства Web-сервиса

Помимо общих свойств объектов конфигурации, Web-сервис содержит следующие свойства:

• URI пространства имен – содержит URI пространства имен веб-сервиса. Каждый Web-сервис может быть однозначно идентифицирован по своему имени и URI пространству имен, которому он принадлежит;
• Пакеты XDTO – перечень пакетов XDTO, типы которых могут использоваться в качестве типов возвращаемого значения операций и типов параметров операций Web-сервиса;
• Имя файла публикации – имя файла описания Web-сервиса, который расположен на веб-сервере.

Кроме этого палитра свойств для Web-сервиса содержит ссылку Модуль, которая позволяет открыть для редактирования модуль Web-сервиса.

Свойства операции Web-сервиса

Помимо общих свойств объектов конфигурации, операция Web-сервиса содержит следующие свойства:

• Тип возвращаемого значения – тип значения, которое возвращает операция Web-сервиса. Может являться типом значения XDTO или типом объекта XDTO;
• Возможно пустое значение – показывает, может ли возвращаемое значение принимать неопределенное значение;
• В транзакции – показывает, будет ли выполняться код модуля Web-сервиса в транзакции, или нет. Если свойство установлено, то при вызове Web-сервиса автоматически будет начата транзакция, а при завершении – транзакция будет либо зафиксирована, либо произойдет откат транзакции (в зависимости от результатов выполнения). Если свойство не установлено – при начале исполнения модуля Web-сервиса транзакция не будет начата;
• Имя процедуры – имя процедуры модуля Web-сервиса, которая будет выполнена при вызове данного свойства.

Свойства параметра

Помимо общих свойств объектов конфигурации, параметр операции Web-сервиса содержит следующие свойства:

• Тип значения – тип значения параметра операции Web-сервиса. Может являться типом значения XDTO, или типом объекта XDTO;
• Возможно пустое значение  – показывает, может ли значение параметра операции принимать неопределенное значение;
• Направление передачи – определяет направление передачи данных с помощью данного параметра. Возможные значения:
  • Входной – означает, что параметр используется для передачи данных Web-сервису;
  • Выходной – означает, что параметр используется для получения данных от Web-сервиса;
  • Входной – Выходной – означает, что параметр может использоваться как для передачи данных, так и для их получения от Web-сервиса.