Power Apps Test Engine の概要 (プレビュー)

[この記事はプレリリース ドキュメントであり、変更されることがあります]

Power Apps Test Engine は、Power Platform CLI (PAC CLI) 内のコンポーネントで、Power Apps でスタンドアロン キャンバス アプリをテストするために使用されます。 Test Engine を使用するには、Microsoft Power Platform CLI をインストール する必要があります。

給付

Power Apps Test Engine には次のメリットがあります。

• Power Fx テストの作成: 使い慣れた Power Fx 言語を使用して、YAML 形式でテストを作成します。
• DOM 抽象化: テストを作成するときに、Power Apps Studio 内で定義されたコントロール名への参照を使用します。 JavaScript を使用する必要も、アプリの出力がレンダリングされたブラウザーのドキュメント オブジェクト モデル (DOM) に精通している必要もありません。
• コネクタ モック: アプリがコネクタを使用して行うネットワーク呼び出しのモックを作成できます。 アプリを変更せずにテストできるため、外部 API による望ましくない副作用を回避できます。
• スクリーンショットとビデオ録画のサポート: Test Engine を使用してスクリーンショットを撮り、テスト実行のビデオを録画できます。 これらの画像とレコーディングは、失敗したテストを診断し、失敗したテスト ケースの実際の経験を理解するのに役立ちます。

アプリのテスト

Test Engine を使用してアプリをテストするには、次の手順に従います。

1. テスト プランを作成する
2. ユーザーの設定
3. テストの実行
4. 結果の表示

テスト プランを作成する

テスト プランは YAML 形式を使用して定義されます。 独自のテスト プランを作成 したり、Test Studio から記録されたテストをダウンロード したりできます。

独自のテスト プランを作成する

Power Apps Test Engine YAML 形式 (プレビュー) で説明されているテスト プラン スキーマを使用して yaml ファイルを作成します。

記録されたテストを Test Studio からダウンロードする

Test Studio に記録したテストがある場合は、Test Studio からダウンロードして Test Engine で再利用できます。

• Test Studio の スイートのダウンロード ボタンを使用して、テスト プランをダウンロードします。 複数のテスト スイートがある場合は、ダウンロードするテスト スイートを選択します。

  

• または、各テスト スイートの下にある ダウンロード ボタンを使用します。

  

• このアプリに別のテナントまたは環境を使用している場合は、必ず構成ファイルとユーザー構成を更新してください。

ユーザーの設定

Test Engine は、多要素認証をサポートしていません。 テストにサインインするには、ユーザー名とパスワードのみが必要なアカウントを使用してください。

テスト資格情報をテスト プラン ファイルに保存することはできません。 環境変数に保存します。 テスト プラン ファイルには、資格情報に使用される環境変数への参照が含まれています。 たとえば、次の YAML スニペットは、user1Email および user1Password 環境変数が使用されていることを示しています。

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email
      passwordKey: user1Password

詳細については、ユーザー を参照してください。

次の PowerShell スクリプトを使用して、ユーザー名とパスワードを環境変数に保存します。

$env:user1Email = "someone@example.com"
$env:user1Password = "fake password"

テストの実行

PAC CLI pac テストの実行 コマンドを使用して、テスト プランを実行します。 次の情報を指定してください。

• テスト プラン ファイルへのパス
• EnvironmentId
• TenantId

結果の表示

テストが完了すると、出力ディレクトリにある .trx ファイルでテストの結果を確認できます。 このフォルダーには、テスト プラン yaml で recordVideo が true に設定されている場合に、テストでキャプチャされたスクリーンショットやビデオが含まれます。

制限

以下は、Power Apps Test Engine を使用する場合の既知の制限事項です。

• 多要素認証はサポートされていません。 テストを実行するには、ユーザー名とパスワードのみが必要なアカウントを使用してください。
• ブラウザーのロケールは、使用しているブラウザーの既定設定に従います
• 最新のコントロール (プレビュ)は現在サポートされていません

でサポートされるブラウザー

テスト エンジンは現在、次のブラウザーをサポートしています。

• Chromium
• Firefox
• WebKit

さらに考慮すべきこと

以下は、テスト プランに関して考慮すべき追加事項です。

小数点の記号にピリオドを使用する言語と地域

Power Fx の構文は、システムの言語設定によって異なる場合があります。 テスト プラン ファイルの testSettings セクションの locale プロパティを使用して、Power Fx が書き込まれるロケールを指定します。 (testSettings で locale を参照)。 これは、異なる小数点記号または桁区切り記号を使用する地域にわたって作業している場合に便利です。 たとえば、10 進数の場合は . の代わりに ,、, の代わりに ; を使用します。

使用例として locale プロパティが指定されている次のサンプルを参照してください。

1. 区切り文字に , の代わりに ; - testPlanForRegionUsePeriodAsDecimalSeparator.fx.yaml
2. 区切り文字に . の代わりに , - testPlanWithCommaForDecimal.fx.yaml.fx.yaml

テスト プラン ファイルでのアプリの参照方法

テスト プラン ファイルがターゲット アプリを参照する方法は、アプリがソリューション内にあるかどうかによって異なります。 移植性が向上するため、可能な限りソリューションを使用することをお勧めします。

ソリューション内でアプリを使用して作業する

ソリューションの概要 の一部であるアプリのテスト プラン ファイルは、環境間で移植可能です。 ソリューションベースのアプリの場合、テスト プランは論理名 (アプリ LogicalName プロパティ) を参照し、アプリが別の環境に移動しても変わりません。

1. アプリの論理名を検索する
   1. ソリューション タブで、アプリを含むソリューションを開く
   2. アプリを選択する
   3. 名前 列をメモします。 これはアプリの論理名です (表示名 ではありません)
2. テスト プラン ファイルを更新する
   1. アプリのテスト プラン YAML ファイルを開く
   2. appLogicalName 値に新しいアプリの論理名を入力する

ソリューション外でアプリを使って作業する

新しい環境に対するソリューションの一部では ない アプリを移動する場合、アプリを参照するようにテスト プラン ファイルを手動で更新する必要があります。 非ソリューションベースのアプリのテスト プラン ファイルを更新する方法

1. 新しい場所でアプリのアプリ ID を検索する
   1. アプリ リストで、アプリを検索しコンテキスト メニューを開く
   2. 詳細 を選択する
   3. 詳細ウィンドウに アプリ ID GUID をメモする
2. テスト プラン ファイルを更新する
   1. アプリのテスト プラン YAML ファイルを開く
   2. 新しいアプリ ID を使用して appId を入力する

参照

Power Apps テスト エンジンのリリース ノート
Power Apps Test Engine の YAML 形式 (プレビュー)
Power Apps Test Engine Power Fx 機能 (プレビュー)