---
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
---
# Erste Schritte mit dynamischen Eingaben
# Erste Schritte mit dynamischen Eingaben {#ariaid-title1}
* Freigeben Version: Xanadu
*
* Aktualisiert 1. August 2024
*
*  17 Minuten Lesedauer
Erstellen Sie eine Beispielaktion, die die Verwendung aller verfügbaren Arten von dynamischen Eingaben in einem Flow veranschaulicht.
## Vorbereitungen
Erforderliche Rolle: action_designer oder admin
## Prozedur
1. [Erstellen Sie Anmeldeinformations- und Verbindungsdatensätze für Ihre Instanz](https://servicenow-prod.fluidtopics.net/SnR3ev7dUgTHMznRRXpBzg#create-credential-and-connection-for-instance "Erstellen Sie die Aliasse, Verbindungen und Anmeldeinformationen, die zum Herstellen einer Verbindung mit Ihrer lokalen Instanz erforderlich sind.").
Dieser Alias für Verbindungen und Anmeldeinformationen stellt die Basis-URL und den Anwenderaccount bereit, die zum Konfigurieren der REST-Schritte Ihrer Datensammlungsaktionen erforderlich sind.
2. [Erstellen Sie eine Datensammlungsaktion, um Tabellennamen abzurufen](https://servicenow-prod.fluidtopics.net/SnR3ev7dUgTHMznRRXpBzg#create-data-gathering-action-to-get-table-names "Erstellen Sie eine anwenderdefinierte Datensammlungsaktion, um eine Liste von Tabellennamen aus der Tabellen-API abzurufen.").
Diese Datensammlungsaktion stellt JSON-Daten für dynamische Auswahleingaben bereit.
3. [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.").
Diese Datensammlungsaktion stellt JSON-Daten für dynamische Vorlageneingaben bereit.
4. [Erstellen Sie eine Datensammlungsaktion, um dynamische Eingaben hinzuzufügen](https://servicenow-prod.fluidtopics.net/SnR3ev7dUgTHMznRRXpBzg#create-data-gathering-action-to-add-dynamic-inputs "Erstellen Sie eine Datensammlungsaktion, um eine dynamische Eingabe des Referenztyps hinzuzufügen.").
Diese Datensammlungsaktion stellt JSON-Daten bereit, um beliebige dynamische Eingaben zu erstellen.
5. [Erstellen Sie eine anwenderdefinierte Aktion zum Testen dynamischer Eingaben](https://servicenow-prod.fluidtopics.net/SnR3ev7dUgTHMznRRXpBzg#get-started-dynamic-input-create-record-action "Erstellen Sie eine anwenderdefinierte Aktion zum Testen dynamischer Eingaben.").
Diese anwenderdefinierte Aktion veranschaulicht verschiedene Arten von dynamischen Eingaben.
{#getting-started-dynamic-input__steps_rwp_pml_kxb}
**Zugehörige Tasks**
* [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.")
**Zugehörige Verweise**
* [Dynamische Eingabekonfigurationsoptionen](https://servicenow-prod.fluidtopics.net/luCiWckln8SAxv1JU9tUBg "Verwenden Sie diese Optionen, um dynamische Eingaben zu konfigurieren.")
## Erstellen Sie Anmeldeinformations- und Verbindungsdatensätze für Ihre Instanz {#ariaid-title2}
Erstellen Sie die Aliasse, Verbindungen und Anmeldeinformationen, die zum Herstellen einer Verbindung mit Ihrer lokalen Instanz erforderlich sind.
### Vorbereitungen
Erforderliche Rolle: admin
### Prozedur
1. Navigieren zu AlleVerbindungen und AnmeldeinformationenAkadem. Grade.
2. Wählen Sie Neu, wählen Sie Anmeldeinformationenfür Standardauthentifizierung aus, und geben Sie diese Feldwerte ein.
1. Geben Sie als NameLokaler Administratorein.
2. Geben Sie unter Anwendernameeinen Anwenderaccount mit Zugriff auf Flow Designer und die REST API ein.
Geben Sie beispielsweise adminein.
3. Geben Sie unter Passwortdas Account-Passwort ein.
{#create-credential-and-connection-for-instance__substeps_wmq_nxk_kxb}
3. Wählen Sie Absenden aus, um den Anmeldeinformationsdatensatz zu erstellen.
4. Navigieren zu AlleVerbindungen und AnmeldeinformationenAliasse für Verbindungen und Anmeldeinformationen.
5. Wählen Sie Neu aus, und geben Sie diese Feldwerte ein.
1. Geben Sie als NameLokale Instanz ein.
2. Übernehmen Sie den Standardwert HTTP für den Verbindungstyp.
3. Wählen Sie Absenden aus, um den Datensatz „Alias für Verbindungen und Anmeldeinformationen" zu erstellen.
{#create-credential-and-connection-for-instance__substeps_wm4_dzk_kxb}
6. Wählen Sie den von Ihnen erstellten Alias aus.
Wählen Sie beispielsweise Lokale Instanzaus.
7. Wählen Sie in der zugehörigen Liste „Verbindungen" Neuaus, und geben Sie diese Feldwerte ein.
1. Geben Sie als NameMeine Instanzein.
2. Wählen Sie unter „Anmeldeinformationen" den von Ihnen erstellten Anmeldeinformationsdatensatz für die Standardauthentifizierung aus.
Wählen Sie beispielsweise die Anmeldeinformationen Lokaler Administrator aus.
3. Geben Sie unter „Verbindungs-URL" die Basis-URL für Ihre Instanz einschließlich des Schrägstrichs am Ende ein.
Fügen Sie das URL-Präfix https:// und einen Schrägstrich am Ende der URL hinzu.
Beispiel: https://beispiel.service-now.com/.
4. Wählen Sie Absenden aus, um den Datensatz für die HTTP(s) -Verbindung zu erstellen.
{#create-credential-and-connection-for-instance__substeps_d5c_c1l_kxb}
### Ergebnisse
Sie können den Alias für lokale Instanzen verwenden, um bei der Konfiguration von REST-Schritten eine Verbindung zu Ihrer lokalen Instanz herzustellen.
## Erstellen Sie eine Datensammlungsaktion, um Tabellennamen abzurufen {#ariaid-title3}
Erstellen Sie eine anwenderdefinierte Datensammlungsaktion, um eine Liste von Tabellennamen aus der Tabellen-API abzurufen.
### Vorbereitungen
Erforderliche Rolle: action_designer oder admin
### Warum und wann dieser Vorgang ausgeführt wird
Diese Datensammlungsaktion besteht aus den folgenden Elementen.
* Ein REST-Schritt zum Erfassen von Tabellennamen aus dem REST [Table API](https://www.servicenow.com/docs/access?context=c_TableAPI&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US)
* Ein Skriptschritt zum Erstellen einer JSON-Nutzlast aus dem Antworttext des REST-Schritts
* Eine Aktionsausgabevariable mit dem Namen „ output " speichert Tabellenname-Wert-Paare als JSON-Dokument
{#create-data-gathering-action-to-get-table-names__ul_lrx_byj_kxb}
Diese anwenderdefinierte Aktion verwendet einen REST-API-Aufruf, um die Funktionalität des ServiceNow Kerns [Aktion „Datensatz suchen"](https://servicenow-prod.fluidtopics.net/sT5esKE9dL1WYcgoQjTEBg "Suchen Sie einen Datensatz aus einer beliebigen Tabelle anhand definierter Bedingungen.") und des [Aktion „Datensätze suchen"](https://servicenow-prod.fluidtopics.net/L6NY2loyXcZk80KjNL69Bw "Suchen Sie mehrere Datensätze in einer beliebigen Tabelle unter definierten Bedingungen.")zu duplizieren. Normalerweise müssen Sie keine anwenderdefinierten Aktionen erstellen, um grundlegende Datensatzvorgänge auszuführen. Diese Aktion veranschaulicht die Arbeit mit den REST- und Skriptschritten zum Sammeln von Tabellendaten für dynamische Eingaben.
### Prozedur
1. Navigieren zu AlleProzessautomatisierungWorkflow-Studio.
2. Wählen Sie auf der Homepage Aktionen.
3. Auswahlvorgang Neu erstellenAktion.
1. Geben Sie auf dem Bildschirm mit den Aktionseigenschaften im Feld Aktionsname Datensammlungsaktion für Tabellen ein.
2. Wählen Sie für Anwendungdie Option Global aus.
3. Wählen Sie Absenden.
{#create-data-gathering-action-to-get-table-names__substeps_fw2_tzz_3xb}
4. Wählen Sie in der Aktionsgliederung im Abschnitt „Eingaben" das Symbol zum Hinzufügen eines neuen Schritts (Symbol zum ![Hinzufügen eines neuen Schritts]()).
5. Wählen Sie im Abschnitt Integrationen den REST -Schritt aus, und geben Sie diese Feldwerte ein.
{#create-data-gathering-action-to-get-table-names__table_pvd_ftf_mjb__entry__2}
| Eingabe | Wert |
|-|-|
| Verbindung | Lassen Sie Verbindungsalias verwenden ausgewählt. |
| Verbindungsalias | Wählen Sie den Alias aus, den Sie zuvor erstellt haben, oder wählen Sie das Symbol zum Erstellen eines ![neuen Datensatzes (Symbol]()zum Erstellen eines neuen Datensatzes ) zum [Erstellen einer HTTP(s)-Verbindung](https://www.servicenow.com/docs/access?context=create-https-connection&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Hinweis: Die Anmeldeinformationen für die HTTP(s)-Verbindung müssen [Anmeldeinformationen](https://www.servicenow.com/docs/access?context=r_BasicAuthCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)für die Standardauthentifizierung verwenden. Darüber hinaus muss die Verbindungs-URL die Basis-URL für Ihre Instanz sein, einschließlich des Schrägstrichs am Ende. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter [Erste Schritte mit Verbindungen](https://www.servicenow.com/docs/access?context=connection-information&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) und [Erste Schritte mit Anmeldeinformationen](https://www.servicenow.com/docs/access?context=credentials-getting-started&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). |
| Build-Anforderung | Lassen Sie die Option Manuell ausgewählt |
| Ressourcenpfad | Geben Sie api/now/doc/table/schema ein |
| HTTP-Methode | Geben Sie GET ein |
[ ]
{#create-data-gathering-action-to-get-table-names__table_pvd_ftf_mjb}
6. Wählen Sie in der Aktionsgliederung unter Ihrem REST-Schritt das Symbol „ ![Neuen Schritt hinzufügen“ (Symbol „Neuer Schritt]()" ) und anschließend den Schritt Skript.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Geben Sie im Feld Namepayloadein.
3. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ![Datenpillenauswahl]()) aus, und wählen Sie REST-SchrittAntworttext.
4. Geben Sie in das Feld Skript den folgenden Code ein.
(function execute(inputs, outputs) {
var payload = JSON.parse(inputs.payload);
var tables = payload.result // Get the value of the result array
.filter(function(table) { return table.value.indexOf('_') < 0; }) // Filter the tables we want
.map(function(table) {
return { label: table.label, name: table.value }; // Set values for label and name
});
outputs.tables = { data: tables }; // Final, properly formatted output
})(inputs, outputs);
Die REST-API gibt eine JSON-formatierte Zeichenfolge zurück, die jede Tabelle mit den Eigenschaften „image", „reference", „rawLabel", „selected", „missing", „verwendet" und „value" beschreibt. Die Eigenschaften „label" und „value" stellen die Werte bereit, die von für eine dynamische Auswahl benötigt werden. Bei einer dynamischen Auswahl muss jede Auswahloption eine Bezeichnung und einen Namen haben. Dieses Skript ordnet die Werteigenschaft einer Namenseigenschaft zu.
5. Wählen Sie im Abschnitt „Ausgabevariablen" Variable erstellen.
6. Geben Sie in den Feldern Bezeichnung und NameTabellenein.
7. Wählen Sie im Feld Typ die Option JSONaus.
{#create-data-gathering-action-to-get-table-names__substeps_ytx_lwf_mjb}
7. Wählen Sie in der Aktionsgliederung die Option Ausgabenaus.
1. Wählen Sie Ausgabe erstellen aus.
2. Geben Sie in den Feldern Bezeichnung und Name die Ausgabeein.
3. Wählen Sie im Feld Typ die Option JSONaus.
4. Wählen Sie Bearbeitungsmodus beenden aus.
5. Wählen Sie neben dem Wertdie Datenpillenauswahl ( ![Datenpillenauswahl]()) aus, und wählen Sie SkriptschrittTabellen.
{#create-data-gathering-action-to-get-table-names__substeps_mqx_swj_kxb}
8. Wählen Sie im Header Aktion Speichern und dann Testen aus, [um die Aktion zu testen](https://servicenow-prod.fluidtopics.net/IwFgwpLrQRWMsGiMe8ymdg "Testen Sie eine Aktion, bevor Sie sie für andere Anwender veröffentlichen.").
1. Wählen Sie Test ausführen.
2. Zeigen Sie die Ausführungsdetails der Aktion an.
Ihre Datensammlungsaktion wird erfolgreich ausgeführt, wenn der Laufzeitwert für `Tabellen` ein komplexes Objekt ist, das ein Array von Schlüssel-Wert-Paaren für `Bezeichnung` und `Name` enthält (siehe folgendes abgekürztes Beispiel).
{
"data": [
{
"name": "evaluation",
"label": "A/B Testing Evaluation"
},
{
"name": "sla",
"label": "Agreement"
},
{
"name": "announcement",
"label": "Announcement"
},
{
"name": "cmdb",
"label": "Base Configuration Item"
},
{
"name": "checklist",
"label": "Checklist"
},
{
"name": "collaborator",
"label": "Collaborator"
},
{
"name": "conflict",
"label": "Conflict"
},
{
"name": "clone",
"label": "Database Clone"
},
{
"name": "dsl",
"label": "DML"
},
{
"name": "global",
"label": "Global"
},
{
"name": "goal",
"label": "Goal"
},
{
"name": "incident",
"label": "Incident"
},
{
"name": "interaction",
"label": "Interaction"
},
{
"name": "map",
"label": "Map"
},
{
"name": "ola",
"label": "OLA"
},
{
"name": "problem",
"label": "Problem"
},
{
"name": "question",
"label": "Question"
},
{
"name": "reminder",
"label": "Reminder"
},
{
"name": "instance",
"label": "ServiceNow Instance"
},
{
"name": "label",
"label": "Tag"
},
{
"name": "task",
"label": "Task"
},
{
"name": "taxonomy",
"label": "Taxonomy"
},
{
"name": "ticket",
"label": "Ticket"
},
{
"name": "topic",
"label": "Topic"
},
{
"name": "expert",
"label": "Wizard"
}
]
}
{#create-data-gathering-action-to-get-table-names__substeps_nqx_swj_kxb}
9. Wählen Sie im Header Aktion Veröffentlichen aus, um diese Aktion für andere Flows und Aktionen im Bereich Global verfügbar zu machen.
{#create-data-gathering-action-to-get-table-names__steps_bfz_nlf_mjb}
## Erstellen Sie eine Datensammlungsaktion, um Feldnamen abzurufen {#ariaid-title4}
Erstellen Sie eine Datensammlungsaktion, um eine Liste der Felder aus einer Tabelle abzurufen.
### Vorbereitungen
Erforderliche Rolle: action_designer oder admin
### Warum und wann dieser Vorgang ausgeführt wird
Diese Datensammlungsaktion besteht aus den folgenden Elementen.
* Ein REST-Schritt zum Erfassen von Feldern aus dem REST [Table API](https://www.servicenow.com/docs/access?context=c_TableAPI&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US)
* Ein Skriptschritt zum Erstellen einer JSON-Nutzlast aus dem Antworttext des REST-Schritts
* Eine Aktionsausgabevariable mit dem Namen „ output " speichert Feldname-Wert-Paare als JSON-Dokument
{#create-data-gathering-action-to-get-field-names__ul_lrx_byj_kxb}
Diese anwenderdefinierte Aktion verwendet einen REST-API-Aufruf, um die Funktionalität des ServiceNow Kerns [Aktion „Datensatz suchen"](https://servicenow-prod.fluidtopics.net/sT5esKE9dL1WYcgoQjTEBg "Suchen Sie einen Datensatz aus einer beliebigen Tabelle anhand definierter Bedingungen.") und des [Aktion „Datensätze suchen"](https://servicenow-prod.fluidtopics.net/L6NY2loyXcZk80KjNL69Bw "Suchen Sie mehrere Datensätze in einer beliebigen Tabelle unter definierten Bedingungen.")zu duplizieren. Normalerweise müssen Sie keine anwenderdefinierten Aktionen erstellen, um grundlegende Datensatzvorgänge auszuführen. Diese Aktion veranschaulicht die Arbeit mit den REST- und Skriptschritten zum Sammeln von Felddaten für dynamische Eingaben.
### Prozedur
1. Navigieren zu AlleProzessautomatisierungWorkflow-Studio.
2. Wählen Sie auf der Homepage Aktionen.
3. Auswahlvorgang Neu erstellenAktion.
1. Geben Sie auf dem Bildschirm mit den Aktionseigenschaften im Feld Aktionsname Datensammlungsaktion für Felder ein.
2. Wählen Sie für Anwendungdie Option Global aus.
3. Wählen Sie Absenden.
{#create-data-gathering-action-to-get-field-names__substeps_fw2_tzz_3xb}
4. Wählen Sie in der Aktionsgliederung die Option Eingabenaus.
1. Wählen Sie im Header „Aktionseingabe" Eingabe erstellenaus.
2. Geben Sie in den Feldern Bezeichnung und NameTabelleein.
3. Wählen Sie im Feld Type die Option Zeichenfolge aus.
4. Aktivieren Sie den Schieberegler auf dem Obligatorisch.
5. Wählen Sie das Symbol Erweiterte Eingaben ein/aus, um die erweiterten Eingaben anzuzeigen.
6. Geben Sie für Standardwert den Wertincidentein.
{#create-data-gathering-action-to-get-field-names__substeps_gl2_dyf_mjb}
5. Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol „ ![Neuen Schritt hinzufügen“ (Symbol „Neuer Schritt]()" ).
6. Wählen Sie im Abschnitt Integrationen den Schritt Skript aus, und geben Sie diese Feldwerte ein.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Im Feld Name geben Sie tableein.
3. Wählen Sie neben dem Wertdie Datenpillenauswahl ( ![Datenpillenauswahl]()) aus, und wählen Sie AktionTabelle.
4. Geben Sie in das Feld Skript den folgenden Code ein.
(function execute(inputs, outputs) {
if(!inputs.table || inputs.table === "-- None --") { // check for empty or no table
outputs.table = "incident"; // set default table to incident
} else {
outputs.table = inputs.table; // use input value provided
}
})(inputs, outputs);
Dieses Skript stellt sicher, dass der REST-Schritt immer einen Tabellennamen hat.
5. Wählen Sie im Abschnitt „Ausgabevariablen" Variable erstellen.
6. Geben Sie in den Feldern Bezeichnung und Name die Tabelleein.
7. Wählen Sie im Feld Type die Option Zeichenfolge aus.
{#create-data-gathering-action-to-get-field-names__substeps_etm_cvc_rxb}
7. Wählen Sie in der Aktionsgliederung im Abschnitt „Eingaben" das Symbol „Neuen Schritt hinzufügen" (Symbol „ ![Neuer Schritt]()" ).
8. Wählen Sie im Abschnitt Integrationen den REST -Schritt aus, und geben Sie diese Feldwerte ein.
{#create-data-gathering-action-to-get-field-names__table_gym_n5f_mjb__entry__2}
| Eingabe | Wert |
|-|-|
| Verbindung | Lassen Sie Verbindungsalias verwenden ausgewählt. |
| Verbindungsalias | Wählen Sie den Alias aus, den Sie zuvor erstellt haben, oder wählen Sie das Symbol zum Erstellen eines ![neuen Datensatzes (Symbol]()zum Erstellen eines neuen Datensatzes ) zum [Erstellen einer HTTP(s)-Verbindung](https://www.servicenow.com/docs/access?context=create-https-connection&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Hinweis: Die Anmeldeinformationen für die HTTP(s)-Verbindung müssen [Anmeldeinformationen](https://www.servicenow.com/docs/access?context=r_BasicAuthCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)für die Standardauthentifizierung verwenden. Darüber hinaus muss die Verbindungs-URL die Basis-URL für Ihre Instanz sein, einschließlich des Schrägstrichs am Ende. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter [Erste Schritte mit Verbindungen](https://www.servicenow.com/docs/access?context=connection-information&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) und [Erste Schritte mit Anmeldeinformationen](https://www.servicenow.com/docs/access?context=credentials-getting-started&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). |
| Build-Anforderung | Manuell verlassen ist ausgewählt. |
| Ressourcenpfad | Geben Sie api/now/table/ ein, und wählen Sie dann die Datenpillenauswahl ( ![Datenpillenauswahl]()). Auswahlvorgang SkriptschrittTabelle. |
| HTTP-Methode | Geben Sie GET ein |
| Abfrageparameter | Fügen Sie diesen Abfrageparameter hinzu, damit die REST API nur einen Datensatz zurückgibt. * Name: sysparm_limit * Wert: 1 {#create-data-gathering-action-to-get-field-names__ul_iqr_hlf_lxb} |
[ ]
{#create-data-gathering-action-to-get-field-names__table_gym_n5f_mjb}
9. Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol „ ![Neuen Schritt hinzufügen“ (Symbol „Neuer Schritt]()" ).
10. Wählen Sie im Abschnitt Integrationen den Schritt Skript aus, und geben Sie diese Feldwerte ein.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Geben Sie im Feld Namepayloadein.
3. Wählen Sie neben dem Wertdie Datenpillenauswahl ( ![Datenpillenauswahl]()) aus, und wählen Sie REST-SchrittAntworttext.
4. Geben Sie in das Feld Skript den folgenden Code ein.
(function execute(inputs, outputs) {
var payload = JSON.parse(inputs.payload);
var fields = Object.keys(payload.result[0]) // Get first record of array
.map(function(property) {
return {
label: property.charAt(0).toUpperCase() + property.slice(1).replace(/_/g, ' '), // Create label from field name
name: property, // Set name to field name
value: '' // Set value to empty so that dynamic template can set value
};
});
outputs.fields = { data: fields }; // final properly formatted output
})(inputs, outputs);
Die REST API gibt eine JSON-formatierte Zeichenfolge zurück, die jedes Feld als einen Satz von Name-Wert-Paaren beschreibt, wobei der Name der Feldname und der Wert der Feldwert ist. Eine dynamische Vorlage benötigt nur den Feldnamen und die Bezeichnung. Der Feldwert muss leer sein, damit er durch den Vorlagenwert festgelegt werden kann. Die Bezeichnungseigenschaft wird aus dem Feldnamen berechnet, indem der erste Buchstabe großgeschrieben und Unterstriche durch Leerzeichen ersetzt werden.
5. Wählen Sie im Abschnitt „Ausgabevariablen" Variable erstellen.
6. Geben Sie in den Feldern Bezeichnung und Namedie Felder ein.
7. Wählen Sie im Feld Typ die Option JSONaus.
{#create-data-gathering-action-to-get-field-names__substeps_uhc_fzf_mjb}
11. Wählen Sie in der Aktionsgliederung die Option Ausgabenaus.
1. Wählen Sie im Header „Aktionsausgabe" Ausgabe erstellenaus.
2. Geben Sie in den Feldern Bezeichnung und Name die Ausgabeein.
3. Wählen Sie im Feld Typ die Option JSONaus.
4. Wählen Sie Bearbeitungsmodus beenden aus.
5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ![Datenpillenauswahl]()) und dann SkriptschrittFelder.
{#create-data-gathering-action-to-get-field-names__substeps_ymc_lzf_mjb}
12. Wählen Sie im Header Aktion Speichern und dann Testen aus, [um die Aktion zu testen](https://servicenow-prod.fluidtopics.net/IwFgwpLrQRWMsGiMe8ymdg "Testen Sie eine Aktion, bevor Sie sie für andere Anwender veröffentlichen.").
1. Geben Sie im Bildschirm Testaktion im Feld Tabelle den Wert incidentein.
2. Wählen Sie Test ausführen.
3. Zeigen Sie die Ausführungsdetails der Aktion an.
Ihre Datensammlungsaktion wird erfolgreich ausgeführt, wenn der Laufzeitwert für die Ausgabe ein komplexes Objekt ist, das ein Array von Schlüssel-Wert-Paaren für `Bezeichnung`, `Name`und `Wert` enthält, wie im folgenden abgekürzten Beispiel gezeigt.
{
"data": [
{
"name": "parent",
"label": "Parent",
"value": ""
},
{
"name": "made_sla",
"label": "Made sla",
"value": ""
},
{
"name": "caused_by",
"label": "Caused by",
"value": ""
},
{
"name": "watch_list",
"label": "Watch list",
"value": ""
},
{
"name": "upon_reject",
"label": "Upon reject",
"value": ""
},
{
"name": "sys_updated_on",
"label": "Sys updated on",
"value": ""
},
{
"name": "...",
"label": "...",
"value": ""
},
{
"name": "category",
"label": "Category",
"value": ""
}
]
}
{#create-data-gathering-action-to-get-field-names__substeps_j24_hd4_tkb}
13. Klicken Sie im Header Aktion auf Veröffentlichen, um diese Aktion für andere Aktionen im globalen Bereich verfügbar zu machen.
{#create-data-gathering-action-to-get-field-names__steps_ujm_c4k_kxb}
## Erstellen Sie eine Datensammlungsaktion, um dynamische Eingaben hinzuzufügen {#ariaid-title5}
Erstellen Sie eine Datensammlungsaktion, um eine dynamische Eingabe des Referenztyps hinzuzufügen.
### Vorbereitungen
Erforderliche Rolle: action_designer oder admin
### Warum und wann dieser Vorgang ausgeführt wird
Diese Datensammlungsaktion enthält die folgenden Elemente.
* Eine Aktionseingabevariable zum Speichern eines Tabellennamens
* Ein Skriptschritt zum Erstellen zweier dynamischer Eingaben als JSON-Objekt
* Eine Aktionsausgabevariable mit dem Namen „ output " zum Speichern der dynamischen Eingaben
{#create-data-gathering-action-to-add-dynamic-inputs__ul_lrx_byj_kxb}
Diese anwenderdefinierte Aktion verwendet eine Referenztypeingabe, um die Funktionalität des ServiceNow Kerns [Aktion „Datensatz suchen"](https://servicenow-prod.fluidtopics.net/sT5esKE9dL1WYcgoQjTEBg "Suchen Sie einen Datensatz aus einer beliebigen Tabelle anhand definierter Bedingungen.") und des [Aktion „Datensätze suchen"](https://servicenow-prod.fluidtopics.net/L6NY2loyXcZk80KjNL69Bw "Suchen Sie mehrere Datensätze in einer beliebigen Tabelle unter definierten Bedingungen.")zu duplizieren. Im Allgemeinen müssen Sie keine anwenderdefinierten Aktionen erstellen, um grundlegende Datensatzvorgänge auszuführen. Diese Aktion veranschaulicht die Arbeit mit den Skriptschritten zum Sammeln von Felddaten für dynamische Eingaben.
### Prozedur
1. Navigieren zu AlleProzessautomatisierungWorkflow-Studio.
2. Wählen Sie auf der Homepage Aktionen.
3. Auswahlvorgang Neu erstellenAktion.
1. Geben Sie auf dem Bildschirm mit den Aktionseigenschaften im Feld Aktionsname Datensammlungsaktion für dynamische Eingabenein.
2. Wählen Sie für Anwendungdie Option Global aus.
3. Wählen Sie Absenden.
{#create-data-gathering-action-to-add-dynamic-inputs__substeps_fw2_tzz_3xb}
4. Wählen Sie in der Aktionsgliederung die Option Eingabenaus.
1. Wählen Sie im Header „Aktionseingabe" Eingabe erstellenaus.
2. Geben Sie in den Feldern Bezeichnung und NameTabelleein.
3. Wählen Sie im Feld Type die Option Zeichenfolge aus.
4. Wählen Sie das Symbol „Erweiterte Eingaben ein/aus" (Symbol „ ![Erweiterte Eingabe ein]()/aus" ).
5. Im Feld Standardwert geben Sie sys_userein.
{#create-data-gathering-action-to-add-dynamic-inputs__substeps_gl2_dyf_mjb}
5. Wählen Sie in der Aktionsgliederung unter „Eingaben" das Symbol „Neuen Schritt hinzufügen" (Symbol „ ![Neuer Schritt]()" ).
6. Wählen Sie im Abschnitt Integrationen den Schritt Skript aus, und geben Sie diese Feldwerte ein.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Im Feld Name geben Sie tableein.
3. Wählen Sie neben dem Wertdie Datenpillenauswahl ( ![Datenpillenauswahl]()) aus, und wählen Sie EingabenTabelle.
4. Geben Sie in das Feld Skript den folgenden Code ein.
(function execute(inputs, outputs) {
// Define JSON for desired dynamic input type
outputs.data = {
data: [{
label: 'Reference type input',
name: 'referencetype',
reference: inputs.table,
type: 'reference',
}]
}
})(inputs, outputs);
Jeder Typ von dynamischer Eingabe hat eine eigene JSON-Struktur. Eine dynamische Referenzfeldeingabe benötigt diese Eigenschaften.
label
: Der Text, der neben der Eingabe angezeigt werden soll. Beispiel: Referenzfeldeingabe.
name
: Der interne Name der dynamischen Eingabe, der zum Identifizieren und Speichern von Werten verwendet wird. Beispiel: Referenztyp.
Referenz
: Der Zieltabellenname des Referenzfelds. Beispiel: sys_user. In diesem Skript ist der Tabellenname eine Variable.
type
: Der Datentyp der dynamischen Eingabe. Beispiel: Referenz. Die Typeigenschaft bestimmt, wie Workflow-Studio die Eingabe anzeigt und welche anderen Eigenschaften zum Konfigurieren der Eingabe erforderlich sind.
5. Wählen Sie im Abschnitt „Ausgabevariablen" Variable erstellen.
6. Geben Sie in den Feldern Bezeichnung und NameDatenein.
7. Wählen Sie im Feld Typ die Option JSONaus.
{#create-data-gathering-action-to-add-dynamic-inputs__substeps_uhc_fzf_mjb}
7. Wählen Sie in der Aktionsgliederung die Option Ausgabenaus.
1. Wählen Sie im Header „Aktionsausgabe" Ausgabe erstellenaus.
2. Geben Sie in den Feldern Bezeichnung und Name die Ausgabeein.
3. Wählen Sie im Feld Typ die Option JSONaus.
4. Wählen Sie Bearbeitungsmodus beenden aus.
5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ![Datenpillenauswahl]()) und dann SkriptschrittDaten.
{#create-data-gathering-action-to-add-dynamic-inputs__substeps_ymc_lzf_mjb}
8. Wählen Sie im Header Aktion Speichern und dann Testen aus, [um die Aktion zu testen](https://servicenow-prod.fluidtopics.net/IwFgwpLrQRWMsGiMe8ymdg "Testen Sie eine Aktion, bevor Sie sie für andere Anwender veröffentlichen.").
1. Wählen Sie Test ausführen.
2. Zeigen Sie die Ausführungsdetails der Aktion an.
Wenn Ihre Datensammlungsaktion erfolgreich ausgeführt wird, ist der Laufzeitwert für die Ausgabe eine JSON-Zeichenfolge (siehe folgendes Beispiel).
{
"data": [
{
"reference": "sys_user",
"name": "referencetype",
"label": "Reference type input",
"type": "reference"
}
]
}
{#create-data-gathering-action-to-add-dynamic-inputs__substeps_j24_hd4_tkb}
9. Wählen Sie im Header Aktion Veröffentlichen aus, um diese Aktion für andere Aktionen im globalen Bereich verfügbar zu machen.
## Erstellen Sie eine anwenderdefinierte Aktion zum Testen dynamischer Eingaben {#ariaid-title6}
Erstellen Sie eine anwenderdefinierte Aktion zum Testen dynamischer Eingaben.
### Vorbereitungen
Erforderliche Rolle: action_designer oder admin
### Warum und wann dieser Vorgang ausgeführt wird
Diese Hilfsaktion dupliziert die Funktionalität von [Schritt „Datensatz erstellen"](https://servicenow-prod.fluidtopics.net/qWV~__7AWjOX1qVv3CAVZg "Erstellt einen Datensatz in einer beliebigen Tabelle. Sie können dynamisch Felder für den Datensatz hinzufügen und konfigurieren."), um das Sammeln von Daten aus einem REST-Schritt zu veranschaulichen. Im Allgemeinen verwenden Sie dynamische Eingaben für Integrationen mit Drittparteisystemen und -daten.
Diese anwenderdefinierte Aktion enthält die folgenden Elemente.
* Eine Eingabe vom Typ „Dynamische Auswahl" zum Auswählen einer Tabelle
* Eine Eingabe vom Typ „Dynamische Vorlage" zum Auswählen und Festlegen von Feldwerten
* Ein Skriptschritt zum Erstellen eines Datensatzes aus dem [GlideRecord - Global](https://www.servicenow.com/docs/access?context=c_GlideRecordAPI&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US)
* Eine Aktionsausgabevariable mit dem Namen „ output " zur Speicherung der sys_id des erstellten Datensatzes
{#get-started-dynamic-input-create-record-action__ul_lrx_byj_kxb}
### Prozedur
1. Navigieren zu AlleProzessautomatisierungWorkflow-Studio.
2. Wählen Sie auf der Homepage Aktionen.
3. Auswahlvorgang Neu erstellenAktion.
1. Geben Sie auf dem Bildschirm mit den Aktionseigenschaften im Feld Aktionsname Datensatz aus dynamischen Eingaben erstellenein.
2. Wählen Sie für Anwendungdie Option Global aus.
3. Wählen Sie Absenden.
{#get-started-dynamic-input-create-record-action__substeps_fw2_tzz_3xb}
4. Wählen Sie in der Aktionsgliederung die Option Eingabenaus.
1. Wählen Sie Eingabe erstellen aus.
2. Geben Sie in den Feldern Bezeichnung und NameTabelleein.
3. Wählen Sie im Feld Typ die Option Dynamische Auswahlaus.
4. Aktivieren Sie den Umschalter Obligatorisch.
5. Geben Sie unter Standardwert den Wertincidentein.
6. Akzeptieren Sie den Standardwert für Auswahl.
7. Wählen Sie unter Dynamische Optionen für das Feld Aktion die Option Datensammlungsaktion für Tabellen aus.
8. Wählen Sie Eingabe erstellen aus, um eine weitere Aktionseingabe zu erstellen.
9. Geben Sie in den Feldern Bezeichnung und NameFelder ein.
10. Wählen Sie im Feld Typ die Option Dynamische Vorlageaus.
11. Aktivieren Sie den Umschalter Obligatorisch.
12. Wählen Sie unter Dynamische Optionen im Feld Aktion die Option Datensammlungsaktion für Felder aus.
13. Aktivieren Sie neben dem Feld Tabelle den Umschalter Abhängig von einer anderen Eingabe.
14. Wählen Sie im Feld Tabelle die Eingabe Tabelle aus.
15. Wählen Sie Eingabe erstellen aus, um eine weitere Aktionseingabe zu erstellen.
16. Geben Sie in den Feldern Bezeichnung und NameDynamische Eingabeein.
17. Wählen Sie im Feld Typ die Option Dynamische Eingabenaus.
18. Wählen Sie unter Dynamische Optionen im Feld Aktion die Option Datensammlungsaktion für dynamische Eingaben aus.
19. Lassen Sie das Feld Tabelle leer, um den Standardwert sys_user zu verwenden, der von der Datensammlungsaktion bereitgestellt wurde.
{#get-started-dynamic-input-create-record-action__substeps_mdf_mbg_mjb}
5. Wählen Sie in der Aktionsgliederung im Abschnitt „Eingaben" das Symbol „Neuen Schritt hinzufügen" (Symbol „ ![Neuer Schritt]()" ).
6. Wählen Sie im Abschnitt Integrationen den Schritt Skript aus, und geben Sie diese Feldwerte ein.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Im Feld Name geben Sie tableein.
3. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ![Datenpillenauswahl]()) aus, und wählen Sie EingabenTabelle.
4. Wählen Sie Variable erstellen aus, um eine weitere Eingabevariable zu erstellen.
5. Geben Sie im Feld Name die Felderein.
6. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ![Datenpillenauswahl]()) aus, und wählen Sie EingabenFelder.
7. Wählen Sie Variable erstellen aus, um eine weitere Eingabevariable zu erstellen.
8. Geben Sie im Feld Namepayloadein.
9. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ![Datenpillenauswahl]()) aus, und wählen Sie EingabenDynamische Eingabe.
10. Geben Sie in das Feld Skript den folgenden Code ein.
(function execute(inputs, outputs) {
var payload = inputs.payload.referencetype; // match name from data gathering action
var obj = JSON.parse(payload);
var user = obj.value;
var gr = new GlideRecord(inputs.table); // dynamic choice input
gr.applyEncodedQuery(inputs.fields); // dynamic template input
gr.applyEncodedQuery("caller_id=" + user); // dynamic inputs reference field
gr.insert();
outputs.record = gr;
})(inputs, outputs);
11. Wählen Sie im Abschnitt „Ausgabevariablen" Variable erstellen.
12. Geben Sie in den Feldern Bezeichnung und Name den Datensatzein.
13. Wählen Sie im Feld Typ die Option Dokument-IDaus.
{#get-started-dynamic-input-create-record-action__substeps_ghf_5bg_mjb}
7. Wählen Sie in der Aktionsgliederung die Option Ausgabenaus.
1. Wählen Sie im Header „Aktionsausgabe" Ausgabe erstellenaus.
2. Geben Sie in den Feldern Bezeichnung und NameDatensatz erstelltein.
3. Wählen Sie im Feld Typ die Option Dokument-IDaus.
4. Wählen Sie Bearbeitungsmodus beenden aus.
5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ![Datenpillenauswahl]()) und dann Skriptschrittrecord.
{#get-started-dynamic-input-create-record-action__substeps_ymc_lzf_mjb}
8. Wählen Sie im Header Aktion Speichern und dann Testen aus, [um die Aktion zu testen](https://servicenow-prod.fluidtopics.net/IwFgwpLrQRWMsGiMe8ymdg "Testen Sie eine Aktion, bevor Sie sie für andere Anwender veröffentlichen.").
1. Wählen Sie im Bildschirm „Testaktion" in der Eingabe Tabelle eine beliebige dynamisch generierte Tabellenauswahloption aus.
Wählen Sie beispielsweise die Incident-Tabelle aus.
2. Wählen Sie Feldwert hinzufügen, wählen Sie ein beliebiges Feld aus, und geben Sie einen beliebigen Wert ein.
Wählen Sie beispielsweise das Feld Kurzbeschreibung aus, und geben Sie den Wert Test ein.
3. Wählen Sie im Abschnitt Dynamische Eingaben und im Eingabefeld Referenztyp einen Referenzfeldwert aus.
Wählen Sie beispielsweise den Benutzer Abel Tuter aus.
4. Wählen Sie Test ausführen.
Hinweis:
Datensätze, die Sie über die Tabellen-API erstellen, umgehen Datenrichtlinien und Pflichtfelder, die normalerweise mit der Datensatzerstellung zusammenhängen. Diese Aktion dient nur zur Veranschaulichung. Verwenden Sie stattdessen [Schritt „Datensatz erstellen"](https://servicenow-prod.fluidtopics.net/qWV~__7AWjOX1qVv3CAVZg "Erstellt einen Datensatz in einer beliebigen Tabelle. Sie können dynamisch Felder für den Datensatz hinzufügen und konfigurieren."), um Datensätze mit Standardschutzmaßnahmen und -validierungen zu erstellen.
5. Zeigen Sie die Ausführungsdetails der Aktion an.
Sie können die Ausgabe „Datensatz erstellt" verwenden, um zu überprüfen, ob die Laufzeitwerte für `Tabelle` und `Feld` mit den eingegebenen Testwerten übereinstimmen.
{#get-started-dynamic-input-create-record-action__substeps_qn3_qcg_mjb}
9. Wählen Sie im Header Aktion Veröffentlichen aus, um diese Aktion für Flows innerhalb des Bereichs Global verfügbar zu machen.
### Ergebnisse
Sie können diese Aktion einem Flow in Workflow-Studiohinzufügen. Diese Beispielaktion generiert dynamisch eine Liste von Tabellen und zugehörigen Feldern in Ihrer Instanz, deren Werte Sie während des Flow-Designs zuweisen können.