次の方法で共有

Test Engine でモデル駆動型アプリケーションをテストする (プレビュー)

注意

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

Test Engine を使用してモデル駆動型アプリをテストするには、次の手順が必要です:

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

テスト計画を作成する

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

チップ

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

プレビューを有効にする

現在、すべてのモデル駆動型アプリ拡張テスト機能は、プレビュー関数を使用する必要があります。 これらを有効にするには、Preview の allowPowerFxNamespaces のリストに を に追加します。

次に、これを追加する例を示します。

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

ユーザーの設定

現在、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
  • --domain: テストする モデル駆動型アプリ ページのドメイン URL

モデル駆動型アプリの URL フォーマット

モデル駆動型アプリの場合、--domain パラメーターはテストするページのタイプによって異なります。 URL 形式では、テスト シナリオに基づいて正しい pagetype を指定する必要があります。

# For custom pages
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=custom&name=dev_home_c8017"

# For entity lists (views)
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=entitylist&etn=account&viewid=5a84c584-df1c-ed11-9db0-000d3a991110"

# For entity records (forms)
pac test run `
   --provider mda `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value `
   --domain "https://contoso.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&pagetype=entityrecord&etn=account&id=72e0e163-df1c-ed11-9db0-000d3a991110"

Dataverse 統合

モデル駆動型アプリのテストで Dataverse の統合を有効にするには、enableDataverseFunctions に パラメーターを追加します:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview
    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