HTTP Сервисы: Путь к своему сервису. Часть 3

10.10.18

Разработка - Инструментарий разработчика

Продолжение статьи «HTTP Сервисы: Путь к своему сервису. Часть 2». В предыдущих частях мы использовали только Get, в этой части поговорим о других методах и длительных операциях.

Скачать файлы

Наименование Файл Версия Размер
Расширение с рассмотренными примерами сервисов. (Под 8.3.12)
.cfe 31,34Kb
35
.cfe 0.0.4 31,34Kb 35 Скачать
Расширение с рассмотренными примерами сервисов. Без Длительных Операций (Под 8.3.10)
.cfe 26,81Kb
20
.cfe 0.0.3 26,81Kb 20 Скачать
Внешняя обработка созданная по ходу статьи (HTTP-сервисы часть3)
.epf 8,07Kb
45
.epf 0.1 8,07Kb 45 Скачать

В первой части мы создали каркас для Get метода в расширении конфигурации. Во второй части мы поработали с OData и создали обработку, получающую через HTTP-Сервис используя метод Get данные сформированные при помощи СКД. В этой части поговорим про другие методы и БСП:Базовая функциональность\Длительные операции (при отсутствии БСП в Вашей конфигурации необходимо использовать фоновые задания).

В этой статье http-сервис будет в расширении конфигурации БСП 2.4.6.146 на платформе 8.3.10.2650 + IIS, а вот посылать запросы и получать ответы будем в БСП 3.0.1.231 на платформе 8.3.12.1595.

Начнем.

Какие методы можно добавить в HTTP-Сервис?

  • GET - Получение данных.
  • HEAD - Запрашивает ресурс так же, как и метод GET, но без тела ответа.
  • PUT - Изменение данных.
  • POST - Создания новой сущности на сервере.
  • DELETE - Удаления данных.
  • PATCH - Используется для частичного изменения ресурса.
  • MERGE - Предназначен для дифференциального изменения данных. Аналогичен методу PATCH, но является расширением от Microsoft.
  • OPTIONS - Предназначен для получения информации о способах работы с данным URI (доступные HTTP-методы, форматы представления и т.п.).
  • TRACE - Возвращает полученный запрос так, что клиент может увидеть, какую информацию промежуточные серверы добавляют или изменяют в запросе.
  • CONNECT - Преобразует соединение запроса в прозрачный TCP/IP-туннель, обычно чтобы содействовать установлению защищённого SSL-соединения через нешифрованный прокси.
  • ANY (Любой) - Указывает, что может быть использован любой HTTP-метод из перечисления HTTPМетод.
  • И команды для WebDAV(Web Distributed Authoring and Versioning) или просто DAV — набор расширений и дополнений к протоколу HTTP, поддерживающих совместную работу пользователей над редактированием файлов и управление файлами на удаленных веб-серверах. (Еще ссылка по WebDAV)
 
 WebDAV расширяет HTTP следующими командами:

Подробнее о методах можно почитать туттут и тут

Давайте обратим внимание на метод «ANY (Любой)» - Данный метод позволяет перехватывать любой метод и обрабатывать его.

В голову пришел небольшой эксперимент благодаря статье Отправка PUT запроса средствами 1С 8.3. Давайте создадим в нашем http-сервисе метод ANY и в цикле используя ВызватьHTTPМетод переберем методы (GET, HEAD, PUT, POST, DELETE, PATCH, MERGE, OPTIONS, TRACE, CONNECT), обращаясь с телом запроса и без. Будем возвращать информацию по запросу.

Для начала создадим Демо базу на основе БСП 2.4.6.146 (на платформе 8.3.10), добавим в нее расширении из предыдущей части, изменим Корневой URL на PAPI и добавим метод "Любой (ANY)".

Обратите внимание на заголовок "Content-Type" (Код обработчика PAPI_ALL). Данный заголовок содержит тип данных и служит для того чтобы можно было понять, что находится в запросе или ответе. Про возможные типы можно почитать тут. мы укажем "text/plain; charset=utf-8" - текстовые данные.

 
 Код обработчика PAPI_ALL

Шаблон у нас будет такой: /{ИмяМетода}

Теперь опубликуем:

Создадим, если ранее не создавали Демо базу на основе БСП 3.0.1.231 (на платформе 8.3.12), и создадим небольшую внешнюю обработку с одной командой ВсеМетоды и реквизитом Результат с типом строка.

 
 Код команды ВсеМетоды

Проверяем результат:

 
Лог из IIS

Из логов видно, что все запросы кроме запроса с методом TRACE отработали и с телом запроса и без.

