В данном разделе описаны все разделы вкладки "Команды" студии Roomy bots
Внешнее взаимодействие
Использовать внешнюю библиотеку
Команда «Использовать внешнюю библиотеку» расположена в разделе «Внешнее взаимодействие» в панели выбора команд. Для корректной работы команды «Использовать внешнюю библиотеку» версия ядра на котором была собрана внешняя библиотека должна быть 3.1 или ниже. Использовать внешнюю библиотеку используется для запуска DLL файлов.
Свойство;Описание
Путь к файлу; Значение или данные из переменной, которые будет использоваться в качестве пути и имени файла. Так же предусмотрена возможность выбора DLL файла через диалоговое окно, с возможностью выбора класса, метода, параметров.
Имя класса; Укажите имя класса, который содержит метод для вызова.
Имя метода; Укажите имя метода в классе.
Сохранить в переменную; Существующая переменная или имя новой переменной, в которую будет записан результат.
Параметры метода; Укажите значения параметров (если необходимо).
Получить результат http запроса
Команда «Получить результатhttpзапроса» расположена в разделе «Внешнее взаимодействие» в панели выбора команд. Получить результатhttpзапроса используется для получения данных из HTML/XML кода с помощью XPath запроса.
Свойство;Описание
Пользовательская переменная; Данные из переменной (HTML/XML), над которыми будут выполняться действия.
Запрос объекта; Введите XPath запрос.
Сохранить в переменную; Существующая переменная или имя новой переменной, в которую будет записан результат.
Команда «Отправитьhttp запрос» расположена в разделе «Внешнее взаимодействие» в панели выбора команд.
Отправить http запрос используется для сохранения в переменную HTML кода с вэб страницы.
Свойство;Описание
Адрес запроса; Укажите URL веб страницы HTML код, которой необходимо получить.
Сохранить в переменную; Существующая переменная или имя новой переменной, в которую будет записан результат.
Код результата в переменную; Существующая переменная или имя новой переменной, в которую будет записан код результата выполнения запроса.
REST взаимодействие
Команда «REST взаимодействие» расположена в разделе «Внешнее взаимодействие» в панели выбора команд. Данная команда позволяет настроить и организовать взаимодействие между распределенными компонентами системы или между различными системами, каждая из которых может физически располагаться в разных местах. В команде поддерживается следующие методы – GET, POST, PUT, DELETE, HEAD, OPTIONS, HEAD, PATCH, MERGE, COPY. Для настройки взаимодействия с целевой системой/сервисом необходимо указать обязательные параметры - Базовый адрес запроса, Точка подключения (endpoint), Тип метода, Параметры метода и Использовать переменную. Все указанные параметры должны быть известны из описания методов взаимодействия с сервисом (API). Дополнительно, могут быть указаны другие параметры при их наличии. При настройке, в поле Время ожидания запроса можно указать время ожидания ответа/реакции системы, с которой настраивается взаимодействие. Настройка структуры запроса и списка данных передаваемых/получаемых при взаимодействии, указывается в дополнительной форме, открываемой при выборе пункта Параметры метода. В данной форме могут быть указаны: - заголовок HEADER, PARAMETR, содержание тела объекта (описание передаваемых данных) и сами данные, имя файла и путь к файлу (в случае передачи файла) (см. табл. 7).
Свойство;Описание
Базовый адрес запроса; URL на который отправляется запрос https://{site_url}/
Точка подключения; Часть URL поле базового адреса. https://{site_url}/_api/web
Тип метода; Раскрывающийся список содержит следующие значения: GET, POST, PUT, DELETE, HEAD, OPTIONS, PATCH, MERGE, COPY.
Имя пользователя; Логин для авторизации. Поддерживается только в Basic access authentication.
Пароль; Пароль для авторизации. Поддерживается только в Basic access authentication.
Путь к файлу сертификата; Путь к файлу, который содержит внутреннее средство авторизации.
Время ожидания запроса (с); Время, выделенное на получение ответа по запросу, иначе будет ошибка выполнения по времени
Использовать переменную; Переменная, в которую будет сохранен ответ на запрос
Пример, настроенного POST запроса приведен на рисунке.
Свойство;Описание
Параметры;
Header;В "Наименование" передается название переменной (ключ), в "Значение" передается значение переменной. Данные переменные передаются в Response Headers
Parameter;В "Наименование" передается название переменной (ключ), в "Значение" передается значение переменной. Передаваемые переменные являются параметрами запроса.
Тело JSON объекта;Тело передаваемого JSON
Имя файла;Имя файла, которое будет присвоено JSON файлу, передаваемому через "Путь к файлу"
Путь к файлу;Путь к файлу в директории, с расширением .json. Пример: C:\Users\Documents\Rest.json