Estado del flujo de trabajo de elección - AWS Step Functions
Reglas de Choice (JSONata)Reglas de Choice (JSONPath)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Estado del flujo de trabajo de elección

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.

El estado Choice ("Type": "Choice") agrega una lógica condicional a la máquina de estado.

Además de la mayoría de los campos de estado comunes, los estados Choice contienen los campos adicionales que se indican a continuación.

Choices (Obligatorio)

Matriz de reglas de Choice que determina qué estado provoca que la máquina de estado adopte el siguiente estado. Debe definir al menos una regla en el estado Choice.

Cuando se ejecuta un estado Choice, Step Functions evalúa cada regla de Choice como true o false. Según el resultado, Step Functions pasa al siguiente estado del flujo de trabajo.

Default (opcional, recomendado)

El nombre del estado al que se realizará la transición si ninguna de las reglas de Choice se evalúa como true.

importante

Los estados Choice no admiten el campo End. Además, solamente utilizan Next dentro del campo Choices.

Si ninguna opción de Choices se evalúa como true cuando se ejecuta el flujo de trabajo y no se proporciona ningún valor predeterminado, la máquina de estado generará un error debido a que no se pudo realizar la transición para salir del estado.

Reglas de Choice (JSONata)

Un estado Choice debe tener un campo Choices cuyo valor sea una matriz no vacía de reglas de Choice, que contenga los siguientes campos cuando se utilice JSONata:

  • Campo Condition: una expresión de JSONata que se evalúa como true/false.

  • Campo Next: un valor que debe coincidir con el nombre de un estado en la máquina de estado.

En el ejemplo siguiente, se comprueba si el valor numérico es igual a 1.

{
  "Condition": "{% $foo = 1 %}",
  "Next": "NumericMatchState"
}

En el ejemplo siguiente se comprueba si la variable type es igual a local.

{
  "Condition": "{% $type = 'local' %}",
  "Next": "StringMatchState"
}

En el ejemplo siguiente, se comprueba si la cadena es mayor que MyStringABC.

{
  "Condition": "{% $foo > 'MyStringABC' %}",
  "Next": "StringGreaterMatchState"
}

En el ejemplo siguiente se comprueba si la cadena no tiene un valor null.

{
 "Condition" : "{% $possiblyNullValue != null and $possiblyNullValue = 42 %}",
 "Next": "NotNullAnd42"
}

Reglas de Choice (JSONPath)

Un estado Choice debe tener un campo Choices cuyo valor sea una matriz no vacía de reglas de Choice, que contenga los siguientes campos cuando se utilice JSONPath:

  • Una comparación: dos campos que especifican la variable de entrada que se va a comparar, el tipo de comparación y el valor con el que se va a comparar la variable de entrada. Las reglas de Choice permiten la comparación entre dos variables. Dentro de una regla de Choice, el valor de la variable se puede comparar con otro valor de la entrada de estado añadiendo Path al nombre de los operadores de comparación compatibles. Los valores de los campos Variable y Ruta de una comparación deben ser rutas de referencia válidas.

  • Un campo Next: el valor de este campo debe coincidir con el nombre del estado en que se encuentra la máquina de estado.

En el ejemplo siguiente, se comprueba si el valor numérico es igual a 1.

{
  "Variable": "$.foo",
  "NumericEquals": 1,
  "Next": "FirstMatchState"
}

En el ejemplo siguiente, se comprueba si la cadena es igual a MyString.

{
  "Variable": "$.foo",
  "StringEquals": "MyString",
  "Next": "FirstMatchState"
}

En el ejemplo siguiente, se comprueba si la cadena es mayor que MyStringABC.

{
  "Variable": "$.foo",
  "StringGreaterThan": "MyStringABC",
  "Next": "FirstMatchState"
}

En el ejemplo siguiente, se comprueba si la cadena es nula.

{
 "Variable": "$.possiblyNullValue",
 "IsNull": true
}

En el ejemplo siguiente, se muestra cómo la regla StringEquals solo se evalúa cuando existe $.keyThatMightNotExist debido a la regla de Choice IsPresent anterior.

