Учимся создавать http сервис (часть третья). Передача нескольких параметров в http сервис

Публикация № 1303368

Разработка - Практика программирования

http web json

Пошаговое руководство по созданию http сервиса (часть третья). Передача нескольких параметров в http сервис, a также формирование сложных JSON строк.

На прошлых уроках Учимся создавать http-сервисы (часть первая) , Учимся создавать http сервисы (часть вторая). Передача параметра в http сервис , мы с вами научились создавать http  сервис, научились передавать один параметр в сервис. Сегодня мы разберем вопрос о том, как передавать несколько параметров в http сервис, а так-же немного поработаем с формированием JSON строки.

Цель:

-Научится передавать сколько угодно параметров в http сервис.

-Научится собирать сложные JSON строки.

 

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

-Добавим справочник «Склады»

-Добавим справочник «Контрагенты»

-Добавим документ «РеализацияТоваровУслуг»

Реквизиты шапки:

-Контрагент (спр. Ссылка «Контрагенты»)

-Склад (спр. Ссылка «Склады»)

Табличная часть «Товары»

Реквизиты табличной части:

-Номенклатура (спр. «Номенклатура»)

-Цена (Число 15,2)

-Количество (Число 15,3)

-Сумма (Число 15,3)

 

Сохраним все изменения и обновим конфигурацию базы данных.

Зайдем в режим предприятия и добавим несколько складов, контрагентов и документов.

 

 

Постановка задачи:

Необходимо получить документы в JSON формате за период с Даты1 по Дата2.

Из задачи следует, что нам нужно передать два параметра в http запрос, начальную дату и конечную дату.

-Откроем ветку «Общие» - «HTTP сервисы»

-Создадим новый http сервис «РаботаСДокументами»

-Установим корневой URL documents

 

 

-Перейдем на закладку «ШаблоныURL»

-Добавим новый шаблон «ПолучитьРасходныеДокументыЗаПериод». Настроим шаблон /get_documents_from_date_to_date/. Как помним из второго урока, параметры записываются в фигурных скобках, установим параметр /get_documents_from_date_to_date/{beginDate}. Установили первый параметр. Установим второй параметр /get_documents_from_date_to_date/{beginDate}/{endDate}. Таким образом мы установили два параметра.

Можно было уставить их немного по другому, добавить дополнительное пояснение в шаблоне, о том что это за параметры, например так: /get_documents_from_date_to_date/beginDate/{beginDate}/endDate/{endDate}.

Давайте в нашей задаче остановимся на первом варианте.

Итак мы имеем шаблон: /get_documents_from_date_to_date/{beginDate}/{endDate}. Таким образом мы научились передавать два параметра в http запрос.

 

 

-Добавим новый метод «ПолучитьДокументы»

 

-Перейдем в обработчик

-Получим значения параметра {beginDate} и {endDate} (если забыли, смотрим вторую часть infostart.ru/1c/articles/1296740/)

-Преобразуем наши параметры в тип «Дата», при помощи функции Дата()

 

-Перейдем в общий модуль «ОбщегоНазначения» и в нем напишем функцию «ПолучитьJSONСтрокуДокументов», которая возвращаем json строку – информацию по документам.

 

-Вызываем эту функцию из обработчика и передаем в нее два параметра НачалоПериода и КонецПериода.

-JSON строку устанавливаем в «Ответ»

 

 

-Публикуем http сервис. Запускаем программу 1С из под администратора. Меню Администрирование – Публикация на веб сервере. Публикуем http сервис. Подробное описание тут infostart.ru/1c/articles/1293341/

 

-Открываем браузер. Собираем строку подключения с параметрами. В моем случае эта строка будет иметь такой вид: http://localhost/my_name/hs/documents/get_documents_from_date_to_date/20201001/20201002

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

 

 

