4 JSONPath-Funktionalität

Übersicht

Dieser Abschnitt beschreibt die unterstützte JSONPath-Funktionalität innerhalb der Vorverarbeitungsschritte von Datenpunkt-Werten.

JSONPath besteht aus Segmenten, die durch Punkte getrennt sind. Ein Segment kann die Form eines einfachen Wortes annehmen, das einen JSON-Wertnamen darstellt, des Platzhalterzeichens (*) oder eines komplexeren Konstrukts in eckigen Klammern. Der Punkt vor einem in Klammern gesetzten Segment ist optional und kann weggelassen werden.

Siehe auch: Escaping special characters from LLD macro values in JSONPath.

Unterstützte Segmente

Um ein passendes Segment unabhängig von seiner Herkunft zu finden (detached segment), muss ihm mit zwei Punkten (..) vorangestellt werden. Zum Beispiel geben $..name oder $..['name'] die Werte aller name-Eigenschaften zurück.

Namen abgeglichener Elemente können extrahiert werden, indem dem JSONPath ein Tilde-Suffix (~) hinzugefügt wird. Dabei wird der Name des abgeglichenen Objekts oder ein Index des abgeglichenen Array-Elements im Zeichenfolgenformat zurückgegeben. Das Ausgabeformat folgt denselben Regeln wie bei anderen JSONPath-Abfragen – Ergebnisse eines definitiven Pfads werden unverändert zurückgegeben, und Ergebnisse eines nicht definitiven Pfads werden in einem Array zurückgegeben. Allerdings hat das Extrahieren des Namens eines Elements, das einem definitiven Pfad entspricht, nur einen geringen Nutzen, da dieser bereits bekannt ist.

Filterausdruck

Der Filterausdruck ist ein arithmetischer Ausdruck in Infixnotation.

Unterstützte Operanden:

Unterstützte Operatoren:

Funktionen

Funktionen können am Ende von JSONPath verwendet werden. Mehrere Funktionen können verkettet werden, wenn die vorhergehende Funktion einen Wert zurückgibt, der von der nachfolgenden Funktion akzeptiert wird.

Unterstützte Funktionen:

JSONPath-Aggregatfunktionen akzeptieren numerische Werte in Anführungszeichen. Diese Werte werden automatisch von Zeichenfolgen in numerische Typen umgewandelt, wenn eine Aggregation erforderlich ist. Nicht kompatible Eingaben führen dazu, dass die Funktion einen Fehler erzeugt.

Ausgabewert

JSONPaths können in bestimmte und unbestimmte Pfade unterteilt werden. Ein bestimmter Pfad kann nur null oder eine einzelne Übereinstimmung zurückgeben. Ein unbestimmter Pfad kann mehrere Übereinstimmungen zurückgeben: JSONPaths mit losgelösten Segmenten, mehreren Namens-/Indexlisten, Array-Slices oder Ausdruckssegmenten. Wird jedoch eine Funktion verwendet, wird der JSONPath zu einem bestimmten Pfad, da Funktionen immer einen einzelnen Wert ausgeben.

Ein bestimmter Pfad gibt das Objekt/Array/den Wert zurück, auf das/den er verweist. Im Gegensatz dazu gibt ein unbestimmter Pfad ein Array der übereinstimmenden Objekte/Arrays/Werte zurück.

Regeln für die Pfadformatierung

Leerzeichen (Leerzeichen, Tabulatorzeichen) können in Segmenten und Ausdrücken der Klammernotation verwendet werden, zum Beispiel: $[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first( ).

Zeichenfolgen sollten in einfache (') oder doppelte (") Anführungszeichen gesetzt werden. Innerhalb der Zeichenfolgen werden einfache oder doppelte Anführungszeichen (je nachdem, welche zum Einschließen verwendet werden) und Backslashes (\) mit dem Backslash-Zeichen (\) maskiert.

Beispiel

{
  "books": [
    {
      "category": "Referenz",
      "author": "Nigel Rees",
      "title": "Sprüche des Jahrhunderts",
      "price": 8.95,
      "id": 1
    },
    {
      "category": "Belletristik",
      "author": "Evelyn Waugh",
      "title": "Sword of Honour",
      "price": 12.99,
      "id": 2
    },
    {
      "category": "Belletristik",
      "author": "Herman Melville",
      "title": "Moby Dick",
      "isbn": "0-553-21311-3",
      "price": 8.99,
      "id": 3
    },
    {
      "category": "Belletristik",
      "author": "J. R. R. Tolkien",
      "title": "Der Herr der Ringe",
      "isbn": "0-395-19395-8",
      "price": 22.99,
      "id": 4
    }
  ],
  "services": {
    "delivery": {
      "servicegroup": 1000,
      "description": "Lieferung am nächsten Tag in der Stadt",
      "active": true,
      "price": 5
    },
    "bookbinding": {
      "servicegroup": 1001,
      "description": "Drucken und Zusammenstellen eines Buches im A5-Format",
      "active": true,
      "price": 154.99
    },
    "restoration": {
      "servicegroup": 1002,
      "description": "Verschiedene Restaurierungsmethoden",
      "active": false,
      "methods": [
        {
          "description": "Chemische Reinigung",
          "price": 46
        },
        {
          "description": "Pressen von durch Feuchtigkeit beschädigten Seiten",
          "price": 24.5
        },
        {
          "description": "Neubinden eines zerrissenen Buches",
          "price": 99.49
        }
      ]
    }
  },
  "filters": {
    "price": 10,
    "category": "Belletristik",
    "no filters": "keine \"Filter\""
  },
  "closed message": "Geschäft ist geschlossen",
  "tags": [
    "a",
    "b",
    "c",
    "d",
    "e"
  ]
}