Справка по системе Платформа ELMA BPM
×
Меню

GET-запрос

Использование GET-запроса – простейший способ запуска бизнес-процесса из внешней системы. Все, что нужно для создания такого запроса – это составить ссылку вида:
Рис. 1. Схема HTTP-GET запроса, при помощи которого выполняется запуск бизнес-процесса ELMA.
К адресу сервера добавляется стандартный путь /Processes/ProcessHeader/RunByWebQuery/. После последнего символа / указываются параметры запроса. Первое, что требуется указать – это токен бизнес-процесса. По сути, правильно указанные адресная часть и токен уже позволяют использовать эту ссылку для запуска бизнес-процесса. В этом случае он будет запущен со стандартными, определенными по умолчанию, параметрами. То есть, результат будет такой же, как при запуске процесса через веб-приложение системы ELMA.
Если же требуется указать некоторые дополнительные значения параметров бизнес-процесса, то их нужно перечислить в тексте ссылки после токена. Токен и параметры в ссылке отделяются вопросительным знаком (?); между собой параметры отделяются знаком амперсанда (&). Параметр указывается в следующем формате: Имя_параметра=Значение_параметра.
Полученная ссылка может быть запущена с любого устройства. В простейшем случае, ее достаточно ввести вручную в адресной строке браузера компьютера.
Пример GET-запроса:http://elma.someorg.ru/Processes/ProcessHeader/RunByWebQuery/995ea844-74a8-413b-96be-bc92462eff85?Name=Иван&Surname=Иванов&Fathername=Иванович&Age=54&Partner=1
Данный запрос приведет к запуску бизнес-процесса с токеном 995ea844-74a8-413b-96be-bc92462eff85 на сервере ELMA, расположенном на http://elma.someorg.ru. При этом бизнес-процесс будет запущен с определенными стартовыми параметрами. Перед началом выполнения процесса в его контекст будет загружено пять переменных: Name, Surname, Fathername, Age, Partner.
При необходимости передать в параметрах текст с пробелами вместо пробела необходимо использовать символ "+" или символьный код "%20". Принципиальной разницы между ними нет.
Например: http://elma.someorg.ru/Processes/ProcessHeader/RunByWebQuery/995ea844-74a8-413b-96be-bc92462eff85?FullName=Иванов%20Иван%20Иванович&Street=Заречное+Шоссе
Если же необходимо передать символ "+", то вместо него нужно передавать символьный код "%2B".
Возможность запуска бизнес-процессов при помощи GET-запроса имеется только при условии, что процесс был опубликован с корректно сформированным токеном и установленными флажками Запуск из внешних систем и Веб-запрос (GET) в блоке Варианты запуска процесса (рис. 2).
Рис. 2. Настройки публикации процесса для использования GET-запроса
В HTTP-GET запросе передаются только параметры, которые могут быть введены в строковом виде, то есть целые и дробные числа, строки, текст, даты, идентификаторы объектов. Такие параметры, как графические изображения и файлы, не могут быть переданы через HTTP-GET запрос.
См. также: