Вернуть таблицу значений через веб сервис 1с

Обновлено: 06.07.2024

Медитируя на тему почему нет нормальной “Консоли запросов в управляемом приложении” захотелось покопаться в этих внутренностях 1С.

Как ставить и настраивать вэб-сервис в 1С, я не буду расказывать. Вы это легко найдете.

Идея такая: почему бы нам не создать вэб-сервис, который на строку запроса 1С выдаст web таблицу(с тэгами…). Заморачиваться с XTDO не советую, капризный он. Выдаем ответ сервера в виде строки. Данные в таблице для простоты тоже сделаем текстовыми (html).

Сделаем конфигурацию в которой один вэб-сервис (Прикреплен к статье). И распишем функцию подробно,чтобы ее можно было подключить к любой конфигурации вручную.
Все парамеры в функции строковые
Request1C – текст запроса
TableData – html строка ответа.
Возвращаем истина или ложь;
Код 1C v 8.2 УП

Публикуем web-сервис c именем testws. Для тестирования уберем из базы всех пользователей, включаем анонимную идентификацию и смотрим чтобы ресурс htp://localhost/testws/ws/testws?wsdl был доступен из браузера. Если показывает в браузере описание вэб-сервиса, значит все нормально.

Вы не разбираетесь в Web программировании – не беда. Главное усвоить основы. Мы посылаем специально подготовленный post запрос в Web-сервер, он передает его 1С и возращает ответ. И нам в браузере необходимо обработать ответ сервера.

var soapEnv = ‘ ‘; soapEnv += ”;

Вырезаем из ответа сервера необходимое и преобразуем назад спец символы < и > на < и >.

Нажимаем кнопку. И приходит к нам счастье.

Дополнительно скажу, что для слишком больших результатов запросов данная схема может не работать. У меня где-то начинала не выводить или выводить неправильно к 10000-100000 записям. Скорее всего ответ сервера посто не залезает в один пакет soap. А если отключить сжатие пакетов я думаю будет еще хуже. Так, что будьте осторожны.

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

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

Итак, создадим в чистой конфигурации справочники Номенклатура и, например, Категории. В номенклатуру добавим реквизит Категория с типом СправочникСсылка.Категории.

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

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

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

В ЦБ создаем объект конфигурации XDTO-пакет следующего вида

В данном пакете мы описываем структуру передаваемых нами данных. Свойства типов Code и Name у нас имеют тип string и означают Код и Наименование соответственно. Сами типы CategoryString и ProducString соответствуют строке элемента справочника. Типы ProductTable и CategoryTable представляют из себя массивы строк соответствующих справочников. Для того, чтобы тип стал массивом, в свойствах его свойства(ProductStr например) необходимо максимальное значение указать как "-1". Свойства CategoryStr и ProductStr имеют тип CategoryString и ProducString соответственно. И последнее оставшееся свойство это Category, которое имеет тип CategoryStr. Далее нам необходимо создать веб-сервис и операцию с типом возвращаемого объекта ProductTable. почему именно с этим типом, потому что он содержит необходимые нам категории.

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

Теперь наш веб-сервис готов к публикации и после этого, можно приступать к настройке МП. Напомню, там мы на данный момент имеем только два справочника аналогичных ЦБ. Для простоты, в МП создадим объект обработка из которой и будем вызывать нашу синхронизацию. Добавим на форме обработки всего одну кнопку, которая и будет вызывать процедуру синхронизации, на это подробно останавливаться не буду. Код процедуры ниже:

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

В ЦБ создаем объект конфигурации XDTO-пакет следующего вида

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

Я рассмотрю примеры:

Установка у массива элементов атрибута количества.
Передача в 1С xml-файла, не описанного в пакете, в формате base64
Получение из 1С документа pdf в формате base64 и его декодирование

7. Установка количества элементов в массиве.

Напомню, вот что получилось у меня с запросом в xml документа расходной накладной в прошлый раз:

А мне хотелось бы видеть вложенную структуру, где указано количество элементов в массиве, типа такой: <saleitems quantity="3'><saleitem number="1". </saleitem></saleitems>

