レコードトリガーフロー、自動起動フロー、Data Cloud トリガーフローの自動テスト

フローのテスト

Flow Builder では、レコードトリガーフロー、自動起動フロー、Data Cloud トリガーフローの自動フローテストを作成、保存、実行できます。必要に応じて、テストが組織データに影響しないように、分離されたテストデータを使用できます。フローを変更するたびにテストを実行できます。

1. [フロー] リストビューを開きます。
   • [設定] で、[クイック検索] ボックスに「フロー」と入力して、[フロー] を選択します。
   • Automation アプリケーションから、[フロー] タブを選択します。
   • 任意の Lightning アプリケーションの [フロー] タブで、アクション メニューをクリックし、[フローを開く] を選択します。
2. テストするフローバージョンを開きます。
   • [設定] のフロー リスト画面で、テストするフローの [] をクリックし、[詳細とバージョンを表示] を選択して、[開く] をクリックします。
   • オートメーションまたは任意の Lightning アプリケーションのフロー リスト画面で、フローの [関連] タブをクリックします。テストするフローバージョンで、[] をクリックし、[フローを開く] を選択します。
3. [テストを表示] をクリックし、[作成] をクリックします。
4. [テストの詳細、トリガー、パスの設定] ウィンドウで、テストを設定します。
   1. テストの表示ラベル、API 参照名、および説明を入力します。
   2. [レコードが次の場合にテストを実行] で、[作成済み] または [更新済み] を選択します。
   3. [テストするフローバージョン] で、[選択されたフローバージョン] 列にフローバージョンを追加します。
      Flow Builder で現在開いているフローバージョンのフローテストが実行されます。フローテストは、選択した各フローバージョンで使用できます。

      
5. レコードトリガーフローと自動起動フローで分離されたテストデータを使用するには、[Test Setup (テストの設定)] をクリックし、[Run from Data Silo (データサイロから実行)] を選択して、@testSetupメソッドを持つ既存の Apex テストクラスを選択します。
   フローテストを作成する前に、テスト中に使用するレコードを挿入するテスト設定メソッドを含む Apex クラスを作成してリリースします。Apex クラスが表示されない場合は、テスト設定メソッドを使用する Apex クラスがありません。「分離されたテストデータを使用したテストフロー」セクションを参照してください。分離されたテストデータは、レコードトリガーフローと自動起動フローで使用できます。
6. 自動起動フローの場合は、[Set Test Input Values (テスト入力値の設定)] をクリックし、レコード、テキスト、数値などの各入力変数の値を設定します。
7. レコードトリガーフローと Data Cloud トリガーフローの場合は、[Set Initial Triggering Record] をクリックし、テストを最初にトリガーするレコードの値を入力します。
8. 更新されたレコードがテストの実行をトリガーする場合は、［Set Updated Trigger Record］ をクリックし、レコード値を入力します。
9. [アサーションを設定] をクリックし、各アサーションの条件とカスタム失敗メッセージを設定します。
10. 変更内容を保存して、[テストを表示] をクリックします。
    フローの所有者は、テストを最後に編集したユーザーに変更されます。
11. 設定したテストを選択し、[実行] をクリックします。
    Flow Builder でテストが実行され、[結果] 列に結果が表示されます。

分離されたテストデータを使用したフローのテスト

テスト設定メソッドを含むApexクラスからの再利用可能な専用テスト・データを使用して、レコード・トリガー・フローと自動起動フローのフロー・テストを実行します。実行の終了後、テストはApex単体テストのようにロールバックされるため、組織のライブ・データは元の状態に保たれます。

1. @isTest 注釈と、フローテスト中に使用するレコードを挿入する @testSetup メソッドを使用して、Apex クラスを作成します。

   たとえば、次の Apex クラスはテストアカウントを作成します。「Using Apex Test Setup Methods」を参照してください。

   @isTest
   global class CommonTestSetup {
     @testSetup
     global static void setup() {
       List<Account> accts = new List<Account>();
       for (Integer i = 1; i <= 2; i++) {
         accts.add(new Account(Name = 'Test Account ' + i));
       }
       insert accts;
     }
   }

   分離されたテストデータに一致するレコードが存在しないフローはテストできません。入力レコードは、分離されたテストデータにすでに存在するレコードを参照する必要があるため、このデータソースを使用して「レコードが見つかりません」パスをテストすることはできません。組織データを使用するテストとは異なり、分離されたテストデータの入力レコードの項目値はカスタマイズできません。分離されたテストデータでは、そのレコードが主要な項目によって選択され、そのまま使用されます。Apex @testSetupメソッドで、すべての主要なフィールドに入力します。重要な項目は、後の手順で選択します。