{
"Документы": [
{
"номер": "000000001",
"дата": "2020-10-01T23:15:39",
"id": "613f40d0-0422-11eb-85d6-54271ef75e0a",
"Товары": [
{
"id_товара": "b427820a-fc3e-11ea-85d4-54271ef75e0a",
"наименование": "Печенье",
"количество": 20,
"сумма": 1200
},
{
"id_товара": "b427820b-fc3e-11ea-85d4-54271ef75e0a",
"наименование": "Вентилятор",
"количество": 15,
"сумма": 15000
},
{
"id_товара": "613f40cd-0422-11eb-85d6-54271ef75e0a",
"наименование": "Номенклатура 2",
"количество": 2,
"сумма": 10000
}
]
},
{
"номер": "000000002",
"дата": "2020-10-01T23:16:29",
"id": "613f40d1-0422-11eb-85d6-54271ef75e0a",
"Товары": [
{
"id_товара": "b427820a-fc3e-11ea-85d4-54271ef75e0a",
"наименование": "Печенье",
"количество": 20,
"сумма": 1200
},
{
"id_товара": "613f40cd-0422-11eb-85d6-54271ef75e0a",
"наименование": "Номенклатура 2",
"количество": 10,
"сумма": 10000
},
{
"id_товара": "613f40ce-0422-11eb-85d6-54271ef75e0a",
"наименование": "Номенклатура 3",
"количество": 3,
"сумма": 300
}
]
},
{
"номер": "000000003",
"дата": "2020-10-01T23:17:05",
"id": "613f40d2-0422-11eb-85d6-54271ef75e0a",
"Товары": [
{
"id_товара": "613f40cf-0422-11eb-85d6-54271ef75e0a",
"наименование": "Номенклатура 4",
"количество": 4,
"сумма": 2000
}
]
}
]
}

 

 

На этом уроке мы научились передавать два параметра в http сервис.

Аналогично можно передавать множество параметров, по шаблону

Ip адрес / Имя публикации / hs / корневой каталог / шаблон / {Параметр1}/{Параметр2}/ … / {Параметр N}.

Всего хорошего.

При реализации данного функционала была использована платформа 1С:Предприятие 8.3 (8.3.12.1567).

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

Наименование Файл Версия Размер
Учимся создавать http сервис (часть третья). Передача нескольких параметров в http сервис.

.cf 14,36Kb
04.10.20
1
.cf 14,36Kb 1 Скачать

Специальные предложения

Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. user1304317 02.10.20 12:10 Сейчас в теме
Спасибо! Вы супер ментор по HTTP))
2. hpi 269 02.10.20 12:22 Сейчас в теме
Спасибо. Очень приятно такое слышать :)
3. Steelvan 02.10.20 12:24 Сейчас в теме
Читайте сарказм между строк, хе-хе, сверх учитель.
4. hpi 269 02.10.20 12:31 Сейчас в теме
Добрый день. Если у Вас есть замечания рад выслушать.
5. script 226 04.10.20 20:02 Сейчас в теме
Здравствуйте. Оформите пж в статье ссылки на предыдущие части для быстрого перехода. И людям удобно и себе читаемость увеличите. Только с третьего раза увидел что они есть.
6. hpi 269 04.10.20 21:18 Сейчас в теме
Здравствуйте, ссылки есть. В начале статьи.
Прикрепленные файлы:
7. hpi 269 04.10.20 21:19 Сейчас в теме
8. dsdred 1489 04.10.20 21:39 Сейчас в теме
Еще частей 5-10 до метода POST?
9. hpi 269 04.10.20 21:44 Сейчас в теме
10. serg-lom89 60 06.10.20 09:00 Сейчас в теме
а как указывать обязательные и необязательные параметры в шаблоне?
14. ltfriend 584 12.10.20 20:32 Сейчас в теме
(10) передавайте параметры, как нормальные люди
http://mysite.com/get_documents?begin=<значение>&end=<значение>;
Если параметр не задан, то его не передавайте.
Для доступа к этим параметрам используйте свойство ПараметрыЗапроса объекта HTTPСервисЗапрос.
Если Запрос.ПараметрыЗапроса.Свойство("begin") Тогда
user1035175; +1 Ответить
11. AntoShiK86 06.10.20 10:23 Сейчас в теме
Очень доступно. Это будет работать на мобильном устройстве? Можно обмениваться между двумя андройдами списками дела, продуктов или типо чата?
12. TitanLuchs 250 06.10.20 19:09 Сейчас в теме
(11) Работать будет, обмениваться можно.
13. ICeZm 10 12.10.20 14:19 Сейчас в теме
Оставьте свое сообщение

