4 Funcionalidad JSONPath

Descripción general

Esta sección describe la funcionalidad JSONPath compatible dentro de los pasos de preprocesamiento de valores de métricas.

JSONPath se compone de segmentos separados por puntos. Un segmento puede tomar la forma de una palabra simple, que representa un nombre de valor JSON, el carácter comodín (*), o una construcción más compleja encerrada entre corchetes. El punto antes de un segmento entre corchetes es opcional y puede omitirse.

Véase también: Escapando caracteres especiales de valores de macros LLD en JSONPath.

Segmentos soportados

Para encontrar un segmento coincidente ignorando su ascendencia (segmento separado), debe ir precedido de dos puntos (..). Por ejemplo, $..name o $..['name'] devuelven los valores de todas las propiedades name.

Los nombres de los elementos coincidentes pueden extraerse añadiendo un sufijo de tilde (~) a la JSONPath. Devuelve el nombre del objeto coincidente o un índice en formato de cadena del elemento del array coincidente. El formato de salida sigue las mismas reglas que otras consultas JSONPath: los resultados de rutas definidas se devuelven 'tal cual', y los resultados de rutas indefinidas se devuelven en un array. Sin embargo, tiene un valor mínimo extraer el nombre de un elemento que coincide con una ruta definitiva, ya que ya se conoce.

Expresión de filtro

La expresión de filtro es una expresión aritmética en notación infija.

Operandos soportados:

Operadores soportados:

Funciones

Las funciones pueden usarse al final de JSONPath. Se pueden encadenar múltiples funciones si la función anterior devuelve un valor que es aceptado por la siguiente función.

Funciones soportadas:

Las funciones de agregación de JSONPath aceptan valores numéricos entre comillas. Estos valores se convierten automáticamente de cadenas a tipos numéricos cuando se necesita la agregación. Una entrada incompatible hará que la función genere un error.

Valor de salida

Los JSONPaths pueden dividirse en rutas definidas e indefinidas. Una ruta definida solo puede devolver null o una coincidencia única. Una ruta indefinida puede devolver múltiples coincidencias: JSONPaths con listas de nombres/índices separadas, cortes de arrays o segmentos de expresión. Sin embargo, cuando se utiliza una función, el JSONPath se convierte en definido, ya que las funciones siempre devuelven un único valor.

Una ruta definida devuelve el objeto/array/valor al que hace referencia. En cambio, una ruta indefinida devuelve un array de los objetos/arrays/valores coincidentes.

Reglas de formato de ruta

Los espacios en blanco (espacio, carácter de tabulación) pueden usarse en los segmentos de notación de corchetes y expresiones, por ejemplo: $[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first( ).

Las cadenas deben ir entre comillas simples (') o dobles ("). Dentro de las cadenas, las comillas simples o dobles (dependiendo de cuáles se utilicen para encerrarlas) y las barras invertidas (\) se escapan con el carácter de barra invertida (\).

Ejemplo

{
         "books": [
           {
             "category": "referencia",
             "author": "Nigel Rees",
             "title": "Dichos del Siglo",
             "price": 8.95,
             "id": 1
           },
           {
             "category": "ficción",
             "author": "Evelyn Waugh",
             "title": "Espada de Honor",
             "price": 12.99,
             "id": 2
           },
           {
             "category": "ficción",
             "author": "Herman Melville",
             "title": "Moby Dick",
             "isbn": "0-553-21311-3",
             "price": 8.99,
             "id": 3
           },
           {
             "category": "ficción",
             "author": "J. R. R. Tolkien",
             "title": "El Señor de los Anillos",
             "isbn": "0-395-19395-8",
             "price": 22.99,
             "id": 4
           }
         ],
         "services": {
           "delivery": {
             "servicegroup": 1000,
             "description": "Entrega al día siguiente en la ciudad local",
             "active": true,
             "price": 5
           },
           "bookbinding": {
             "servicegroup": 1001,
             "description": "Impresión y encuadernación del libro en formato A5",
             "active": true,
             "price": 154.99
           },
           "restoration": {
             "servicegroup": 1002,
             "description": "Varios métodos de restauración",
             "active": false,
             "methods": [
               {
                 "description": "Limpieza química",
                 "price": 46
               },
               {
                 "description": "Prensado de páginas dañadas por humedad",
                 "price": 24.5
               },
               {
                 "description": "Reencuadernación de libro rasgado",
                 "price": 99.49
               }
             ]
           }
         },
         "filters": {
           "price": 10,
           "category": "ficción",
           "no filters": "sin \"filtros\""
         },
         "closed message": "La tienda está cerrada",
         "tags": [
           "a",
           "b",
           "c",
           "d",
           "e"
         ]
       }