"And": [
 {
 "Variable": "$.keyThatMightNotExist",
 "IsPresent": true
 },
 {
 "Variable": "$.keyThatMightNotExist",
 "StringEquals": "foo"
 }
]

En el ejemplo siguiente, se comprueba si un patrón coincide con un comodín.

{
 "Variable": "$.foo",
 "StringMatches": "log-*.txt"
}

En el ejemplo siguiente, se comprueba si la marca de tiempo es igual a 2001-01-01T12:00:00Z.

{
  "Variable": "$.foo",
  "TimestampEquals": "2001-01-01T12:00:00Z",
  "Next": "FirstMatchState"
}

En el ejemplo siguiente, se compara una variable con otro valor de la entrada de estado.

{
 "Variable": "$.foo",
 "StringEqualsPath": "$.bar"
}

Step Functions examina cada una de las reglas de Choice en el orden en el que aparecen en el campo Choices. A continuación, adopta el estado especificado en el campo Next de la primera regla de Choice en la que la variable coincide con el valor que corresponde al operador de comparación.

Se admiten los siguientes operadores de comparación:

  • And

  • BooleanEquals,BooleanEqualsPath

  • IsBoolean

  • IsNull

  • IsNumeric

  • IsPresent

  • IsString

  • IsTimestamp

  • Not

  • NumericEquals,NumericEqualsPath

  • NumericGreaterThan,NumericGreaterThanPath

  • NumericGreaterThanEquals,NumericGreaterThanEqualsPath

  • NumericLessThan,NumericLessThanPath

  • NumericLessThanEquals,NumericLessThanEqualsPath

  • Or

  • StringEquals,StringEqualsPath

  • StringGreaterThan,StringGreaterThanPath

  • StringGreaterThanEquals,StringGreaterThanEqualsPath

  • StringLessThan,StringLessThanPath

  • StringLessThanEquals,StringLessThanEqualsPath

  • StringMatches

  • TimestampEquals,TimestampEqualsPath

  • TimestampGreaterThan,TimestampGreaterThanPath

  • TimestampGreaterThanEquals,TimestampGreaterThanEqualsPath

  • TimestampLessThan,TimestampLessThanPath

  • TimestampLessThanEquals,TimestampLessThanEqualsPath

En cada uno de estos operadores, el valor correspondiente debe ser del tipo adecuado: cadena, número, booleano o marca de tiempo. Step Functions no intenta asociar un campo numérico con un valor de cadena. Sin embargo, como los campos de marca de tiempo son cadenas, es posible que un campo que se considera una marca de tiempo cumpla una condición establecida con un comparador StringEquals.

nota

Por motivos de interoperabilidad, no presuponga que las comparaciones numéricas funcionan con valores que están fuera del rango de magnitud o precisión que el tipo de datos binary64 de IEEE 754-2008 representa. En particular, es posible que los enteros que están fuera del rango [-253+1, 253-1] no puedan compararse del modo esperado.

Las marcas de tiempo (por ejemplo, 2016-08-18T17:33:00Z) deben ajustarse al perfil RFC3339 de ISO 8601, con restricciones adicionales:

  • Las partes de fecha y hora deben separarse con una letra T mayúscula.

  • Debe utilizarse una letra Z mayúscula para indicar que no se aplica ningún ajuste numérico de zona horaria.

Para comprender el comportamiento de comparación de cadenas, consulte la documentación de Java compareTo.

Los valores de los operadores And y Or deben ser matrices de reglas de Choice que no estén vacías y que no contengan campos Next. Del mismo modo, el valor de un operador Not tiene que ser una única regla de Choice que no debe contener campos Next.

Puede crear reglas de Choice anidadas y complejas utilizando And, Not y Or. Sin embargo, el campo Next solamente puede aparecer en las reglas de Choice de nivel superior.

La comparación de cadenas con patrones con uno o más caracteres comodín (“*”) se puede realizar con el operador de comparación StringMatches. Se aplica escape al carácter comodín de manera estándar con \\ (Ex: “\\*”). Ningún otro carácter que no sea “*” tiene un significado especial para la coincidencia.