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

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.

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:

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"
}

El siguiente ejemplo muestra un Choice estado con Assign bloques por regla que establecen diferentes variables en función de la condición coincidente:

{
  "Type": "Choice",
  "Choices": [
    {
      "Condition": "{% $states.input.category = 'premium' %}",
      "Next": "PremiumPath",
      "Assign": {
        "discount": 20
      }
    },
    {
      "Condition": "{% $states.input.category = 'standard' %}",
      "Next": "StandardPath",
      "Assign": {
        "discount": 5
      }
    }
  ],
  "Default": "DefaultPath",
  "Assign": {
    "discount": 0
  }
}

Uso de los estados Assign with Choice

Puede utilizar el Assign campo en dos niveles en un estado de elección:

Estas dos ubicaciones se excluyen mutuamente en tiempo de ejecución. Si una regla de elección coincide, Step Functions evalúa solo el Assign campo de esa regla y no evalúa el campo de nivel superiorAssign. Step Functions evalúa el nivel superior Assign solo cuando no coincide ninguna regla de elección y el flujo de trabajo pasa al Default estado.

En el siguiente ejemplo, se muestran ambas ubicaciones.

{
  "Type": "Choice",
  "Assign": {
    "outputValue": "{% 'default path taken' %}"
  },
  "Choices": [
    {
      "Condition": "{% $score > 90 %}",
      "Assign": {
        "outputValue": "{% 'high score' %}"
      },
      "Next": "HighScoreState"
    },
    {
      "Condition": "{% $score > 50 %}",
      "Next": "MediumScoreState"
    }
  ],
  "Default": "LowScoreState"
}

En este ejemplo, si $score es mayor que 90, Step Functions asigna outputValue "high score" y realiza transiciones aHighScoreState. El nivel superior no Assign se evalúa. Si ninguna regla coincide, Step Functions evalúa el nivel superior Assign y pasa a él. LowScoreState

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:

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
}

El siguiente ejemplo muestra cómo la StringEquals regla solo se evalúa cuando $.keyThatMightNotExist existe debido a la regla de IsPresent elección 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:

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.