JSON-package

Das JSON-package 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-package 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-packages

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

Actions im JSON-package

Das JSON-package enthält folgende actions:
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

Action Beschreibung
Sitzung starten Starte eine neue JSON-Sitzung basierend auf der angegebenen JSON-Datenquelle. Einzelheiten finden Sie unter action „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 action „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 action „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 action „Sitzung beenden“ in JSON.

Weitere Ressourcen