--- sourceDocument: Xanadu-Build-Workflows sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/build-workflows Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-Build-Workflows ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Dynamische Eingaben # Dynamische Eingaben {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://www.servicenow.com/docs/access?context=request-integrationhub&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US). 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](https://servicenow-prod.fluidtopics.net/6LxT3HiSFiOXOYhunUMnqA "Erstellen Sie eine Datensammlungsaktion, um eine Liste mit Auswahloptionen für eine dynamische Auswahleingabe zu generieren."). 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](https://servicenow-prod.fluidtopics.net/YrDdV28_xj9uD4tWHr~WZw "Erstellen Sie eine Datensammlungsaktion, um mithilfe einer dynamischen Eingabentypeingabe beliebige Aktionseingaben zu erstellen."). 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](https://servicenow-prod.fluidtopics.net/vSOs5ye0GFVyAOesGcnP0w "Erstellen Sie eine Datensammlungsaktion, um Datensatzfeldwerte für eine dynamische Vorlageneingabe zu sammeln."). 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. {#dynamic-inputs__ol_qn1_nwl_mjb} ## Datensammlungsaktionen {#dynamic-inputs__section_dbr_x1b_chb} 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](https://servicenow-prod.fluidtopics.net/D~EIEZA8S5yAeaP0sB6~4g "Fügen Sie benutzerdefiniertes JavaScript hinzu, um es innerhalb einer wiederverwendbaren Aktion auszuführen. Während die meisten zentralen Aktionen und Schritte für gängige Anwendungsfälle geeignet sind, können Sie einen Skriptschritt zum Ausführen von Verhalten erstellen, das von den zentralen Schritten nicht erfüllt wird.") 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. {#dynamic-inputs__ul_g5h_ly1_chb} ## Allgemeine Leitlinien {#dynamic-inputs__id_pd4_1vb_ptb} 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](https://www.servicenow.com/docs/access?context=integrationhub&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US). 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. * **[Erste Schritte mit dynamischen Eingaben](https://servicenow-prod.fluidtopics.net/SnR3ev7dUgTHMznRRXpBzg#getting-started-dynamic-input)** Erstellen Sie eine Beispielaktion, die die Verwendung aller verfügbaren Arten von dynamischen Eingaben in einem Flow veranschaulicht. * **[Erstellen Sie eine Datensammlungsaktion für eine dynamische Auswahl](https://servicenow-prod.fluidtopics.net/6LxT3HiSFiOXOYhunUMnqA)** Erstellen Sie eine Datensammlungsaktion, um eine Liste mit Auswahloptionen für eine dynamische Auswahleingabe zu generieren. * **[Erstellen Sie eine Datensammlungsaktion für eine dynamische Vorlage](https://servicenow-prod.fluidtopics.net/vSOs5ye0GFVyAOesGcnP0w)** Erstellen Sie eine Datensammlungsaktion, um Datensatzfeldwerte für eine dynamische Vorlageneingabe zu sammeln. * **[Erstellen Sie eine Datensammlungsaktion für eine dynamische Eingabentypeingabe](https://servicenow-prod.fluidtopics.net/YrDdV28_xj9uD4tWHr~WZw)** Erstellen Sie eine Datensammlungsaktion, um mithilfe einer dynamischen Eingabentypeingabe beliebige Aktionseingaben zu erstellen. * **[Dynamische Eingabekonfigurationsoptionen](https://servicenow-prod.fluidtopics.net/luCiWckln8SAxv1JU9tUBg)** Verwenden Sie diese Optionen, um dynamische Eingaben zu konfigurieren.