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 Workflow-Studio-Aktionsschritt. Anwender mit der Rolle „action_Designer“ können eine anwenderdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.
Größenbeschränkung der Nutzlast
Zur Laufzeit, JSON-Parser-SchrittUnterstützt Nutzlasten bis zu 10 MB. Erstellen Sie für größere Nutzlasten eine DatenstromAktion. Weitere Informationen zu Datenstromaktionen finden Sie unter Datenstromaktionen und Paginierung.
Felder
| Feld | Beschreibung |
|---|---|
| Quelle | In Quelldaten Wählen Sie eine Datenpille aus, die die JSON-Quellnutzlast enthält, oder ziehen Sie sie. Beispiel: Ein REST-Schritt Antworttext Datenpille. Zur Laufzeit füllen Werte aus der Datenquelle die Ausgabe des komplexen Objekts aus. Unter Quelldaten Und geben Sie im Skripting-Fenster eine Beispielnutzlast ein, um Ihr komplexes Objekt zu generieren. Beispiel: Wenn die Antwort von analysiert wird REST-Schritt Geben Sie das erwartete JSON-Objekt für einen einzelnen Anwender ein, das eine Liste von Anwendern zurückgibt. Sie können jede JSON-Beispielnutzlast mit den folgenden Einschränkungen erstellen:
|
| Strukturierte Payload-Ansicht | Zeigen Sie Ihre Beispielnutzlast als reguläres JSON-Objekt an, oder schalten Sie ein/aus Strukturierte Nutzlastansicht Dient zum Anzeigen der Nutzlast in einer strukturierten Knotenstruktur. Wählen Sie einen Knoten in der Struktur aus, um den JSONPath des Elements zu kopieren. Wenn Sie neue Elemente in hinzufügen Ziel Feld manuell können Sie diesen JSONPath unter den erweiterten Optionen eines Elements einfügen. |
| Ziel generieren | Wählen Sie Aus Ziel Generieren Um die Ausgabestruktur des Schritts aus Ihrer Beispielnutzlast zu erstellen. Ihre Ausgabedatenstruktur wird in angezeigt Ziel Feld. Untergeordnete Elemente für jedes Objekt werden automatisch als Typ „Zeichenfolge“ generiert. Alternativ können Sie Ihr komplexes Zielobjekt manuell erstellen, indem Sie Elemente in hinzufügen Ziel Feld. |
| Zielvorgabe | Zeigen Sie die Ausgabestruktur der JSON-Nutzlast an, oder bearbeiten Sie sie. Erstellen Sie eine strukturierte Ausgabe, indem Sie auf klicken Ziel Generieren , Oder fügen Sie Elemente manuell hinzu. Jedes Element enthält die folgenden Informationen in der Ansicht „Objekt bearbeiten“:
Elemente vom Typ „Objekt“ enthalten Als Vorlage speichern Erweiterte Option, 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 Tipp und einen Standardwert als erweiterte Optionen hinzufügen. Wählen Sie im Header Ziel die Option aus Bearbeitungsmodus Beenden Wenn Sie mit Änderungen an der Struktur Ihrer Ausgabe fertig sind. Sie können dann das Umschaltsymbol für erweiterte Eingaben ( Der JSONPath ist der Pfad zum Element. Ändern Sie den JSONPath, um zu ändern, wie Ihre Quelldatenelemente Elementen in Ihrer Ausgabe zugeordnet werden. 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. |
), um ein geschachteltes untergeordnetes Element hinzuzufügen.
), um anzuzeigen 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-Parser-Schritt hinzu, um die REST-Schritte zu analysieren Response BodyUnd stellen Sie eine komplexe Objektausgabe bereit, die das Schema der Problemtabelle [Problem] darstellt. Erstellen Sie abschließend eine Aktionsausgabe vom Typ „Objekt namens“ Problems from Production. Legen Sie den ab rootDatenpille aus dem JSON-Parser-Schritt in das Wertfeld dieser Ausgabe.
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 Parse Problems from ProductionAktion. Fügen Sie dann ein hinzu For EachFlow-Logik blockieren und ablegen Datenpille in Element Feld. Innerhalb von Für Jeden Blockieren, fügen Sie einen hinzu IfFlow-Logikblock, der überprüft, ob der Status jedes Problems neu ist, und erstellt dann einen Fehlerdatensatz in der Testinstanz, dessen Zuweisungsgruppe und Kurzbeschreibung jedem neuen Problem aus der Produktionsinstanz zugeordnet ist.