Dynamische Eingaben

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer

    • Generieren Sie jedes Mal eine Liste von Aktionseingaben oder Eingabewerten, wenn ein Benutzer die Aktion in einem Flow konfiguriert. Dynamische Eingaben können eine Liste zugehöriger Aktionseingaben, eine Liste von Feldern aus einem Datensatz oder eine Liste der in einer Auswahlliste verfügbaren Optionen anzeigen.

    Hinweis:
    Dynamische Eingaben sind im Basissystem nicht verfügbar. Um dynamische Eingaben in Workflow-Studiozu verwenden, müssen Sie Fordern Sie eine an IntegrationHub Plugin.
    Während des Flow-Designs rufen dynamische Eingaben Werte ab und zeigen sie dynamisch als Eingaben innerhalb einer Aktion an. Diese Arten von dynamischen Eingaben sind für Aktionsautoren verfügbar.
    Dynamische Auswahl
    Die Eingabe vom Typ „Dynamische Auswahl“ sammelt eine Liste der anzuzeigenden Auswahlwerte. Weitere Informationen zum Erstellen einer dynamischen Auswahl finden Sie unter Datensammlungsaktion für eine dynamische Auswahl erstellen.
    Dynamische Eingaben
    Die Eingabe vom Typ „Dynamische Eingaben“ sammelt eine Liste zusätzlicher Aktionseingaben, die angezeigt werden sollen. Verwenden Sie dynamische Eingaben, um einer Aktion beliebige Eingaben hinzuzufügen. Weitere Informationen zum Erstellen dynamischer Eingaben finden Sie unter Erstellen Sie eine Datensammlungsaktion für eine dynamische Eingabentypeingabe.
    Dynamische Vorlage
    Die Eingabe des dynamischen Vorlagentyps sammelt eine Liste von Feldern aus einem dynamisch ausgewählten Datensatztyp. Flow-Autoren können dann auswählen, welche Felder in ihren Flow aufgenommen werden sollen. Da die Liste der Felder dynamisch generiert wird, müssen Sie die Aktion nicht ändern, wenn der Quelltabelle Felder hinzugefügt oder daraus entfernt werden. Weitere Informationen zum Erstellen einer dynamischen Vorlage finden Sie unter Datensammlungsaktion für dynamische Vorlage erstellen.
    Es gibt drei allgemeine Schritte zur Verwendung dynamischer Eingaben.
    1. Ein Aktionsautor erstellt eine Datensammlungsaktion, um dynamische Daten zu generieren.
    2. Ein Aktionsautor erstellt eine Aktion mit einer dynamischen Eingabe und konfiguriert die dynamische Eingabe so, dass die Datensammlungsaktion aufgerufen wird.
    3. Ein Flow-Autor fügt die Aktion einem Flow hinzu und konfiguriert die Aktion mit dynamisch gesammelten Daten.

    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.

    Allgemeine Leitlinien

    Berücksichtigen Sie dynamische Eingaben für Drittanbieterintegrationen
    Mit dynamischen Eingaben können Sie Flows erstellen, die Daten dynamisch aus externen Quellen abrufen. In Drittanbieterintegrationen können dynamische Eingaben Datenwerte bereitstellen, die sich auf einen bestimmten Endpunkt beziehen. 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 Eingaben bis zu 300 Sekunden Zeit, um Daten zu sammeln, bevor sie ablaufen. 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 höheren Wert fest. Verwenden Sie jedoch keine langen Timeout-Werte für interaktive Flows, bei denen ein Endanwender einen Wert eingeben oder auswählen muss.
    Beachten Sie Skriptfehler
    Da alle Datensammlungsaktionen einen Skriptschritt verwenden, können beim Skripting Fehler auftreten. Wenn Sie Skripts zur Ausgabe von JSON-Variablen für Ihre dynamischen Eingaben verwenden, können Fehler auftreten, die verhindern, dass die Eingaben die benötigten JSON-Werte erhalten. Wenn ein Skriptfehler bei der dynamischen Eingabe auftritt, wird möglicherweise die folgende Warnmeldung angezeigt.
    Abbildung : 1. Meldung, die für den Skriptfehler angezeigt wird
    Fehlermeldung für dynamische Aktion
    Beschränken Sie dynamische Eingaben auf 40 Eingabewerte
    Eine Eingabe vom Typ „Dynamische Eingaben“ kann nur eine bestimmte Anzahl von Eingaben rendern, bevor das JSON-Objekt zu groß wird, um es im Arbeitsspeicher zu speichern. Wenn Sie Ihre dynamischen Eingaben auf 40 Eingabewerte beschränken, minimieren Sie die Wahrscheinlichkeit, dass Ihnen der Arbeitsspeicher ausgeht und unerwartetes Verhalten auftritt, z. B. Darstellungsfehler oder Datenkürzung.
    Beschränken Sie die JSON-Ausgabe auf 5000 Array-Elemente für dynamische Vorlagen und dynamische Auswahlmöglichkeiten
    Dynamische Auswahl- und dynamische Vorlageneingaben können nur bis zu 5000 Array-Elemente anzeigen. Eine dynamische Auswahl kann nur bis zu 5000 Auswahllistenoptionen anzeigen, und eine dynamische Vorlage kann nur bis zu 5000 Feldvorlagenwerte anzeigen. Wenn Ihre Datensammlungsaktion Daten für eine dynamische Vorlage oder eine dynamische Auswahl sammelt, beschränken Sie die maximale Anzahl der zurückgegebenen Array-Elemente auf 5000. Die Beschränkung von 5000 Array-Elementen verhindert, dass die Instanz Leistungsprobleme beim Rendern der Auswahlmöglichkeiten oder Feldwerte hat.