Erste Schritte mit dynamischen Eingaben

Freigeben Version: Yokohama

Aktualisiert 30. Januar 2025

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

Erstellen Sie Anmeldeinformations- und Verbindungsdatensätze für Ihre Instanz.
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.
Erstellen Sie eine Datensammlungsaktion, um Tabellennamen abzurufen.
Diese Datensammlungsaktion stellt JSON-Daten für dynamische Auswahleingaben bereit.
Erstellen Sie eine Datensammlungsaktion, um Feldnamen abzurufen.
Diese Datensammlungsaktion stellt JSON-Daten für dynamische Vorlageneingaben bereit.
Erstellen Sie eine Datensammlungsaktion, um dynamische Eingaben hinzuzufügen.
Diese Datensammlungsaktion stellt JSON-Daten bereit, um beliebige dynamische Eingaben zu erstellen.
Erstellen Sie eine anwenderdefinierte Aktion zum Testen dynamischer Eingaben.
Diese anwenderdefinierte Aktion veranschaulicht verschiedene Arten von dynamischen Eingaben.

Erstellen Sie Anmeldeinformations- und Verbindungsdatensätze für Ihre Instanz

Erstellen Sie die Aliasse, Verbindungen und Anmeldeinformationen, die zum Herstellen einer Verbindung mit Ihrer lokalen Instanz erforderlich sind.

Vorbereitungen

Erforderliche Rolle: Administrator

Prozedur

Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationen.
Wählen Sie Neu, wählen Sie Anmeldeinformationen für Standardauthentifizierungaus, 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.
Wählen Sie Absenden aus, um den Anmeldeinformationsdatensatz zu erstellen.
Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
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.
Wählen Sie den von Ihnen erstellten Alias aus.
Wählen Sie beispielsweise Lokale Instanzaus.
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.

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

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
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

Diese anwenderdefinierte Aktion verwendet einen REST-API-Aufruf, um die Funktionalität des ServiceNow Kerns Aktion „Datensatz suchen“. und Aktion „Datensätze suchen“.des 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

Navigieren zu Alle > Prozessautomatisierung > Workflow-Studio.
Wählen Sie auf der Homepage Aktionen.
Auswahlvorgang Neu erstellen > Aktion.
1. Geben Sie auf dem Bildschirm mit den Aktionseigenschaften im Feld AktionsnameDatensammlungsaktion für Tabellenein.
2. Wählen Sie für Anwendungdie Option Global aus.
3. Wählen Sie Absenden.
Wählen Sie in der Aktionsgliederung im Abschnitt „Eingaben“ das Symbol zum Hinzufügen eines neuen Schritts ( ).

Wählen Sie im Abschnitt Integrationen den REST- Schritt aus, und geben Sie diese Feldwerte ein.


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 ( ) zum Erstellen einer HTTP(s)-Verbindung. Hinweis: Die Anmeldeinformationen für die HTTP(s)-Verbindung müssen Anmeldeinformationen für die Standardauthentifizierungverwenden. 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 und Erste Schritte mit Anmeldeinformationen.
Build-Anforderung	Lassen Sie die Option Manuell ausgewählt
Ressourcenpfad	Geben Sie `api/now/doc/table/schema ein`
HTTP-Methode	Geben Sie `GET ein`

Beispiel für eine REST-Schrittkonfiguration aus den Schritten 3 und 4

Wählen Sie in der Aktionsgliederung unter Ihrem REST-Schritt das Symbol „Neuen Schritt hinzufügen“ ( “ ) und anschließend den Schritt Skript.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellen aus.
2. Geben Sie im Feld Namepayloadein.
3. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ) aus, und wählen Sie REST-Schritt > Antworttext.
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 Typdie Option JSONaus.
Wählen Sie in der Aktionsgliederung die Option Ausgabenaus.
1. Wählen Sie Ausgabe erstellen aus.
2. Geben Sie in den Feldern Bezeichnung und Namedie Ausgabeein.
3. Wählen Sie im Feld Typdie Option JSONaus.
4. Wählen Sie Bearbeitungsmodus beenden aus.
5. Wählen Sie neben dem Wertdie Datenpillenauswahl ( ) aus, und wählen Sie Skriptschritt > Tabellen.

