Dynamische Ausgaben

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 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 Datensammlungsaktionen 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 Workflow-Studiozu 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 Datensammlungsaktion verweisen, die die angezeigten Daten sammelt. Beispielsweise kann eine Datensammlungsaktion Werte aus einem Drittparteisystem als Teil von abrufen IntegrationHub Spoke. So verwenden Sie eine dynamische Ausgabe in Workflow-Studio:
    1. Ein Aktionsdesigner erstellt eine Datensammlungsaktion.
    2. Ein Aktionsdesigner erstellt eine übergeordnete Aktion mit einer dynamischen Ausgabe, die auf die untergeordnete Datensammlungsaktion verweist.
    3. Ein Flow Designer fügt einem Flow die übergeordnete Aktion hinzu.

    Datensammlungsaktionen

    Eine Datensammlungsaktion sammelt Daten, die von anderen Aktionen verwendet werden sollen. Datensammlungsaktionen sollten aus dynamischen Eingaben aufgerufen und nicht direkt einem Flow hinzugefügt werden. Datensammlungsaktionen erfassen Daten in der Regel mithilfe eines REST-Aufrufs aus Drittparteisystemen. Alle Datensammlungsaktionen müssen diese Anforderungen und Einschränkungen erfüllen.
    • Die Aktion weist einen Skriptschritt auf, der eine Ausgabevariable vom Typ JSON enthält.
    • Die Aktion besitzt 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 darf 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 5000 Auswahloptionen oder 5000 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 Datensammlungsaktion, anstatt sie hart zu codieren. Weitere Informationen zum Erstellen eines dynamischen Objekts finden Sie unter Datensammlungsaktion für ein dynamisches Objekt erstellen.

    Allgemeine Leitlinien

    Verwenden Sie dynamische Ausgaben für Drittanbieterintegrationen
    Verwenden Sie dynamische Ausgaben, um zu introspektieren und während des Flow-Designs 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 Workflow-Studiofinden 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 das System sie stoppt. Wenn Ihre Datensammlungsaktion 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 Endanwender erwartet, dass er einen Wert eingibt oder auswählt.
    Beachten Sie Skriptfehler
    Da alle Datensammlungsaktionen einen Skriptschritt verwenden, können beim Skripting Fehler auftreten. Überprüfen Sie alle Skripts, die zur Ausgabe von JSON-Variablen verwendet werden, da Skriptfehler möglicherweise verhindern, dass die Ausgaben die benötigten JSON-Werte erhalten. Wenn ein Fehler beim Erstellen des dynamischen Ausgabeskripts auftritt, wird möglicherweise die folgende Warnmeldung angezeigt.
    Abbildung : 1. Meldung, die bei einem Skriptfehler angezeigt wird
    Fehlermeldung für dynamische Aktion