Но у типа СписокXDTO нельзя задать какие-либо атрибуты. Поэтому я рассмотрю один из вариантов задания количества - это прямая запись с помощью ЗаписатьАтрибут и объекта ЗаписьXML. Кода при этом получается больше, чем при записи с помощью ФабрикаXDTO, но зато можно задать любые необходимые вам свойства и атрибуты тегов у получившегося XML файла.

Вот скриншот результата запроса:

Вот код, который я для этого написал:

Как видно, получилось гораздо больше кода, чем в примере в предыдущей статье. Буду рад, если кто-то подскажет, как его упростить. Мне пришла в голову только идея написать XSLT шаблон для преобразования xml в нужный вид, но этот способ достаточно сложный.

8. Обработка XML без описания их в пакете XDTO.

В предыдущем примере для функции getSaleDoc было известно, что входящий параметр имеет тип InDocSaleQuery, который был описан в пакете XDTO. В этом примере я рассмотрю, как можно работать с xml, если мы не описали его в пакете. Создадим новую операцию getSaleDoc2 в веб-сервисе и определим у нее входящий параметр base64data с типом base64Binary. Из типа параметра понятно, что входящий xml-файл будет закодирован в формат base64. Для этого создадим xml с полями number и date следующего вида:

и для его кодировки воспользуемся сайтом

Такие входящие данные можно обработать с помощью записи их во временный xml файл и дальнейшего чтения с помощью функции ФабрикаXDTO.ПрочитатьXML. Получится ОбъектXDTO с полями number и date, только дата здесь уже будет в строковом формате и ее нужно будет преобразовать в формат 1С. Дальнейшая работа функции такая же, как у предыдущей getSaleDoc.

Полностью код функции getSaleDoc2 можно посмотреть в приложенном к статье файле.

9. Получение из веб-сервиса pdf. Декодирование данных из base64 в файл.

Последняя тема, которую я хочу рассмотреть - получение из веб-сервиса pdf в формате base64. Для декодировки из base64 в xml есть сайт

Для получения из веб-сервиса печатной формы в виде pdf создадим новую операцию getPdfDoc, с возвращаемым типом base64Binary. Здесь есть интересный нюанс - без дополнительных усилий тип ДвоичныеДанные преобразовывается в base64Binary, об этом можно узнать из синтакс-помошника. Код получается такой:

При выполнении этого запроса с помощью SoapUI у нас получается достаточно большое количество данных, и преобразовать их в файл нам поможет сайт motobit. Вот как выглядят его настройки:

А вот и результат, документ в pdf:

Кстати, небольшой бонус: если для печати использовать типовые модули управления печатью, из типовых конфигураций то код для получения Табличного Документа примерно такой:

Что ж, на этом всё. Я привел интересные примеры работы с веб-сервисами и буду рад ответить на ваши вопросы в комментариях.

На днях столкнулся с необходимостью реализовать Web сервис. Покурив литературу по этой теме столкнулся с необходимостью предварительно определять и реализовывать XDTO пакеты в дереве конфигураций. Их реализация вызвала у меня легкое отвращение: это довольно рутинная работа.

Немного подумав, реализовал WEB сервис без реализации собственных XDTO пакетов. Получается, что для реализации веб сервисов (по крайней мере, тех что будут использоваться другими программами 1С версии 8) реализация собственных XDTO пакетов необязательна.

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

Плюсы такого подхода:

1) Передача параметров и возврат результата в привычных и удобных структурах данных - таблицах значений, списках значений и т.п.

2) Если Web сервис используется в рамках распределенной базы, то можно передавать обмениваться ссылками на объекты, это очень удобно.

3) Возможность сжатия хранилища. Таким образом экономится траффик.

1) Возможна работа только в рамках 1с 8.

Файл для скачивания содержит пример реализации такого Web сервиса для платформы 8.3. Файл представляет собой архив, в котором находятся файлы выгрузки двух баз: "Источник" и "Приемник". В источник нужно зайти под пользователем "test", без пароля. Web сервис называется "NomenklaturapoKodu", находится в базе "Источник". Обработка, которая вызывает Web сервис называется "ТестРаботыWebСервиса", находится в базе "Приемник".

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

Читайте также: