Erstellen Sie eine Datenerfassungsaktion für eine dynamische Vorlage

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 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

    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 dann Absendenaus.
    4. Wahlweise: Wählen Sie in der Aktionsgliederung die Option Eingabenaus.
      Möglicherweise müssen Sie eine Eingabe erstellen, um einen Tabellennamen oder einen dynamischen URL-Pfad zu Ihrem 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. Klicken Sie in der Aktionsgliederung unter Eingaben auf das Symbol „ NeuenSchritt hinzufügen“ (Symbol „Neuen Schritt hinzufügen“ ), und wählen Sie den REST- Schritt aus.
      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.
        Datenerfassungsaktionen 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 „ NeuenSchritt hinzufügen“ (Symbol „Neuen Schritt hinzufügen“ ) und dann den Schritt Skript aus.
      1. Wählen Sie unter Eingabevariablen die Option Variable erstellenaus, und erstellen Sie eine Eingabevariable, um den REST-Antworttext zu speichern.
      2. Wählen Sie für die Eingabevariable Wert die Datenpille für die Antworttextausgabe des REST-Schritts aus.
      3. Geben Sie unter Skript ein Skript ein, um eine JSON-Ausgabe aus der Eingabevariablen zu erstellen.
        Ihr Skript muss diese Aufgaben ausführen.
        Analysieren Sie die Eingabevariable als JSON
        Sie können die API JSON - Global 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. Ihr Skript muss ein dynamisches JSON-Vorlagenobjekt mit der Eigenschaft data erstellen. Der Wert der Dateneigenschaft muss ein Array von Vorlagenwerten sein. Jeder Vorlagenwert muss eine Bezeichnungseigenschaft, eine Namenseigenschaft und eine leere Werteigenschaft haben. Die Eigenschaft label bestimmt, wie die Vorlagenwertoption in der Aktion angezeigt wird. Die Eigenschaft name bestimmt, wie die Vorlagenwertoption im System gespeichert und referenziert wird. Die Eigenschaft value 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 abgeschnitten.
        Legen Sie das Ausgabeobjekt fest
        Legen Sie das Ausgabeobjekt fest, um Ihr JSON-Objekt für dynamische Vorlagen zurückzugeben.
      4. Wählen Sie unter Ausgabevariablen die Option Variable erstellenaus.
        Diese Ausgabevariable speichert die Vorlagenwerte, die Ihr Skript erstellt.
      5. Wählen Sie als Ausgabevariablentyp JSONaus.
        Der Typ der Skriptausgabevariablen 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 fest, und benennen Sie Ausgabe.
      3. Legen Sie den Ausgabetyp auf JSON fest.
        Hinweis:
        Die Aktion kann mehrere Ausgaben haben, aber es kann nur eine vom Typ JSON geben.
      4. Wählen Sie Bearbeitungsmodus beenden.
      5. Wählen Sie neben dem Feld Wert die Datenpillenauswahl ( Datenpillenauswahl) und dann die Ausgabevariable des Skriptschritts 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 Datenerfassungsaktion 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 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.