選擇工作流程狀態

Choice 狀態 ("Type": "Choice") 會將條件式邏輯新增至狀態機器。

除了大多數常見的狀態欄位， Choice 狀態還包含下列其他欄位。

選擇規則 (JSONata)

Choice 狀態必須具有Choices一個欄位，其值為非空白的選擇規則陣列，其中包含使用 JSONata 時的下列欄位：

以下範例會檢查數值是否等於 1。

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

下列範例會檢查type變數是否等於 local。

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

以下範例會檢查字串是否大於 MyStringABC。

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

下列範例會檢查字串是否不是 null。

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

選擇規則 (JSONPath)

Choice 狀態必須具有Choices一個欄位，其值為選擇規則的非空白陣列，該欄位在使用 JSONPath 時包含下列欄位：

以下範例會檢查數值是否等於 1。

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

以下範例會檢查字串是否等於 MyString。

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

以下範例會檢查字串是否大於 MyStringABC。

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

下列範例會檢查字串是否為 null。

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

下列範例顯示 StringEquals 規則只有在 $.keyThatMightNotExist 存在時，才會因為上述IsPresent選擇規則而進行評估。

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

下列範例會檢查具有萬用字元的模式是否相符。

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

以下範例會檢查時間戳記是否等於 2001-01-01T12:00:00Z。

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

下列範例會將變數與狀態輸入的另一個值進行比較。

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

Step Functions 會依 Choices 欄位中列出的順序檢查每個選擇規則。然後轉換為第一個「選擇規則」的 Next 欄位中指定的狀態，在該規則中變數會根據比較運算子來比對值。

支援下列比較運算子：

對於每個運算子，對應的值必須是適當的類型：字串、數字、布林值或時間戳記。Step Functions 不會嘗試將數值欄位與字串值比對。不過，由於時間戳記欄位邏輯上為字串，因此 StringEquals 比較子可以比對被視為時間戳記的欄位。