См. также

daСклонение: склонение ФИО, должностей, чисел, прилагательных, существительных на языке 1С + ТестЦентр Промо

Универсальные функции v8 1cv8.cf Абонемент ($m)

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

1 стартмани

14.02.2015    104646    98    daMaster    90    

Сравнение реального дохода со средним доходом из API.HH.RU

Зарплата Управленческие v8 v8::СПР ЗУП3.x УУ Абонемент ($m)

Внешняя обработка на управляемой форме для 1С:Предприятие 8.3 по интеграции с HH.RU используя HH REST API. Ключевые функции: получение списка вакансий по должностям (Ключ для работы не нужен); расчет среднего дохода; Тестирование проводилось на платформе 1С:Предприятие 8.3 (8.3.13.1513) Зарплата и управление персоналом, редакция 3.1 (3.1.11.68) совместно с API.HH.RU.

1 стартмани

11.11.2019    4394    6    solaru    2    

Конфигурация для рекламного агентства

Управление услугами и сервисом Управление взаимоотношениями с клиентами (СRM) Производство готовой продукции (работ, услуг) Управление взаимоотношениями с клиентами (СRM) Производство готовой продукции (работ, услуг) v8 Реклама, PR и маркетинг УУ Абонемент ($m)

Данная конфигурация выполнена для решения тестового задания: Цель задания: 1) Понять, на каком из клиентов сколько мы заработали;  2) Понять, по какому виду СМИ сколько мы заработали;  3) Проследить по каждой услуге: у кого за сколько купили и кому за сколько продали, с возможностью перейти в соответствующий документ. Реализовано с помощью: 1. Справочники - контрагенты, номенклатура 2. Документы - Поступление услуг, реализация услуг 3. Отчеты - отчет по контрагентам, номенклатуре и движений.

1 стартмани

21.05.2019    5365    0    solaru    0    

Загрузка номенклатуры в УТ 10.3 из Excel файла с генерацией штрихкодов

Загрузка и выгрузка в Excel Обработка справочников Оптовая торговля Розничная торговля Учет ТМЦ Оптовая торговля Розничная торговля Учет ТМЦ v8 УТ10 Россия Абонемент ($m)

Обработка позволяет генерировать новые номенклатурные позиции на основе данных из файла Excel с последующей генерацией штрихкодов (ШК). Может быть полезна при больших поступлениях товаров на склад, где ручное создание и присваивание штрихкода  (ШК) может занимать много времени.

1 стартмани

24.03.2017    8246    7    solaru    0    

Под капотом управляемых форм

Практика программирования v8 1cv8.cf Бесплатно (free)

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

26.08.2013    270238    Evil Beaver    271    

[NotaBene] Универсальный отчет по таблице значений

Практика программирования v7.7 1cv7.md Россия Абонемент ($m)

1C v.7.7 Готовое решение. Не требует настройки. Не требует допрограммирования. Данная обработка решает часто встречающуюся задачу вывода в "красивом" виде таблицы значений (полученной, например, из запроса). Поддерживается произвольное группирование данных, отключение/включение группировок, в т.ч и создание "шахматок" (типа "продажи понедельно"). Обработка может использоваться как и в отладочных целях (для нормального просмотра ТЗ), так и в составе вполне рабочих отчетов. По крайней мере, я неоднократно клиентам данную обработку ставил вместо того, чтобы каждый раз писать замороченные выводы данных. И клиенты довольны, и мне - проще...

2 стартмани

07.05.2007    29542    3    CheBurator    63