メインコンテンツへスキップ

テストノード

フロー全体を公開する前に、フロー内の個々のノードからデータをテストできます。個々のノードをテストすることで、フローが本番環境で実行されるまで待たずに、誤った設定や権限の問題、不正なパラメータなどを早期に発見できます。例えば、EC2 の DescribeInstances ノードをテストして、期待どおりのインスタンスとフィールドが返されることを確認したり、リソースを削除またはタグ付けするステップをテストして、フルフローを実行したり他のステップへ影響を与えたりすることなく、正しい ID を対象にしているかを検証できます。

さらに、ノードのテスト出力を保存しておくことで、下流ノードをテストするときにそのデータを自動的に利用できるようにすることもできます。CloudFlow は、上流ノードからのデータを使用して、テスト用のペイロードを自動的に構築します。アクションノード (例: AWS や Google Cloud のノード) では、ノード設定を変更することなく、テスト用にカスタム入力パラメータを任意で使用できます。

注意

テストを実行すると、ノードの完全な実行が行われ、リソースの削除やデータの変更など、実際のアクションが開始される可能性があります。テストを実行する前、および下流ノードに進む前に、そのアクションの結果を十分に検討してください。

  • テストする前に、すべてのパラメータと接続を入力する必要があります。

  • アクションノードでは、ノード設定からのパラメータを使用するか、テスト専用に独自のパラメータを使用するかを選択できます。独自のパラメータを使用する場合、Test タブには現在のノードのパラメータがあらかじめ入力されます。これらを編集したり、(上流ノードからのデータなど) 追加のパラメータを追加したりできます。変数や他のノードへの参照は、テスト実行時に解決されます。

  • 下流ノードをテストする際に、あるノードのテストデータを利用可能にするには、Save as test data を選択してください。

  • ページネーションが有効な場合、テストモードでは結果が自動的に最大 100 アイテムに制限されます。この制限が適用されると、ノードはページネーションが制限されたことを示すメッセージをテスト結果に追加します。これにより、テストの実行が高速になり、開発中に大きなデータセットを取得することを避けられます。このリミットは実際のフロー実行には適用されません。公開されたフローは、設定されたとおりにすべてのページを取得します。

ノードをテストする

ノードをテストするには:

  1. ノード設定タブから Go to test を選択するか、Test タブを選択してください。

  2. (任意) アクションノードの場合: 現在のノード設定のパラメータを使用するか、独自のパラメータを使用するかを選択してください。独自のパラメータを使用する場合、Test タブには現在のノードのパラメータがあらかじめ入力されます。これらを編集したり、(上流ノードからのデータなど) 追加のパラメータを追加したりできます。変数や他のノードへの参照は、テスト実行時に解決されます。

    CloudFlow cutom test parameters

  3. (任意) 下流ノードをテストする際にテストデータを利用可能にするには、Save as test data を選択してください。

  4. Test を選択してください。

  5. Test results を選択して、ノードが期待どおりに動作しているか検証してください。

    Test results タブでは、CloudFlow は実行時のラップ構造内にノードの出力を表示します (例えば、resultsmessagecontext を含むエントリの配列など)。これは、そこに表示される JSON がノードが返す生の値そのものではなく、その値がこの構造でラップされたものであることを意味します。下流ノードは、Output schema で説明されているとおり、results[0] 内のペイロードを処理します。

    CloudFlow test results

  6. (任意) Test data を選択してください。次のことができます。

    • Copy を選択してテストデータをコピーします。例えば、テストの実行が遅い/コストが高いなどの理由でテストを実行したくないノードにテストデータが必要な場合、別の実行から既知のペイロードをそのノードのテストデータとして貼り付けることで、その下流のテストを実行できます。

    • Edit を選択してテストデータを編集します。例えば、別のユースケース (異なる ID、日付、フラグなど) をテストしたり、バグを再現したりしたい場合があります。その場合、テストデータを編集して再度テストを実行すれば、上流ノードを再実行する必要はありません。

  7. 下流ノードを編集して Test を選択してください。Save as test data を選択していた場合、参照ノードが一覧表示されます。

    CloudFlow downstream test results

  8. テストしたいフロー内の各ノードについて、これらの手順を繰り返してください。