Verweisen auf Daten im Workflow

Verweisen auf Daten aus der Laufzeit

In der Laufzeit werden die Auslöserdaten einer Integration gespeichert. Die Referenz für die Laufzeitdaten ist {{runtime}}.

Sie können auf Datenteile verweisen, die in der Laufzeit gespeichert sind. Wenn Sie auf diese Elemente verweisen, sollten Sie den Namen des einzelnen Elements angeben.

Wenn beispielsweise ein Blatt in Smartsheet einen Workflow auslöst und Sie auf die ID der betreffenden Zeile verweisen müssen, könnte die Referenz wie folgt aussehen: {{runtime.event.RowID}}.

Die genaue Struktur und Namenskonvention unterscheidet sich je nach Auslöser und Ereignistyp. 

So verwenden Sie den richtigen Verweis:

1. Zeigen Sie im Run-Log mit der Maus auf ein Triggerobjekt. 
2. Wählen Sie
   Brandfolder Image

   
   .
3. Wählen Sie in der angezeigten Liste die Option Datenreferenz kopieren aus.

Brandfolder Image

Verweisen auf Daten aus einem Zustand

Sie können auf einen Status verweisen, wenn Daten von einem übergeordneten Workflow übergeben werden. Das Referenzformat ist {{states.state name.value}}.

Wenn Sie auf Daten aus einem Modul unter einem Zustand verweisen möchten, ist der Zustand auch relevant. In diesem Fall wäre die Referenzstruktur {{states.state name.integration oder utility name.module name}}.

Wenn ein Modul mehrere Datenwerte ausgeben kann, fügen Sie den Pfad für diese spezifischen Daten in Ihrem Datenverweis hinzu (ähnlich wie Sie auf einzelne Teile von Laufzeitdaten verweisen).

Beispielsweise gibt das Modul Smartsheet: Get Row standardmäßig die Daten in der Abbildung unten zurück. 

Brandfolder Image

Um auf den Wert zu verweisen, der in der Adresszelle in der Zeile eingegeben wurde, wäre der Verweis:
{{states.getrow.smartsheet.get_row.cells.address.value}}.

Verweisen auf Daten aus einem untergeordneten Workflow

Sie können auf Daten aus einem untergeordneten Workflow im übergeordneten Workflow verweisen. Befolgen Sie dafür diese Schritte:

1. Kopieren Sie die Datenreferenz, die Sie verwenden möchten, aus dem übergeordneten Workflow.
2. Fügen Sie dem übergeordneten Workflow ein Modul „Untergeordneten Workflow ausführen“ hinzu und geben Sie ihm einen Namen.

Im übergeordneten Workflow, im untergeordneten Modul:

3. Wählen Sie Werte für untergeordnete Entitäten aus. 
4. Fügen Sie einen Schlüssel hinzu, den Namen, um auf die Daten im untergeordneten Workflow zu verweisen.
5. Fügen Sie den entsprechenden Wert hinzu, die Datenreferenz, die Sie in Schritt 1 kopiert haben. Es könnte so aussehen wie {{states.startstate.stringtools.compose_text}}

Im untergeordneten Arbeitsablauf:

3. Wählen Sie das Modul aus, in dem Sie auf die übergeordneten Workflow-Daten verweisen möchten.
4. Geben Sie in das Feld, in dem Sie auf die übergeordneten Workflow-Daten verweisen möchten, {{runtime.entities.text}} ein, wobei „Text“ der in Schritt 4 hinzugefügte Schlüssel ist. 

Wenn Sie {{runtime.entities.text}} wie {{states.text.value}} innerhalb des untergeordneten Workflows referenzieren möchten, müssen Sie im untergeordneten Workflow einen Status mit dem Namen „text“ erstellen

Verweisen auf Daten aus einem untergeordneten Workflow

Sie können auf Daten aus einem untergeordneten Workflow im übergeordneten Workflow verweisen. Dazu könnte Ihr Datenverweis wie folgt aussehen:

• Staaten. {{Staat, der das Kind ausführt}} .child. {{Zustand des Kindes}} .value. ; oder.
• Staaten. {{Staat, der das Kind ausführt}} .child. {{state in child}} .integration oder utility.module.

Optionen für leere Datenverweise

Wenn der nächste Schritt Ihres Workflows von einem bestimmten Wert abhängt, der möglicherweise existiert oder nicht, können Sie vertikale Balken (||) verwenden, um zwei Szenarien zu behandeln.

Nehmen wir einmal an, Sie möchten den Wert in einer Smartsheet-Zelle verwenden, um zu bestimmen, welchem Pfad der Workflow bei einer Verzweigung folgen soll. Sie können jedoch nicht sicher sein, ob die Zelle immer einen Wert enthält. 

Wenn die Zelle leer ist, wird der Workflow gestoppt, sobald er die Verzweigung erreicht. Sie können senkrechte Striche (||) am Ende Ihres Datenverweises hinzufügen, um dies zu verhindern. Wenn dieser Wert Daten enthält, verwendet der Workflow den Verweis links neben den Balken. Wenn in dieser Zelle keine Daten vorhanden sind, verwendet der Workflow das, was sich rechts neben den Balken befindet.

Schauen Sie sich die beiden möglichen Szenarien in dieser Referenz an:
{{states.getRow.Smartsheet.get_row.cells.address.value||116 George Street, Edinburgh, Großbritannien}}

1. Der Workflow versucht zuerst, die Adresse aus der Zeile zu verwenden, die er zuvor erhalten hat: getRow.Smartsheet.get_row.row.cells.Address.Value.
2. Wenn diese Zelle jedoch leer ist, wird die Adresse verwendet, die hinter den senkrechten Strichen angegeben ist: 116 George Street, Edinburgh, Großbritannien.

Tipps zur Verwendung von senkrechten Strichen

Sie können verwenden: 

• eine andere Datenreferenz hinter den senkrechten Strichen statt eines eingegebenen Werts, oder
• mehrere vertikale Balken, um verschiedene mögliche Szenarien zu bewältigen.

Kombinieren von Text und Datenverweisen

In den meisten Modulen können Sie geschriebenen Text und Datenverweise kombinieren. Sie können die Teile der E-Mail eingeben, die immer gleich sein sollen, und Datenverweise für die Teile verwenden, die möglicherweise nicht immer identisch sind, z. B. den Namen eines Empfängers/einer Empfängerin oder ein Datum.

Wenn Sie den Wetter-Workflow im Artikel Start a blank workflow for US Weather Service erstellt haben, ist Ihnen vielleicht aufgefallen, dass die im API-Aufruf an den US Weather Service verwendete URL zwei Datenreferenzen enthielt.