Erstellen Sie eine Datenerfassungsaktion für eine dynamische Vorlage

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Erstellen Sie eine Datenerfassungsaktion, um Datensatzfeldwerte für eine dynamische Vorlageneingabe zu erfassen.

    Vorbereitungen

    • Erforderliche Rolle: action_designer oder admin
    • Erstellen Sie Anmeldeinformationen und Verbindungen für Ihren REST-Endpunkt
    Hinweis:
    Dynamische Eingaben sind im Basissystem nicht verfügbar. Zur Verwendung dynamischer Eingaben in Workflow-Studio, Müssen Sie Fordern Sie an IntegrationHub Pluginan.

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designeran.
    2. Auswahlvorgang Neu erstellen > Aktionan.
    3. In Aktionsname Geben Sie einen Namen für Ihre Aktion ein, und wählen Sie den richtigen aus Anwendung Bereich, und wählen Sie dann aus Übermitteln .
    4. Wahlweise: Wählen Sie in der Aktionsgliederung die Option aus Eingaben .
      Möglicherweise müssen Sie eine Eingabe erstellen, um einen Tabellennamen oder einen dynamischen URL-Pfad für Ihren REST-Schritt bereitzustellen.
      Erstellen Sie beispielsweise eine Zeichenfolgeneingabe, um einen Tabellennamen zu speichern. Siehe Erstellen Sie eine Datenerfassungsaktion, um Feldnamen abzurufen für Anweisungen.
    5. Wählen Sie in der Aktionsstruktur unter Eingaben das Symbol Neuen Schritt hinzufügen ( Symbol „neuen Schritt hinzufügen“) Und wählen Sie aus REST Schritt.
      1. Wählen Sie in den Verbindungsdetails einen Verbindungsalias aus, oder definieren Sie eine Verbindung inline.
        Mit einem Verbindungsalias können Sie Verbindungsdetails aktualisieren, ohne die Aktion bearbeiten zu müssen.
        Wählen Sie beispielsweise einen Verbindungsalias für Ihre lokale Instanz aus.
      2. Wählen Sie für die Anforderungsdetails eine Methode zum Erstellen einer Anforderung aus, geben Sie einen Ressourcenpfad an, wählen Sie eine HTTP-Methode aus, und geben Sie alle Abfrageparameter an.
        Datenerfassungsaktionen verwenden im Allgemeinen eine GET-HTTP-Methode, um Daten von einem REST-Endpunkt anzufordern. Weitere Informationen zur Verwendung des REST-Schritts in finden Sie IntegrationHub, Siehe REST-Schritt Und REST in IntegrationHub .
    6. Wählen Sie in der Aktionsstruktur unter dem REST-Schritt das Symbol Neuen Schritt hinzufügen ( Symbol „neuen Schritt hinzufügen“) Und wählen Sie aus Skript Schritt.
      1. Wählen Sie unter Eingabevariablen die Option aus Variable Erstellen , Und erstellen Sie eine Eingabevariable, um den REST-Antworttext zu speichern.
      2. Wählen Sie für den Eingabevariablen-Wert die Datenpille für die REST-Schritte aus Antworttext Ausgabe.
      3. Geben Sie unter Skript ein Skript ein, um eine JSON-Ausgabe aus der Eingabevariable zu erstellen.
        Ihr Skript muss diese Aufgaben ausführen.
        Analysieren Sie die Eingabevariable als JSON
        Sie können verwenden JSON - Global API zum Transformieren der Eingabevariable von einer Zeichenfolge in ein JSON-Objekt.
        Erstellen Sie ein neues JSON-Objekt, das für eine dynamische Vorlage formatiert ist
        Sie müssen die Datenstruktur der REST-Antwort kennen, um Antwortwerte Vorlagenwerten zuzuordnen. Ihr Skript muss ein dynamisches Vorlagen-JSON-Objekt mit einer Eigenschaft namens erstellen Daten . Der Wert der Dateneigenschaft muss ein Array von Vorlagenwerten sein. Jeder Vorlagenwert muss einen haben Bezeichnung Eigenschaft, A Name Eigenschaft, und leer Wert Eigenschaft. Die Bezeichnungseigenschaft bestimmt, wie die Vorlagenwertoption in der Aktion angezeigt wird. Die Namenseigenschaft bestimmt, wie die Vorlagenwertoption gespeichert und im System referenziert wird. Die Werteigenschaft ist leer, sodass der Wert dynamisch festgelegt werden kann, wenn die Aktion konfiguriert wird.

        Dieses JSON-Objekt definiert beispielsweise ein Array von Vorlagenwerten aus der Incident-Tabelle.

        {
    "data": [
      {
        "name": "parent",
        "label": "Parent",
        "value": ""
      },
      {
        "name": "number",
        "label": "Number",
        "value": ""
      },
      {
        "name": "state",
        "label": "State",
        "value": ""
      },
      {
        "name": "active",
        "label": "Active",
        "value": ""
      },
      {
        "name": "priority",
        "label": "Priority",
        "value": ""
      },
      {
        "name": "caller_id",
        "label": "Caller id",
        "value": ""
      },
      {
        "name": "short_description",
        "label": "Short description",
        "value": ""
      },
      {
        "name": "description",
        "label": "Description",
        "value": ""
      },
      {
        "name": "sys_id",
        "label": "Sys id",
        "value": ""
      },
      {
        "name": "urgency",
        "label": "Urgency",
        "value": ""
      },
      {
        "name": "assigned_to",
        "label": "Assigned to",
        "value": ""
      },
      {
        "name": "severity",
        "label": "Severity",
        "value": ""
      },
      {
        "name": "category",
        "label": "Category",
        "value": ""
      }
    ]
}
        Hinweis:
        Eine dynamische Vorlageneingabe kann nur bis zu 5000 Feldvorlagenwerte anzeigen. Ein JSON-Objekt, das mehr als 5000 Feldvorlagenwerte zurückgibt, wird beim Rendern gekürzt.
        Legen Sie das Ausgabeobjekt fest
        Legen Sie das Ausgabeobjekt so fest, dass Ihr dynamisches Vorlagen-JSON-Objekt zurückgegeben wird.
      4. Wählen Sie unter Ausgabevariablen die Option aus Variable Erstellen .
        Diese Ausgabevariable speichert die Vorlagenwerte, die Ihr Skript erstellt.
      5. Wählen Sie für den Ausgabevariablentyp aus JSON .
        Der Typ der Skriptausgabevariable muss JSON sein.
    7. Wählen Sie in der Aktionsgliederung die Option aus Ausgaben
      1. Wählen Sie Ausgabe Erstellen.
      2. Legen Sie die Bezeichnung und den Namen der Ausgabe fest Ausgabe .
      3. Legen Sie den Ausgabetyp auf fest JSON .
        Hinweis:
        Die Aktion kann mehrere Ausgaben haben, es kann jedoch nur eine vom Typ „JSON“ geben.
      4. Wählen Sie Aus Bearbeitungsmodus Beenden .
      5. Neben Wert Feld die Datenpillenauswahl auswählen ( Datenpillenauswahl) Und wählen Sie dann die von Ihnen erstellte Skriptschritt-Ausgabevariable aus, um Vorlagenwerte zu speichern.
    8. Klicken Sie Auf Speichern Und Testen Sie die Aktion .
      In den Ausführungsdetails wird Ihre Datenerfassungsaktion erfolgreich ausgeführt, wenn der Laufzeitwert für angegeben ist Ausgabe Enthält Daten Eigenschaft im richtigen Format.
    9. Klicken Sie Auf Veröffentlichen Um die Aktion für andere Flows oder Aktionen innerhalb desselben Anwendungsbereichs verfügbar zu machen.

    Ergebnisse

    Sie können jetzt Ihre Datenerfassungsaktion verwenden, um die Optionen auszufüllen, die für eine dynamische Vorlageneingabe in einer übergeordneten Aktion angezeigt werden.Verwenden Sie Ihre Datenerfassungsaktion, um Optionen für eine dynamische Vorlage auszufüllen.