Uso de rutas JSONPath - AWS Step Functions
Rutas de referencia

Uso de rutas JSONPath

Administración del estado y transformación de los datos

Obtenga información sobre la Transmisión de datos entre estados con variables y la Transformación de datos con JSONata.

En Amazon States Language, una ruta es una cadena que comienza por $ y se puede utilizar para identificar componentes en el texto JSON. Las rutas siguen la sintaxis de JSONPath, que solo está disponible cuando QueryLanguage se establece en JSONPath. Puede especificar una ruta para acceder a los subconjuntos de la entrada al especificar valores para InputPath, ResultPath y OutputPath.

Debe utilizar la notación entre corchetes si el nombre de campo contiene algún carácter que no esté incluido en la definición member-name-shorthand de la regla JSONPath ABNF. Por lo tanto, para codificar caracteres especiales, como los signos de puntuación (excepto_), debe utilizar la notación entre corchetes. Por ejemplo, $.abc.['def ghi'].

Rutas de referencia

Una ruta de referencia es una ruta cuya sintaxis está limitada de tal forma que solo puede identificar un único nodo en una estructura JSON:

  • Solo puede obtener acceso a los campos de objeto con la notación de punto (.) y corchete ([ ]).

  • Funciones como length() no son compatibles.

  • Los operadores léxicos, que no son simbólicos, como subsetof no están admitidos.

  • No se admite el filtrado por expresiones regulares o por referencia a otro valor de la estructura JSON.

  • Los operadores @, ,, : y ? no son compatibles

Por ejemplo, si los datos de entrada del estado contienen los valores siguientes:

{
  "foo": 123,
  "bar": ["a", "b", "c"],
  "car": {
      "cdr": true
  }
}

Las siguientes rutas de referencia devolverían lo siguiente.

$.foo => 123
$.bar => ["a", "b", "c"]
$.car.cdr => true

Algunos estados utilizan rutas y rutas de referencia para controlar el flujo de una máquina de estado o para configurar los valores o las opciones del estado. Para obtener más información, consulte Modelado del procesamiento de las rutas de entrada y salida del flujo de trabajo con un simulador de flujo de datos y Uso eficiente de JSONPath de forma eficaz en AWS Step Functions

Aplanamiento de una matriz de matrices

Si el estado Estado Parallel de un flujo de trabajo o Estado del flujo de trabajo Map de las máquinas de estado devuelve una matriz de matrices, puede transformarlas en una matriz plana con el campo ResultSelector. Puede incluir este campo dentro de la definición de estados Parallel o Map para manipular el resultado de estos estados.

Para aplanar matrices, utilice la sintaxis: [*] en el campo ResultSelector, como se muestra en el siguiente ejemplo.

"ResultSelector": {
    "flattenArray.$": "$[*][*]"
  }

Para ver ejemplos que muestran cómo aplanar una matriz, consulte el Paso 3 de los siguientes tutoriales: