Ссылки на данные в рабочем процессе

Ссылка на данные из среды выполнения

Среда выполнения — это место, где хранятся данные триггера интеграции. Чтобы создать ссылку на данные в среде выполнения, введите {{runtime}}.

Вы можете ссылаться на элементы данных, хранящиеся в среде выполнения. Создавая ссылку на эти элементы, вы должны указать имя отдельного элемента.

Например, если таблица в Smartsheet запускает рабочий процесс и вам нужно сослаться на идентификатор соответствующей строки, ссылка может выглядеть следующим образом: {{runtime.event.rowId}} .

Точная структура ссылки и используемые имена зависят от типа триггера и события. 

Чтобы создать ссылку на нужный элемент, выполните следующие действия.

1. На странице Run Log (Журнал запуска) наведите указатель на объект, запускающий срабатывание процесса. 
2. Выберите Brandfolder Image .
3. В появившемся списке выберите Copy Data Reference (Копировать ссылку на данные).

Brandfolder Image

Ссылка на данные из состояния

Вы можете сослаться на состояние, когда данные передаются из родительского рабочего процесса. Ссылка имеет следующий формат: {{states.state name.value}}.

Если вы хотите сослаться на данные из модуля, который находится ниже состояния, состояние всё равно необходимо учитывать. В этом случае структура ссылки будет выглядеть так: {{states.имя состояния.интеграция или имя утилиты.имя модуля}}.

Если модуль может выводить несколько значений данных, добавьте в ссылку путь к этим конкретным данным (аналогично ссылке на отдельные элементы данных в среде выполнения).

Например, модуль Smartsheet: Get Row по умолчанию возвращает данные, показанные на рисунке ниже. 

Brandfolder Image

Чтобы сослаться на значение, введённое в ячейку Address (Адрес) в строке, используйте ссылку
{{states.GetRow.smartsheet.get_row.row.cells.Address.value}}.

Ссылка на данные из дочернего рабочего процесса

Вы можете ссылаться на данные из дочернего рабочего процесса в родительском рабочем процессе. Инструкции

1. Скопируйте нужную ссылку на данные из родительского рабочего процесса.
2. Добавьте модуль Run Child Workflow (Запустить дочерний рабочий процесс) в родительский рабочий процесс и присвойте ему имя.

В родительском рабочем процессе, в модуле дочерний:

3. Значения сущности Дочерний выбрать .  
4. Добавьте ключ — имя, которое будет использоваться для ссылки на данные в дочернем рабочем процессе.
5. Добавьте соответствующее значение — ссылку на данные, скопированную на шаге 1. Это может выглядеть как {{states.startstate.stringtools.compose_text}}

В дочернем рабочем процессе:

3. Выбрать модуль, в котором вы хотите сослаться на данные родительского рабочего процесса.
4. В поле, в котором нужно сослаться на данные родительского рабочего процесса, введите {{runtime.entities.text}}, где «text» — это ключ, добавленный на шаге 4. 

Если вы хотите создать ссылку на {{runtime.entities.text}}, например {{states.text.value}} в дочернем рабочем процессе, необходимо создать состояние с именем «text» в дочернем рабочем процессе

Ссылка на данные из дочернего рабочего процесса

Вы можете ссылаться на данные из дочернего рабочего процесса в родительском рабочем процессе. Ссылка на данные может выглядеть следующим образом:

• states.{{состояние, запускающее дочерний процесс}}.child.{{состояние в дочернем процессе}}.value.; или
• states.{{состояние, запускающее дочерний процесс}}.child.{{состояние в дочернем процессе}}.integration или utility.module.

Работа со ссылками на несуществующие данные

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

Например, вы хотите использовать значение в ячейке Smartsheet, чтобы определить, по какому пути пойдёт рабочий процесс при разветвлении. Однако вы не знаете, будет ли ячейка содержать значение. 

Если ячейка пуста, рабочий процесс будет остановлен на развилке. Чтобы избежать этого, можно добавить вертикальные полосы (||) в конце ссылки на данные. Если в ячейке будут содержаться данные, рабочий процесс будет использовать ссылку слева от вертикальных полос. Если данных в этой ячейке нет, рабочий процесс будет использовать данные, расположенные справа.

Эта ссылка включает два возможных сценария:
{{states.GetRow.smartsheet.get_row.row.cells.Address.value||116 George Street, Edinburgh, UK}}

1. Сначала рабочий процесс попытается использовать адрес из строки, полученной ранее: GetRow.smartsheet.get_row.row.cells.Address.value.
2. Однако если эта ячейка пуста, процесс использует адрес, указанный после вертикальных полос: 116 George Street, Edinburgh, UK.

Советы по использованию вертикальных полос

Вы можете использовать: 

• другую ссылку на данные после вертикальных полос, а не конкретное значение, или
• несколько пар вертикальных полос для создания нескольких различных сценариев.

Текст и ссылки на данные

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

Если вы создали рабочий процесс для работы с данными о погоде в статье Создание пустого рабочего процесса для метеослужбы США, вы могли заметить, что URL-адрес, используемый в HTTP-вызове к приложению метеослужбы США, содержит две ссылки на данные.