Beginnen Sie mit dynamischen Eingaben

Freigeben Version: Washingtondc

Aktualisiert 1. Februar 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

Erstellen Sie Anmelde- und Verbindungsdatensätze für Ihre Instanzan.
Dieser Alias für Verbindungen und Anmeldeinformationen stellt die Basis-URL und den Benutzeraccount bereit, die zum Konfigurieren der REST-Schritte Ihrer Datenerfassungsaktionen erforderlich sind.
Erstellen Sie eine Datenerfassungsaktion, um Tabellennamen abzurufenan.
Diese Datenerfassungsaktion stellt JSON-Daten für dynamische Auswahleingaben bereit.
Erstellen Sie eine Datenerfassungsaktion, um Feldnamen abzurufenan.
Diese Datenerfassungsaktion stellt JSON-Daten für dynamische Vorlageneingaben bereit.
Erstellen Sie eine Datenerfassungsaktion, um dynamische Eingaben hinzuzufügenan.
Diese Datenerfassungsaktion stellt JSON-Daten bereit, um beliebige dynamische Eingaben zu erstellen.
Erstellen Sie eine benutzerdefinierte Aktion, um dynamische Eingaben zu testenan.
Diese benutzerdefinierte Aktion veranschaulicht verschiedene Arten von dynamischen Eingaben.

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

Erstellen Sie die Aliasse, Verbindungen und Anmeldeinformationen, die für die Verbindung mit Ihrer lokalen Instanz erforderlich sind.

Vorbereitungen

Erforderliche Rolle: admin

Prozedur

Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Berechtigungen.
Wählen Sie Neu, dann Anmeldeinformationenfür Standardauthentifizierung aus, und geben Sie die folgenden Feldwerte ein.
1. Geben Sie unter NameLokaler Administratorein.
2. Geben Sie für Benutzernameeinen Benutzeraccount mit Zugriff auf Flow Designer und die REST API ein.
  Geben Sie beispielsweise adminein.
3. Geben Sie im Feld Passwortdas Passwort des Accounts 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, und geben Sie die folgenden Feldwerte ein.
1. Geben Sie für NameLokale Instanz ein.
2. Akzeptieren Sie den Standardwert HTTP für den Verbindungstyp.
3. Wählen Sie Absenden aus, um den Datensatz für Aliasse 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“ die Option Neuaus, und geben Sie die folgenden Feldwerte ein.
1. Geben Sie unter NameMy Instanceein.
2. Wählen Sie für Credential (Anmeldeinformationen) den von Ihnen erstellten Anmeldeinformationsdatensatz für die Basic Authentication aus.
  Wählen Sie beispielsweise die Anmeldeinformationen des lokalen Administrators aus.
3. Geben Sie im Feld Verbindungs-URL die Basis-URL für Ihre Instanz ein, einschließlich des Schrägstrichs am Ende.
  Schließen Sie das URL-Präfix https:// ein, und fügen Sie am Ende der URL einen Schrägstrich hinzu.
  
  Beispiel: https://example.service-now.com/.
4. Wählen Sie Absenden aus, um den HTTP(s)-Verbindungsdatensatz zu erstellen.

Ergebnisse

Sie können den Alias „Lokale Instanz“ verwenden, um beim Konfigurieren von REST-Schritten eine Verbindung zu Ihrer lokalen Instanz herzustellen.

Erstellen Sie eine Datenerfassungsaktion, um Tabellennamen abzurufen

Erstellen Sie eine benutzerdefinierte Datenerfassungsaktion, 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 Datenerfassungsaktion besteht aus diesen 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 “, um Tabellenname und Wertepaare als JSON-Dokument zu speichern