Wählen Sie im Header Aktion Speichern und dann Testen aus, um die Aktion zu testen.

Wählen Sie Test ausführen.

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"
    }
  ]
}

Beispieldetails der Aktionsausführung aus Schritt 7

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.

Erstellen Sie eine Datensammlungsaktion, um Feldnamen abzurufen

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
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

Prozedur

Navigieren zu Alle > Prozessautomatisierung > Workflow-Studio.
Wählen Sie auf der Homepage Aktionen.
Auswahlvorgang Neu erstellen > Aktion.
1. Geben Sie auf dem Bildschirm mit den Aktionseigenschaften im Feld AktionsnameDatensammlungsaktion für Felderein.
2. Wählen Sie für Anwendungdie Option Global aus.
3. Wählen Sie Absenden.
Wählen Sie in der Aktionsgliederung die Option Eingabenaus.
1. Wählen Sie im Header „Aktionseingabe“ Eingabe erstellen aus.
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.
Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol „Neuen Schritt hinzufügen“ ( ).
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 erstellen aus.
2. Im Feld Name geben Sie tableein.
3. Wählen Sie neben dem Wertdie Datenpillenauswahl ( ) aus, und wählen Sie Aktion > Tabelle.
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 Namedie Tabelleein.
7. Wählen Sie im Feld Type die Option Zeichenfolge aus.
Wählen Sie in der Aktionsgliederung im Abschnitt „Eingaben“ das Symbol „Neuen Schritt hinzufügen“ ( ).

Wählen Sie im Abschnitt Integrationen den REST- Schritt aus, und geben Sie diese Feldwerte ein.


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 ( ) zum Erstellen einer HTTP(s)-Verbindung. Hinweis: Die Anmeldeinformationen für die HTTP(s)-Verbindung müssen Anmeldeinformationen für die Standardauthentifizierungverwenden. 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 und Erste Schritte mit Anmeldeinformationen.
Build-Anforderung	Manuell verlassen ist ausgewählt.
Ressourcenpfad	Geben Sie `api/now/table/` ein, und wählen Sie dann die Datenpillenauswahl ( ). Auswahlvorgang Skriptschritt > Tabelle.
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

Beispiel für eine REST-Schrittkonfiguration aus Schritt 7

Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol „Neuen Schritt hinzufügen“ ( ).
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 erstellen aus.
2. Geben Sie im Feld Namepayloadein.
3. Wählen Sie neben dem Wertdie Datenpillenauswahl ( ) aus, und wählen Sie REST-Schritt > Antworttext.
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 Felderein.
7. Wählen Sie im Feld Typdie Option JSONaus.
Wählen Sie in der Aktionsgliederung die Option Ausgabenaus.
1. Wählen Sie im Header „Aktionsausgabe“ Ausgabe erstellen aus.
2. Geben Sie in den Feldern Bezeichnung und Namedie Ausgabeein.
3. Wählen Sie im Feld Typdie Option JSONaus.
4. Wählen Sie Bearbeitungsmodus beenden aus.
5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ) und dann Skriptschritt > Felder.

Wählen Sie im Header Aktion Speichern und dann Testen aus, um die Aktion zu testen.

Geben Sie im Bildschirm Testaktion im Feld Tabelleden Wert incidentein.
Wählen Sie Test ausführen.

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, Nameund 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": ""
      }
    ]
  }

Beispieldetails der Aktionsausführung aus Schritt 9

Klicken Sie im Header Aktion auf Veröffentlichen, um diese Aktion für andere Aktionen im globalen Bereich verfügbar zu machen.

Erstellen Sie eine Datensammlungsaktion, um dynamische Eingaben hinzuzufügen

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

Diese anwenderdefinierte Aktion verwendet eine Referenztypeingabe, um die Funktionalität des ServiceNow Kerns Aktion „Datensatz suchen“. und Aktion „Datensätze suchen“.des 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