Результаты метода ANY:

 
 GET
 
 HEAD
 
 PUT
 
 POST
 
 DELETE
 
 PATCH
 
 MERGE
 
 OPTIONS
 
 TRACE
 
 CONNECT

Как мы видим, часть методов имеет схожее назначение за некоторыми отличиями. Большинство API предоставляют клиентам только методы GET, POST и реже PUT.

Давайте сравним GET и POST:

Параметры сравнения

GET

POST

Описание

Запросы можно кэшировать

Да

Нет

Могут быть кэшированы браузером.

Запросы сохраняются в истории браузера

Да

Нет

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

Запросы можно добавить в закладки, идемпотентность

Да

Нет

При многочисленном повторном обращении вернут один и тот же результат, кроме случаев когда информация устарела.

Безопасные запросы

Да

Нет

Спецификация HTTP 1.1 вводит два понятия: безопасный и небезопасный запрос, или если быть более точным, метод.

Безопасные — это методы, которые могут лишь запросить информацию. Они не могут изменить запрашиваемый ресурс, не могут привести к нежелательным результатам для пользователя, других лиц или сервера.

Содержит тело запроса

Нет

Да

Для POST параметры передаются в теле.

Можно передавать файлы

Нет

Да

 

Способен передать большие объемы данных

Нет

Да

 

Запрос ограничен длинной URL

Да

Нет

Несмотря на то, что RFC не описывает такой параметр, как длина URL, Internet Explorer упорно придерживается мнения, что максимальная длина URL не может превышать 2048 символов, это накладывает некоторые ограничения на использование GET.

Картинка ниже, утрировано, но очень наглядно показывает выбор между GET и POST:

Ссылки по сравнению GET с POST:

Давайте нарисуем сервис «Список заданий за период», раз уж мы используем демо базу БСП, то использовать будем Отчет.Задания и его СКД макет с вариантом настроек «СписокЗаданий». Будем подавать Начало и Конец периода и формировать ответ в формате JSON. Наша задача сделать так, чтобы можно было забирать данные как через GET, так и через POST.

Добавляем метод POST и пишем код его обработки.

 
 Функция PAPI_POST

Правим, обработчик метода GET, добавляем Метод запроса.

 
 Функция PAPI_GET

 В модуль PAPI_ОбработкаУниверсальныхМетодов добавляем код для нового метода.

 
 Код модуля PAPI_ОбработкаУниверсальныхМетодов

В модуль PAPI_ОбщиеПроцедурыИФункции добавляем функцию ПолучитьДатуВремяИзСтроки - для преобразования данных в дату.

 
 Код модуля PAPI_ОбщиеПроцедурыИФункции

В модуль PAPI_ОбработкаМетодовGET добавляем код обработки метода "ПолучитьСписокЗаданийЗаПериод"

 
 Код модуля PAPI_ОбработкаМетодовGET

Создаем модуль PAPI_ОбработкаМетодовPOST

 
 Код модуля PAPI_ОбработкаМетодовPOST

Наш сервис готов! Давайте теперь дорисуем обработку и будем тестировать. Обратите внимание, что я оставил метод ANY, по сути, обращение к нему отличается лишь отсутствием в URL "V1/". Данный метод позволит Вам выводить параметры вашего запроса.

GET: http://127.0.0.1/DemoSSL2_4_6_146/hs/PAPI/V1/ПолучитьСписокЗаданийЗаПериод?StartPeriod=2014-01-01T00:00:00&EndPeriod=2018-01-01

 
 Результат

GET через ANY: http://127.0.0.1/DemoSSL2_4_6_146/hs/PAPI/ПолучитьСписокЗаданийЗаПериод?StartPeriod=2014-01-01T00:00:00&EndPeriod=2018-01-01

 
 Результат

Доделаем обработку, которую создавали выше. Добавим реквизиты КонецПериода и НачалоПериода с типом Дата, МетодСервиса с типом Строка и делаем РежимВыбораИзСписка (GET(GET), POST(POST), Проверить(ANY)). Добавляем команду ПолучитьРезультат.

 
 Код команды ПолучитьРезультат

Проверяем:

 
 Результат "Проверить"

Длительные операции.

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

Давайте для нашего GET метода создадим параметр BTask=True - будет означать, что операцию нужно выполнить используя БСП:Базовая функциональность\Длительные операции. Создадим модуль для асинхронных операций. Создадим метод GET для проверки выполнения фонового задания и получения результата "ФоновоеЗаданиеПроверить" с параметрами Result_Key (Адрес хранилища результата. Обязательный параметр) и Task_Key (Идентификатор фонового задания. Необязательный параметр).

