Dynamische Ausgaben

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

    • Greifen Sie während des Flow-Designs auf Aktions- und Subflow-Ausgaben als dynamisch generierte Datenpillen zu. Sie können auch Datenerfassungsaktionen erstellen, um komplexe Objekte aus den Ausgaben Now Platform und IntegrationHub zu generieren.

    Hinweis:
    Dynamische Ausgaben sind im Basissystem nicht verfügbar. Um dynamische Ausgaben in Flow Designerzu verwenden, müssen Sie Fordern Sie eine an IntegrationHub Plugin.

    Während des Flow-Designs ruft eine dynamische Ausgabe die Schemawerte des komplexen Objekts ab und zeigt sie als Datenpillen im Datenbereich an.

    Eine dynamische Ausgabe muss auf eine Datenerfassungsaktion verweisen, die die angezeigten Daten erfasst. Beispielsweise kann eine Datenerfassungsaktion Werte aus einem Drittanbietersystem als Teil eines abrufen IntegrationHub Spoke. So verwenden Sie eine dynamische Ausgabe in Flow Designer:
    1. Ein Aktionsdesigner erstellt eine Datenerfassungsaktion.
    2. Ein Aktionsdesigner erstellt eine übergeordnete Aktion mit einer dynamischen Ausgabe, die auf die untergeordnete Datenerfassungsaktion verweist.
    3. Ein Flow Designer fügt die übergeordnete Aktion einem Flow hinzu.

    Datenerfassungsaktionen

    Eine Datenerfassungsaktion erfasst Daten, die von anderen Aktionen verwendet werden sollen. Datenerfassungsaktionen sollen aus dynamischen Eingaben aufgerufen und nicht direkt einem Flow hinzugefügt werden. Datenerfassungsaktionen erfassen normalerweise Daten aus Drittanbietersystemen mithilfe eines REST-Aufrufs. Alle Datenerfassungsaktionen müssen diese Anforderungen und Einschränkungen erfüllen.
    • Die Aktion verfügt über einen Skriptschritt, der eine Ausgabevariable vom Typ JSON enthält.
    • Die Aktion hat eine Ausgabe namens output vom Typ JSON, deren Wert von der JSON-Ausgabevariablen des Skriptschritts abgeleitet wird.
      Hinweis:
      Die Aktion kann mehrere Ausgaben haben, aber nur eine vom Typ JSON.
    • Der Skriptschritt formatiert die JSON-Ausgabe so, dass sie eine Eigenschaft namens data enthält.
    • Die JSON-Ausgabe sollte nicht mehr als 5.000 Auswahloptionen, Feldvorlagenwerte oder Array-Elementelemente zurückgeben, wenn die Daten für eine dynamische Auswahl oder eine dynamische Vorlageneingabe vorgesehen sind.
      Hinweis:
      Dynamische Auswahl- und dynamische Vorlageneingaben können nur bis zu 5.000 Auswahloptionen oder 5.000 Vorlagenwerte aus der JSON-Ausgabe anzeigen.
    • Die Aktion wartet bis zu 300 Sekunden (5 Minuten), um Daten zu sammeln, bevor eine Zeitüberschreitung auftritt.
      Hinweis:
      Um die Zeitüberschreitung für alle Aktionen zu ändern, ändern Sie den Wert der Systemeigenschaft sn_flow_designer.sync_action_execution_timeout_in_seconds.

    Dynamisches Objekt

    Ein dynamisches Objekt ist entweder ein komplexes Objekt oder ein Array von komplexen Objekten. Aktionsdesigner erstellen die Objektstruktur dynamisch mit einer Datenerfassungsaktion, anstatt sie fest zu codieren. Weitere Informationen zum Erstellen eines dynamischen Objekts finden Sie unter Datenerfassungsaktionen für ein dynamisches Objekt erstellen.

    Allgemeine Richtlinien

    Verwenden Sie dynamische Ausgaben für Drittanbieterintegrationen
    Verwenden Sie dynamische Ausgaben, um während des Flow-Designs eine Introspektion durchzuführen und Daten aus externen Systemen abzurufen. Sie können beispielsweise Serviceendpunkte angeben oder Aktionen aufrufen, die mit bestimmten Endpunkt-APIs interagieren. Weitere Informationen zum Einrichten von Drittanbieterintegrationen mit Flow Designerfinden Sie unter IntegrationHub.
    Beachten Sie die Zeit, die zum Abrufen großer Datenmengen erforderlich ist
    Standardmäßig haben dynamische Ausgaben bis zu 300 Sekunden Zeit, um Daten zu sammeln, bevor sie vom System angehalten werden. Wenn Ihre Datenerfassungsaktion mehr Zeit zum Sammeln von Daten benötigt, legen Sie die Systemeigenschaft sn_flow_designer.sync_action_execution_timeout_in_seconds auf einen größeren Wert fest. Vermeiden Sie lange Zeitüberschreitungswerte für interaktive Flows, bei denen ein Endbenutzer erwartet, einen Wert einzugeben oder auszuwählen.
    Beachten Sie Skriptfehler
    Da alle Datenerfassungsaktionen einen Skriptschritt verwenden, können beim Skripting potenzielle Fehler auftreten. Überprüfen Sie alle Skripts, die zur Ausgabe von JSON-Variablen verwendet werden, da Skriptfehler dazu führen können, dass die Ausgaben die benötigten JSON-Werte erhalten. Wenn ein dynamischer Ausgabeskriptfehler auftritt, wird möglicherweise die folgende Warnmeldung angezeigt.
    Abbildung : 1. Meldung, die für einen Skriptfehler angezeigt wird
    Fehlermeldung für dynamische Aktion