本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 AWS Step Functions
<a name="building-stepfunctions"></a>

下列各節說明如何使用 AWS Step Functions `Amazon State Language (ASL)` AWS Toolkit 中包含狀態機器定義的檔案。如需 AWS Step Functions 狀態機器的詳細資訊，請參閱《 *AWS Step Functions*開發人員指南》[中的 Step Functions 中的了解狀態機器](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-statemachines.html)主題。

## 檢視 Step Functions 狀態機器
<a name="starting-sfn-list"></a>

若要在 AWS Toolkit Explorer 中檢視包含狀態機器定義的現有`ASL`檔案，請完成下列步驟。

1. 從 AWS Toolkit Explorer 中，展開包含您要檢視之`ASL`檔案的區域。

1. 展開 **Step Functions** 標題。

1. 您的`ASL`檔案會顯示在 AWS Explorer 中。

## 建立 Step Functions 狀態機器
<a name="starting-sfn-create"></a>

在 AWS Toolkit 中，您可以從 檔案建立新的 Step Functions 狀態機器，也可以使用 範本。下列程序說明如何從 檔案建立 Step Functions 狀態機器。如需從範本建立 SFN； 狀態機器的詳細資訊，請參閱本使用者指南主題中的下列*狀態機器範本*一節。

**注意**  
若要在 VS 程式碼中使用 Step Functions，包含狀態機器定義的 `Amazon State Language`(ASL) 檔案副檔名必須以 `asl.json`、 `asl.yml`或 結尾`.asl.yaml`。  
根據預設，相關的 Step Functions 檔案會在 Workflow Studio 中開啟。如需透過 AWS Toolkit 在 Workflow Studio 中運作的詳細資訊，請參閱本使用者指南中的[使用 Workflow Studio](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/stepfunctions-workflowstudio.html) 主題。

1. 在 VS 程式碼的工作區中，建立新的檔案。

1. 為您的檔案命名，並將副檔名指定為 `asl.json`、 `asl.yml`或 `.asl.yaml`。

1. 建立時， AWS Toolkit 會在 AWS Step Functions Workflow Studio 中開啟新檔案。

1. 從 **Workflow Studio** 選擇公用程式功能表中的**儲存**按鈕，以儲存您的新`ASL`檔案。

## 從範本建立 Step Functions 狀態機器
<a name="templates-stepfunctions"></a>

在 AWS Toolkit 中，您可以從範本建立 Step Functions 狀態機器。範本程序會建立包含狀態機器定義的`ASL`檔案，為您的專案提供起點。下列程序說明如何從 AWS Toolkit 中的範本建立 Step Functions 狀態機器。

1. 從 AWS Toolkit Explorer 中，展開您要在其中建立 Step Functions 狀態機器的區域。

1. 開啟 （按一下滑鼠右鍵） **Step Functions **的內容選單，然後選擇**建立新的 Step Functions 狀態機器**，以在 VS 程式碼中開啟**選取入門範本 (1/2)** 精靈。

1. 從**選取入門範本 (1/2)** 精靈中，選擇 Step Functions 狀態機器的範本類型以繼續。

1. 在**選取範本格式 (2/2)** 畫面中，為您的範本格式選擇 **YAML** 或 **JSON**。

1. 包含狀態機器定義的新`ASL`檔案會在 VS 程式碼編輯器中開啟。

## 下載 Step Functions 狀態機器
<a name="sfn-download"></a>

若要將遠端儲存的 Step Functions 狀態機器下載至 VS Code 的本機執行個體，請完成下列步驟。

1. 從 AWS Toolkit Explorer 中，展開包含您要下載之 Step Functions 狀態機器的區域。

1. 展開 **Step Functions**，然後在您要下載的 Step Functions 狀態機器上按一下滑鼠右鍵，然後選擇**下載定義...**。

1. 指定在本機存放 Step Functions 狀態機器的位置以繼續。

1. 當程序完成時，Step Functions 狀態機器會在 Workflow Studio 中開啟。

## 將變更儲存至 Step Functions 狀態機器
<a name="starting-sfn-update"></a>

下列程序說明如何儲存對 Step Functions 狀態機器所做的變更。

**注意**  
在 Workflow Studio 同步至本機檔案時所做的編輯，但在 VS Code 編輯器或 Workflow Studio 中儲存您的工作之前，不會儲存。如果您在 Workflow Studio 開啟時修改並儲存本機檔案，且您的`ASL`檔案中未偵測到任何錯誤，則在儲存完成時，您會在 Workflow Studio 中收到**成功**通知。不過，如果您的本機檔案包含無效 `JSON`或 `YAML`且您嘗試儲存，則本機檔案無法同步，且您在 Workflow Studio 中會收到**警告**通知。

1. 從 Workflow Studio 中包含狀態機器定義的開啟`ASL`檔案，導覽至**公用程式按鈕**。

1. 選擇 **Save (儲存)** 按鈕。

1. VS 程式碼會在檔案儲存時通知您。

## 執行 Step Functions 狀態機器
<a name="starting-sfn-execute"></a>

下列程序說明如何在 AWS Toolkit 中執行 Step Functions 狀態機器。

1. 從 AWS Toolkit Explorer 中，展開包含您要執行之 Step Functions 狀態機器的區域。

1. 展開 **Step Functions**，然後在您要執行的 Step Functions 狀態機器上按一下滑鼠右鍵。

1. 從內容功能表中，選擇**開始執行**以啟動啟動程序。

1. 啟動狀態會顯示在 VS 程式碼的 **AWS Toolkit Output** 視窗中。

## 使用程式碼片段
<a name="building-stepfunctions-code-snippets"></a>

程式碼片段是根據您正在處理的程式碼產生的自動化建議。若要在工具組中搭配 Step Functions 使用程式碼片段，請完成下列步驟。

**注意**  
若要在 VS 程式碼中使用 Step Functions 程式碼片段，包含狀態機器定義的`ASL`檔案副檔名必須以 `.asl.json`、 `.asl.yml`或 結尾`.asl.yaml`。  
根據預設，相關的 Step Functions 檔案會在 Workflow Studio 中開啟。

1. 從 VS 程式碼中，開啟包含您要修改或建立新`ASL`檔案之狀態機器定義的`ASL`檔案。

1. 如果您處於**設計**模式，請從 Workflow Studio 切換至**程式碼**模式。

1. 從 Workflow Studio 程式碼編輯器，將游標放在 `"States"` 屬性中。

1. 按 **control \+ space**開啟程式碼片段功能表，可按 **control \+ space**以根據 `"State"` 存取其他屬性`"Type"`。

1. 從清單中選擇您想要的程式碼片段。

## 程式碼驗證
<a name="building-stepfunctions-code-completion"></a>

當您在 Workflow Studio 中處理 Step Functions 時，程式碼驗證會主動識別錯誤，並針對下列項目提出建議：
+ 缺少屬性
+ 不正確的值
+ 非終端機狀態
+ 指向不存在的狀態