2. Flow Builder で、フローを開いて [テストを表示] をクリックし、[作成] をクリックするか、既存のフローテストを編集します。
3. [Test Setup (設定のテスト)] をクリックし、[Run from Data Silo (データサイロから実行)] を選択して、作成した Apex テストクラスを選択します。
   フローテストでは、データソースとして Apex クラスが使用されます。このテストでは、ロールバックで分離されたテストデータが使用されるため、組織データは変更されません。
   
4. テストで使用する各オブジェクトの主要な項目を選択します。
   分離されたオブジェクトの外部キー項目は、分離されたテストデータの一意のレコードを識別します。テストレコード ID は毎回実行後に変更されるため、これらの主要な項目はテスト実行時に入力レコードを分離されたテストデータと照合します。たとえば、Phone フィールドを取引先レコードを識別するキーフィールドとして使用します。
   
5. 分離されたテストデータの入力変数値を設定します。
6. アサーションやその他のテストの詳細を設定し、フローテストを保存して実行します。
   フローテストは、ライブ組織のデータではなく、データサイロ内の分離されたテストデータに対して実行されます。

エラー処理のためのフローのテスト

フローテストで、計画どおりにいかないフローパスを意図的にテストするネガティブアサーションを設定し、フローでエラーが正常に処理されることを確認します。

1. フローテストを作成します。
2. アサーションを設定するときに、レコードの作成、レコードの更新、レコードの削除、またはアクション要素のリソースを選択します。
3. [演算子] で、[エラーあり] を選択します。
4. 値を選択し、フローテストを保存します。

例

顧客データを処理するフローについて考えてみます。必須項目の欠落など、無効な入力がフローで処理されていることを確認するためのテストを作成できます。

フローテスト結果の解釈

フローテスト実行の完了後にフローテストの結果を解釈する方法を理解します。

1. テスト実行の詳細を表示するには、[] をクリックし、[Run Test and View Details (テスト実行と詳細の表示)] を選択します。
   [Test Run Details (テスト実行の詳細)] の [All Details (すべて詳細)] タブには、テスト実行全体の結果が表示されます。フローが失敗した場合は、フローエラーをトラブルシューティングします。
2. フローテストの状況を確認するには、[テスト実行の詳細] で [アサーション] タブを選択し、各アサーションを展開します。
   
   Flow Builder では、テスト実行のパスが強調表示されます (1)。[Test Run Details (テスト実行の詳細)] では、各アサーションが探している条件 (2)、それらの条件がチェックされた値 (括弧内) (3)、そのアサーションに定義したカスタムエラーメッセージ (4) が示されます。
3. 失敗したフローテストを解釈します。
   1. 失敗したアサーションの条件と条件評価を確認します。
      この例では、[優先度を高に設定] 要素で、失敗したアサーションは [$Record’s Priority ($Record の優先度)] 項目の値を [高] に設定します。
   2. 値を変更するには、要素をクリックし、[要素を編集] をクリックします。
      この例では、失敗したアサーションを修正するには、[優先度を高に設定] 要素を編集し、$Record の優先度を [高] に変更します。
   3. フローを保存し、失敗したフローテストを実行します。

例

このテストでは、オブジェクトが更新され、フローが即時実行パスを辿る場合に、フローを検証します。

テストには、トリガーレコードの初期値および更新値を設定する項目が含まれます。このレコードは、フローの実行をトリガーするレコードと同じレコードです。テストでは、テストでのみ使用されるレコードのコピーが作成されます。このレコードはデータベースには保存されません。

テストでは、各アサーションを評価して、フローが期待どおりに実行されていることを検証します。テストで評価できるのは、フロー要素が実行されたかどうかと、フローリソース値が期待どおりに設定されているかどうかのみです。このテストでは、Salesforce データベースの既存のデータと、ルールや制限などのカスタマイズに基づいてフローが評価されます。

フローにテストが含まれる場合、[テスト] リストビューには、フローのすべてのテストと、関連付けられたテスト結果が表示されます。

テストの実行が完了すると、[テスト実行の詳細] には各アサーションがどのように評価されたかが表示されます。条件が false に評価されると、アサーションとテストは失敗します。すべてのアサーションが合格すると、テストは合格します。

[すべての詳細] タブには、テスト実行全体の結果が表示されます。アサーションはテスト実行の終了時に評価されます。

フローテストの制限

フローごとに作成できるテストの数とフローテストの制限について説明します。