Erste Schritte mit dynamischen Eingaben

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 17 Minuten Lesedauer
  • Erstellen Sie eine Beispielaktion, die die Verwendung aller verfügbaren Typen dynamischer Eingaben in einem Flow veranschaulicht.

    Vorbereitungen

    Erforderliche Rolle: action_designer oder admin

    Prozedur

    1. 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 Datenerfassungsaktionen erforderlich sind.
    2. Erstellen Sie eine Datenerfassungsaktion, um Tabellennamen abzurufen.
      Diese Datenerfassungsaktion stellt JSON-Daten für dynamische Auswahleingaben bereit.
    3. Erstellen Sie eine Datenerfassungsaktion, um Feldnamen abzurufen.
      Diese Datenerfassungsaktion stellt JSON-Daten für dynamische Vorlageneingaben bereit.
    4. Erstellen Sie eine Datenerfassungsaktion, um dynamische Eingaben hinzuzufügen.
      Diese Datenerfassungsaktion stellt JSON-Daten bereit, um beliebige dynamische Eingaben zu erstellen.
    5. Erstellen Sie eine anwenderdefinierte Aktion, um dynamische Eingaben zu testen.
      Diese anwenderdefinierte Aktion veranschaulicht verschiedene Arten dynamischer Eingaben.

    Erstellen Sie Anmeldeinformations- 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: Administrator

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationenan.
    2. Wählen Sie Aus Neu , Wählen Sie aus Anmeldeinformationen Für Standardauthentifizierung , Und geben Sie diese Feldwerte ein.
      1. Für Name , Eingabetaste Lokaler Administrator .
      2. Für Anwendername , Geben Sie einen Anwenderaccount mit Zugriff auf Flow Designer und die REST API ein.
        Geben Sie beispielsweise ein Administrator .
      3. Für Passwort , Geben Sie das Account-Passwort ein.
    3. Wählen Sie Aus Übermitteln Zum Erstellen des Anmeldeinformationsdatensatzes.
    4. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationenan.
    5. Wählen Sie Aus Neu Und geben Sie diese Feldwerte ein.
      1. Für Name Geben Sie die lokale Instanz ein.
      2. Akzeptieren Sie den Standardwert von HTTP für Verbindungstyp .
      3. Wählen Sie Aus Übermitteln Dient zum Erstellen des Datensatzes „Alias für Verbindungen und Anmeldeinformationen“.
    6. Wählen Sie den von Ihnen erstellten Alias aus.
      Wählen Sie beispielsweise aus Lokale Instanz .
    7. Wählen Sie in der zugehörigen Liste Verbindungen die Option aus Neu , Und geben Sie diese Feldwerte ein.
      1. Für Name , Eingabetaste Meine Instanz .
      2. Wählen Sie für Anmeldeinformationen den von Ihnen erstellten Anmeldeinformationsdatensatz für die Standardauthentifizierung aus.
        Wählen Sie beispielsweise aus Lokaler Administrator Anmeldeinformationen.
      3. Geben Sie für die Verbindungs-URL die Basis-URL für Ihre Instanz ein, einschließlich des Schrägstrichs am Ende
        Fügen Sie das URL-Präfix https:// hinzu, und fügen Sie am Ende der URL einen Schrägstrich hinzu.
        Beispiel: https://example.service-now.com/ .
      4. Wählen Sie Aus Übermitteln Zum Erstellen des HTTP(s)-Verbindungsdatensatzes.

    Ergebnisse

    Sie können den lokalen Instanzalias verwenden, um eine Verbindung mit Ihrer lokalen Instanz herzustellen, wenn Sie REST-Schritte konfigurieren.

    Erstellen Sie eine Datenerfassungsaktion, um Tabellennamen abzurufen

    Erstellen Sie eine anwenderdefinierte 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 Sammeln 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 Ausgabe Dient zum Speichern von Tabellenname- und Wertpaaren als JSON-Dokument

    Diese anwenderdefinierte Aktion verwendet einen REST-API-Aufruf, um die Funktionalität von zu duplizieren ServiceNow Kern Aktion „Datensatz suchen“ Und Aktion „Datensätze suchen“. 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 Alle > Prozessautomatisierung > Workflow-Studioan.
    2. Wählen Sie auf der Homepage aus Aktionen .
    3. Auswahlvorgang Neu erstellen > Aktionan.
      1. Auf dem Bildschirm Aktionseigenschaften in Aktionsname Feld eingeben Datenerfassungsaktion für Tabellen .
      2. Für Anwendung , Wählen Sie Global.
      3. Wählen Sie Absenden.
      Beispielaktionseigenschaften, die aus Schritt 2 erstellt wurden
    4. Wählen Sie im Abschnitt „Aktionsstruktur“ im Abschnitt „Eingaben“ das Symbol „Neuen Schritt hinzufügen“ ( Symbol „neuen Schritt hinzufügen“).
    5. Von Integrationen Wählen Sie den Abschnitt aus REST Schritt, und geben Sie diese Feldwerte ein.
      Eingabe Wert
      Verbindung Verlassen Verwenden Sie Den Verbindungsalias Ausgewählt.
      Verbindungsalias Wählen Sie den Alias aus, den Sie zuvor erstellt haben, oder wählen Sie das Symbol Neuen Datensatz erstellen ( Symbol „Neuen Datensatz erstellen“) Bis Erstellen Sie eine HTTP(s)-Verbindung .
      Hinweis:
      Die Anmeldeinformationen Für die HTTP(s)-Verbindung muss verwenden Anmeldeinformationen für Standardauthentifizierung . Darüber hinaus die Verbindungs-URL Muss 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 Verlassen Sie die Manuell Option ausgewählt
      Ressourcenpfad Geben Sie Ein api/now/doc/table/schema
      HTTP-Methode Geben Sie Ein ABRUFEN
      Beispiel für eine REST-Schrittkonfiguration aus den Schritten 3 und 4
    6. Wählen Sie in der Aktionsstruktur unter Ihrem REST-Schritt das Symbol Neuen Schritt hinzufügen ( Symbol „neuer Schritt“), und wählen Sie aus Skript Schritt.
      1. Wählen Sie im Abschnitt Eingabevariablen die Option aus Variable Erstellen .
      2. In Name Feld eingeben Nutzlast .
      3. Neben Wert Feld die Datenpillenauswahl auswählen ( Datenpillenauswahl) Und wählen Sie aus REST-Schritt > Antworttextan.
      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 Bild, Referenz, rawLabel, ausgewählt, Bezeichnung, beschreibt. fehlende, verwendete und Werteigenschaften. Die Bezeichnungs- und Werteigenschaften stellen die Werte bereit, 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 Werteigenschaft einer Namenseigenschaft zu.

      5. Wählen Sie im Abschnitt Ausgabevariablen die Option aus Variable Erstellen .
      6. In Bezeichnung Und Name Felder eingeben Tabellen .
      7. In Typ Feld auswählen JSON .
      Beispiel für eine Skriptschrittkonfiguration aus Schritt 5
    7. Wählen Sie in der Aktionsgliederung die Option aus Ausgaben .
      1. Wählen Sie Aus Ausgabe Erstellen .
      2. In Bezeichnung Und Name Felder eingeben Ausgabe .
      3. In Typ Feld auswählen JSON .
      4. Wählen Sie Aus Bearbeitungsmodus Beenden .
      5. Neben Wert , Wählen Sie die Datenpillenauswahl ( Datenpillenauswahl) Und wählen Sie aus Skriptschritt > Tabellenan.
      Beispielaktions-Ausgabekonfiguration aus Schritt 6
    8. Wählen Sie im Aktionsheader die Option aus Speichern Und wählen Sie dann aus Testen Bis Testen Sie die Aktion .
      1. Wählen Sie Test ausführen.
      2. Zeigen Sie die Ausführungsdetails der Aktion an.
        Ihre Datenerfassungsaktion wird erfolgreich ausgeführt, wenn der Laufzeitwert für angegeben ist Tabellen Ist ein komplexes Objekt, das ein Array von Schlüssel-Wert-Paaren für enthält Bezeichnung Und Name 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"
            }
          ]
        }
      Ausführungsdetails der Beispielaktion aus Schritt 7
    9. Wählen Sie im Aktionsheader die Option aus Veröffentlichen 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 Ausgabe Dient zum Speichern von Feldnamen- und Wertpaaren als JSON-Dokument

    Diese anwenderdefinierte Aktion verwendet einen REST-API-Aufruf, um die Funktionalität von zu duplizieren ServiceNow Kern Aktion „Datensatz suchen“ Und Aktion „Datensätze suchen“. 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 Alle > Prozessautomatisierung > Workflow-Studioan.
    2. Wählen Sie auf der Homepage aus Aktionen .
    3. Auswahlvorgang Neu erstellen > Aktionan.
      1. Auf dem Bildschirm Aktionseigenschaften in Aktionsname Feld eingeben Datenerfassungsaktion für Felder .
      2. Für Anwendung , Wählen Sie Global.
      3. Wählen Sie Absenden.
      Beispiel für Aktionseigenschaften aus Schritt 2
    4. Wählen Sie in der Aktionsgliederung die Option aus Eingaben .
      1. Wählen Sie im Header „Aktionseingabe“ die Option aus Eingabe Erstellen .
      2. In Bezeichnung Und Name Felder eingeben Tabelle .
      3. Wählen Sie im Feld Type die Option Zeichenfolge aus.
      4. Schalten Sie ein/aus Obligatorisch Schieberegler, damit er aktiv ist.
      5. Wählen Sie das Symbol Erweiterte Eingaben ein/aus, um die erweiterten Eingaben anzuzeigen.
      6. Für Standardwert , Eingabetaste Incident .
      Beispieleingabekonfiguration aus Schritt 3
    5. Wählen Sie in der Aktionsstruktur unter dem REST-Schritt das Symbol Neuen Schritt hinzufügen ( Symbol „neuer Schritt“).
    6. Von Integrationen Wählen Sie den Abschnitt aus Skript Schritt, und geben Sie diese Feldwerte ein.
      1. Wählen Sie im Abschnitt Eingabevariablen die Option aus Variable Erstellen .
      2. In Name Feld eingeben Tabelle .
      3. Neben Wert , Wählen Sie die Datenpillenauswahl ( Datenpillenauswahl) Und wählen Sie aus Aktion > Tabellean.
      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 aus Variable Erstellen .
      6. In Bezeichnung Und Name Felder eingeben Tabelle .
      7. Wählen Sie im Feld Type die Option Zeichenfolge aus.
      Beispiel für eine Skriptschrittkonfiguration aus Schritt 5
    7. Wählen Sie in der Aktionsstruktur im Abschnitt Eingaben das Symbol Neuen Schritt hinzufügen ( Symbol „neuer Schritt“).
    8. Von Integrationen Wählen Sie den Abschnitt aus REST Schritt, und geben Sie diese Feldwerte ein.
      Eingabe Wert
      Verbindung Verlassen Verwenden Sie Den Verbindungsalias Ausgewählt.
      Verbindungsalias Wählen Sie den Alias aus, den Sie zuvor erstellt haben, oder wählen Sie das Symbol Neuen Datensatz erstellen ( Symbol „Neuen Datensatz erstellen“) Bis Erstellen Sie eine HTTP(s)-Verbindung .
      Hinweis:
      Die Anmeldeinformationen Für die HTTP(s)-Verbindung muss verwenden Anmeldeinformationen für Standardauthentifizierung . Darüber hinaus die Verbindungs-URL Muss 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 Verlassen Manuell Ausgewählt.
      Ressourcenpfad Geben Sie Ein api/now/table/ Und wählen Sie dann die Datenpillenauswahl ( Datenpillenauswahl). Auswahlvorgang Skriptschritt > Tabellean.
      HTTP-Methode Geben Sie Ein ABRUFEN
      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
    9. Wählen Sie in der Aktionsstruktur unter dem REST-Schritt das Symbol Neuen Schritt hinzufügen ( Symbol „neuer Schritt“).
    10. Von Integrationen Wählen Sie den Abschnitt aus Skript Schritt, und geben Sie diese Feldwerte ein.
      1. Wählen Sie im Abschnitt Eingabevariablen die Option aus Variable Erstellen .
      2. In Name Feld eingeben Nutzlast .
      3. Neben Wert , Wählen Sie die Datenpillenauswahl ( Datenpillenauswahl) Und wählen Sie aus REST-Schritt > Antworttextan.
      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 Namenwertpaaren 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 die Option aus Variable Erstellen .
      6. In Bezeichnung Und Name Felder eingeben Felder .
      7. In Typ Feld auswählen JSON .
      Beispiel für eine Skriptschrittkonfiguration aus Schritt 9
    11. Wählen Sie in der Aktionsgliederung die Option aus Ausgaben .
      1. Wählen Sie im Header der Aktionsausgabe die Option aus Ausgabe Erstellen .
      2. In Bezeichnung Und Name Felder eingeben Ausgabe .
      3. In Typ Feld auswählen JSON .
      4. Wählen Sie Aus Bearbeitungsmodus Beenden .
      5. Neben Wert Feld die Datenpillenauswahl auswählen ( Datenpillenauswahl) Und dann auswählen Skriptschritt > Felderan.
      Beispielausgabekonfiguration aus Schritt 8
    12. Wählen Sie im Aktionsheader die Option aus Speichern Und wählen Sie dann aus Testen Bis Testen Sie die Aktion .
      1. Auf dem Bildschirm Testaktion in Tabelle Feld eingeben Incident .
      2. Wählen Sie Test ausführen.
      3. Zeigen Sie die Ausführungsdetails der Aktion an.
        Ihre Datenerfassungsaktion wird erfolgreich ausgeführt, wenn der Laufzeitwert für angegeben ist Ausgabe Ist ein komplexes Objekt, das ein Array von Schlüssel-Wert-Paaren für enthält Bezeichnung , Name , Und Wert 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": ""
              }
            ]
          }
      Ausführungsdetails der Beispielaktion aus Schritt 9
    13. Klicken Sie im Aktionsheader 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 Eingabe des Referenztyps hinzuzufügen.

    Vorbereitungen

    Erforderliche Rolle: action_designer oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Diese Datenerfassungsaktion enthält diese Elemente.
    • Eine Aktionseingabevariable zum Speichern eines Tabellennamens
    • Ein Skriptschritt zum Erstellen von zwei dynamischen Eingaben als JSON-Objekt
    • Eine Aktionsausgabevariable mit dem Namen Ausgabe Zum Speichern der dynamischen Eingaben

    Diese anwenderdefinierte Aktion verwendet eine Referenztypeingabe, um die Funktionalität von zu duplizieren ServiceNow Kern Aktion „Datensatz suchen“ Und Aktion „Datensätze suchen“. 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 Alle > Prozessautomatisierung > Workflow-Studioan.
    2. Wählen Sie auf der Homepage aus Aktionen .
    3. Auswahlvorgang Neu erstellen > Aktionan.
      1. Auf dem Bildschirm Aktionseigenschaften in Aktionsname Feld eingeben Datenerfassungsaktion für dynamische Eingaben .
      2. Für Anwendung , Wählen Sie Global.
      3. Wählen Sie Absenden.
      Beispiel für Aktionseigenschaften aus Schritt 2
    4. Wählen Sie in der Aktionsgliederung die Option aus Eingaben .
      1. Wählen Sie im Header „Aktionseingabe“ die Option aus Eingabe Erstellen .
      2. In Bezeichnung Und Name Felder eingeben Tabelle .
      3. Wählen Sie im Feld Type die Option Zeichenfolge aus.
      4. Wählen Sie das Symbol Erweiterte Eingaben ein/aus ( Symbol für erweiterte Eingabe ein/aus).
      5. In Standardwert Feld eingeben sys_user .
      Beispielaktions-Eingabekonfiguration aus Schritt 3
    5. Wählen Sie in der Aktionsstruktur unter Eingaben das Symbol Neuen Schritt hinzufügen ( Symbol „neuer Schritt“).
    6. Von Integrationen Wählen Sie den Abschnitt aus Skript Schritt, und geben Sie diese Feldwerte ein.
      1. Wählen Sie im Abschnitt Eingabevariablen die Option aus Variable Erstellen .
      2. In Name Feld eingeben Tabelle .
      3. Neben Wert , Wählen Sie die Datenpillenauswahl ( Datenpillenauswahl) Und wählen Sie aus Eingaben > Tabellean.
      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 dynamischer Eingabe hat eine eigene JSON-Struktur. Für eine dynamische Eingabe eines Referenzfelds sind diese Eigenschaften erforderlich.
        label
        Der Text, der neben der Eingabe angezeigt werden soll. Beispiel: Eingabe des Referenzfelds.
        name
        Der interne Name der dynamischen Eingabe, die zum Identifizieren und Speichern von Werten verwendet wird. Beispiel: Referencettype.
        Referenz
        Der Name der Zieltabelle 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 Zeigt die Eingabe und die anderen Eigenschaften an, die zum Konfigurieren erforderlich sind.
      5. Wählen Sie im Abschnitt Ausgabevariablen die Option aus Variable Erstellen .
      6. In Bezeichnung Und Name Felder eingeben Daten .
      7. In Typ Feld auswählen JSON .
      Beispiel für eine Skriptschrittkonfiguration aus den Schritten 4 bis 5
    7. Wählen Sie in der Aktionsgliederung die Option aus Ausgaben .
      1. Wählen Sie im Header der Aktionsausgabe die Option aus Ausgabe Erstellen .
      2. In Bezeichnung Und Name Felder eingeben Ausgabe .
      3. In Typ Feld auswählen JSON .
      4. Wählen Sie Aus Bearbeitungsmodus Beenden .
      5. Neben Wert Feld die Datenpillenauswahl auswählen ( Datenpillenauswahl) Und dann auswählen Skriptschritt > Datenan.
      Beispielausgabekonfiguration aus Schritt 6
    8. Wählen Sie im Aktionsheader die Option aus Speichern Und wählen Sie dann aus Testen Bis Testen Sie die Aktion .
      1. Wählen Sie Test ausführen.
      2. Zeigen Sie die Ausführungsdetails der Aktion an.
        Wenn Ihre Datenerfassungsaktion erfolgreich ausgeführt wird, wird der Laufzeitwert für angegeben Ausgabe Ist eine JSON-Zeichenfolge, wie im folgenden Beispiel gezeigt.
        {
          "data": [
            {
              "reference": "sys_user",
              "name": "referencetype",
              "label": "Reference type input",
              "type": "reference"
            }
          ]
        }
      Ausführungsdetails der Beispielaktion aus Schritt 7
    9. Wählen Sie im Aktionsheader die Option aus Veröffentlichen Um diese Aktion für andere Aktionen im globalen Bereich verfügbar zu machen.

    Erstellen Sie eine anwenderdefinierte Aktion, um dynamische Eingaben zu testen

    Erstellen Sie eine anwenderdefinierte 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 Drittparteien.

    Diese anwenderdefinierte Aktion enthält diese 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 GlideRecord - Global
    • Eine Aktionsausgabevariable mit dem Namen Ausgabe Zum Speichern der sys_ID des erstellten Datensatzes

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Workflow-Studioan.
    2. Wählen Sie auf der Homepage aus Aktionen .
    3. Auswahlvorgang Neu erstellen > Aktionan.
      1. Auf dem Bildschirm Aktionseigenschaften in Aktionsname Feld eingeben Erstellen Sie einen Datensatz aus dynamischen Eingaben .
      2. Für Anwendung , Wählen Sie Global.
      3. Wählen Sie Absenden.
      Beispielkonfiguration der Aktionseigenschaften aus Schritt 2
    4. Wählen Sie in der Aktionsgliederung die Option aus Eingaben .
      1. Wählen Sie Aus Eingabe Erstellen .
      2. In Bezeichnung Und Name Felder eingeben Tabelle .
      3. In Typ Feld auswählen Dynamische Auswahl .
      4. Aktivieren Sie Obligatorisch Umschalter.
      5. In Standardwert , Eingabetaste Incident .
      6. Akzeptieren Sie den Standardwert für Auswahl .
      7. Unter dynamische Optionen für Aktion Feld auswählen Datenerfassungsaktion für Tabellen .
      8. Wählen Sie Aus Eingabe Erstellen Um eine weitere Aktionseingabe zu erstellen.
      9. In Bezeichnung Und Name Felder eingeben Felder .
      10. In Typ Feld auswählen Dynamische Vorlage .
      11. Aktivieren Sie Obligatorisch Umschalter.
      12. Unter dynamische Optionen in Aktion Feld auswählen Datenerfassungsaktion für Felder .
      13. Neben Tabelle Feld, aktivieren Sie Hängt Von Einer Anderen Eingabe Ab Umschalter.
      14. In Tabelle Wählen Sie das Feld aus Tabelle Eingabe.
      15. Wählen Sie Aus Eingabe Erstellen Um eine weitere Aktionseingabe zu erstellen.
      16. In Bezeichnung Und Name Felder eingeben Dynamische Eingabe .
      17. In Typ Feld auswählen Dynamische Eingaben .
      18. Unter dynamische Optionen in Aktion Feld auswählen Datenerfassungsaktion für dynamische Eingaben .
      19. Verlassen Sie die Tabelle Feld leer, um den Standardwert von sys_user zu verwenden, der von der Datenerfassungsaktion bereitgestellt wird.
      Beispieleingabekonfiguration aus Schritt 3
    5. Wählen Sie in der Aktionsstruktur im Abschnitt Eingaben das Symbol Neuen Schritt hinzufügen ( Symbol „neuer Schritt“).
    6. Von Integrationen Wählen Sie den Abschnitt aus Skript Schritt, und geben Sie diese Feldwerte ein.
      1. Wählen Sie im Abschnitt Eingabevariablen die Option aus Variable Erstellen .
      2. In Name Feld eingeben Tabelle .
      3. Neben Wert Feld die Datenpillenauswahl auswählen ( Datenpillenauswahl) Und wählen Sie aus Eingaben > Tabellean.
      4. Wählen Sie Aus Variable Erstellen Um eine weitere Eingabevariable zu erstellen.
      5. In Name Feld eingeben Felder .
      6. Neben Wert Feld die Datenpillenauswahl auswählen ( Datenpillenauswahl) Und wählen Sie aus Eingaben > Felderan.
      7. Wählen Sie Aus Variable Erstellen Um eine weitere Eingabevariable zu erstellen.
      8. In Name Feld eingeben Nutzlast .
      9. Neben Wert Feld die Datenpillenauswahl auswählen ( Datenpillenauswahl) Und wählen Sie aus Eingaben > Dynamische Eingabean.
      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 aus Variable Erstellen .
      12. In Bezeichnung Und Name Felder eingeben Datensatz .
      13. In Typ Feld auswählen Dokument-ID .
      Beispiel für eine Skriptschrittkonfiguration aus den Schritten 4 bis 5
    7. Wählen Sie in der Aktionsgliederung die Option aus Ausgaben .
      1. Wählen Sie im Header der Aktionsausgabe die Option aus Ausgabe Erstellen .
      2. In Bezeichnung Und Name Felder eingeben Datensatz Erstellt .
      3. In Typ Feld auswählen Dokument-ID .
      4. Wählen Sie Aus Bearbeitungsmodus Beenden .
      5. Neben Wert Feld die Datenpillenauswahl auswählen ( Datenpillenauswahl) Und dann auswählen Skriptschritt > recordan.
      Beispielausgabekonfiguration aus Schritt 6
    8. Wählen Sie im Aktionsheader die Option aus Speichern Und wählen Sie dann aus Testen Bis Testen Sie die Aktion .
      1. Auf dem Bildschirm Testaktion in Tabelle Eingabe: Wählen Sie eine beliebige dynamisch generierte Tabellenauswahloption aus.
        Wählen Sie beispielsweise die Incident-Tabelle aus.
      2. Wählen Sie Aus Fügen Sie Einen Feldwert Hinzu , 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 Werttest ein.
      3. Im Abschnitt „dynamische Eingaben“ und im Referenztypeingabe Feld einen Referenzfeldwert auswählen.
        Wählen Sie beispielsweise den Anwender 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 zu Illustrationszwecken. Verwenden Sie Schritt „Datensatz erstellen“ Stattdessen sollen Datensätze mit Standardschutz und -Validierungen erstellt werden.
      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 Stimmen Sie mit den von Ihnen eingegebenen Testwerten überein.
      Ausführungsdetails der Beispielaktion aus Schritt 7
    9. Wählen Sie im Aktionsheader die Option aus Veröffentlichen Um diese Aktion für Flows innerhalb des globalen Bereichs verfügbar zu machen.

    Ergebnisse

    Sie können diese Aktion einem Flow in hinzufügen Workflow-Studio. 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