Настройка web сервисов 1С

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-сервиса позволяют выполнять операции, используя различные протоколы.