Описание программы Robot
Релизы

Способы задания параметров действий

Концепция задания параметров блоков

Виды параметров

Различные блоки могут содержать параметры разного вида. Это могут быть поля для ввода, выпадающие списки, чекбоксы, переключатели и кнопки.

Все необходимые для корректной работы действий параметры отмечены красной звездой.

Чтобы получить более детальную информацию, что конкретно требуется вводить и выбирать в используемом блоке, необходимо обратиться к описанию соответствующего действия в разделе "Описание действия".

Ниже рассмотрены типовые примеры и приведено объяснение.

Присваивание определенного значения

В большом количестве действий требуется определенному параметру присвоить какое-либо значение. Так, например, в действии "Дописать в файл" необходимо указать путь к файлу и текст, который нужно дописать. Или, например, в действии "Задать значение переменной" необходимо указать, какое значение должна принять переменная. В большинстве случаев при задании значения требуется выбрать одну из опций: "Задать значение", "Сохранить результат предыдущего шага" или "Вычислить значение". Рассмотрим подробнее, что эти опции значат.

Задать значение

Все введенное в поле интерпретируется либо как строка, либо как число.

Если выбрана опция "Задать значение", то это значит, что всё, что будет введено в соответствующее поле, будет интерпретироваться либо как строка, либо как число. Так, например, если в поле написать Город "Москва", то данное значение автоматически интерпретируется как строка. Если же в поле написать какое-либо число, например, 123, то значение будет интерпретироваться как число. В таблице ниже приведены некоторые примеры интерпретаций.

Входное значение

Тип

Выходное значение

831

Число

831

Имя контрагента

Строка

"Имя контрагента"

831 + 210

Строка

"831 + 210"

true

Строка

"true"

"Сегодня " + new Date()

Строка

"\"Сегодня\" + new Date()"

[1,2,3,4].filter( x => x > 2)

Строка

"[1,2,3,4].filter( x => x > 2)"

Сохранить результат предыдущего шага

В качестве значения подставляется результат предыдущего действия

Если выбрана опция "Сохранить результат предыдущего шага", то в качестве значения будет подставлено то, что возвращает действие на предыдущем шаге (если действие не возвращает результат, то значение не будет записано). Например, если используется действие "Прочитать письма", то для сохранения результата считывания в переменную автоматически добавлено действие "Задать значение переменной" с опцией "Сохранить результат предыдущего шага" (пример на рисунке ниже).

Выбранная опция "Сохранить результат предыдущего шага"

Вычислить значение

Переменная принимает то значение, которое получается в соответствии с правилами языка JavaScript

Если выбрана опция "Вычислить значение", то переменная примет тот тип, который получится при задании значения. В данном случае необходимо соблюдать правила синтаксиса языка JavaScript.

Например, если задать в переменную contragent_exists значение true, то переменная примет логический тип и значение истины. Если в переменную city написать "Город Москва", то она превратится в строку.

В таблице ниже приведены результаты для тех же примеров, что и в таблице в разделе "Задать значение".

Входное значение

Тип

Выходное значение

831

Число

831

Имя контрагента

Не определен

Ошибка "Unexpected identifier"

831 + 210

Число

1041

true

Логический

true

"Сегодня " + new Date()

Строка

"Сегодня Thu Jul 04 2019 17:41:35 GMT+0300 (MSK)"

[1,2,3,4].filter( x => x > 2)

Массив чисел

[3,4]

При использовании опции "Вычислить значение" возможно использовать и дополнительные библиотеки - lodash и moment.js.

Одиночные поля

Некоторые действия содержат лишь один параметр с полем для ввода чего-либо. Например, в таких функциях, как "Если.., то", "Выполнить код", "Цикл пока" в поле требуется ввести код на языке JavaScript. Более подробные примеры смотрите в описании действия.

При этом в действии "Подпрограмма" также содержится одиночное поле, но в нем нельзя указать код на JavaScript. Здесь требуется указать путь к подпрограмме в виде обычной строки.