BattleCaseкомпьютерная помощь

Какие веб сервисы бывают. WEB-сервис

- (от англ. web-service, синоним - онлайновая служба). Под веб-сервисами понимают услуги, которые предоставляются в Интернете с помощью специальных программ.

Какие веб сервисы бывают. WEB-сервис
Содержание
  1. Книги
  2. Введение
  3. Общий подход
  4. Сервер
  5. Клиент
  6. Коротко о главном
  7. Архитектура и протоколы Web-сервисов
  8. Задачи веб-сервисов
  9. Создание веб-сервиса 1С
  10. Пример создания простого WEB-сервиса

Например, распространены такие сервисы, как: , хостинг, электронная почта, хранение в Интернете различной информации (файлы, закладки), календарь и т.д. Важное свойство веб-сервиса состоит в том, что он не зависит от вашего провайдера, компьютера или браузера - вы можете работать со своими данными в любой точке мира, где у вас есть доступ в .

WEB-сервис

Князев А.А. Энциклопедический словарь СМИ. - Бишкек: Издательство КРСУ

А. А. Князев

Книги

  • Информационные технологии в туристической индустрии , В. Н. Шитов. В пособии подробно рассматриваются компьютерные технологии общего назначения с использованием популярных пакетов Microsoft Office 2010 и альтернативных комплексов, использование... Купить за 546 руб
  • 75 готовых решений для вашего Web-сайта на PHP , Стейнмец У., Вард Б.. Каждый, кто делает или собирается сделать свой web-сайт, неизбежно сталкивается с целым рядом задач и трудностей: как сделать блог на сайте....... "прикрутить" голосование, закрыть определенные...

Заголовок топика - это действительно вопрос, т.к. Я сам не знаю, что это и впервые попробую поработать с этим в рамках настоящей статьи. Единственное, что могу гарантировать, что код, представленный ниже, будет работать, однако мои фразы будут лишь предположениями и догадками о том, как я сам все это понимаю. Итак, поехали

Введение

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

Все этого сокращенно называется RPC (Remote Procedure Calling - удаленный вызов процедур). В качестве примеров можно привести технологии CORBA, а для Java - RMI (Remote Method Invoking - удаленный вызов методов). И все вроде в них хорошо, особенно в CORBA, т.к. С ней можно работать на любом языке программирования, но чего-то все же не хватало.

Полагаю, что минусом CORBA является то, что она работает через какие-то свои сетевые протоколы вместо простого HTTP, который пролезет через любой firewall.

Идея веб-сервиса заключалась в создании такого RPC, который будет засовываться в HTTP пакеты. Так началась разработка стандарта. Какие у этого стандарта базовые понятия:

  1. SOAP . Прежде чем вызвать удаленную процедуру, нужно этот вызов описать в XML файле формата SOAP. SOAP - это просто одна из многочисленных XML разметок, которая используется в веб-сервисах. Все, что мы хотим куда-то отправить через HTTP, сначала превращается в XML описание SOAP, потом засовывается в HTTP пакет и посылается на другой компьютер в сети по TCP/IP.
  2. WSDL . Есть веб-сервис, т.е. Программа, методы которой можно удаленно вызывать. Но стандарт требует, чтобы к этой программе прилагалось описание, в котором сказано, что "да, вы не ошиблись - это действительно веб-сервис и можно у него вызвать такие-то такие-то методы". Такое описание представляется еще одним файлом XML, который имеет другой формат, а именно WSDL. Т.е. WSDL - это просто XML файл описания веб-сервиса и больше ничего.

Почему так кратко спросите вы? А по подробней нельзя? Наверное можно, но для этого придется обратиться к таким книгам как Машнин Т. "Web-сервисы Java". Там на протяжении первых 200 страниц идет подробнейшее описание каждого тега стандартов SOAP и WSDL. Стоит ли это делать? На мой взгляд нет, т.к. Все это на Java создается автоматически, а вам нужно лишь написать содержимое методов, которые предполагается удалено вызывать.

Так вот, в Java появился такой API, как JAX-RPC. Если кто не знает, когда говорят, что в Java есть такой-то API, это означает, что есть пакет с набором классов, которые инкапсулируют рассматриваемую технологию. JAX-RPC долго развивался от версии к версии и в конечном итоге превратился в JAX-WS. WS, очевидно, означает WebService и можно подумать, что это простое переименование RPC в популярное нынче словечко.

