Test Engine でキャンバスアプリケーションをテストする (プレビュー)

注意

プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。これらの機能を公式リリースの前に使用できるようにすることで、顧客が事前にアクセスし、そこからフィードバックを得ることができます。

Test Engine を使用してキャンバスアプリをテストするには、次の手順が必要です。

テストプランの作成
ユーザーの設定
テストの実行
結果の表示

テスト計画を作成する

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

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

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

独自のテスト計画の作成を選択すると、次の機能を利用できます。

追加の Power Fx 関数: 追加登録された Power Fx アクションを使用して、Power Apps component framework (PCF) コンポーネントと対話し、テスト計画の機能を強化します。
カスタムデータ構造と関数を定義する: ユーザー定義型 (UDT) とユーザー定義関数 (UDF) を使用して、再利用可能で保守可能なテストステップを作成します。

チップ

GitHub リポジトリで利用可能なサンプルプランを確認します。

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

Test Studio から記録されたテストをダウンロードすることで、ユーザーとアプリケーションとのインタラクションをすばやくキャプチャして再生することができます。このメソッドは、コードを記述せずに基本的なテストケースを作成する場合に便利です。ただし、柔軟性と複雑なシナリオを処理する能力の点で制限があります。

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

Test Studio の スイートのダウンロード ボタンを使用して、テストプランをダウンロードします。複数のテストスイートがある場合は、ダウンロードするテストスイートを選択します。
または、各テストスイートの下にある ダウンロード ボタンを使用します。
このアプリに別のテナントまたは環境を使用している場合は、必ず構成ファイルとユーザー構成を更新してください。

ユーザーの設定

現在、Test Engine には次の認証方法があります。

メソッド	プロパティ
ストレージの状態	Microsoft Windowsデータ保護 API を使用して、認証されたユーザー状態をユーザープロファイルにローカルに保存します
Dataverse	X.509 証明書で暗号化された独自のカスタマーマネージドキーを使用し、ASP.NET コアデータ保護を使用して、認証されたユーザーの状態を Dataverse 内に保存します

テスト資格情報をテストプランファイルに保存することはできません。資格情報を保存する安全な場所として、Storagestate または Dataverse を選択する必要があります。テスト計画ファイルには、ユーザーペルソナに使用される環境変数の参照が含まれています。たとえば、次の YAML スニペットは、環境変数 user1Email が使用されていることを示しています。

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

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

次の PowerShell スクリプトを使用して、ユーザー名を環境変数に格納します。

$env:user1Email = "someone@example.com"

注意

ユーザー・パスワードは、環境変数では不要になりました。サポートされているオプションについては、認証を確認してください。

テストの実行

PAC CLI pac テストの実行コマンドを使用して、テストプランを実行します。

必要なパラメーター

次の情報を入力する必要があります。

--test-plan-file: テストプランファイルへのパス
--tenant: 使用しているテナント ID
--environment-id: 使用してい環境 ID

コマンド例

キャンバスアプリケーションのテストを実行する例を次に示します。

pac test run `
   --provider canvas `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value

短いパラメーターエイリアスを使用することもできます。

pac test run `
   -p canvas `
   -test your-testplan.te.yaml `
   -t your-tenantid-guid-value `
   -env your-environmentid-guid-value

Dataverse 統合

キャンバスアプリのテストで Dataverse 統合機能を有効にするには、テスト設定に enableDataverseFunctions パラメーターを追加します:

testSettings:
  extensionModules:
    enable: true
    parameters:
      enableDataverseFunctions: true

Dataverse の統合を有効にすると、Dataverse 環境の権限を持つユーザーまたはサービスプリンシパルで Azure CLI を開く必要があります。 az login コマンドを使用できます。詳細情報については、Azure CLI でサインインするを参照してください。

統合に使用する Dataverse API URL は、pac test run--domainパラメーターのホストドメイン名から取得するか、という DATAVERSE_URLを定義して取得します。

結果の表示

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

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-08-12