Web-сервисы
Механизм Web-сервисов позволяет использовать 1С:Предприятие 8.1 как набор сервисов в сложных распределенных и гетерогенных системах, а также позволяет интегрировать 1С:Предприятие 8.1 с другими промышленными системами использованием сервисно-ориентированной архитектуры.
Подробнее об использовании механизма Web-сервисов см. Главу 15 «Механизм Web-сервисов».
Добавление Web-сервиса
Для того чтобы добавить Web-сервис в дерево конфигурации следует выделить ветку «Общие | Web-сервисы» и выполнить команду контекстного меню «Добавить».
В результате выполнения команды будет открыто окно редактирования Web-сервиса (см. параграф «Окно редактирования объекта»).
На закладке «Прочее» окна редактирования веб-сервиса следует установить следующие параметры:
· URI пространства имен – содержит URI пространства имен веб-сервиса. Каждый Web-сервис может быть однозначно идентифицирован по своему имени и URI пространству имен, которому он принадлежит;
· Пакеты XDTO – перечень пакетов XDTO, типы которых могут использоваться в качестве типов возвращаемого значения операций и типов параметров операций Web-сервиса;
· Имя файла публикации – имя файла описания Web-сервиса, который расположен на веб-сервере (о публикации Web-сервисов см. параграф «Публикация Web-сервисов»).
Кроме этого на этой закладке содержится кнопка Модуль, которая позволяет открыть для редактирования модуль Web-сервиса.
Иерархическая структура Web-сервиса
Каждый Web-сервис, описываемый в дереве конфигурации, может содержать набор операций. Каждой операции должна соответствовать экспортная процедура, описанная в модуле Web-сервиса.
В свою очередь каждая операция может содержать набор параметров, имена которых должны соответствовать именам параметров процедуры, описывающей данную операцию.
Операции Web-сервиса
На закладке «Операции» выполняется добавление операции Web-сервиса. Редактирование свойств операции выполняется в палитре свойств:
· Тип возвращаемого значения – тип значения, которое возвращает операция Web-сервиса. Может являться типом значения XDTO или типом объекта XDTO;
· Возможно пустое значение – показывает, может ли возвращаемое значение принимать неопределенное значение;
· В транзакции – показывает, будет ли выполняться код модуля Web-сервиса в транзакции, или нет. Если свойство установлено, то при вызове Web-сервиса автоматически будет начата транзакция, а при завершении – транзакция будет либо зафиксирована, либо произойдет откат транзакции (в зависимости от результатов выполнения). Если свойство не установлено – при начале исполнения модуля Web-сервиса транзакция не будет начата;
· Имя процедуры – имя процедуры модуля Web-сервиса, которая будет выполнена при вызове данного свойства.
Параметр операции
На закладке «Операции» для указанной операции осуществите задание параметров операции Web-сервиса. Редактирование свойств параметра выполняется в палитре свойств.
Помимо общих свойств объектов конфигурации, параметр операции Web-сервиса содержит следующие свойства:
· Тип значения – тип значения параметра операции Web-сервиса. Может являться типом значения XDTO, или типом объекта XDTO;
· Возможно пустое значение – показывает, может ли значение параметра операции принимать неопределенное значение;
· Направление передачи – определяет направление передачи данных с помощью данного параметра. Возможные значения:
Входной – означает, что параметр используется для передачи данных Web-сервису;
Выходной – означает, что параметр используется для получения данных от Web-сервиса;
Входной – Выходной – означает, что параметр может использоваться как для передачи данных, так и для их получения от Web-сервиса.
Указание типов, определяемых системой 1С:Предприятие 8.1
Чтобы в веб-сервисе воспользоваться типами, определяемыми системой 1С:Предприятие 8.1 (например в параметрах и возвращаемом значении операций), нужно в конфигурации определить пакеты XDTO и для каждого пакета указать в его списке импортируемых пакетов (свойство Директивы импорта) набор пакетов платформы, в которые эти типы входят. URI пространства имен для указания типа указано в статье Синтакс-Помощника по объекту данного типа.
Публикация Web-сервисов
Задача публикации Web-сервисов сводится к размещению конфигурационных файлов *.1cws Web-сервисов в соответствующем каталоге веб-сервера с соответствующими настройками для веб-сервера. Для того, чтобы выполнить публикацию Web-сервисов, следует выполнить команду меню «Администрирование | Публикация Web-сервисов».
В результате выполнения этой команды будет открыто окно публикации Web-сервисов.
Окно публикации Web-сервисов содержит путь к веб-серверу и два списка:
· «Web-сервисы» – список Web-сервисов конфигурации;
· «Публикация» – список Web-сервисов, опубликованных на указанном веб-сервере.
С помощью кнопки «Соединение…» следует указать веб-сервер, на котором требуется опубликовать Web-сервисы.
Окно выбора пути к веб-серверу позволяет указать путь двумя способами:
· на закладке «Файлы» – этот способ используется в том случае, когда публикация выполняется на том же компьютере, на котором установлен веб-сервер. В качестве пути указывается локальный каталог, соответствующий интернет-странице, с которой будет выполняться вызов публикуемого Web-сервера;
· на закладке «FTP сайт» – этот способ используется в том случае, когда требуется опубликовать Web-сервис на удаленном компьютере. Для выполнения публикации необходимо указать параметры FTP-соединения с удаленным компьютером и каталог, в котором будет опубликован Web-сервис.
Публикация выбранного Web-сервиса осуществляется с помощью кнопки «Опубликовать»
Для отмены публикации Web-сервиса используется кнопка «Удалить» .
Для обновления списка опубликованных Web-сервисов используется кнопка «Обновить текущий список» –.
WS-ссылки
Система 1С:Предприятие 8.1 может использовать веб-сервисы, предоставляемые другими поставщиками, с помощью статических ссылок, создаваемых в дереве конфигурации.
Добавление WS-ссылки
Для того чтобы добавить статическую ссылку на внешний веб-сервис в дерево конфигурации, следует выделить ветку WS-ссылки и выполнить команду контекстного меню «Добавить», или соответствующую команду меню «Действия».
В открывшемся окне следует ввести URL описания добавляемого веб-сервиса, например: http://www.1c.ru/dem/products.1cws?wsdl.
Иерархическая структура WS-ссылки
Просмотр иерархической структуры WS-ссылки выполняется в окне просмотра WS-ссылки. Значения свойств элементов ссылки можно просмотреть в палитре свойств.
Для того чтобы открыть окно просмотра WS-ссылки следует выделить в дереве конфигурации требуемую WS-ссылку и выполнить команду контекстного меню Свойства. После этого в палитре свойств воспользоваться ссылкой WS-ссылка, которая открывает окно просмотра WS-ссылки.
Окно просмотра WS-ссылки содержит иерархическую структуру WS-ссылки, отображенную в виде дерева.
На первом уровне иерархии могут располагаться:
· Модель данных – содержит перечень пакетов XDTO, описывающих структуру типов, используемую веб-сервисами, на которые ссылается данная WS-ссылка;
· Web-сервисы – перечень Web-сервисов, на которые ссылается данная ссылка.
Просмотр структуры и свойств модели данных выполняется аналогично работе с пакетами XDTO («Иерархическая структура пакета XDTO»), за исключением того, что редактирование свойств пакетов, отображаемых в окне просмотра WS-ссылки, невозможно.
Просмотр структуры Web-сервисов выполняется аналогично работе с Web-сервисами («Иерархическая структура Web-сервиса») за исключением того, что для каждого Web-сервиса отображаются поддерживаемые точки подключения Web-сервиса, для которых, в свою очередь, отображается список операций и параметров каждой операции.
Различные точки подключения Web-сервиса позволяют выполнять операции, используя различные протоколы.
