Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Stato del workflow di scelta

Uno Choice stato ("Type": "Choice") aggiunge logica condizionale a una macchina a stati.

Oltre alla maggior parte dei campi di stato comuni, Choice states contiene i seguenti campi aggiuntivi.

Regole di scelta (JSonata)

Uno Choice stato deve avere un Choices campo il cui valore è un array non vuoto di Choice Rules, che contiene i seguenti campi quando si utilizza JSonata:

L'esempio seguente verifica se il valore numerico è uguale a 1.

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

L'esempio seguente verifica se la type variabile è uguale alocal.

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

L'esempio seguente verifica se la stringa è maggiore di MyStringABC.

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

L'esempio seguente verifica se la stringa non è nulla.

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

L'esempio seguente mostra uno Choice stato con Assign blocchi per regola che impostano variabili diverse in base alla condizione corrispondente:

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

L'utilizzo degli stati Assign with Choice

È possibile utilizzare il Assign campo a due livelli in uno stato Choice:

Questi due posizionamenti si escludono a vicenda in fase di esecuzione. Se una regola di scelta corrisponde, Step Functions valuta solo il Assign campo di quella regola e non valuta il campo di primo livelloAssign. Step Functions valuta il livello superiore Assign solo quando nessuna regola di scelta corrisponde e il flusso di lavoro passa allo stato. Default

L'esempio seguente mostra entrambi i posizionamenti.

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

In questo esempio, se $score è maggiore di 90, Step Functions outputValue assegna a "high score" e transizioni a. HighScoreState Il livello superiore non Assign viene valutato. Se nessuna regola corrisponde, Step Functions valuta il livello superiore Assign e passa a. LowScoreState

Regole di scelta (JsonPath)

Uno Choice stato deve avere un Choices campo il cui valore è una matrice non vuota di Choice Rules, che contiene i seguenti campi quando si utilizza JsonPath:

L'esempio seguente verifica se il valore numerico è uguale a 1.

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

L'esempio seguente verifica se la stringa è uguale a MyString.

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

L'esempio seguente verifica se la stringa è maggiore di MyStringABC.

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

L'esempio seguente verifica se la stringa è nulla.

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

L'esempio seguente mostra come la StringEquals regola viene valutata solo quando $.keyThatMightNotExist esiste a causa della precedente Choice Rule. IsPresent

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

L'esempio seguente verifica se un pattern con un carattere jolly corrisponde.

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

L'esempio seguente verifica se il timestamp è uguale a 2001-01-01T12:00:00Z.

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

L'esempio seguente confronta una variabile con un altro valore dell'input di stato.

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

Step Functions esamina ciascuna delle regole di scelta nell'ordine elencato nel Choices campo. Quindi passa allo stato specificato nel campo Next della prima regola Choice in cui la variabile corrisponde al valore in base all'operatore di confronto.

Sono supportati i seguenti operatori di confronto:

Per ciascuno di questi operatori, il valore corrispondente deve essere del tipo appropriato: stringa, numero, booleano o timestamp. Step Functions non tenta di abbinare un campo numerico a un valore stringa. Tuttavia, poiché i campi timestamp sono logicamente delle stringhe, è possibile che un campo considerato come timestamp possa corrispondere a un comparatore StringEquals.