Это не так, т.к. Теперь веб-сервисы отошли от первоначальной задумки и позволяют не просто вызывать удаленные методы, но и просто посылать сообщения-документы в формате SOAP. Зачем это нужно я пока не знаю, вряд ли ответ здесь будет "на всякий случай, вдруг понадобится". Сам бы хотел узнать от более опытных товарищей.

Ну и последнее, далее появился еще JAX-RS для так называемых RESTful веб-сервисов, но это тема отдельной статьи.

На этом введение можно заканчивать, т.к. Далее мы будем учиться работать с JAX-WS.

Общий подход

В веб-сервисах всегда есть клиент и сервер. Сервер - это и есть наш веб-сервис и иногда его называют endpoint (типа как, конечная точка, куда доходят SOAP сообщения от клиента). Нам нужно сделать следующее:

  1. Описать интерфейс нашего веб-сервиса
  2. Реализовать этот интерфейс
  3. Запустить наш веб-сервис
  4. Написать клиента и удаленно вызвать нужный метод веб-сервиса

Запуск веб-сервиса можно производить разными способами: либо описать класс с методом main и запустить веб-сервис непосредственно, как сервер, либо задеплоить его на сервер типа Tomcat или любой другой. Во втором случае мы сами не запускаем новый сервер и не открываем еще один порт на компьютере, а просто говорим контейнеру сервлетов Tomcat, что "мы написали тут классы веб-сервиса, опубликуй их, пожалуйста, чтобы все, кто к тебе обратиться, могли нашим веб-сервисом воспользоваться".

В независимости от способа запуска веб-сервиса, клиент у нас будет один и тот же.

Сервер

Запустим IDEA и создадим новый проект Create New Project

. Укажем имя HelloWebService

И нажмем кнопку Next

, далее кнопку Finish

. В папке src

Создадим пакет ru.javarush.ws

. В этом пакете создадим интерфейс HelloWebService:

package

ru.

javarush.

ws;

// это аннотации, т.е. Способ отметить наши классы и методы,

// как связанные с веб-сервисной технологией

import

javax.

jws.

WebMethod;

import

javax.

jws.

WebService;

import

javax.

jws.

soap.

SOAPBinding;

// говорим, что наш интерфейс будет работать как веб-сервис

@WebService

// говорим, что веб-сервис будет использоваться для вызова методов

@SOAPBinding

(style =

SOAPBinding.

Style.

RPC)

public

interface

HelloWebService

// говорим, что этот метод можно вызывать удаленно

@WebMethod

public

String getHelloString

(String name)

В этом коде классы WebService и WebMethod являются так называемыми аннотациям и ничего не делают, кроме как помечают наш интерфейс и его метод, как веб-сервис. Это же относится и к классу SOAPBinding . Разница лишь в том, что SOAPBinding - это аннотация с параметрами. В данном случае используется параметр style со значением, говорящим, что веб-сервис будет работать не через сообщения-документы, а как классический RPC, т.е. Для вызова метода.

Давайте реализуем логику нашего интерфейса и создадим в нашем пакете класс HelloWebServiceImpl . Кстати, замечу, что окончание класса на Impl - это соглашение в Java, по которому так обозначают реализацию интерфейсов (Impl - от слова implementation, т.е. Реализация). Это не требование и вы вольны назвать класс как хотите, но правила хорошего тона того требуют:

package

ru.

javarush.

ws;

// таже аннотация, что и при описании интерфейса,

import

javax.

jws.

WebService;

// но здесь используется с параметром endpointInterface,

// указывающим полное имя класса интерфейса нашего веб-сервиса

@WebService

