JSON-Paket

Das JSON-Paket ermöglicht es Ihnen, Informationen aus JSON-Datenquellen zu extrahieren und zu analysieren. Sie können damit JSON-Daten bearbeiten, z. B. Werte innerhalb einer JSON-Zeichenfolge hinzufügen oder aktualisieren, JSON-Zeichenfolgen mithilfe des Knotenpfads in Objekte umwandeln sowie JSON-Zeichenfolgen in Wörterbücher konvertieren und umgekehrt.

JSON-Paket spielt eine entscheidende Rolle bei der nahtlosen Integration von Automatisierungs-Workflows mit Webservices und APIs, die JSON für den Datenaustausch verwenden.

Vorteile

  • JavaScript Object Notation (JSON) ist ein schlankes, leicht verständliches und erweiterbares Format zum Speichern, Transportieren und Abrufen von Daten. JSON verwendet Schlüssel-Wert-Paare von Daten und bietet einen schnelleren Datenaustausch und schnellere Webservice-Ergebnisse.
  • Die meisten REST Web Services (APIs), einige Konfigurationsdateien und viele NoSQL-Datenbanken wie MongoDB verwenden üblicherweise JSON aufgrund seines flexiblen Formats für den Datenaustausch. Es ist textbasiert, schlank und verfügt über ein einfach zu analysierendes Datenformat. Das bedeutet, dass kein zusätzlicher Code erforderlich ist, um die bereitgestellten Daten zu verstehen und zu interpretieren.
  • JSON-Dateien eignen sich hervorragend zum Speichern und Abrufen von Konfigurationsdaten, auf die sich Ihre Automatisierung bei der Bestimmung von server- und umgebungsspezifischen Details oder der Freigabe von Ordnern beziehen kann.
  • Die flexible Struktur von JSON ermöglicht die effiziente Aufnahme verschiedener Datentypen und komplexer Datenhierarchien.

JSON-Datentypen

Die Werte in JSON müssen den folgenden Datentyp aufweisen:
  • Zeichenfolgen
  • Zahlen
  • Objekt (JSON-Objekt)
  • Array
  • Boolesche Werte
Anmerkung: Der Wert NULL wird in Automation 360 nicht unterstützt. Daher werden beim Extrahieren von JSON-Daten und deren Umwandlung in eine Wörterbuchvariable alle Nullwerte im JSON-String nicht konvertiert, da Wörterbuchvariablen keine Nullwerte unterstützen. Wenn das JSON jedoch eine leere Zeichenfolge ("") anstelle von null enthält, wird es erfolgreich in eine Wörterbuchvariable konvertiert.

Erläuterungen zu JSON-Strukturen

In JSON werden Daten hauptsächlich in zwei Strukturen gespeichert:
  • Objekte: Objekte in JSON sind Sammlungen von Schlüsseln, Wertepaaren in geschweiften Klammern {}. Jeder Schlüssel ist eine Zeichenkette, die in Anführungszeichen (““) eingeschlossen ist, gefolgt von einem Doppelpunkt (:), und Kommas (,) werden verwendet, um die Schlüssel-Wert-Paare zu trennen.
    Beispiel:
    {"name ": "John", "age": "30", "city": Detroit}
  • Arrays: Arrays sind geordnete Wertelisten, die in eckigen Klammern [] eingeschlossen sind. Werte innerhalb eines Arrays werden durch Kommas (,) getrennt.
    Beispiel:
    ["John", "Annie", "Shane"]

Verwenden des JSON-Pakets

Verwenden Sie die Aktionen im JSON-Paket in der folgenden Reihenfolge:
  1. Starten Sie die JSON-Sitzung mit der Aktion Sitzung starten. Verwenden Sie diesen Sitzungsnamen für alle entsprechenden Aktionen.
  2. Verwenden Sie die im JSON-Paket verfügbaren Aktionen, um JSON-bezogene Aufgaben zu automatisieren.
  3. Beenden Sie die Sitzung mit der Aktion Sitzung beenden, um eine Aufgabe abzuschließen.

Aktionen im JSON-Paket

Das JSON-Paket enthält folgende Aktionen:
Anmerkung: Wenn Sie eine Automatisierung auf der macOS-Plattform erstellen, fordert Sie ein Bestätigungsfenster auf, App-Berechtigungen in macOS zu erteilen. Siehe dieses Thema für eine Liste von Eingabemeldungen und Anleitungen zur Verwaltung von App-Berechtigungen.

Anwendungsberechtigungen auf macOS

Aktion Beschreibung
Sitzung starten Starte eine neue JSON-Sitzung basierend auf der angegebenen JSON-Datenquelle. Einzelheiten finden Sie unter Aktion „Sitzung starten“ in JSON.
Knotenwert hinzufügen Fügen Sie dem in Sitzung starten angegebenen JSON einen neuen Knoten hinzu. Einzelheiten finden Sie unter Knotenwert hinzufügen.
Wörterbuch in JSON umwandeln Konvertiert den Inhalt einer Wörterbuch-Variablen in das JSON-Format. Einzelheiten finden Sie unter Wörterbuch in JSON umwandeln.
JSON in Wörterbuch umwandeln Extrahieren Sie den Inhalt der JSON-Datenquelle in eine Wörterbuch-Variable. Einzelheiten finden Sie unter JSON in Wörterbuch umwandeln.
Knotenliste abrufen Ruft die Liste der Knoten für einen Knotenpfad ab. Einzelheiten finden Sie unter Aktion „Knotenliste abrufen“ in JSON.
Knotenpunkte abrufen Extrahiert die Schlüsselwerte aus der JSON-Quelle. Siehe Knoten in JSON abrufen
Knotenwert abrufen Ruft den Wert eines Knotens aus der JSON-Quelle ab. Einzelheiten finden Sie unter Aktion „Knotenwert abrufen“ in JSON.
Knotenwert aktualisieren Aktualisieren Sie den Wert eines Knotens in der JSON-Datenquelle. Einzelheiten finden Sie unter Knotenwert aktualisieren.
Validieren Überprüft die Syntax, Struktur und das Schema der JSON-Datenquelle. Siehe Aktion „Validieren“
Sitzung beenden Schließt eine JSON-Sitzung. Einzelheiten finden Sie unter Aktion „Sitzung beenden“ in JSON.

Weitere Ressourcen