Теги

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

Что такое теги соединений?

Теги соединений — это интерактивные элементы, которые появляются при подключении блоков. Они представляют данные, которые могут передаваться от одного блока к другому, и позволяют вам:

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

Теги соединений упрощают просмотр доступных данных из предыдущих блоков и их использование в текущем блоке без необходимости запоминания сложных структур данных.

Использование тегов соединений

Существует два основных способа использования тегов соединений в ваших рабочих процессах:

Перетаскивание

Нажмите на тег соединения и перетащите его в поля ввода целевых блоков. Появится выпадающий список с доступными значениями.

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

Синтаксис угловых скобок

Введите <> в полях ввода, чтобы увидеть выпадающий список доступных значений соединений из предыдущих блоков.

Нажмите в любое поле ввода, где вы хотите использовать подключенные данные
Введите <>, чтобы вызвать выпадающий список соединений
Просмотрите и выберите данные, на которые хотите сослаться
Продолжайте ввод или выберите из выпадающего списка, чтобы завершить ссылку

Синтаксис тегов

Теги соединений используют простой синтаксис для ссылки на данные:

<blockName.path.to.data>

Где:

blockName — имя исходного блока
path.to.data — путь к конкретному полю данных

Например:

<agent1.content> — ссылается на поле content из блока с ID "agent1"
<api2.data.users[0].name> — ссылается на имя первого пользователя в массиве users из поля data блока с ID "api2"

Динамические ссылки тегов

Теги соединений вычисляются во время выполнения, что означает:

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

Примеры

// Ссылка в тексте
"Имя пользователя: <userBlock.name>"

// Ссылка в JSON
{
  "userName": "<userBlock.name>",
  "orderTotal": <apiBlock.data.total>
}

// Ссылка в коде
const greeting = "Привет, <userBlock.name>!";
const total = <apiBlock.data.total> * 1.1; // Добавить 10% налога

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