Diese benutzerdefinierte Aktion verwendet einen REST-API-Aufruf, um die Funktionalität von ServiceNow Core Aktion „Datensatz suchen“ und Aktion „Datensätze suchen“zu duplizieren. Normalerweise müssen Sie keine benutzerdefinierten 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 > Flow Designer.
Auswahlvorgang Neu erstellen > Aktion.
1. Geben Sie auf dem Bildschirm „Aktionseigenschaften“ im Feld Aktionsname Datensammlungsaktion für Tabellen ein.
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 (Symbol zum ) aus.

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 „ erstellen“ (Symbol „Neuen Datensatz erstellen“ ), um eine HTTP(s)-Verbindung zu erstellen. Hinweis: Die Anmeldeinformationen für die HTTP(s)-Verbindung müssen die Anmeldeinformationen der Basic Authenticationverwenden. 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 die REST-Schrittkonfiguration aus den Schritten 3 und 4

Klicken Sie in der Aktionsgliederung unter Ihrem REST-Schritt auf das Symbol hinzufügen (Symbol für neuen Schritt) und dann auf den Schritt Skript.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Geben Sie im Feld Name den Namen payloadein.
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“, „label“, „missing“, „used“ und „value“ beschreibt. Die Eigenschaften label und value liefern die Werte, die von für eine dynamische Auswahl benötigt werden. Eine dynamische Auswahl erfordert, dass jede Auswahloption eine Bezeichnung und einen Namen hat. Dieses Skript ordnet die Eigenschaft value einer Eigenschaft name zu.
5. Wählen Sie im Abschnitt Ausgabevariablen die Option Variable erstellenaus.
6. Geben Sie in den Feldern Bezeichnung und NameTabellenein.
7. Wählen Sie im Feld Typ die Option JSONaus.
Wählen Sie in der Aktionsgliederung Ausgabenaus.
1. Wählen Sie Ausgabe erstellen.
2. Geben Sie in die Felder Bezeichnung und NameAusgabeein.
3. Wählen Sie im Feld Typ die Option JSONaus.
4. Wählen Sie Bearbeitungsmodus beenden.
5. Wählen Sie neben dem Wertdie Datenpillenauswahl ( ) aus, und wählen Sie Skriptschritt > Tabellen.

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

Wählen Sie Test ausführen.

Zeigen Sie die Ausführungsdetails der Aktion an.

Ihre Datenerfassungsaktion 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, wie im folgenden abgekürzten Beispiel gezeigt.

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

Beispiel für Aktionsausführungsdetails aus Schritt 7

Wählen Sie im Header Aktion die Option Veröffentlichen aus, um diese Aktion für andere Flows und Aktionen im globalen Bereich verfügbar zu machen.

Erstellen Sie eine Datenerfassungsaktion, um Feldnamen abzurufen

Erstellen Sie eine Datenerfassungsaktion, um eine Liste von Feldern aus einer Tabelle abzurufen.

Vorbereitungen

Erforderliche Rolle: action_designer oder admin

Warum und wann dieser Vorgang ausgeführt wird

Diese Datenerfassungsaktion besteht aus diesen Elementen.

Ein REST-Schritt zum Sammeln 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 “, um Feldname und Wertpaare als JSON-Dokument zu speichern

Prozedur

Navigieren zu Alle > Prozessautomatisierung > Flow Designer.
Auswahlvorgang Neu erstellen > Aktion.
1. Geben Sie auf dem Bildschirm „Aktionseigenschaften“ im Feld Aktionsname Datensammlungsaktion für Felder ein.
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“ die Option Eingabe erstellenaus.
2. Geben Sie in die Felder Bezeichnung und NameTabelleein.
3. Wählen Sie im Feld Type die Option Zeichenfolge aus.
4. Schalten Sie den Schieberegler auf „ Obligatorisch “ um.
5. Klicken Sie auf das Symbol Erweiterte Eingaben umschalten, um die erweiterten Eingaben anzuzeigen.
6. Geben Sie für Standardwertincidentein.
Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol „ “ ) aus.
Wählen Sie im Abschnitt „ Integrationen “ den Skriptschritt aus, und geben Sie die folgenden Feldwerte ein.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Geben Sie im Feld Name den Namen 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 die Option Variable erstellenaus.
6. Geben Sie in die Felder Bezeichnung und NameTabelleein.
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“ (Symbol „ “ ) aus.

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 „ erstellen“ (Symbol „Neuen Datensatz erstellen“ ), um eine HTTP(s)-Verbindung zu erstellen. Hinweis: Die Anmeldeinformationen für die HTTP(s)-Verbindung müssen die Anmeldeinformationen der Basic Authenticationverwenden. 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/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-REST-Schrittkonfiguration aus Schritt 7

Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol „ “ ) aus.
Wählen Sie im Abschnitt „ Integrationen “ den Skriptschritt aus, und geben Sie die folgenden Feldwerte ein.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Geben Sie im Feld Name den Namen payloadein.
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 Satz von Name-Wert-Paaren beschreibt, wobei Name der Feldname und Wert der Feldwert ist. Eine dynamische Vorlage benötigt nur den Feldnamen und die Bezeichnung. Der Feldwert muss leer sein, damit er vom 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 die Option Variable erstellenaus.
6. Geben Sie in den Feldern Bezeichnung und NameFelder ein.
7. Wählen Sie im Feld Typ die Option JSONaus.
Wählen Sie in der Aktionsgliederung Ausgabenaus.
1. Wählen Sie im Header der Aktionsausgabe die Option Ausgabe erstellenaus.
2. Geben Sie in die Felder Bezeichnung und NameAusgabeein.
3. Wählen Sie im Feld Typ die Option JSONaus.
4. Wählen Sie Bearbeitungsmodus beenden.
5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ) und dann Skriptschritt > Felder.

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

