翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS Step Functions Workflow Studio の使用
<a name="stepfunctions-workflowstudio"></a>

以下のセクションでは、 で AWS Step Functions Workflow Studio を使用する方法について説明します AWS Toolkit for Visual Studio Code。 AWS Step Functions Workflow Studio の詳細については、「 デベロ*AWS Step Functions*ッパーガイド」の[「ワークフローの開発](https://docs.aws.amazon.com//step-functions/latest/dg/developing-workflows.html)」トピックを参照してください。

## Workflow Studio を開く
<a name="w2aac17c55b9b5"></a>

次のリストでは、VS Code で Workflow Studio を開くために使用できるさまざまなパスについて説明します。

**注記**  
VS Code で Workflow Studio を使用するには、ステートマシン定義を含む `Amazon State Language`(ASL) ファイルの拡張子が `asl.json`、`asl.yml`、`asl.yaml` で終わる必要があります。 AWS Toolkit で新しいステートマシン定義をダウンロードまたは作成する方法の詳細については、このユーザーガイドの[「 の使用 AWS Step Functions](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/building-stepfunctions.html)」トピックの*「ステートマシンのダウンロード*」セクションと*「ステートマシンの作成*」セクションを参照してください。
+  AWS Explorer から、ステートマシン定義を含む`ASL`ファイルのコンテキストメニューを開き (右クリック）、**Workflow Studio で開く**を選択します。
+ ステートマシン定義を含む、開いた状態の `ASL` ファイルから、VS Code エディタウィンドウのタブの横にある **[Workflow Studio で開く]** アイコンを選択します。
+ ステートマシン定義を含む、開いた状態の `ASL` ファイルから、ファイルの上部にある **Open with Workflow Studio** の CodeLens コマンドを選択します。
+ ステートマシン定義を含む `ASL` ファイルを閉じてから再度開くと、デフォルトの Workflow Studio を手動で無効にしない限り、Workflow Studio でファイルが自動的に再度開きます。

## 設計モードとコードモード
<a name="w2aac17c55b9b7"></a>

Workflow Studio には、ステートマシン定義を含む `ASL` ファイルを操作するためのモードが 2 つあります。**[設計]** モードと **[コード]** モードです。[**設計**] モードには、プロトタイプを作成する際にワークフローを可視化するグラフィカルインターフェイスがあります。**[コード]** モードには、ワークフローの `ASL` 定義を表示、書き込み、編集できるコードエディタが統合されています。

**注記**  
設計モードとコードモードの各 UI セクションの詳細については、「*AWS Step Functions* デベロッパーガイド」の「[Workflow Studio の使用](https://docs.aws.amazon.com//step-functions/latest/dg/workflow-studio.html)」トピックを参照してください。たとえば、**Config モード**など、すべての Workflow Studio 機能が AWS Toolkit で使用できるわけではありません。

**[設計]** モードの UI には、次の図でラベル付きで説明されているように、7 つの主要セクションがあります。

1. モードボタン: **[設計]** モードと **[コード]** モードを切り替えるためのボタン。

1. ユーティリティボタン: Workflow Studio の終了、ワークフローの保存、JSON ファイルや YAML ファイル への `ASL` 定義のエクスポートなどのタスクを実行するための一連のボタン。

1. デザインツールバー : 取り消し、削除、ズームコントールなどの一般的なアクションを実行する一連のボタンを含むツールバー。

1. ステートブラウザ: ワークフローキャンバスにステートをドラッグアンドドロップできるブラウザ。ステートはタブに整理され、**アクション**、**フロー**、**パターン**として定義されます。

1. キャンバスとワークフローグラフ: 設定のステートを削除、再編成、選択できるワークフローの視覚的なレンダリング。

1. Inspector パネル: キャンバスで選択したステートのプロパティを表示および編集。キャンバスワークフローグラフで選択されたステートに応じて、**設定**、**入力/出力**、**変数**、**エラー処理**のステート固有のオプションがタブに入力されます。

1. 情報リンク: ヘルプが必要なときにコンテキスト情報を含むパネルを表示。これらのパネルには、「*AWS Step Functions* デベロッパーガイド」の関連トピックへのリンクも含まれています。

![\[Toolkit の Workflow Studio UI の設計モード AWS\]](http://docs.aws.amazon.com/ja_jp/toolkit-for-vscode/latest/userguide/images/SFNWFS022025.png)


## 設計中の単一ステートテストの使用
<a name="w2aac17c55b9b9"></a>

Workflow Studio のテストステート UI から、ステートマシンの個々のステートをテストできます。これには、状態入力の提供、変数の設定、 と AWS SAM CloudFormation 定義の両方の置換を行う機能が含まれます。

コードとしてのインフラストラクチャ (IaC)、リソース定義、データの変換の詳細については、「 *AWS Step Functions*デベロッパーガイド」の[「Step Functions ワークフローを構築 AWS SAM するための の使用](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-sam-sfn.html)」および[「Step Functions トピックの JSONata を使用したデータの変換](https://docs.aws.amazon.com/step-functions/latest/dg/transforming-data.html)」を参照してください。

次の手順では、Workflow Studio でテストステート UI を開く方法について説明します。

**テストステート UI を開く**

1. Workflow Studio の **[設計]** モードタブからキャンバスに移動し、ステートを選択して **[Inspector]** パネルで開きます。

1. **[Inspector]** パネルから、**[テストステート]** ボタンを選択します。

1. VS Code で **[Test state]** UI が開きます。

テストステート UI には、**[Test input]**、**[Arguments & Output]**、**[State definition]** の 3 つのメインタブがあります。**テスト入力**タブには、**状態入力**を提供したり、**変数**を設定したり、 AWS SAM または CloudFormation テンプレートから**定義の置換**を指定したりできる 3 つの追加フィールドがあります。**[State definition]** タブでは、ワークフローを調整して再テストできます。テストの実行が完了したら、ステートマシン定義に変更を適用して保存できます。

次のスクリーンショットは、トピックリソース定義を含むテストステート UI を示しています。

![\[Toolkit の Workflow Studio テスト状態 UI AWS\]](http://docs.aws.amazon.com/ja_jp/toolkit-for-vscode/latest/userguide/images/SFNWFSteststate022025.png)


## デフォルトで Workflow Studio を無効にする
<a name="w2aac17c55b9c11"></a>

デフォルトでは、Workflow Studio はステートマシン定義を含む `ASL` ファイルのデフォルトのエディタです。ローカル `.vscode` ディレクトリの `settings.json` ファイルを変更することで、デフォルト設定を無効にすることができます。Workflow Studio をデフォルトで無効にしても、このトピックにある「*Workflow Studio を開く*」セクションに記載されている方法でアクセスできます。

VS Code から `settings.json` ファイルを編集するには、次の手順を実行します。

1. VS Code で **option\$1shift\$1p** (Mac) または **ctrl\$1shift\$1p** (Windows) を押して、**コマンドパレット**を開きます。

1. VS Code **コマンドパレット**で検索フィールドに **Open User Settings (JSON)** を入力し、リストに表示されたらそのオプションを選択します。

1. エディタの `settings.json` から、ファイルに次の変更を追加します。

   ```
                   {
                       "workbench.editorAssociations": {
                       // Use all the following overrides or a specific one for a certain file type        
                       "*.asl.json": "default",
                       "*.asl.yaml": "default",
                       "*.asl.yml": "default"
                       }
                   }
   ```

1. 変更を `settings.json` に保存し、VS Code を更新または再起動します。