Erstellen Sie eine Datensammlungsaktion für eine dynamische Vorlage

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Erstellen Sie eine Datensammlungsaktion, um Datensatzfeldwerte für eine dynamische Vorlageneingabe zu sammeln.

    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. Um dynamische Eingaben in Workflow-Studiozu verwenden, müssen Sie Fordern Sie eine an IntegrationHub Plugin.

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designer.
    2. Auswahlvorgang Neu erstellen > Aktion.
    3. Geben Sie im Feld Aktionsname einen Namen für Ihre Aktion ein, wählen Sie den richtigen Anwendungsbereich aus, und wählen Sie Absenden aus.
    4. Wahlweise: Wählen Sie in der Aktionsgliederung die Option Eingabenaus.
      Möglicherweise müssen Sie eine Eingabe erstellen, um Ihrem REST-Schritt einen Tabellennamen oder einen dynamischen URL-Pfad bereitzustellen.
      Erstellen Sie beispielsweise eine Zeichenfolgeneingabe, um einen Tabellennamen zu speichern. Siehe Erstellen Sie eine Datensammlungsaktion, um Feldnamen abzurufen für Anweisungen.
    5. Wählen Sie in der Aktionsgliederung unter Eingaben das Symbol zum Hinzufügen eines neuen Schritts ( Symbol zum Hinzufügen eines neuen Schritts) und anschließend den 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 Abfrageparameter an.
        Datensammlungsaktionen verwenden im Allgemeinen eine GET-HTTP-Methode, um Daten von einem REST-Endpunkt anzufordern. Weitere Informationen zur Verwendung des REST-Schritts in IntegrationHubfinden Sie unter REST-Schritt und REST in IntegrationHub.
    6. Wählen Sie in der Aktionsgliederung unter dem REST-Schritt das Symbol zum Hinzufügen eines neuen Schritts ( Symbol zum Hinzufügen eines neuen Schritts) und anschließend den Schritt Skript.
      1. Wählen Sie unter Eingabevariablen die Option Variable erstellen aus, und erstellen Sie eine Eingabevariable zum Speichern des REST-Antworttexts.
      2. Wählen Sie für die Eingabevariable „Wert“ die Datenpille für die Ausgabe des Antworttexts des REST-Schritts aus.
      3. Geben Sie unter Skript ein Skript ein, um aus der Eingabevariablen eine JSON-Ausgabe zu erstellen.
        Ihr Skript muss diese Aufgaben ausführen.
        Analysieren Sie die Eingabevariable als JSON
        Sie können die JSON - Global API verwenden, um die Eingabevariable von einer Zeichenfolge in ein JSON-Objekt umzuwandeln.
        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. Das Skript muss ein dynamisches JSON-Vorlagenobjekt mit einer Eigenschaft namens „data“erstellen. Der Wert der Dateneigenschaft muss ein Array von Vorlagenwerten sein. Jeder Vorlagenwert muss eine Bezeichnungseigenschaft, eine Namenseigenschaft und eine leere Werteigenschaft aufweisen. Die Eigenschaft „label“ 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 5.000 Feldvorlagenwerte zurückgibt, wird beim Rendern gekürzt.
        Legen Sie das Ausgabeobjekt fest
        Legen Sie das Ausgabeobjekt so fest, dass Ihr dynamisches JSON-Vorlagenobjekt zurückgegeben wird.
      4. Wählen Sie unter Ausgabevariablen die Option Variable erstellen aus.
        Diese Ausgabevariable speichert die von Ihrem Skript erstellten Vorlagenwerte.
      5. Wählen Sie als Ausgabevariablentyp JSONaus.
        Der Variablentyp der Skriptausgabe muss JSON sein.
    7. Wählen Sie in der Aktionsgliederung die Option Ausgabenaus
      1. Wählen Sie Ausgabe erstellen aus.
      2. Legen Sie die Ausgabebezeichnung und den Namen der Ausgabefest.
      3. Legen Sie den Ausgabetyp auf JSONfest.
        Hinweis:
        Die Aktion kann mehrere Ausgaben haben, es darf jedoch nur eine vom Typ JSON vorhanden sein.
      4. Wählen Sie Bearbeitungsmodus beenden aus.
      5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( Datenpillenauswahl) und dann Skriptschritt-Ausgabevariable aus, die Sie zum Speichern von Vorlagenwerten erstellt haben.
    8. Klicken Sie auf Speichern und testen Sie die Aktion.
      In den Ausführungsdetails wird Ihre Datensammlungsaktion erfolgreich ausgeführt, wenn der Laufzeitwert für die Ausgabe die Dateneigenschaft im richtigen Format enthält.
    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 Datensammlungsaktion verwenden, um die Optionen auszufüllen, die für eine dynamische Vorlageneingabe in einer übergeordneten Aktion angezeigt werden.Verwenden Sie Ihre Datensammlungsaktion, um Optionen für eine dynamische Vorlage auszufüllen.