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

02.10.20

Интеграция - WEB-интеграция

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

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

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

На прошлых уроках Учимся создавать 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 web json

См. также

Модуль для обмена "1С:Предприятие 8. УАТ. ПРОФ" с FortMonitor

WEB-интеграция 8.3.8 Конфигурации 1cv8 Автомобили, автосервисы Беларусь Украина Россия Казахстан Управленческий учет Платные (руб)

Расширение предназначено для конфигурации "1С:Предприятие 8. Управление Автотранспортом. ПРОФ". Функционал модуля: 1. Заполнение регистров сведений по подсистеме "Мониторинг", а именно: события по мониторингу, координаты по мониторингу, пробег и расход по мониторингу, текущее местоположение ТС по мониторингу 2. Заполнение путевого листа: пробег по мониторингу, время выезда/заезда, табличная часть ГСМ 3. Отчеты по данным загруженным в регистры сведений. Модуль работает без включенной константы по настройкам мониторинга. Модуль формы предоставляется с открытым кодом, общий модуль защищен.

11856 руб.

25.05.2021    11753    9    4    

8

Интеграция с сервисом vetmanager

WEB-интеграция Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Данная обработка разрабатывалась для загрузки документов из Ветменеджер в 1С: Бухгалтерия 3.

6000 руб.

02.02.2021    14453    34    43    

19

Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС

Обмен с ГосИС WEB-интеграция Платформа 1С v8.3 Управляемые формы 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия государственного учреждения 1С:Документооборот 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Платные (руб)

Обработка является альтернативой механизму, разработанному фирмой 1С и заполняющему реквизиты контрагента по ИНН или наименованию. Не требуется действующей подписки ИТС. Вызывается как внешняя дополнительная обработка, т.е. используется, непосредственно, из карточки контрагента. Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС (egrul.nalog.ru) для БП 2.0, БП 3.0, БГУ 1.0, БГУ 2.0, УТ 10.3, УТ 11.x, КА 1.1, КА 2.x, УПП 1.x, ERP 2.x, УНФ 1.5, УНФ 1.6, УНФ 3.0, ДО 2.1

2400 руб.

28.04.2016    85160    142    211    

297

Прайс-лист с фотографиями, выгрузкой в Excel с подсчетом суммы заказа, загрузкой заказа в Управление торговлей 11 (Россия) и Управление торговлей для Беларуси 3

Прайсы Загрузка и выгрузка в Excel Оптовая торговля WEB-интеграция Платформа 1С v8.3 Оперативный учет 1С:Управление торговлей 11 Россия Управленческий учет Платные (руб)

Прайс-лист для программы 1С: Управление торговлей 11 и Управление торговлей для Беларуси 3, позволяющий: 1) Формировать прайс-лист с фотографиями; 2) Сохранить прайс-лист в Excel с формулами, подсчитывающими количество и сумму заказа; 3) Передать сформированный прайс-лист по каналу ftp на сайт; 4) Сохранить прайс-лист в формате CSV; 5) Загрузить сделанный по прайс-листу заказ обратно в программу.

6000 руб.

04.09.2014    120807    44    105    

53

Sync1C: Синхронизация 1С и OpenCart

WEB-интеграция Оптовая торговля Розничная торговля Платформа 1С v8.3 Оперативный учет 1С:Управление торговлей 11 Управленческий учет Платные (руб)

Внешняя обработка для обмена данными с интернет-магазином OpenCart. Позволяет быстро наполнить магазин товарами, затем обновлять цены и добавлять новые товары. Далее можно средствами OpenCart настраивать и дополнять карточки товаров как надо для магазина, при этом связь товаров с 1С не теряется.

3840 руб.

30.03.2018    41860    77    133    

81

Merlion Commander Версия 1.3.9.2 - июль 2022 г. (Интеграция с 1С: УT, редакция 11.4, 1С:Розница 2.3,1С:ERP Управление предприятием 2, УТ 10.3, редакция веб-сервиса MERLION API 3.0 от 18.08.2021)

Оптовая торговля Розничная торговля WEB-интеграция Платформа 1С v8.3 1С:Управление торговлей 11 Россия Платные (руб)

