Verbindungs-Tags

Verbindungs-Tags sind visuelle Darstellungen der verfügbaren Daten aus verbundenen Blöcken und bieten eine einfache Möglichkeit, auf Daten zwischen Blöcken und Ausgaben aus vorherigen Blöcken in Ihrem Workflow zu verweisen.

Was sind Verbindungs-Tags?

Verbindungs-Tags sind interaktive Elemente, die erscheinen, wenn Blöcke verbunden werden. Sie repräsentieren die Daten, die von einem Block zum anderen fließen können und ermöglichen es Ihnen:

Verfügbare Daten aus Quellblöcken zu visualisieren
Auf bestimmte Datenfelder in Zielblöcken zu verweisen
Dynamische Datenflüsse zwischen Blöcken zu erstellen

Verbindungs-Tags machen es einfach zu sehen, welche Daten aus vorherigen Blöcken verfügbar sind und diese in Ihrem aktuellen Block zu verwenden, ohne sich komplexe Datenstrukturen merken zu müssen.

Verwendung von Verbindungs-Tags

Es gibt zwei Hauptmethoden, um Verbindungs-Tags in Ihren Workflows zu verwenden:

Drag and Drop

Klicken Sie auf einen Verbindungs-Tag und ziehen Sie ihn in Eingabefelder von Zielblöcken. Ein Dropdown-Menü wird angezeigt, das verfügbare Werte zeigt.

Fahren Sie mit dem Mauszeiger über einen Verbindungs-Tag, um verfügbare Daten zu sehen
Klicken und ziehen Sie den Tag in ein Eingabefeld
Wählen Sie das spezifische Datenfeld aus dem Dropdown-Menü
Die Referenz wird automatisch eingefügt

Spitze-Klammer-Syntax

Geben Sie <> in Eingabefeldern ein, um ein Dropdown-Menü mit verfügbaren Verbindungswerten aus vorherigen Blöcken zu sehen.

Klicken Sie in ein beliebiges Eingabefeld, in dem Sie verbundene Daten verwenden möchten
Geben Sie <> ein, um das Verbindungs-Dropdown-Menü aufzurufen
Durchsuchen und wählen Sie die Daten aus, auf die Sie verweisen möchten
Tippen Sie weiter oder wählen Sie aus dem Dropdown-Menü, um die Referenz zu vervollständigen

Tag-Syntax

Verbindungs-Tags verwenden eine einfache Syntax, um auf Daten zu verweisen:

<blockName.path.to.data>

Wobei:

blockName ist der Name des Quellblocks
path.to.data ist der Pfad zum spezifischen Datenfeld

Zum Beispiel:

<agent1.content> - Verweist auf das Inhaltsfeld eines Blocks mit der ID "agent1"
<api2.data.users[0].name> - Verweist auf den Namen des ersten Benutzers im Benutzer-Array aus dem Datenfeld eines Blocks mit der ID "api2"

Dynamische Tag-Referenzen

Verbindungs-Tags werden zur Laufzeit ausgewertet, was bedeutet:

Sie verweisen immer auf die aktuellsten Daten
Sie können in Ausdrücken verwendet und mit statischem Text kombiniert werden
Sie können in andere Datenstrukturen eingebettet werden

Beispiele

// Reference in text
"The user's name is <userBlock.name>"

// Reference in JSON
{
  "userName": "<userBlock.name>",
  "orderTotal": <apiBlock.data.total>
}

// Reference in code
const greeting = "Hello, <userBlock.name>!";
const total = <apiBlock.data.total> * 1.1; // Add 10% tax

Wenn Sie Verbindungs-Tags in numerischen Kontexten verwenden, stellen Sie sicher, dass die referenzierten Daten tatsächlich eine Zahl sind, um Typkonvertierungsprobleme zu vermeiden.