Navigieren zu Alle > Prozessautomatisierung > Workflow-Studio.
Wählen Sie auf der Homepage Aktionen.
Auswahlvorgang Neu erstellen > Aktion.
1. Geben Sie auf dem Bildschirm mit den Aktionseigenschaften im Feld AktionsnameDatensammlungsaktion für dynamische Eingabenein.
2. Wählen Sie für Anwendungdie Option Global aus.
3. Wählen Sie Absenden.
Wählen Sie in der Aktionsgliederung die Option Eingabenaus.
1. Wählen Sie im Header „Aktionseingabe“ Eingabe erstellen aus.
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“ ( ).
5. Im Feld Standardwert geben Sie sys_userein.
Wählen Sie in der Aktionsgliederung unter „Eingaben“ das Symbol „Neuen Schritt hinzufügen“ ( ).
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 erstellen aus.
2. Im Feld Name geben Sie tableein.
3. Wählen Sie neben dem Wertdie Datenpillenauswahl ( ) aus, und wählen Sie Eingaben > Tabelle.
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.
  
  Typ
  
  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 Typdie Option JSONaus.
Wählen Sie in der Aktionsgliederung die Option Ausgabenaus.
1. Wählen Sie im Header „Aktionsausgabe“ Ausgabe erstellen aus.
2. Geben Sie in den Feldern Bezeichnung und Namedie Ausgabeein.
3. Wählen Sie im Feld Typdie Option JSONaus.
4. Wählen Sie Bearbeitungsmodus beenden aus.
5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ) und dann Skriptschritt > Daten.
Wählen Sie im Header Aktion Speichern und dann Testen aus, um die Aktion zu testen.
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"
    }
  ]
}
```
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

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“, 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
Eine Aktionsausgabevariable mit dem Namen „ output“ zur Speicherung der sys_id des erstellten Datensatzes

Prozedur

Navigieren zu Alle > Prozessautomatisierung > Workflow-Studio.
Wählen Sie auf der Homepage Aktionen.
Auswahlvorgang Neu erstellen > Aktion.
1. Geben Sie auf dem Bildschirm mit den Aktionseigenschaften im Feld AktionsnameDatensatz aus dynamischen Eingaben erstellenein.
2. Wählen Sie für Anwendungdie Option Global aus.
3. Wählen Sie Absenden.
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 Typdie 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 Aktiondie Option Datensammlungsaktion für Tabellenaus.
8. Wählen Sie Eingabe erstellen aus, um eine weitere Aktionseingabe zu erstellen.
9. Geben Sie in den Feldern Bezeichnung und NameFelderein.
10. Wählen Sie im Feld Typdie Option Dynamische Vorlageaus.
11. Aktivieren Sie den Umschalter Obligatorisch.
12. Wählen Sie unter Dynamische Optionen im Feld Aktiondie Option Datensammlungsaktion für Felderaus.
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 Typdie Option Dynamische Eingabenaus.
18. Wählen Sie unter Dynamische Optionen im Feld Aktiondie Option Datensammlungsaktion für dynamische Eingabenaus.
19. Lassen Sie das Feld Tabelle leer, um den Standardwert sys_user zu verwenden, der von der Datensammlungsaktion bereitgestellt wurde.
Wählen Sie in der Aktionsgliederung im Abschnitt „Eingaben“ das Symbol „Neuen Schritt hinzufügen“ ( ).
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 erstellen aus.
2. Im Feld Name geben Sie tableein.
3. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ) aus, und wählen Sie Eingaben > Tabelle.
4. Wählen Sie Variable erstellen aus, um eine weitere Eingabevariable zu erstellen.
5. Geben Sie im Feld Namedie Felderein.
6. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ) aus, und wählen Sie Eingaben > Felder.
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 ( ) aus, und wählen Sie Eingaben > Dynamische 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 Nameden Datensatzein.
13. Wählen Sie im Feld Typdie Option Dokument-IDaus.
Wählen Sie in der Aktionsgliederung die Option Ausgabenaus.
1. Wählen Sie im Header „Aktionsausgabe“ Ausgabe erstellen aus.
2. Geben Sie in den Feldern Bezeichnung und NameDatensatz erstelltein.
3. Wählen Sie im Feld Typdie Option Dokument-IDaus.
4. Wählen Sie Bearbeitungsmodus beenden aus.
5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ) und dann Skriptschritt > Datensatz.
Wählen Sie im Header Aktion Speichern und dann Testen aus, um die Aktion zu testen.
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“, 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.
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.

Beispiel-Flow mit der Aktion Datensatz aus dynamischen Eingaben erstellen