JSON-Parser-Schritt
Identifizieren Sie strukturierte Daten aus einer JSON-Nutzlast, ohne ein Skript schreiben zu müssen. Ordnen Sie eingehenden JSON-Inhalt einer komplexen Objektausgabe zu, die Sie in anderen Schritten oder Aktionen verwenden können. Zur Laufzeit füllen Werte aus einer JSON-Nutzlast die komplexe Objektausgabe.
Weitere Informationen zu komplexen Objekten finden Sie unter Komplexe Daten.
Rollen und Verfügbarkeit
Verfügbar als Aktionsdesigner-Aktionsschritt. Benutzer mit der Rolle „action_designer“ können eine benutzerdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.
Größenbeschränkung für Nutzlast
Zur Laufzeit unterstützt JSON-Parser-Schritt Nutzlasten bis zu 10 MB. Erstellen Sie für größere Nutzlasten eine Datenstrom -Aktion. Weitere Informationen zu Datenstrom-Aktionen finden Sie unter Datenstromaktionen und Paginierung.
Felder
| Feld | Beschreibung |
|---|---|
| Quelle | Wählen oder ziehen Sie im Feld Quelldaten eine Datenpille, die die JSON-Nutzlast der Quelle enthält. Zum Beispiel eine REST-Schritt-Datenpille „ Antworttext “. Zur Laufzeit füllen Werte aus der Datenquelle die komplexe Objektausgabe aus. Geben Sie unter Quelldaten und im Skriptfenster eine Beispielnutzlast ein, um Ihr komplexes Objekt zu generieren. Wenn Sie beispielsweise die Antwort eines REST-Schritts analysieren, der eine Liste von Benutzern zurückgibt, geben Sie das erwartete JSON-Objekt für einen einzelnen Benutzer ein. Sie können eine beliebige JSON-Beispielnutzlast mit den folgenden Einschränkungen erstellen:
|
| Strukturierte Payload-Ansicht | Zeigen Sie Ihre Beispielnutzlast als reguläres JSON-Objekt an, oder schalten Sie die strukturierte Nutzlastansicht um, um die Nutzlast in einer strukturierten Knotenstruktur anzuzeigen. Wählen Sie einen Knoten in der Struktur aus, um den JSONPath des Elements zu kopieren. Wenn Sie neue Elemente im Feld Ziel manuell hinzufügen, können Sie diesen JSONPath unter den erweiterten Optionen eines Elements einfügen. |
| Ziel generieren | Wählen Sie Ziel generieren aus, um die Ausgabestruktur des Schritts aus Ihrer Beispielnutzlast zu erstellen. Ihre Ausgabedatenstruktur wird im Feld Ziel angezeigt. Untergeordnete Elemente für jedes Objekt werden automatisch als Typ Zeichenfolge generiert. Alternativ können Sie Ihr komplexes Zielobjekt manuell erstellen, indem Sie Elemente im Feld Ziel hinzufügen. |
| Zielvorgabe | Zeigen Sie die Ausgabestruktur der JSON-Nutzlast an, oder bearbeiten Sie sie. Erstellen Sie eine strukturierte Ausgabe, indem Sie auf Ziel generierenklicken, oder fügen Sie Elemente manuell hinzu. Jedes Element enthält die folgenden Informationen in der Ansicht „Objekt bearbeiten“:
Elemente vom Typ Objekt enthalten die erweiterte Option Als Vorlage speichern, mit der Sie die Struktur Ihres Objekts als komplexe Objektvorlage speichern können. Sie können diese Vorlage dann verwenden, um das Schema einer Objektausgabe für Ihre Aktion zu definieren. Für Elemente vom Typ „Zeichenfolge“ können Sie auch eine maximale Länge, einen Hinweis und einen Standardwert als erweiterte Optionen hinzufügen. Wählen Sie im Header „Ziel“ die Option Bearbeitungsmodus beenden aus, wenn Sie mit den Änderungen an der Struktur der Ausgabe fertig sind. Sie können dann das Symbol „Erweiterte Eingaben umschalten“ (Symbol „ Der JSONPath ist der Pfad zum Element. Ändern Sie den JSONPath, um die Zuordnung Ihrer Quelldatenelemente zu Elementen in Ihrer Ausgabe zu ändern. Wenn Sie Elemente manuell hinzufügen, können Sie den JSONPath aus einem Knoten in Ihrer Beispielnutzlast kopieren und unter den erweiterten Optionen eines Elements einfügen. |
zum Hinzufügen eines untergeordneten Elements) aus, um ein geschachteltes untergeordnetes Element hinzuzufügen.
umschalten“ ) auswählen, um die Option Beispiel für JSON-Parser-Schritt
In diesem Beispiel werden neu erstellte Probleme aus einer Produktionsinstanz als Fehler in einer Testinstanz nachverfolgt. Erstellen Sie zuerst eine neue Aktion mit dem Namen Parse Problems from Production. Fügen Sie einen REST-Schritt hinzu, um eine Liste von Problemen aus der Produktionsinstanz abzurufen. Fügen Sie dann den JSON-Parserschritt hinzu, um Response Body des REST-Schritts zu analysieren, und geben Sie eine komplexe Objektausgabe an, die das Schema der Problemtabelle [problem] darstellt. Erstellen Sie abschließend eine Aktionsausgabe vom Typ Objekt mit dem Namen Problems from Production. Legen Sie die Datenpille root aus dem JSON-Parser-Schritt im Wertfeld dieser Ausgabe ab.
Erstellen Sie als Nächstes einen neuen Flow mit dem Namen Sync New Problems, der täglich um Mitternacht ausgelöst wird. Die erste Aktion im Flow ist die Aktion Parse Problems from Production. Fügen Sie dann einen Flow-Logikblock For Each hinzu, und verwerfen Sie den Datenpille in das Feld Element. Fügen Sie innerhalb des Blocks Für alle einen Flow-Logikblock If hinzu, der überprüft, ob der Status jedes Problems neu ist, und dann in der Testinstanz einen Fehlerdatensatz erstellt, dessen Zuweisungsgruppe und Kurzbeschreibung jedem neuen Problem aus der Produktionsinstanz zugeordnet wird.