Предлагаю перенести наше разрешение в Демо базу на основе БСП 3.0.1.231 (на платформе 8.3.12). Хочу создать справочник для хранения результатов, что позволит обращаться к результатам хоть через год... Пока не удалят элемент справочника.

Редактируем обработчик PAPI_GET, добавляем в структуру БазовыйURL.

 
 Функция PAPI_GET

Создаем Справочник.PAPI_ХранилищеРезультатов. Добавляем реквизиты АдресРезультата - Строка(200) и Результат - ХранилищеЗначения

Создаем модуль PAPI_АсинхронныеОперации

 
 Код модуля PAPI_АсинхронныеОперации

Правим модуль PAPI_ОбработкаМетодовGET. Добавляем код для запуска фонового задания и метод получения результата фонового задания.

 
 Код модуля PAPI_ОбработкаМетодовGET

В модуль PAPI_ОбщиеПроцедурыИФункции, добавляем функцию НайтиЗадание.

 
 Код модуля PAPI_ОбщиеПроцедурыИФункции

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

http://127.0.0.1/DemoSSL3_0_1_231/hs/PAPI/V1/ПолучитьСписокЗаданийЗаПериод?StartPeriod=2008-01-01T00:00:00&EndPeriod=2018-01-01&BTask=true

Нажимаем "Ссылка на получение результата"

Была сформирована ссылка на сохраненный результат:

http://127.0.0.1/DemoSSL3_0_1_231/hs/PAPI/V1/ФоновоеЗаданиеПроверить?Result_Key=ПолучитьСписокЗаданийЗаПериод_b2fe7494-3e86-4748-bce6-a33d69c14ca2&Task_Key=e8a450b1-bdd5-4703-a76b-9c6015a39fb7

Соответственно можно и без идентификатора задания обращаться:

http://127.0.0.1/DemoSSL3_0_1_231/hs/PAPI/V1/ФоновоеЗаданиеПроверить?Result_Key=ПолучитьСписокЗаданийЗаПериод_b2fe7494-3e86-4748-bce6-a33d69c14ca2

Третью часть заканчиваю. Мы рассмотрели с Вами методы GET, POST и ANY, создали сервис на основании данных отчета СКД. Сделали возможность запускать фоновое задание через GET и сохранили результат. Данный механизм при должной доработке позволит выдавать одинаковые запросы без обработки запросов.

Статьи из данного цикла:

HTTP Сервисы: Путь к своему сервису. Часть 1

HTTP Сервисы: Путь к своему сервису. Часть 2

HTTP Сервисы: Путь к своему сервису. Часть 4

HTTP-сервис API JSON IIS http web apache сервис Публикатор Линк PAPI Pretty API atom-xml XML OData Код состояния СКД БСП Длительные операции

См. также

SALE! 20%

Infostart Toolkit: Инструменты разработчика 1С 8.3 на управляемых формах

Инструментарий разработчика Роли и права Запросы СКД Платформа 1С v8.3 Управляемые формы Запросы Система компоновки данных Конфигурации 1cv8 Платные (руб)

Набор инструментов программиста и специалиста 1С для всех конфигураций на управляемых формах. В состав входят инструменты: Консоль запросов, Консоль СКД, Консоль кода, Редактор объекта, Анализ прав доступа, Метаданные, Поиск ссылок, Сравнение объектов, Все функции, Подписки на события и др. Редактор запросов и кода с раскраской и контекстной подсказкой. Доработанный конструктор запросов тонкого клиента. Продукт хорошо оптимизирован и обладает самым широким функционалом среди всех инструментов, представленных на рынке.

13000 10400 руб.

02.09.2020    122217    673    389    

715

SALE! 25%

Infostart PrintWizard

Пакетная печать Печатные формы Инструментарий разработчика Платформа 1С v8.3 Запросы 1С:Зарплата и кадры бюджетного учреждения 1С:Конвертация данных 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 Платные (руб)

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

18000 15300 руб.

06.10.2023    7309    22    6    

39

SALE! 20%

Infostart УДиФ: Управление данными и формами

Инструменты администратора БД Инструментарий разработчика Роли и права Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

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

10000 8000 руб.

10.11.2023    3556    11    1    

34

SALE! 30%

PowerTools

Инструментарий разработчика Инструменты администратора БД Платформа 1С v8.3 Управляемые формы Конфигурации 1cv8 Россия Платные (руб)

Универсальный инструмент программиста для администрирования конфигураций. Сборник наиболее часто используемых обработок под единым интерфейсом.

3600 2520 руб.

14.01.2013    177765    1074    0    

849

Многопоточность. Универсальный «Менеджер потоков» 2.1

Инструментарий разработчика Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

