--- 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 --- # Erstellen Sie eine Datensammlungsaktion für eine dynamische Vorlage # Erstellen Sie eine Datensammlungsaktion für eine dynamische Vorlage {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer Erstellen Sie eine Datensammlungsaktion, um Datensatzfeldwerte für eine dynamische Vorlageneingabe zu sammeln. ## Vorbereitungen * Erforderliche Rolle: action_designer oder admin * Erstellen Sie Anmeldeinformationen und Verbindungen für Ihren REST-Endpunkt {#create-data-gathering-action-dynamic-template__ul_bzg_l2q_mxb} 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). ## Prozedur 1. Navigieren zu AlleProzessautomatisierungFlow Designer. 2. Auswahlvorgang Neu erstellenAktion. 3. Geben Sie im Feld Aktionsname einen Namen für Ihre Aktion ein, wählen Sie den richtigen Anwendungsbereich aus, und wählen Sie Absendenaus. 4. **Wahlweise:** Wählen Sie in der Aktionsgliederung die Option Eingabenaus. Möglicherweise müssen Sie eine Eingabe erstellen, um Ihrem REST-Schritt einen Tabellennamen oder einen dynamischen URL-Pfad bereitzustellen. Erstellen Sie beispielsweise eine Zeichenfolgeneingabe, um einen Tabellennamen zu speichern. Siehe [Erstellen Sie eine Datensammlungsaktion, um Feldnamen abzurufen](https://servicenow-prod.fluidtopics.net/SnR3ev7dUgTHMznRRXpBzg#create-data-gathering-action-to-get-field-names "Erstellen Sie eine Datensammlungsaktion, um eine Liste der Felder aus einer Tabelle abzurufen.") für Anweisungen. 5. Wählen Sie in der Aktionsgliederung unter Eingaben das Symbol zum Hinzufügen eines neuen Schritts (Symbol zum ![Hinzufügen eines neuen Schritts]()) und anschließend den REST- Schritt. 1. Wählen Sie in den Verbindungsdetails einen Verbindungsalias aus, oder definieren Sie eine Verbindung inline. Mit einem Verbindungsalias können Sie Verbindungsdetails aktualisieren, ohne die Aktion bearbeiten zu müssen. Wählen Sie beispielsweise einen Verbindungsalias für Ihre lokale Instanz aus. 2. Wählen Sie für die Anforderungsdetails eine Methode zum Erstellen einer Anforderung aus, geben Sie einen Ressourcenpfad an, wählen Sie eine HTTP-Methode aus, und geben Sie Abfrageparameter an. Datensammlungsaktionen verwenden im Allgemeinen eine GET-HTTP-Methode, um Daten von einem REST-Endpunkt anzufordern. Weitere Informationen zur Verwendung des REST-Schritts in IntegrationHubfinden Sie unter [REST-Schritt](https://servicenow-prod.fluidtopics.net/qBIp7gBa9DnOzz82FeLPmQ "Senden Sie eine ausgehende REST-Webdienstanforderung an ein externes System.") und [REST in IntegrationHub](https://developer.servicenow.com/app.do#!/training/article/app_store_learnv2_rest_paris_rest_in_integrationhub/app_store_learnv2_rest_paris_rest_in_integrationhub_objectives?v=paris). {#create-data-gathering-action-dynamic-template__substeps_nck_f2q_mxb} 6. Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol zum Hinzufügen eines neuen Schritts (Symbol zum ![Hinzufügen eines neuen Schritts]()) und anschließend den Schritt Skript. 1. Wählen Sie unter Eingabevariablen die Option Variable erstellenaus, und erstellen Sie eine Eingabevariable zum Speichern des REST-Antworttexts. 2. Wählen Sie für die Eingabevariable „Wert" die Datenpille für die Ausgabe des Antworttexts des REST-Schritts aus. 3. Geben Sie unter Skript ein Skript ein, um aus der Eingabevariablen eine JSON-Ausgabe zu erstellen. Ihr Skript muss diese Aufgaben ausführen. Analysieren Sie die Eingabevariable als JSON : Sie können die [JSON - Global](https://www.servicenow.com/docs/access?context=c_JSONAPI&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) API verwenden, um die Eingabevariable von einer Zeichenfolge in ein JSON-Objekt umzuwandeln. Erstellen Sie ein neues JSON-Objekt, das für eine dynamische Vorlage formatiert ist : Sie müssen die Datenstruktur der REST-Antwort kennen, um Antwortwerte Vorlagenwerten zuzuordnen. Das Skript muss ein dynamisches JSON-Vorlagenobjekt mit einer Eigenschaft namens „ `data`" erstellen. Der Wert der Dateneigenschaft muss ein Array von Vorlagenwerten sein. Jeder Vorlagenwert muss eine `Bezeichnungseigenschaft`, eine `Namenseigenschaft` und eine leere `Werteigenschaft` aufweisen. Die Eigenschaft „label" bestimmt, wie die Vorlagenwertoption in der Aktion angezeigt wird. Die Namenseigenschaft bestimmt, wie die Vorlagenwertoption gespeichert und im System referenziert wird. Die Werteigenschaft ist leer, sodass der Wert dynamisch festgelegt werden kann, wenn die Aktion konfiguriert wird. Dieses JSON-Objekt definiert beispielsweise ein Array von Vorlagenwerten aus der Incident-Tabelle. { "data": [ { "name": "parent", "label": "Parent", "value": "" }, { "name": "number", "label": "Number", "value": "" }, { "name": "state", "label": "State", "value": "" }, { "name": "active", "label": "Active", "value": "" }, { "name": "priority", "label": "Priority", "value": "" }, { "name": "caller_id", "label": "Caller id", "value": "" }, { "name": "short_description", "label": "Short description", "value": "" }, { "name": "description", "label": "Description", "value": "" }, { "name": "sys_id", "label": "Sys id", "value": "" }, { "name": "urgency", "label": "Urgency", "value": "" }, { "name": "assigned_to", "label": "Assigned to", "value": "" }, { "name": "severity", "label": "Severity", "value": "" }, { "name": "category", "label": "Category", "value": "" } ] } Hinweis: Eine dynamische Vorlageneingabe kann nur bis zu 5000 Feldvorlagenwerte anzeigen. Ein JSON-Objekt, das mehr als 5.000 Feldvorlagenwerte zurückgibt, wird beim Rendern gekürzt. Legen Sie das Ausgabeobjekt fest : Legen Sie das Ausgabeobjekt so fest, dass Ihr dynamisches JSON-Vorlagenobjekt zurückgegeben wird. 4. Wählen Sie unter Ausgabevariablen die Option Variable erstellenaus. Diese Ausgabevariable speichert die von Ihrem Skript erstellten Vorlagenwerte. 5. Wählen Sie als Ausgabevariablentyp JSONaus. Der Variablentyp der Skriptausgabe muss JSON sein. {#create-data-gathering-action-dynamic-template__substeps_ymx_zp3_mxb} 7. Wählen Sie in der Aktionsgliederung die Option Ausgabenaus 1. Wählen Sie Ausgabe erstellen aus. 2. Legen Sie die Ausgabebezeichnung und den Namen der Ausgabe fest. 3. Legen Sie den Ausgabetyp auf JSON fest. Hinweis: Die Aktion kann mehrere Ausgaben haben, es darf jedoch nur eine vom Typ JSON vorhanden sein. 4. Wählen Sie Bearbeitungsmodus beenden aus. 5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ![Datenpillenauswahl]()) und dann Skriptschritt-Ausgabevariable aus, die Sie zum Speichern von Vorlagenwerten erstellt haben. {#create-data-gathering-action-dynamic-template__substeps_dd5_yw3_mxb} 8. Klicken Sie auf Speichern und [testen Sie die Aktion](https://servicenow-prod.fluidtopics.net/IwFgwpLrQRWMsGiMe8ymdg "Testen Sie eine Aktion, bevor Sie sie für andere Anwender veröffentlichen."). In den Ausführungsdetails wird Ihre Datensammlungsaktion erfolgreich ausgeführt, wenn der Laufzeitwert für die `Ausgabe` die `Dateneigenschaft` im richtigen Format enthält. 9. Klicken Sie auf Veröffentlichen, um die Aktion für andere Flows oder Aktionen innerhalb desselben Anwendungsbereichs verfügbar zu machen. {#create-data-gathering-action-dynamic-template__steps_bfz_nlf_mjb} ## Ergebnisse Sie können jetzt Ihre Datensammlungsaktion verwenden, um die Optionen auszufüllen, die für eine dynamische Vorlageneingabe in einer übergeordneten Aktion angezeigt werden. **Zugehörige Tasks** * [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 Eingabentypeingabe](https://servicenow-prod.fluidtopics.net/YrDdV28_xj9uD4tWHr~WZw "Erstellen Sie eine Datensammlungsaktion, um mithilfe einer dynamischen Eingabentypeingabe beliebige Aktionseingaben zu erstellen.") **Zugehörige Verweise** * [Dynamische Eingabekonfigurationsoptionen](https://servicenow-prod.fluidtopics.net/luCiWckln8SAxv1JU9tUBg "Verwenden Sie diese Optionen, um dynamische Eingaben zu konfigurieren.")