На прошлом уроке, //infostart.ru/1c/articles/1293341/ , мы с вами научились создавать http сервис. Научились его опубликовывать. В результате работы сервиса мы получили данные из регистра сведений в виде JSON строки. Результат работы мы увидели в браузере.
Сегодня мы с вами разберем вопрос о том, как передавать параметры в http сервис.
Для чего это может быть нужно. Например, нам нужно получить информацию не о всей номенклатуре, а только о той номенклатуре, у которой определенный штрих код.
Цель: научиться передавать параметр в http сервис.
Итак, начнем.
-Откроем ветку «Общие» - «HTTP сервисы»
-Откроем http сервис «ОперацииСНоменклатурой»
-Перейдем на закладку «Шаблоны»
-Добавим новый шаблон. Назовем его «ИзучениеПередачиПараметров»
-Придумаем шаблон, например, «get_products_barcode»
До этого момента мы с вами повторили действия предыдущего занятия.
Перейдем к передаче параметров. Параметры в http сервисе, заключены в фигурные скобки. Например, {beginDate} или {articul} или {} еще что-то.
Как можно предположить параметр {beginDate} – это какая-то начальная дата, параметр {articul} – это артикул. ИТАК, ПАРАМЕТРЫ В HTTP ЗАПРОСЕ ЗАКЛЮЧЕНЫ В ФИГУРНЫЕ СКОБКИ - {SOME_PARAMETER} - имя какого-то параметра. В нашей задаче нам нужен параметр штрих код. Таким образом мы его должны записать в фигурных скобках, вот так {barcode}. ПАРАМЕТРЫ ДОЛЖНЫ БЫТЬ НАЗВАНЫ ЛАТИНСКИМИ БУКВАМИ ПО ПРАВИЛУ СОЗДАНИЯ ИМЕН ПЕРЕМЕННЫХ.
Замечательно. Но куда этот параметр деть, куда его приложить?
А вот куда. Мы придумали имя шаблона «get_products_barcode», так вот после него и записывается параметр вот так, /get_products_barcode/{barcode}. Мы в шаблоне указали параметр.
//////////////////////////////////////////////////////
-В общем модуле «ОбщегоНазначения» создадим новую функцию, которая будет возвращать JSON строку с данными по номенклатуре, в зависимости от параметра штрих кода.
Функция будет называться «ПолучитьНоменклатуруПоШтрихкоду»
-В модуле http сервиса «ОперацииСНоменклатурой» - шаблон «ИзучениеПередачиПараметров» добавляем метод «ПолучитьНоменклатуруПоШтрихкоду». Далее переходим в модуль http сервиса и описываем код, который принимает параметр из Http запроса.
-Опубликовываем http сервис «ОперацииСНоменклатурой»
Меню - Администрирование - Публикация на веб-сервере
-Открываем браузер и собираем строку запроса. Как мы помним из прошлого урока строка собирается так:
Ip адрес / имя_публикации / hs / корневой_каталог / шаблон/{параметр}
localhost/my_name/hs/products/get_products/{barcode} – ТОЛЬКО ВМЕСТО ФИГУРНЫХ СКОБОК, КОНКРЕТНОЕ ЗНАЧЕНИЕ ШТРИХ КОДА, НАПРИМЕР 20000000583067
localhost/my_name/hs/products/get_products/20000000583067
Видео инструкция по передаче параметров в http сервис.
