К тексту на этой странице мог быть частично применён машинный перевод.

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

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

Доступно для:

Планы:

  • Bridge by Smartsheet

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

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

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

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

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

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

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

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

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

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

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

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

Reference data

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

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

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

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

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

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

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

  1. Выберите модуль, в котором вы хотите сослаться на данные родительского рабочего процесса.
  2. В поле, где вы хотите сослаться на данные родительского рабочего процесса, введите {{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-адрес, используемый в вызове API к метеослужбе США, содержал две ссылки на данные.