Как тестировать веб сервис 1с
Веб сервисы в 1С 8.3 — настройка, пример создания и обращения
Web-сервис в 1С 8.3 и 8.2 — объект метаданных, позволяющий интегрировать платформу 1С с другими информационными системами при помощи сервис-ориентированной архитектуры (SOA).
1С умеет как публиковать свои веб-сервисы, так и использовать веб-сервисы других информационных систем с помощью WS-ссылок.
Для публикации своих веб-сервисов необходимы: рабочий веб-сервер (IIS или Apache) и созданные в метаданных веб-сервисы. Пример обращения к веб-сервису 1С и множество другой полезной информации можно увидеть в данной статье.
Пример создания и настройки web-сервиса в 1С
Рассмотрим создание и настройку на примере веб-сервиса, позволяющего производить двухсторонний обмен между базами 1С 8 по средству SOAP.
Для начала обратим внимание на вкладку Прочее:
Структура веб-сервиса 1С
DataExchange — сам web-сервис. UnloadData, LoadData — операции, по сути, описание функций, которые можно вызывать по протоколу SOAP. ExchangePlanName, NodeCode и т.д. — передаваемые веб-сервису значения.
Модуль веб-сервиса
В модуле закладывается самое интересное — описание функций будущего веб-сервиса. В нашем случае мы описываем функционал, позволяющий получать и отправлять данные, используя стандартные механизмы обмена 1С. Т.к. обмен идёт между одной платформой — 1С, то они не требуют сериализации данных.
Проверка работы http сервиса 1С на веб-сервере
Сделать это очень просто — после публикации достаточно вбить адрес веб-сервера 1С в браузер в таком формате:
Если Вы увидите что-то вроде этого, Вы на правильном пути, и веб-сервис опубликован на сервере верно.
Если Вы начинаете изучать 1С программирование, рекомендуем наш бесплатный курс (не забудьте подписаться на YouTube — регулярно выходят новые видео):
К сожалению, мы физически не можем проконсультировать бесплатно всех желающих, но наша команда будет рада оказать услуги по внедрению и обслуживанию 1С. Более подробно о наших услугах можно узнать на странице Услуги 1С или просто позвоните по телефону +7 (499) 350 29 00. Мы работаем в Москве и области.
Ваш браузер устарел, пожалуйста обновите ваш браузер пройдя по ссылке www.microsoft.com/download
Отладка Web сервисов в 1С 8.1 в картинках
Отладка Web сервисов 1С в картинках
Используемые материалы:
«Примеры пользования web сервисов 1С из браузера» //infostart.questa.ru/public/16001/
уважаемого Трактор ( //infostart.questa.ru/profile/10200/ )
Архив содержит:
1) данную статью в формате PDF ;
— «Получатель WS » дополненную обработкой получения списка сотрудников через WS ;
3) файлы comcntrcfg.xml и webservicecfg.xml
1) Подготовка к отладке Web сервиса
Цитата из ЖКК:
«Для указания внешнему соединению или web-сервису необходимости запуска в отладочном режиме используют настройки, размещенные в xml-файлах (comcntrcfg.xml и webservicecfg.xml соответственно), которые должны располагаться в подкаталоге CONF каталога исполняемого файла 1С:Предприятия 8.1 (BIN). Если файл не найден, приложение открывается в обычном режиме.»
Согласно вышенаписанному в подкаталог 1С:Предприятия 8.1 BIN / CONF помещаем два файла comcntrcfg.xml и webservicecfg.xml:
Листинг файла webservicecfg.xml:
2) Настройка отладки в конфигурации, содержащей Web -сервис (Поставщик WS )
Далее идем в меню Сервис-Параметры:
В появившемся диалоге на закладке [Запуск 1С:Предприятия] включаем флажок Устанавливать режим разрешения отладки:
Далее, для подключения предметов отладки, идем в меню Отладка-Подключение…
и в появившемся окне диалога жмем на кнопку [Автоматическое подключение…]
В диалоге Автоматическое подключение включаем флажок WEB -сервисы:
И жмем кнопку ОК.
3) Отладка web -сервиса из Получатель WS .
В появившейся форме вводим критерий поиска в поле [Строка для поиска по ФИО] или же оставляем его пустым и жмем на кнопку :
Хе-хе, я специально не закрывал окно Предметы отладки, чтобы увидеть наше левое подключение (закроем это окно) :).
Далее бежим по коду, смотрим интересные нам места:
(Хе-хе, не волнуйтесь, увидевшие свои ники в списке, я не собираю компромат на вас, это просто моя дань уважения и благодарности к вам, выраженная вот в таком скромном виде 🙂 Хотя список, конечно должен был быть гораздо больше! )
4) Дополнительные инструменты отладки и тестирования.
Прямо здесь же можно ввести параметр и получить результат или проанализировать ошибки:
А вот отлов ошибок в FireBug :
И результат после добавления в файл js варианта firefox 5:
Желаю всем успешного и удачного дня и хорошего настроения!
Изменения
— Небольшие правки в статье;
— Разделил один архив на два: рабочие файлы и саму статью. Общий архив оставил тоже.
Риски использования веб-сервисов 1С
В платформе 1С81 появилась реализация веб-сервисов.
Но их использование чревато рисками:
Клиенту выдается документ о продаже (чек) только в том случае, если транзакция по сервису прошла успешно. Иначе возможна ситуация, когда клиент получит чек и будет пребывать в уверенности, что получил услугу, а на самом деле это не так.
Веб-сервисы SOAP используют WSDL схемы и объекты XDTO для представления данных.
Загрузка WSDL
Для того, чтобы использовать внешний сервис, нужно загрузить его WSDL-схему.
Особенности загрузки WSDL в 1С
Особенность загрузки WSDL в 1С в том, что валидные схемы могут не загружаться. Никакого встроенного валидатора нет, поэтому приходится искать ошибку методом деструктивного анализа, последовательно уменьшая количество элементов в схеме. Можно, например, удалить описание веб-сервиса.
1С не любит слово « policies ». Если WS-ссылка не загружается, нужно убрать все, что связано с этим словом в любом XML-редакторе.
Обработка для тестирование работающего внешнего веб-сервиса
Для тестирования работающего внешнего веб-сервиса используйте обработку «ТестПроизвольногоВебСервиса.epf» из пакета к этой статье.
Тестирование можно использовать на примере сервиса Morpher, склоняющего имена (адрес сервиса http://www.morpher.ru/WebServices/Morpher.asmx?WSDL ):
Таким способом можно протестировать любой сервис, который имеет простые точки входа, содержащие параметры простых типов: число, дата, строка.
В обработке можно указать также логин и пароль, которые требуются для авторизации доступа к веб-сервису.
Стандартные средства отладки сервисов
SOAP и HTTPS
К сожалению, SOAP в 1С достаточно капризно ведет себя при работе через протокол HTTPS, практика показывает, что добиться HTTPS соединения невозможно, хотя возможность и продекларирована в платформе. Сказывается отсутствие средств диагностики и отладки для выяснения причин, из-за которых не устанавливается соединение. Поэтому удобно использовать SOAP через CURL.
Встроенный механизм использования HTTPS подразумевает, что все сертификаты должны быть опубликованы в общем файле pem в каталоге программы 1С.
Использование 1С как сервиса
Правилом хорошего тона является создание в сервисе операцию, которая информирует о том, что сервис доступен. Это облегчает жизнь интеграторов, им будет проще проверять, налажена ли связь с сервисом.
Например, можно использовать операцию Hello без параметров, которая просто возвращает булево значение Истина.
Публикация веб-сервиса
Окно выбора пути к веб-серверу позволяет указать путь двумя способами:
Публиковать можно в локальном каталоге или по FTP. Можно публиковать и на удаленный сервер по UNC-пути, если удаленный сервер входит в локальную сеть.
Авторизация к веб-сервису 1С
Для доступа к сервису нужно пройти аутентификацию.
Если требуется несколько пользователей, то можно создать несколько логинов для веб-сервера, к каждому из них привязать пользователя Windows и соответственно, прописать в 1С доступ к пользователям Windows.
В свойствах Пользователь и Пароль объекта WSПрокси используется не логин 1С, а логин пользователя веб-сервера.
Тестирование веб-сервиса 1С
Для тестирования 1с как веб-сервиса используйте обработку «ТестПроизвольногоВебСервиса.epf», как описано в разделе «Тестирование работающего внешнего веб-сервиса».
Файл 1cws и является WSDL-описанием веб-сервиса 1С.
Использование сервисов в Рознице
Обычно в рознице сервисы используются для оказания различных услуг населению – прием платежей, погашение кредитов, денежные переводы, покупка программного обеспечения и т.п.
При этом по оказанной услуге в 1С формируется чек, в котором сохраняются параметры транзакции. После чего этот чек распечатывается клиенту с подробной информацией об оказанной услуге. Возможна печать предварительного чека, для того, чтобы клиент подтвердил введенные с его слов данные своей подписью.
Сервис может быть по-разному интегрирован в розничную программу, написанную на языке 1С (УТ, Розница и другие):
Организация служебных данных в 1С
Для хранения информации о транзакции в чеке необходимо создать дополнительную табличную часть «Сложные продажи» с реквизитами:
Справочник «Сложные продажи: Параметры» содержит перечень параметров транзакции.
Табличную часть выгоднее использовать, чем набор реквизитов, т.к. у транзакции их может быть очень много, а в других чеках, не связанных с сервисом, эти реквизиты не будут использоваться, и будут занимать лишнее место. Кроме того, такое решение универсально для любого сервиса и не требует реструктуризации данных после внедрения нового сервиса.
Продавцу делается отдельная закладка (или печатная форма, чтобы не менять конфигурацию), в которой он может посмотреть табличку реквизитов транзакции для чека.
Использование обработок на языке 1С
Если (Номенклатура = Справочники.Номенклатура.Paym) И (ВидОперации <> Перечисления.ВидыОперацийЧекККМ.Возврат) Тогда
ОбработкаПлатежа = Функции. ДатьВнешнююОбработку(«Paym»);
Если Результат = Неопределено Тогда
ИначеЕсли ВидОперации <> Перечисления.ВидыОперацийЧекККМ.Возврат И Выборка.НомеклатураСсылка = Справочники.Номенклатура.Paym Тогда
СтрокаСложныхПродаж = СложныеПродажи.Найти(Справочники.СложныеПродажиПараметры.PaymТекстЧека, «Реквизит»);
Если СтрокаСложныхПродаж <> Неопределено Тогда
Отдельный вопрос – как обеспечить завершенность транзакции. Т.е. если транзакция прошла в сервисе, как сделать, чтобы она не потерялась в 1С. Наиболее оптимальный путь – сверка реестров. Но это предмет отдельного рассмотрения.
Использование программ, интегрируемых с 1С
XDTO в платформе 1С
Некоторые типы в схеме не имеют имени, чтобы их получить, надо пройтись по иерархии типов.
В примере был описан список System, содержавший структуры XDTO. Чтобы создать саму структуру, нужно было получить ее тип таки вот образом:
Частые проблемы с XDTO
Сопровождение сервисов
Учитывая, что сервис – это совокупность двух систем – 1с и внешней, ошибки могут быть в обоих системах, что снижает общую надежность работы.
Для того, чтобы проще было разбираться в причинах отказов в работе сервисов, рекомендуется использовать комплекс мер.
Протоколирование запросов
Рекомендуется сохранять все запросы и ответы на них в каталог программы, файлы сохранять в папки вида ГГГГММДД по дням. Это очень способствует пониманию причин проблем.
Использование SoapUi для работы с веб-сервисами. Часть1
В нескольких статьях я расскажу о возможностях протестировать с помощью SoapUI, как работают веб-сервисы 1С. Также приведу примеры возврата из 1С документов в формате PDF и сложных xml-файлов. Некоторые вещи сходны с вот с этой статьей, однако я рассмотрю более сложные примеры работы с веб-сервисами. Но для начала я по шагам рассмотрю процесс запуска веб-сервисов и работы с SoapUI, чтобы легче было разобраться в их функционировании с нуля.
1. Простой веб-сервис
Для начала возьмем каркасную конфигурацию без веб-сервисов и пройдем по шагам процесс их создания.
Добавим новый веб-сервис с именем test1 и создадим в нем операцию hello с возвращаемым типом string. Имена веб-сервисов и операций лучше всегда задавать на латинице.
Также нужно задать URI пространства имен и имя файла публикации:
При нажатии на лупу в поле «Имя процедуры» будет открыт модуль веб-сервиса и можно будет реализовать функцию hello.
2. Публикация веб-сервиса.
Теперь, чтобы получившаяся функция была доступна по http, нужно опубликовать наш сервис на веб-сервере. Для этого подойдет Apache 2.2. Я почитал статьи о том, как можно настроить работу с IIS и мне это показалось гораздо сложнее. После установки и запуска Apache 2.2 нужно зайти в меню Администрирование — Публикация на веб-сервере. Поле «каталог» должно быть заполнено и содержать каталог установки Apache. Запомните поля «имя» и «адрес» веб-сервиса, они нам пригодятся на следующем шаге.
3. Тестирование с помощью SoapUI
Для тестирования создадим отдельного пользователя WsUser, с простым паролем и дадим ему полные права.
После этого устанавливаем и запускаем SoapUI. Эта программа очень удобна для тестирования веб-сервисов, она может получать их описание и делать post-запросы к сервисам.
Заходим в меню File — New SOAP project, задаем имя проекта hellotest а в поле Initial WSDL пропишем вот такую ссылку:
В ней часть «test_ws» была задана на прошлом этапе в поле «имя» а test1.1cws в поле «адрес».
Нажимаем ОК и на этом этапе нужно будет авторизоваться, войдя под тестовым пользователем WsUser. Будет создан проект и два элемента binding.
Soap12Binding отличается тем, что работает по новой версии стандарта SOAP 1.2. Откроем в test1Soap12Binding элемент Request1 и увидим вот что:
SoapUI показывает, какой xml будет передано в нашу функцию. Перед запуском теста есть еще один нюанс, по умолчанию SoapUI будет требовать авторизацию для каждого отдельного элемента Request. Поэтому, чтобы не задавать ее каждый раз, нужно кликнуть правой кнопкой мышки на testSoap12Binding, выбрать Show interface view и в открывшемся окне на вкладке «Service Endpoint» задать имя и пароль пользователя веб-сервисов:
Если этого не сделать, то для каждого Request нужно будет задавать авторизацию, в нижней панели по кнопке Auth.
Теперь можно наконец-то выполнить запрос к функции hello и посмотреть ответ:
Отлично, все заработало!
4. Передача простых параметров в функцию.
Теперь сделаем новую функцию с параметрами, например проверим работу с датами, сделаем функцию getSaleDocNumbersByDate, которая будет принимать дату документа (расходной накладной) и возвращать номера документов за эту дату строкой. Добавим к операции параметр date с типом dateTime:
Теперь в SoapUI правой кнопкой мыши нужно кликнуть на элемент testSoap12Binding и выбрать пункт Update Definition. После этого в проекте появится функция getSaleDocNumbersByDate и готовый Request к ней. Для заполнения даты нужно использовать формат «YYYY-MM-DDThh:mm:ss» (можно посмотреть на w3schools и ОЧЕНЬ рекомендую пользоваться этим сайтом для понимания работы с xml)
Тогда получатся вот такие запрос и ответ:
5. Пакеты XDTO
Если необходимо передавать в функции более сложные параметры (например, xml с несколькими полями), или получать в ответ сложные по структуре xml, то нам не обойтись без пакетов XDTO.
Очень подробно работа с XDTO рассмотрена в цикле статей XDTO это просто. По сути, пакет определяет структуру и тип полей используемых xml-файлов.
Я рассмотрю пример передачи и получение xml-файла, тип которого определен в пакете
А также в следующих статьях я рассмотрю примеры:
6. Передача в 1с в параметре xml-файла, тип которого определен в пакете.
Задача будет такая: найти документ расходной накладной по заданным во входящем xml номеру и дате и вернуть найденный документ. Возвращать нужно также в виде xml с номером, датой, контрагентом и его кодом и табличной частью товаров.
Далее в свойствах веб-сервиса нужно задать использование пакета XDTO packet1_ns. getSaleDoc с типом возвращаемого значения SaleDoc и входным параметром incomingXML типа InDocSaleQuery.
Сначала продемонстрирую код функции, а уже затем объясню что происходит
Здесь два основных нюанса. Первый: так как был задан тип входящего параметра incomingXML и он был описан этот тип в пакете, то сразу возможно обращаться к полям этого входящего xml. Второй: работа с фабрикой XDTO. Из нее был получен тип для результирующих выходных параметров и создано ЗначениеXDTO этого типа, у которого были заполнены необходимые поля. Также стоит заметить, что в типе SaleDoc следует ввести отдельное поле для ошибки, но для тестовых целей ошибки будут записаны в поле number.
Вот как выглядит результат этого запроса в SoapUI:
Как видно, все работает, но еще есть что улучшить — например, хотелось бы знать какое количество элементов SaleItems у нас в документе.
Об этом и о более сложных примерах я расскажу уже в следующей статье.
В приложенном архиве — выгрузка информационной базы и проект SoapUI.
Веб-сервисы и 1С: «Здравствуй, Name», время-деньги и «Жизнь»
Веб-сервисы и 1С: «Здравствуй, Name», время-деньги и «Жизнь»
«Вся наша жизнь — игра. » ( У. Шекспир)
«Что наша жизнь? Игра. » (А. Пушкин)
Часть вводная.
При разработке приложений с глобальным взаимодействием уже давно известна архитектура SOA (Service Oriented Architecture).
Существует достаточно большое количество реализации этой архитектуры. Одним из видов такой реализации является технология основанная на связке специфицированных консорциумом w3c таких технологий, как веб-сервисы и протоколы SOAP, WSDL, WADL и т.п., которые в свою очередь основаны на XML. Уже достаточно длительное время эта технология интегрирована в платформу 1с Предприятие. Благодаря этому 1с предприятие может служить «сервером приложений», поставщиком сервисов, можно организовать взаимодействие между 1с, и приложениями, написанными на других платформах, можно организовать взаимодействие между различными системами на базе 1с и так далее.
Существует достаточно большое количество полезных web-сервисов, например: получение курсов валют, службы отправки почтовых сообщений и SMS на основе
web-сервисов и WSDL, каковую архитектуру используют туристические агентства, гостиницы, ритейлеры и т.п.
Часть 1. Здравствуй, Name!
Есть достаточное количество противников SOA и сторонников других технологий, как и тех, кто недолюбливает 1С. Однако существующая технология разработки на платформе 1с позволяет приступить к разработке и получить готовый результат довольно быстро при весьма поверхностном знакомстве с подробностями спецификаций SOA, WSDL и веб-сервисов, по сравнению со многими другими известными продуктами как от гигантов софтверной индустрии, так и с бесплатными open-source решениями, что само по себе не является ни плюсом ни минусом, но может заставить задуматься.
Но не сразу, а постепенно, для начала, чтобы просто понять, как это работает, создадим простой веб-сервис, который будет иметь выполнять одну операцию с одним параметром строкового типа и будет возвращать тоже строку.
Для начала надо всё же установить веб-сервер, который будет обрабатывать запросы, это может быть Apache или IIS. Я предпочитаю Apache. Поскольку The Apache HTTP Server Project
предоставляет только исходники своего продукта, воспользуемся скомпилированной версией
от Apache House. (это обязательно должна быть 32-разрядная версия, веб-расширение 1С не работает с 64-разрядной)
Теперь нам нужно также:
создать в каталоге веб-документов каталог для публикации наших сревисов
установить web-расширение 1c-Предприятия
создать и опубликовать первый веб-сервис
Каталог для публикации должен быть расположен в каталоге c:\Apache24\htdocs.
Назовем его WebServices.
Теперь откроем панель управления: Панель управления\Программы\Программы и компоненты, выберем нужную версию программы 1с-Предприятие, нужно будет нажать правую кнопку и выбрать пункт «Изменить», затем «Изменить-Далее» и выбрать в списке
Теперь создадим пустую файловую базу, в ней роль «Полная» с полными правами на все группы объектов и пользователя Admin, назначив ему эту единственную роль.
имя файла публикации может быть любым, но желательно латинским шрифтом и обязательно с расширением 1cws. Все вместе это выглядит так (Рис. 2):
Тело функции Привет() модуля сервиса будет содержать только одну строку:
В поле «Каталог» вводим путь к нашему каталогу на web-сервере, который мы создали ранее, то есть C:\Apache24\htdocs\WebServices\
Остальные параметры вы можете рассмотреть на рисунке Рис. 3
Осталось только протестировать нашу веб-службу. Для этого наберем в строке браузера http://localhost/WebServices/ws/1c_wstest.1cws?wsdl
Результат должен выглядеть как-то так:
Клиентская часть будет содержать чуть больше кода. Можно обращаться к сторонним сервисам двумя способами:
— использовать ws-ссылку (объект метаданных)
— создать ws-определение программно
Первый способ означает, что нам нужна ещё одна конфигурация, поэтому сейчас используем второй. Разница лишь в том, что мы создадим объект программно.
Создадим новую обработку с реквизитом Name, разместим его на форме, добавим форме команду Тест с двумя поцедурами, на клиенте и на сервере.
Параметры конструктора объекта WSПрокси ИмяСервиса и ИмяТочкиПодключения можно найти в XML-тексте, который возвращает наш сервис по URI https://localhost/WebServices/ws/1c_wstest.1cws?wsdl
А именно в элементе
где ИмяСервиса — это атрибут Name этого элемента, то есть
ИмяТочкиПодключения — это атрибуты Name вложенных элементов
Обычно мы имеем две точки для разных версий SOAP, в нашем случае они называются
WebServiceTestSoap и WebServiceTestSoap12 — можно использовать любой из них.
Сохраняем изменения в обработке, открываем её в любой базе и тестируем. Результат — вывод сообщения возвращенной операцией нашего удаленного сервиса строки. (Рис. 4)