Test Studio の操作
このクイックスタートでは、Kudos というキャンバス アプリを対象にしたテストを作成します。 また、テストの概念を調べて理解し、独自のキャンバス アプリのテストを記述するために適用することもできます。 サンプルの Kudos アプリは、従業員エクスペリエンス スタート キットからダウンロードできる従業員エンゲージメント アプリのスイートの一部です。
このビデオでは、テスト スタジオの使用方法について説明します:
テスト スタジオを開く
Power Apps にサインインします。
アプリを Power Apps に保存して、テスト スタジオを開きます。
注意
アプリのテストを記述する前に、アプリを保存する必要があります。
左のナビゲーションにある詳細ツールを選択します。
テストを開くを選択して、このアプリケーション用のテスト スタジオを開きます。 このアクションにより、新しいブラウザー タブでテスト スタジオが開きます。
注意
テストが公開され、アプリ パッケージに保存されます。 キャンバス アプリ パッケージを別の環境にエクスポートおよびインポートすると、作成したテスト スイートやテスト ケースなどのすべてのテスト定義も含まれます。
テスト スイートの作成
既定では、テスト スイートとテスト ケースがテスト スタジオで自動的に作成されます。 テスト スイートは、テスト ケースを整理するために使用します。 1 つのアプリに 1 つまたは複数のテスト スイートを含めることができます。 既定のテスト スイートとテスト ケースを使用してテストの記述をすぐに開始することも、新しいテスト スイートを作成することもできます。
新しいスイートを選択します。
メイン グリッドでフィールドを選択して、テスト スイートの名前と説明を更新します。
テスト ケースの作成
テストをどのように整理またはグループ化したいかに応じて、1 つのテスト スイートに複数のテスト ケースを作成できます。 各ケースでは、アプリ内の特定の機能または機能のサブセットをテストできます。
- テスト スイートを選択します。
- 上部のメニューで新しいケースを選択して、新しいケースを作成します。
- メイン グリッドでフィールドを選択して、テスト ケースの名前と説明を更新します。
テスト ケースの記録
テスト ケースは、アクションが含まれるテスト ステップで構成されます。 テスト アクションは、タスクを実行する Power Apps 式を使用して記述されます。 レコーダーを使用して、アプリを操作しながらテスト ステップを自動的に生成できます。 記録した後、テスト ケースを更新したり、新しいステップを追加したり、ステップを削除したり、テスト アサーションを記述してテストの結果を検証できます。
注意
発行済みのアプリのみが記録モードで再生されます。 テスト ケースの記録を開始する前に、アプリへの任意の最新の変更を公開します。 最新の変更を公開せずに記録すると、最後に公開されたアプリのバージョンが記録モードで再生されます。
上部のメニューからレコードを選択します。 これにより、発行済みのアプリが新しいブラウザー タブに記録モードで表示されます。
重要
既存のテスト ケース上に記録すると、既に存在する既存のテスト ステップが上書きされます。
アプリを操作します。 操作は、左側のウィンドウで記録済です。
操作が完了したら、完了を選択します。 必要に応じて、キャンセルを選択して、操作を記録せずにテスト スタジオに戻ることができます。
テスト スタジオで自動的に生成されたテスト ステップと式を表示します。
必要に応じて、メイン グリッド内のステップの説明のテキストを編集します。 メイン グリッドで数式を選択して、テスト ステップのアクションを更新することもできます。
テスト ステップとテスト アサーションの追加
すべてのテスト ケースには、予想される結果が必要です。 Kudos の例では、Kudo を送信する場合に想定される結果の 1 つは、Microsoft Dataverse (Dataverse) データベースに新しいレコードを作成することです。 次に、テスト ケースを更新し、その他のテスト ステップを追加して、レコードが正常に作成されたことを検証します。
次の手順に従って、レコードが正常に作成されたことを検証します。
- テスト ケースの冒頭で、データベース内の Kudo レコード総数に対する変数を初期化します。
- テスト ケースの最後に、データベース内の Kudo レコード総数に対する変数を初期化します。
- 総数が 1 ずつ増分されていることを検証するためのテスト アサーション式を記述します。 このカウントが 1 ずつ増加していない場合、テスト アサーションは失敗し、テスト ケースが失敗します。
Kudos アプリにテスト ステップとテスト アサーションを追加するには:
ステップ 1 またはその上に新しいステップを挿入するステップを選択します。
上部のメニューから上にステップを挿入を選択するか、アクティブな行からオプションを選択します。 このアクションで空のステップが作成されます。
注意
上にステップを挿入を選択すると、現在のステップの上に新しい空のステップが追加されます。 代わりにアサート、SetProperty、選択または追跡アクションを使用することもできます。 これにより、編集可能な各アクション数式がステップに追加されます。
ステップの説明を更新します。 たとえば、"データベースの Kudo 総数"。
テスト実行前にデータベース内のレコードをカウントするアクション入力に、式または数式を入力します。
サポートされている任意の式を使用できます。 また、アプリに含まれているデータ ソース、コレクション、変数、実行フローのクエリを実行したり、テストで使用する新しいグローバル変数やコレクションを作成したりすることもできます。
Set(kudosBeforeTest, CountRows(Filter(Kudos, Receiver.Email = "someone@example.com")))```Select Step 2 or the step above which you want to insert a new step.
Select Insert a step above from the top menu or by selecting the option from the active row. This action creates an empty step.
Enter an expression or formula in the action input to Trace and write the kudosBeforeTest value to test the results record.
Trace("kudosBeforeTest : " & kudosBeforeTest);
テスト ケースの下部に移動し、テスト完了後にデータベース内のレコードをカウントする新しいステップを挿入します。
Set(kudosAfterTest, CountRows(Filter(Kudos, Receiver.Email = "someone@example.com")))```Add a final step to validate that the record count in the database has increased by a count of 1, and enter the following assertion action to verify:
Assert(kudosAfterTest = kudosBeforeTest + 1, "Kudos count incorrect. Expected : " & kudosBeforeTest + 1 & " Actual :" & kudosAfterTest)
テスト スタジオの右上のメニューからテスト ケースを保存します。
テストの再生
記録されたテストを再生して、アプリ機能を検証できます。 単一のテスト スイートまたは単一のテスト ケース内のすべてのテストを再生できます。
最近の変更を加えた記録を再生する前に、アプリを公開する必要があります:
重要
公開をスキップする場合、記録再生には最新のテスト変更は含まれません。 最後に公開されたテスト ケースまたはテスト スイートが、アプリに対して再生されます。
公開する を選択して、テストを自動的に保存して公開します。
テスト スイートまたは単一のテスト ケースのどちらかを選択します。
再生 を選択します。 公開されたアプリが再生モードで開き、テスト ステップが自動的に再生されることを確認できます。 緑のチェック マークは、テスト ステップが正常に実行されたことを示します。 ステップが失敗すると、エラー メッセージと共に赤いエラー インジケーターが表示されます。
完了を選択してテスト スタジオに戻ります。
失敗したアサーション
このセクションでは、テスト アサーションを変更して、失敗したテストを試します:
式のボックスを選択して、アサーション ステップを編集します。
テスト アクションの
+ 1を+ 2に更新します。 このアップデートは、テストで 2 つのレコードが作成されることを想定していることを意味しますが、これは正しくありません。 テストが成功していれば、データベースにはレコードが 1 つだけ作成されているはずです。Assert(kudosAfterTest = kudosBeforeTest + 2, "Kudos count incorrect. Expected : " & kudosBeforeTest + 2 & " Actual :" & kudosAfterTest)
公開 を選択します。
再生 を選択します。
テストの再生を表示します。 最後のステップが失敗し、エラーおよびアサーション ステップに指定したメッセージが表示されます。
ブラウザーでのテストの再生
リンクをコピーして、テスト スタジオ外部の別のブラウザーでテストを再生することもできます。 これにより、Azure DevOps などの継続的なビルドとリリースのパイプラインにテストを統合できます。
選択したテストの再生リンクが保持されます。 テスト スイートまたはテスト ケースは変更されません。 ビルドおよびリリース プロセスを変更することなく、テストを更新できます。
ブラウザーでテストを再生するには:
右側のウィンドウでテスト スイートまたはテスト ケースを選択します。
再生リンクのコピーをクリックします。
発行されていない変更がある場合は、テストを発行するように求められます。
公開プロセスをスキップして再生リンクをコピーすることを選択できます。 スキップした場合、テストに対する新しい変更は再生されません。
ブラウザーを開き、URL をアドレス バーに貼り付けてテストを再生します。
テストの再生を表示します。
テストをセットアップする
テストスイートの OnTestCaseStart プロパティは、自分のテストをセットアップできます。 このプロパティに入力された式は、ケースの実行が開始される前に、スイート内のすべてのテスト ケースに対してトリガーされます。 OnTestCaseStart は、すべてのケースの最初に同じテスト手順を書くことを避けるのに役立ちます。 このプロパティをカスタマイズして、次のようなスイートのすべてのケースに共通する設定タスクを実行できます。
- 常に最初の画面からテスト実行を開始します。
- 一般的なコレクションまたは変数の初期化。
- 現在実行中のテストのデータ ソースからテストデータを取得する
TestCaseInfo レコードには、実行中の現在のテストの詳細が含まれています。 以下のプロパティを含みます。
- TestCaseName – テスト ケースの名前。
- TestCaseDescription – テストケースの説明。
- TestCaseId – テスト ケースの ID。
- TestSuiteName – ケースが属するテスト スイート名。
- TestSuiteDescription – テスト スイートの説明。
- TestSuiteId – ケースが属するテスト スイートの ID。
以下の例では、OnTestCaseStart プロパティをカスタマイズするので、すべてのテスト ケースはアプリの最初の画面から始まります。 また、テスト ケースの手順で参照できるデータ ソースからテスト データをフェッチします。
左側のウィンドウでテストを選択するか、スイート ヘッダーで表示します。
OnTestCaseStart アクションを選択します。
最初の画面に移動する式を入力し、テストのテスト データをフェッチします。
//Start every cases on the first screen in the Kudos app Navigate('Dashboard Screen'); //Initialize my test data for the current case. Set(currentTestData, LookUp(KudosTestData, TestCase = TestCaseInfo.TestCaseName)); //Set kudosBeforeTest to 0 Set(kudosBeforeTest, 0)
テスト結果の処理
ブラウザーを使用する場合、テスト スタジオでのテスト再生時に表示されるテスト パネルは表示されません。 この動作により、実行する特定のテスト ステップを判別することや、テストが成功または失敗したかどうかを判断することはできません。
テスト スタジオの外部でテスト結果を確認するために、テスト オブジェクトで使用可能な OnTestCaseComplete および OnTestSuiteComplete という 2 つのプロパティがあり、テストの結果を処理するために使用できます。 Azure DevOps のような継続的なビルドとリリースのパイプラインにテストを統合する場合は、これらのプロパティを使用して、アプリの展開を続行する必要があるかどうかを判断できます。
これらのプロパティに入力した式は、各ケースまたはスイートが完了するとトリガーされます。 これらのプロパティをカスタマイズして処理し、テストの結果を次のさまざまなデータ ソースまたはサービスに送信できます:
- SQL Server。
- Dataverse。
- Power Automate。
- Office 365 を使用する電子メール。
これらの設定は、アプリ内のすべてのテスト スイートまたはテスト ケースに適用されます。 各テスト スイートまたはテスト ケースが完了すると、テスト結果とテストに含まれるすべての追跡メッセージが、TestCaseResult および TestSuiteResult レコードで使用できるようになります。
TestCaseResult レコードには、次のプロパティが含まれます:
- TestCaseName – テスト ケースの名前。
- TestCaseDescription – テストケースの説明。
- TestCaseId – テスト ケースの ID。
- TestSuiteName – ケースが属するテスト スイート名。
- TestSuiteDescription – テスト スイートの説明。
- TestSuiteId – ケースが属するテスト スイートの ID。
- StartTime – テストの実行開始時刻。
- EndTime – テストの実行終了時刻。
- Trace – テスト アサーションの結果および Trace 関数からのメッセージ。
- Success – テスト ケースが正常に完了したかどうかを示します。
- TestFailureMessage – ケースが失敗した場合のエラー メッセージ。
TestSuiteResult レコードには、次のプロパティが含まれます:
- TestSuiteName – テスト スイート名。
- TestSuiteDescription – テスト スイートの説明。
- TestSuiteId – テスト スイート ID。
- StartTime – テスト スイートの実行開始時刻。
- EndTime – テスト スイートの実行終了時刻。
- TestsPassed – スイートで正常に完了したテスト ケースの数。
- TestsFailed - スイートで失敗したテスト ケースの数。
このクイックスタートでは、Dataverse データベースに 2 つのカスタム テーブルを作成し、OnTestCaseComplete および OnTestSuiteComplete プロパティをカスタマイズして、テスト結果を格納します。
左側のウィンドウでテストを選択するか、スイート ヘッダーで表示します。
OnTestCaseComplete アクションを選択します。
テストの結果を処理する式を入力します。 次のサンプルでは、Dataverse のカスタム AppTestResults テーブルに各テスト ケースの結果を保存します。 オプションで、テスト結果を SQL、SharePoint、またはその他のデータ ソースに格納できます。 データ ソースの追跡フィールドを必要に応じて設定または増加させることが必要になる場合があります。
注意
次のサンプルは Microsoft Dataverse に接続します。 簡単なアプリを作成したり、Dataverse を使用してアプリをゼロから構築することもできます。 また、次のサンプルで使用されるデータ ソースのレコードを変更する方法の詳細については、Patch 関数リファレンスを参照してください。
//Save to Dataverse Patch(AppTestResults , Defaults(AppTestResults) , { TestPass: TestCaseResult.TestCaseName & ":" & Text(Now()) ,TestSuiteId: TestCaseResult.TestSuiteId ,TestSuiteName: TestCaseResult.TestSuiteName ,TestCaseId: TestCaseResult.TestCaseId ,TestCaseName: TestCaseResult.TestCaseName ,StartTime: TestCaseResult.StartTime ,EndTime: TestCaseResult.EndTime ,TestSuccess: TestCaseResult.Success ,TestTraces: JSON(TestCaseResult.Traces) ,TestFailureMessage: TestCaseResult.TestFailureMessage } );
OnTestSuiteComplete アクションを選択します。
テストの結果を処理する式を入力します。 次のサンプルでは、Dataverse のカスタム AppTestResults テーブルに各テスト スイートの結果を保存します。
//Save to Dataverse Patch(AppTestSuiteResults , Defaults(AppTestSuiteResults) , { TestSuiteId: TestSuiteResult.TestSuiteId ,TestSuiteName: TestSuiteResult.TestSuiteName ,StartTime: TestSuiteResult.StartTime ,EndTime: TestSuiteResult.EndTime ,TestPassCount: TestSuiteResult.TestsPassed ,TestFailCount: TestSuiteResult.TestsFailed } );
これらのプロパティで使用できるその他の式の例を次に示します:
Power Automate のフローに結果を送信します。
MyTestResultsFlow.Run(JSON(TestCaseResult))結果を電子メールで送信します。
Office365.SendMailV2("someone@example.com", "Test case results", JSON(TestCaseResult, JSONFormat.IndentFour))テスト結果のアプリ通知を受信します。
たとえば、テスト スタジオ外部のブラウザーでテストを再生した場合、テスト完了後に通知を受け取ります。
Notify(TestCaseResult.TestCaseName & " : " & If( TestCaseResult.Success , " Passed" , TestCaseResult.TestFailureMessage) ,If( TestCaseResult.Success , NotificationType.Success , NotificationType.Error) )
Test 関数
Power Apps で使用可能な 関数 に加えて、テストを作成するときに通常使用する一般的な関数を次に示します。
次の手順
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示