Расширении конфигурации "Управление торговлей, редакция 11" для работы с веб-сервисом Мерлион с помощью Merlion API. Расширение и набор подключаемых дополнительных обработок позволяет без изменения конфигурации получить возможность работы с API крупнейшего российского дистрибьютора http://merlion.com. Логика работы максимально приближена к работе веб-сервиса b2b. Вы сможете создать и исправить заказ, зарезервировать товар прямо из 1С, посмотреть актуальные остатки и цены, импортировать штрихкода EAN13 товаров, загружать заказ c автоматическим созданием номенклатуры в 1С и корректности создания. Можно выбирать характеристики по товарным группам и загружать товар с выбранными характеристиками, загружать изображения товара. Не требуется установки дополнительного ПО для работы с веб-сервисом. Кроссплатформенное решение для ОС Windows и Linux. Весь код модулей открыт и доступен для просмотра и внесения изменений.

8280 руб.

02.05.2017    37379    40    45    

47
Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. user1304317 02.10.20 12:10 Сейчас в теме
Спасибо! Вы супер ментор по HTTP))
2. acvatoris 499 02.10.20 12:22 Сейчас в теме
Спасибо. Очень приятно такое слышать :)
3. Steelvan 292 02.10.20 12:24 Сейчас в теме
Читайте сарказм между строк, хе-хе, сверх учитель.
4. acvatoris 499 02.10.20 12:31 Сейчас в теме
Добрый день. Если у Вас есть замечания рад выслушать.
15. Greek26rusa 2 27.01.21 23:42 Сейчас в теме
(4)Добрый вечер.Нету примера с POST?:
16. acvatoris 499 31.01.21 18:17 Сейчас в теме
Добрый день. Вот ссылка https://infostart.ru/1c/articles/1307941/
5. script 127 04.10.20 20:02 Сейчас в теме
Здравствуйте. Оформите пж в статье ссылки на предыдущие части для быстрого перехода. И людям удобно и себе читаемость увеличите. Только с третьего раза увидел что они есть.
6. acvatoris 499 04.10.20 21:18 Сейчас в теме
Здравствуйте, ссылки есть. В начале статьи.
Прикрепленные файлы:
7. acvatoris 499 04.10.20 21:19 Сейчас в теме
Хорошо
8. dsdred 2716 04.10.20 21:39 Сейчас в теме
Еще частей 5-10 до метода POST?
9. acvatoris 499 04.10.20 21:44 Сейчас в теме
:) нет
10. serg-lom89 71 06.10.20 09:00 Сейчас в теме
а как указывать обязательные и необязательные параметры в шаблоне?
14. ltfriend 912 12.10.20 20:32 Сейчас в теме
(10) передавайте параметры, как нормальные люди
http://mysite.com/get_documents?begin=<значение>&end=<значение>;
Если параметр не задан, то его не передавайте.
Для доступа к этим параметрам используйте свойство ПараметрыЗапроса объекта HTTPСервисЗапрос.
Если Запрос.ПараметрыЗапроса.Свойство("begin") Тогда
sashocq; al.gerasimov; user1684575; user729873; user1035175; +5 Ответить
17. Bassgood 1386 16.12.21 19:43 Сейчас в теме
(14) Имеется в виду такой вот шаблон URL сервиса: http://server/documents/{document}/{ref}
Допустим, он должен отрабатывать следующие варианты обращений к нему:
1. get-запрос = http://server/documents/накладные - возвращает список накладных
2. get-запрос = http://server/documents/накладные/123 - возвращает накладную с идентификатором "123"
3. post-запрос = http://server/documents/накладные - создает новую накладную и возвращает ее идентификатор
11. AntoShiK86 23 06.10.20 10:23 Сейчас в теме
Очень доступно. Это будет работать на мобильном устройстве? Можно обмениваться между двумя андройдами списками дела, продуктов или типо чата?
12. TitanLuchs 376 06.10.20 19:09 Сейчас в теме
(11) Работать будет, обмениваться можно.
13. ICeZm 21 12.10.20 14:19 Сейчас в теме
Спасибо!
18. kobayoshi 19 29.06.22 12:00 Сейчас в теме
Добрый день. Хочу заметить, что для того, что бы браузер получил json, а не html страничку, нужно указать
Ответ.Заголовки.Вставить("Content-type", "application/json");

перед тем как вернуть Ответ.
kolibrik99; acvatoris; +2 Ответить
Оставьте свое сообщение