Dynamische Eingaben

  • Freigeben Version: Washingtondc
  • Aktualisiert 14. Februar 2024
  • 3 Minuten Lesedauer

    • Generieren Sie jedes Mal eine Liste von Aktionseingaben oder Eingabewerten, wenn jemand 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 von Optionen anzeigen, die in einer Auswahlliste verfügbar sind.

    Hinweis:
    Dynamische Eingaben sind im Basissystem nicht verfügbar. Um dynamische Eingaben in Flow Designerzu 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 stehen Aktionsautoren zur Verfügung.
    Dynamische Auswahl
    Der Eingabetyp „Dynamische Auswahl“ erfasst eine Liste von Auswahlwerten, die angezeigt werden sollen. Weitere Informationen zum Erstellen einer dynamischen Auswahl finden Sie unter Datenerfassungsaktion für eine dynamische Auswahl erstellen.
    Dynamische Eingaben
    Der Eingabetyp Dynamische Eingaben erfasst 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 Datenerfassungsaktion für eine dynamische Eingabe vom Typ Eingabe.
    Dynamische Vorlage
    Der Eingabetyp „Dynamische Vorlage“ erfasst 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 Felder der Quelltabelle hinzugefügt oder daraus entfernt werden. Weitere Informationen zum Erstellen einer dynamischen Vorlage finden Sie unter Datenerfassungsaktionen für eine dynamische Vorlage erstellen.
    Es gibt drei allgemeine Schritte zur Verwendung dynamischer Eingaben.
    1. Ein Aktionsautor erstellt eine Datenerfassungsaktion, um dynamische Daten zu generieren.
    2. Ein Aktionsautor erstellt eine Aktion mit einer dynamischen Eingabe und konfiguriert die dynamische Eingabe so, dass die Datenerfassungsaktion aufgerufen wird.
    3. Ein Flow-Autor fügt die Aktion einem Flow hinzu und konfiguriert die Aktion mit dynamisch erfassten Daten.

    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.

    Allgemeine Richtlinien

    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 Flow Designerfinden 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 eine Zeitüberschreitung auftritt. 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 höheren Wert fest. Verwenden Sie jedoch keine langen Zeitüberschreitungswerte für interaktive Flows, bei denen ein Endbenutzer einen Wert eingeben oder auswählen muss.
    Beachten Sie Skriptfehler
    Da alle Datenerfassungsaktionen einen Skriptschritt verwenden, können beim Skripting potenzielle Fehler auftreten. Wenn Sie Skripts zur Ausgabe von JSON-Variablen für Ihre dynamischen Eingaben verwenden, können Fehler auftreten, die verhindern, dass Eingaben die benötigten JSON-Werte erhalten. Wenn ein dynamischer Eingabeskriptfehler auftritt, wird möglicherweise die folgende Warnmeldung angezeigt.
    Abbildung : 1. Meldung für Skriptfehler angezeigt
    Fehlermeldung für dynamische Aktion
    Begrenzen Sie Eingaben vom Typ „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 im Speicher gespeichert zu werden. 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.
    Begrenzen Sie die JSON-Ausgabe für dynamische Vorlagen und dynamische Auswahlmöglichkeiten auf 5000 Array-Elemente
    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 Datenerfassungsaktion Daten für eine dynamische Vorlage oder eine dynamische Auswahl erfasst, beschränken Sie die maximale Anzahl der zurückgegebenen Array-Elemente auf 5000. Die Beschränkung auf 5000 Array-Elemente verhindert, dass die Instanz beim Rendern der Auswahlmöglichkeiten oder Feldwerte Leistungsprobleme hat.