Geben Sie im Bildschirm „Testaktion“ im Feld Tabelle den Wert incidentein.
Wählen Sie Test ausführen.

Zeigen Sie die Ausführungsdetails der Aktion an.

Ihre Datenerfassungsaktion 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": ""
      }
    ]
  }

Beispiel für Aktionsausführungsdetails 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 Datenerfassungsaktion, um dynamische Eingaben hinzuzufügen

Erstellen Sie eine Datenerfassungsaktion, um eine dynamische Referenztyp-Eingabe hinzuzufügen.

Vorbereitungen

Erforderliche Rolle: action_designer oder admin

Warum und wann dieser Vorgang ausgeführt wird

Diese Datenerfassungsaktion 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 “, um die dynamischen Eingaben zu speichern

Diese benutzerdefinierte Aktion verwendet eine Referenztyp-Eingabe, um die Funktionalität von ServiceNow Core Aktion „Datensatz suchen“ und Aktion „Datensätze suchen“zu duplizieren. Im Allgemeinen müssen Sie keine benutzerdefinierten 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 > Flow Designer.
Auswahlvorgang Neu erstellen > Aktion.
1. Geben Sie auf dem Bildschirm „Aktionseigenschaften“ im Feld Aktionsname Datensammlungsaktion 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“ die Option Eingabe erstellenaus.
2. Geben Sie in die Felder Bezeichnung und NameTabelleein.
3. Wählen Sie im Feld Type die Option Zeichenfolge aus.
4. Wählen Sie das Symbol „Erweiterte Eingaben umschalten“ (Symbol „ “ ) aus.
5. Geben Sie im Feld Standardwertsys_userein.
Wählen Sie in der Aktionsgliederung unter „Eingaben“ das Symbol „Neuen Schritt hinzufügen“ (Symbol „ “ ) aus.
Wählen Sie im Abschnitt „ Integrationen “ den Skriptschritt aus, und geben Sie die folgenden Feldwerte ein.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Geben Sie im Feld Name den Namen 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);
```
  Jede Art 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 zu ihrer Identifizierung und zum 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 Eigenschaft type bestimmt, wie Flow Designer die Eingabe anzeigt und welche anderen Eigenschaften zur Konfiguration erforderlich sind.
5. Wählen Sie im Abschnitt Ausgabevariablen die Option Variable erstellenaus.
6. Geben Sie in die Felder Bezeichnung und NameDatenein.
7. Wählen Sie im Feld Typ die Option JSONaus.
Wählen Sie in der Aktionsgliederung Ausgabenaus.
1. Wählen Sie im Header der Aktionsausgabe die Option Ausgabe erstellenaus.
2. Geben Sie in die Felder Bezeichnung und NameAusgabeein.
3. Wählen Sie im Feld Typ die Option JSONaus.
4. Wählen Sie Bearbeitungsmodus beenden.
5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ) und dann Skriptschritt > Daten.
Wählen Sie im Header Aktion Speichern und dann Test aus, um die Aktion zu testen.
1. Wählen Sie Test ausführen.
2. Zeigen Sie die Ausführungsdetails der Aktion an.
  Wenn Ihre Datenerfassungsaktion erfolgreich ausgeführt wird, ist der Laufzeitwert für die Ausgabe eine JSON-Zeichenfolge, wie im folgenden Beispiel gezeigt.
```
{
  "data": [
    {
      "reference": "sys_user",
      "name": "referencetype",
      "label": "Reference type input",
      "type": "reference"
    }
  ]
}
```
Wählen Sie im Header Aktion die Option Veröffentlichen aus, um diese Aktion für andere Aktionen im globalen Bereich verfügbar zu machen.

Erstellen Sie eine benutzerdefinierte Aktion, um dynamische Eingaben zu testen

Erstellen Sie eine benutzerdefinierte Aktion, um dynamische Eingaben zu testen.

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 in Systeme und Daten von Drittanbietern.

Diese benutzerdefinierte 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 “, um die sys_id des erstellten Datensatzes zu speichern

Prozedur

Navigieren zu Alle > Prozessautomatisierung > Flow Designer.
Auswahlvorgang Neu erstellen > Aktion.
1. Geben Sie im Bildschirm „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.
2. Geben Sie in die Felder Bezeichnung und NameTabelleein.
3. Wählen Sie im Feld Typ die Option Dynamische Auswahlaus.
4. Aktivieren Sie den Umschalter Obligatorisch.
5. Geben Sie in das Feld StandardwertIncidentein.
6. Akzeptieren Sie den Standardwert für Auswahl.
7. Wählen Sie unter Dynamische Optionen für das Feld Aktion die Option Datenerfassungsaktion für Tabellen aus.
8. Wählen Sie Eingabe erstellen aus, um eine weitere Aktionseingabe zu erstellen.
9. Geben Sie in die Felder 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 Datenerfassungsaktion 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 die Felder 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 Datenerfassungsaktion für dynamische Eingaben aus.
19. Lassen Sie das Feld Tabelle leer, um den Standardwert sys_user zu verwenden, der von der Datenerfassungsaktion bereitgestellt wird.
Wählen Sie in der Aktionsgliederung im Abschnitt „Eingaben“ das Symbol „Neuen Schritt hinzufügen“ (Symbol „ “ ) aus.
Wählen Sie im Abschnitt „ Integrationen “ den Skriptschritt aus, und geben Sie die folgenden Feldwerte ein.
1. Wählen Sie im Abschnitt Eingabevariablen die Option Variable erstellenaus.
2. Geben Sie im Feld Name den Namen 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 NameFelderein.
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 Name den Namen payloadein.
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 die Option Variable erstellenaus.
12. Geben Sie in den Feldern Bezeichnung und NameDatensatzein.
13. Wählen Sie im Feld Typ die Option Dokument-IDaus.
Wählen Sie in der Aktionsgliederung Ausgabenaus.
1. Wählen Sie im Header der Aktionsausgabe die Option Ausgabe erstellenaus.
2. Geben Sie in die Felder Bezeichnung und NameDatensatz erstelltein.
3. Wählen Sie im Feld Typ die Option Dokument-IDaus.
4. Wählen Sie Bearbeitungsmodus beenden.
5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( ) und dann Skriptschritt > record.
Wählen Sie im Header Aktion Speichern und dann Test 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ügenaus, 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 erforderliche Felder, die normalerweise mit der Datensatzerstellung zusammenhängen. Diese Aktion dient nur zur Veranschaulichung. Verwenden Sie stattdessen Schritt „Datensatz erstellen“, um Datensätze mit Standardschutz 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 von Ihnen eingegebenen Testwerten übereinstimmen.
Wählen Sie im Header Aktion die Option Veröffentlichen aus, um diese Aktion für Flows innerhalb des globalen Bereichs verfügbar zu machen.

Ergebnisse

Sie können diese Aktion einem Flow in Flow Designerhinzufü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