Восстановление партий или взаиморасчетов, расчет зарплаты, пакетное формирование документов или отчетов - теперь все это стало доступнее. * Есть желание повысить скорость работы медленных алгоритмов! Но... * Нет времени думать о реализации многопоточности? * о запуске и остановке потоков? * о поддержании потоков в рабочем состоянии? * о передаче данных в потоки и как получить ответ из потока? * об организации последовательности? Тогда ЭТО - то что надо!!!

5000 руб.

07.02.2018    99357    239    97    

296

[ЕХТ] Фреймворк для Расширений 1С

Инструментарий разработчика Платформа 1С v8.3 Управляемые формы Платные (руб)

"Фреймворк для Расширений 1С" это универсальное и многофункциональное решение, упрощающее разработку и поддержку создаваемых Расширений. Поставляется в виде комплекта из нескольких Расширений с открытым исходным кодом. Работает в любых Конфигурациях в режиме Управляемого приложения с режимом совместимости 8.3.12 и выше без необходимости внесения изменений в Конфигурацию.

3000 руб.

27.08.2019    18122    6    8    

40

1С HTML Шаблоны / HTML Templates

Инструментарий разработчика Платформа 1С v8.3 Конфигурации 1cv8 Платные (руб)

Быстрая и удобная обработка для работы с шаблонами HTML. Позволяет легко и быстро формировать код HTML.

2040 руб.

27.12.2017    28113    3    10    

15

Выполнение произвольного кода или запроса с параметрами через Web-сервис (замена COM-подключений)

Инструментарий разработчика Обмен между базами 1C Платформа 1С v8.3 Платные (руб)

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

2400 руб.

24.09.2019    23605    15    15    

32
Отзывы
5. dsdred 3279 29.08.18 19:57 Сейчас в теме
(4)
Веб-/хттп-сервисы не занимают клиентскую лицензию (работают без ее использования)

Я не про лицензии на подключение web\http-сервисов имел ввиду. Я про тот случай когда клиент использует наш сервис, в своей системе. На картинке ниже изобразил.
Прикрепленные файлы:
Остальные комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. 🅵🅾️🆇 522 28.08.18 12:09 Сейчас в теме
3. dsdred 3279 28.08.18 21:34 Сейчас в теме
(1)Не за что ;)) А за слово не мне спасибо, а Бенджамину Пирсу.
2. eeeio 123 28.08.18 16:16 Сейчас в теме
Обязательно продолжайте
4. Cyberhawk 135 29.08.18 15:05 Сейчас в теме
мы знаем, что результат будет формироваться долгое время и нет смысла держать сеанс (лицензию)
Веб-/хттп-сервисы не занимают клиентскую лицензию (работают без ее использования)
5. dsdred 3279 29.08.18 19:57 Сейчас в теме
(4)
Веб-/хттп-сервисы не занимают клиентскую лицензию (работают без ее использования)

Я не про лицензии на подключение web\http-сервисов имел ввиду. Я про тот случай когда клиент использует наш сервис, в своей системе. На картинке ниже изобразил.
Прикрепленные файлы:
6. Cyberhawk 135 29.08.18 20:47 Сейчас в теме
(5) Ясно. Но все равно пока не приходит на ум такой сценарий, при котором на стороне потребителя хттп-сервиса такая экономия лицензии будет иметь смысл.
7. dsdred 3279 29.08.18 21:07 Сейчас в теме
(6) Это просто вариант, который возможен, а смысл длительных операций и хранения результата может использоваться во многих вещах. Про одну из таких вещей я сказал в конце данной статьи вскользь - хранение результата для «одинаковых запросов». О еще одной вещице расскажу в 4 части, если соберусь ее писать…
8. maxx 991 30.08.18 10:54 Сейчас в теме
9. maxx 991 30.08.18 11:32 Сейчас в теме
Вопросик про длительные операции возник.

Вы в запросе входящем передаёте ИдентификаторЗадания для поиска фонового и АдресРезультат для поиска элемента в справочнике хранилище результатов. А можно ли бы идентификатор задания сохранить в реквизите справочника ХранилищеРезультатов, тогда в url запросе можно было передавать только один параметр АдресРезультата (или вообще уже передавать уникальный идентификатор элемента ХранилищеРезультатов) ?
10. dsdred 3279 30.08.18 12:19 Сейчас в теме
(9)
А можно ли бы идентификатор задания сохранить в реквизите справочника ХранилищеРезультатов, тогда в url запросе можно было передавать только один параметр АдресРезультата (или вообще уже передавать уникальный идентификатор элемента ХранилищеРезультатов) ?


Не вижу смысла хранить идентификатор фонового задания.