(endpointInterface =

"ru.javarush.ws.HelloWebService"

public

class

HelloWebServiceImpl

implements

HelloWebService

@Override

public

String getHelloString

(String name)

// просто возвращаем приветствие

return

"Hello, "

+

name +

"!"

Запустим наш веб-сервис как самостоятельный сервер, т.е. Без участия всяких Tomcat и серверов приложений (это тема отдельного разговора). Для этого в структуре проекта в папке src

Создадим пакет ru.javarush.endpoint , а в нем создадим класс HelloWebServicePublisher с методом main:

package

ru.

javarush.

endpoint;

// класс, для запуска веб-сервера с веб-сервисами

import

javax.

xml.

ws.

Endpoint;

// класс нашего веб-сервиса

import

ru.

javarush.

ws.

HelloWebServiceImpl;

public

class

HelloWebServicePublisher

public

static

void

main

(String.

args)

// запускаем веб-сервер на порту 1986

// и по адресу, указанному в первом аргументе,

// запускаем веб-сервис, передаваемый во втором аргументе

Endpoint.

publish

( "

new

HelloWebServiceImpl

Теперь запустим этот класс, нажав Shift+F10

. В консоли ничего не появится, но сервер запущен. В этом можно убедиться набрав в браузере строку . Открывшаяся страница, с одной стороны, доказывает, что у нас на компьютере (localhost) запустился веб-сервер ( на порту 1986, а, с другой стороны, показывает WSDL описание нашего веб-сервиса.

Если вы остановите приложение, то описание станет недоступно, как и сам веб-сервис, поэтому делать этого не будем, а перейдем к написанию клиента.

Клиент

В папке проекта src

Создадим пакет ru.javarush.client , а в нем класс HelloWebServiceClient с методом main:

package

ru.

javarush.

client;

// нужно, чтобы получить wsdl описание и через него

// дотянуться до самого веб-сервиса

import

java.

net.

URL;

// такой эксепшн возникнет при работе с объектом URL

import

java.

net.

MalformedURLException;

// классы, чтобы пропарсить xml-ку c wsdl описанием

// и дотянуться до тега service в нем

import

javax.

xml.

namespace.

QName;

import

javax.

xml.

ws.

Service;

// интерфейс нашего веб-сервиса (нам больше и нужно)

import

ru.

javarush.

ws.

HelloWebService;

public

class

HelloWebServiceClient

public

static

void

main

(String

args)

throws

MalformedURLException {

// создаем ссылку на wsdl описание

URL url =

new

URL

( "

// Параметры следующего конструктора смотрим в самом первом теге WSDL описания - definitions

// 1-ый аргумент смотрим в атрибуте targetNamespace

// 2-ой аргумент смотрим в атрибуте name

QName qname =

new

QName

("

"HelloWebServiceImplService"

// Теперь мы можем дотянуться до тега service в wsdl описании,

Service service =

Service.

create

(url,

qname)

// а далее и до вложенного в него тега port, чтобы

// получить ссылку на удаленный от нас объект веб-сервиса

HelloWebService hello =

service.

getPort

(HelloWebService.

class

// Ура! Теперь можно вызывать удаленный метод

System.

out.

println

(hello.

getHelloString

("JavaRush"

Максимум комментариев по коду я дал в листинге. Добавить мне нечего, поэтому запускаем (Shift+F10). Мы должны в консоли увидеть текст: Hello, JavaRush! Если не увидели, то видимо забыли запустить веб-сервис.

Коротко о главном

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

UPD.

Мы рассмотрели общие понятия использования механизма

"

Web

-сервисов".

Освежим некоторые знания.

Web-сервисы применяются для обмена данными между сервером и клиентом; формат XML используется для "упаковывания" данных в целях взаимопонимания между обоими участниками общения.

РАЗДЕЛ

I

ПРИМЕР РЕАЛИЗАЦИИ

WEB

-СЕРВИСА В СИСТЕМЕ "1С:ПРЕДПРИЯТИЕ"

ЗАДАЧА:

Необходимо создать web-сервис, обращаясь к которому клиенты могут определить всю необходимую информацию по своим заявкам.

Задача является демонстрационной и служит только примером для понимания и обучения механизму

web

-сервисов.

РЕШЕНИЕ:

Шаг 1.

Создадим новую информационную базу без конфигурации для разработки новой конфигурации.

Шаг 2.

Добавим в конфигурацию несколько новых объектов

Справочник "Клиенты";

Документ "Заявка";

Перечисление "СтатусыЗаявок".

Шаг 3.

Создадим новый XDTO-пакет.

Почему и для чего мы создаем XDTO-пакет? Подробнее об использовании механизма XDTO можно прочитать в "Глава 16. Руководство разработчика" и .

Коротко отметим лишь только то, что механизм XDTO является универсальным способом представления данных для взаимодействия с различными внешними источниками данных и программными системами.

В нашем случае пакет XDTO создается для описания возвращаемого значения web-сервиса.

Раскроем ветку "Общие" → "XDTO-пакеты" → Добавить

Укажем имя XDTO-пакета " DocumentsData

" и его пространство имен или (для облегчения понимания и процесса обучения, мы указываем локальный IP-адрес компьютера, где установлен web-сервер (поддерживаемые web-сервера: IIS или Apache)). Каждый Web-сервис может быть однозначно идентифицирован по своему имени и URI пространству имен, которому он принадлежит.

Наш пакет содержит два типа объектов XDTO:

1) Сustomer

- для передачи данных элемента справочника "Клиенты".

- Name

2) Document

- для передачи данных документа "Заявки"

Этот тип объекта XDTO будет содержать следующие свойства:

- Сustomer

- тип Сustomer из пространства имен ; представляет собой ссылку на объект XDTO, который мы определили выше;

- Status

- тип string из пространства имен ;

- Numder

- тип string из пространства имен .

Шаг 4.

Добавим в конфигурацию новый Web-сервис

Раскроем ветку "Общие" → "Web-сервисы" → Добавить

Для Web-сервиса укажем следующими значения свойств:

Имя - DocumentsData

URI Пространства имен -

Пакеты XDTO - DocumentsData

Или

Имя файла публикации - request.1cws

Шаг 5.

У созданного Web-сервиса определим операцию " GetData

"

Значения свойств операции:

Тип возвращаемого значения - Document (

Возможно пустое значение - Истина

Имя процедуры - GetData

Шаг 6.

У операции GetData

Определим параметр Сustomer со следующими значениями свойств:

Тип значения - тип string

Из пространства имен

Направление передачи - входной

Шаг 7.

Откроем модуль созданного Web-сервиса и поместить в него функцию Получить(), которая будет выполняться при вызове данного Web-сервиса.

Функция GetData(Сustomer)

// Получить типы объектов XDTO

КлиентТип = ФабрикаXDTO.Тип(" "Сustomer");

ЗаявкаТип = ФабрикаXDTO.Тип(" "Document");

// Получаем клиента

КлиентСсылка = Справочники.Клиенты.НайтиПоНаименованию(Сustomer);

Если Не ЗначениеЗаполнено(КлиентСсылка) Тогда

Возврат Неопределено;

КонецЕсли;

Запрос = Новый Запрос;

Запрос.Текст =

"ВЫБРАТЬ ПЕРВЫЕ 1

| Заявка.Ссылка,

| ПРЕДСТАВЛЕНИЕ(Заявка.Статус) КАК Статус,

| Заявка.Номер

|ИЗ

| Документ.Заявка КАК Заявка

|ГДЕ

| Заявка.Клиент = &Клиент";

Запрос.УстановитьПараметр("Клиент", КлиентСсылка);

РезультатЗапроса = Запрос.Выполнить();

Если РезультатЗапроса.Пустой() Тогда

Возврат Неопределено;

КонецЕсли;

Выборка = РезультатЗапроса.Выбрать();

Выборка.Следующий();

Документ = Выборка.Ссылка.ПолучитьОбъект();

// Создать объект XDTO заявки

Заявка = ФабрикаXDTO.Создать(ЗаявкаТип);

Заявка.Numder = Выборка.Номер;

Клиент = ФабрикаXDTO.Создать(КлиентТип);

Клиент.Name = КлиентСсылка.Наименование;

Заявка.Сustomer = Клиент;

Заявка.Status = Выборка.Статус;

// Вернуть заявку

Возврат Заявка;

КонецФункции

Шаг 8.

Опубликуем созданный Web-сервис на веб-сервере.

Пункт меню Конфигуратор: "Администрирование" → "Публикация на Web-сервере".

На вкладке "Web-сервисы" устанавливаем признак "Публиковать Web-сервисы" и напротив нашего нового Web-сервиса также ставим "галочку".

РАЗДЕЛ

II

ПРИМЕР ОБРАЩЕНИЯ К

WEB

-СЕРВИСУ СИСТЕМЫ "1С:ПРЕДПРИЯТИЕ" ИЗ СТОРОННЕГО ПРИЛОЖЕНИЯ

Основное назначение механизма Web-сервисов в системе "1С:Предприятие" - это передача необходимых данных сторонним приложениям.

Рассмотрим пример разработки приложения на Delphi обращения к нашему web-сервису из первого раздела данной статьи.

Шаг 1.

Создадим новый проект и на форме разместим несколько элементов управления

Текстовое поле - используется для вывода полученной от web-сервиса информации;

Две кнопки - очистка текстового поля и обращение к web-сервису;

Поле ввода - передаваемый в web-сервис параметр.

Шаг 2.

Выполняем импорт WSDL-файла

В результате мы получаем новый модуль request

(такое наименование мы определили непосредственно в 1С). В данном модуле имеется все необходимая информация по web-сервису.

Шаг 3.

Напишем обработчик вызова web-сервиса

Переменная DocumentDataPortType уже определена в модуле request

Шаг 4.

Запустить приложение и выполнить проверку.

РАЗДЕЛ

III

ПРИМЕР ОБРАЩЕНИЯ К

WEB

-СЕРВИСУ В СИСТЕМЕ "1С:ПРЕДПРИЯТИЕ"

Шаг 1.

Создадим новую внешнюю обработку с именем "WEB_Service"

Шаг 2.

Для обработки определим новую форму

Шаг 3.

У формы укажем несколько реквизитов

Клиент - тип "Строка"

КлиентВозврат - тип "Строка"

НомерВозврат - тип "Строка"

СтатусВозврат - тип "Строка".

Выведем реквизиты на форму.

Шаг 4.

Добавим команду формы " ПолучитьДанные

"

Укажем обработчик команды

&НаКлиенте

Процедура ПолучитьДанные(Команда)

ПолучитьДанныеНаСервере(Клиент);

КонецПроцедуры

Процедура ПолучитьДанныеНаСервере(Клиент)

// Создать WS-прокси на основании ссылки и выполнить операцию Получить()

Определение = Новый WSОпределения("

Прокси = Новый WSПрокси(Определение, " "DocumentsData", "DocumentsDataSoap");

ДанныеЗаявки = Прокси.GetData(Клиент);

Если ДанныеЗаявки = Неопределено Тогда

КлиентВозврат = "Неопределено";

СтатусВозврат = "Неопределено";

НомерВозврат = "Неопределено";

Возврат;

КонецЕсли;

КлиентВозврат = ДанныеЗаявки.Сustomer.Name;

СтатусВозврат = ДанныеЗаявки.Status;

НомерВозврат = ДанныеЗаявки.Numder;

КонецПроцедуры

Система "1С:Предприятие" может использовать веб-сервисы, предоставляемые другими поставщиками, двумя способами:

С помощью статических

Ссылок, создаваемых в дереве конфигурации;

"плюс":

Большая скорость работы;

"минус":

Повторный импорт WSDL-описания средствами конфигуратора и сохранение измененной конфигурации.

С помощью динамических

Ссылок, создаваемых средствами встроенного языка

(соответственно "минусы" статических для динамических - "плюсы")

РАЗДЕЛ

IV

ОТЛАДКА WEB-СЕРВИСОВ В СИСТЕМЕ "1С:ПРЕДПРИЯТИЕ"

Для локального web-сервиса необходимо:

Шаг 1.

Положить на клиент, где запускается система 1С файлик webservicecfg.xml

Со следующим содержимом

Шаг 2.

В файл default

vrd

Публикации конфигурации добавить строку

Шаг 3.

В конфигураторе выбрать пункт меню

"Отладка" → "Подключение" → "Автоматическое подключение" → "Web-сервисы на сервере"

Шаг 4.

Нажать на кнопку "OK"

Для серверного варианта надо еще сервер 1с запускать в режим отладки с ключом /debug

Web-сервис (служба) - программа, которая организовывает взаимодействие между сайтами. Информация с одного портала передается на другой.

Например, есть авиакомпания. У нее много рейсов, соответственно, много билетов. Информацию через веб-службу она передает сайту-агрегатору тур-путешествий. Пользователь, который заходит на агрегатор, сможет прямо там купить билеты этой авиакомпании.

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

Информация в интернете разнородна. Сайты управляются разными системами. Используются разные протоколы передачи и шифрования. Веб-сервисы упрощают обмен информацией между разными площадками.

Архитектура и протоколы Web-сервисов

Можно определить 3 инстанции, которые взаимодействуют между собой: каталог, исполнитель и заказчик. После создания сервиса, исполнитель регистрирует его в каталоге, а там сервис находит заказчик.

Механизм обмена данными формируется в описании Web Services Description. Это спецификация, охватывающая форматы пересылки, типы контента, транспортные протоколы, которые применяются в процессе обмена сведениями между заказчиком и транспортировщиком услуг.

Сегодня чаще всего используются несколько технологий для реализации различных веб-сервисов:

  1. TCP/IP - протокол, который понимается практически любым сетевым оборудованием, от мэйнфреймов до портативных устройств и PDA.
  2. HTML - универсальный язык разметки, используемый для демонстрации контента устройствами потребителей.
  3. XML - универсальное средство для обработки всех разновидностей данных. На его базе могут работать и прочие протоколы обмена информацией: SOAP и WSDL.
  4. UDDI - универсальный источник распознавания, интеграции и описания. Работает, как правило, в частных сетях и пока не нашел достаточного распространения.

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

Преимущества

  • Создание необходимых условий для взаимодействия программных компонентов вне зависимости от платформы.
  • Веб-сервисы основываются на открытых стандартных протоколах. За счет внедрения XML обеспечивается простота формирования и настройки веб-сервисов.
  • Применение HTTP гарантирует взаимодействие систем посредством межсетевого доступа.

Недостатки

  • Невысокая производительность и большой объем трафика, в сравнении с системами RMI, CORBA, DCOM, за счет использоваться XML-сообщений в разрезе текста.
  • Уровень безопасности. Все современные веб-сервисы должны внедрять кодирование, и требовать авторизации пользователя. Хватит ли здесь наличия HTTPS или необходимы более надежные протоколы, как XML Encryption, SAML и т.д., - решаются в ходе разработки.

Задачи веб-сервисов

Веб-сервисы могут использоваться во многих сферах.

B2B-транзакции

Интеграция процессов идет сразу, без участия людей. Например, пополнение каталога интернет-магазина новыми товарами. Их привозят на склад, и кладовщик отмечает в базе данных приход. Автоматически информация передается в интернет-магазин. И покупатель вместо пометки "Нет на складе" на карточке товара видит его количество.

Интеграция сервисов предприятий

Если в компании используются корпоративные программы, то веб-сервис поможет настроить их совместную работу.

Создание системы клиент-сервер

Сервисы используются, чтобы настроить работу клиента и сервера. Это дает преимущества:

  • Можно продавать не само программное обеспечение, а делать платным доступ к веб-сервису;
  • Легче решать проблемы с использованием стороннего ПО;
  • Проще организовывать доступ к контенту и материалам сервера.

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

Сегодня WEB сервисы используются практически повсеместно - именно они предоставляют нам информацию о рейсах самолетов и поездов, курсах валют и погоде. Неудивительно, что и 1С обладает возможностью создания собственных WEB сервисов, позволяющих выступать как в роли поставщика, так и потребителя. Данный механизм встроен в платформу "1С:Предприятие 8.3" и разработчики могут добавлять даже в типовую конфигурацию собственные объекты типа "WEB-сервисы". Их архитектура построена на наборе сервисов, позволяющих обмениваться информацией с другим программным обеспечением.

Создание веб-сервиса 1С

Одним из главных преимуществ WEB-сервисов 1С является отсутствие необходимости давать прямой доступ к данным ИБ. Правильно настроенный веб-сервис 1С позволяет другим приложениям пользоваться функциями извне. В таких случаях определять право пользования данными по заданным параметрам должна сама функция по прописанным разработчиком правилам.

Как создавать веб-сервис в 1С?

Чтобы определенная функция системы 1С стала доступна внешнему ПО, необходимо выполнить следующий алгоритм действий:

  1. Зайти в конфигурацию и в определенной ветке дерева добавить объект WEB-сервис;
  2. Описать все операции, которые сможет выполнять наш функционал. Описание функций производиться в модуле на встроенном в 1С языке;
  3. Добавить описание параметров функций веб-сервиса. Учтите, что типы данных описываются с учетом существующих типов механизма XDTO, появившегося в платформе версии 8.1;
  4. Опубликовать созданный WEB-сервис на сервере. Механизм, встроенный в платформу 1С, поддерживает следующие стандарты:
  • SSL/TLS
  • WS-I BP

Пример создания простого WEB-сервиса

Чтобы наиболее наглядно продемонстрировать работу механизма WEB-сервисов, создадим пример - функционал, определяющий длину введенной строки. Программное обеспечение передаст в качестве параметра запроса строку, а функция, описанная в 1С, вернет число символов. При создании нужно помнить, что публикация этого механизма даст возможность обращения к нему различного ПО. Так как не каждое ПО способно воспринимать кириллицу, будем называть объекты конфигурации, используя латинские знаки.

Открываем конфигуратор, находим в дереве ветку "WEB-сервисы" и добавляем новый сервис "wa_LengthString". Также необходимо на вкладке "Операции" добавить новую операцию. Назовем ее "CalcLengthString", в свойствах укажем тип возвращаемого значения - int или integer и создадим внутри нее параметр "InputString". Тип значения оставляем string.

Теперь необходимо прописать действие функции CalcLengthString в модуле WEB-сервиса. Для этого открываем свойства созданной функции и нажимаем кнопку в виде лупы справа, у поля ввода "Имя процедуры". 1С автоматически создаст функцию в модуле нашего WEB-сервиса и откроет его для того, чтобы мы описали действие CalcLengthString. Воспользуемся этим и напишем действие функции - определение длины вводимой строки.

Фактически на этом создание простейшего WEB-сервиса закончено. Теперь необходимо "выложить" этот сервис в общий доступ, чтобы стороннее ПО или другие системы 1С могли пользоваться данным функционалом.

Для того чтобы мы смогли опубликовать созданный веб-сервис с его функциональностью, нам необходимо иметь доступ на сайт. Перед тем как мы начнем публикацию сервиса, необходимо проверить имя файла в свойствах созданного модуля wa_LengthString. Оно должно быть понятное, простое и иметь расширение "1cws".

Теперь настало время публиковать созданный нами WEB-сервис на сервере. Эта возможность появилась в версии платформы 8.3 и многие компании уже поняли всю пользу этого функционала. Для того чтобы приступить к публикации, необходимо в конфигураторе открыть форму "Администрирование/Публикация на веб-сервере...".

В открывшемся окне нам необходима настройка Web сервисов 1С и заполнение определенных полей:

  • Имя. Обозначает папку на веб-сервере, в которой будет храниться описание нашего веб-сервиса. Будьте внимательны к регистрам, так как иногда серверы различают символы большого и малого регистра;
  • Веб-сервер. Необходимо выбрать сервер из установленных на компьютере;
  • Каталог. Вы должны выбрать путь к папке, где хранятся данные веб-сервера по настройке подключения. Используются исключительно латинские буквы;
  • Два признака типа "Булево". Первый нам пригодиться, если необходимо настроить доступ через веб-клиент к конфигурации. Для того чтобы опубликовать сервис 1С, необходимо поставить вторую отметку.

Остается лишь проверить, что у нужного WEB-сервиса установлена галка в первом столбце, и нажать на "Опубликовать".

Так как данный механизм еще достаточно новый, то вы можете столкнуться с ошибкой вида "Ошибка при выполнении файловой операции...". В этом случае вам нужно просто повторить нажатие "Опубликовать". В большинстве случаев это помогает, и вам покажется сообщение о том, что публикация веб-сервиса выполнена.

Ru//ws/.1cws?wsdl

В ответ на такой запрос адреса браузер должен отобразить структуру файла XML. Если же вы видите пустую страницу, ошибку или непонятные символы (проблемы с кодировкой), то нужно еще раз проверить все действия. Также не лишним будет убедиться, что сервер настроен верно, и у вас есть к нему доступ. После успешной публикации WEB-сервис 1С смогут использовать сторонние приложения.

Рубрика: Новичкам и программирование

Похожие статьи