Фоновое задание служит для формирования результата и идентификатор нужен только на момент его работы, чтобы понимать ,что фоновое задание еще работает или уже завершено. Пока задание не отработало результата в принципе быть не может. А когда есть результат, идентификатор задания уже не нужен.

У меня в статье описано, что идентификатор задания не обязательный параметр, к результату вы можете потом обращаться так:

http://127.0.0.1/DemoSSL3_0_1_231/hs/PAPI/V1/ФоновоеЗаданиеПроверить?Result_Key=ПолучитьСписокЗаданийЗаПериод_b2fe7494-3e86-4748-bce6-a33d69c14ca2

где Result_Key - адрес результата

Я конечно понимаю что имя метода ФоновоеЗаданиеПроверить несовсем корректно, надо было назвать ПолучитьРезультат или что то в этом духе...
С другой стороны я просто рисую примеры, а не коммерческий проект))
11. akimych 227 17.05.19 17:24 Сейчас в теме
Спасибо за статью.
вопрос про длину URL для метода GET.

Нужно в параметре передавать список ID, но опытным путем выяснили, что в строку URL можно уложить примерно 310 символов.

vs-uat01-1c111/DEV_1/hs/DBReconciliation/GetData/1205687050,1205687070,1205687110,1205697010,1205702490,1205704160,1205704310,1205704320,1205704330,1205711230,1205711240,1205711250,1205711260,1205711270,1205711280,1205711300,1205711310,1205711320,1205711330,1205711340,1205711350,1205711370


Может где-то на IIS есть настройка, на ограничение длины запроса или в 1С органичение на длину передаваемого параметра?

Платформа 8.3.13.
12. dsdred 3279 18.05.19 12:33 Сейчас в теме
(11)Картинка из 4 части

Максимальная длинна URL и максимальная длина строки запроса

Как вариант еще тут посмотрите -> http://qaru.site/questions/327774/wcf-get-url-length-limit-issue-bad-request-invalid-url

Отпишитесь если помогло.
13. akimych 227 20.05.19 12:14 Сейчас в теме
(12) Приветсвую, спасибо за помощь,

помог именно вариант 2, когда в реестре прописали HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Pa­rameters
UrlSegmentMaxLength = 1000.
14. user916652 16.06.20 16:08 Сейчас в теме
Добрый день,

Имеется код на PHP

if ($method == 'GET' && $_GET['hub_mode'] == 'subscribe'
&& $_GET['hub_verify_token'] == VERIFY_TOKEN) {
echo $_GET['hub_challenge'];

В котором при выполнении гет запроса, идет обращение к серверу методом GET. Как с помощью HTTP сервиса обратиться на сервер ($_GET['hub_mode'])
15. dsdred 3279 17.06.20 11:47 Сейчас в теме
(14)
Как с помощью HTTP сервиса обратиться на сервер ($_GET['hub_mode'])

Не совсем понял вопрос.

Вы делаете Get запрос, передаете параметры.
Вопрос в чем? Как в http сервисе прочитать параметры и сделать какие то действия на стороне 1с?


Функция СервисGET(Запрос)
    Ответ = Новый HTTPСервисОтвет(200);
    hub_mode= Запрос.ПараметрыURL.Получить("hub_mode");

//....Какие то действия

    Возврат Ответ;
КонецФункции
16. jenyavp 101 06.11.20 21:50 Сейчас в теме
Добрый вечер. А вы не сталкивались с тем, что при передаче JSON формата более 300 кб процесс зависает на веб сервере. Веб сервер IIS.
JSON формируется в ответ ,устанавливается как строка. Использую HTTP - сервисы в 1С.
Виснет процесс iis worker process. Висит и все. В настройках сайта 30 МБ. Максимальная допустимая длина.
17. dsdred 3279 06.11.20 22:03 Сейчас в теме
(16)Сам не славливал, но попробуйте почитать тут:

https://docs.microsoft.com/ru-ru/dotnet/framework/wcf/feature-details/large-data-and-streaming

При отправке больших объемов данных необходимо задать maxAllowedContentLength параметр IIS (Дополнительные сведения см. в разделе Настройка ограничений запросов IIS) и maxReceivedMessageSize параметр привязки (например, System. ServiceModel. BasicHttpBinding. MaxReceivedMessageSize или MaxReceivedMessageSize ). maxAllowedContentLengthСвойство по умолчанию имеет значение 28,6 МБ, а maxReceivedMessageSize свойство по умолчанию — 64 КБ.

https://docs.microsoft.com/en-us/iis/configuration/system.webserver/security/requestfiltering/requestlimits/
Оставьте свое сообщение