次の方法で共有

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

注意

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

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

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

テスト プランの作成

Power Appsテスト エンジンの YAML 形式 (プレビュー)を使用して yaml ファイルを作成します。

チップ

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

プレビューを有効にする

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

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

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

ユーザーの設定

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

メソッド 説明
ストレージの状態 Microsoft Windows Data Protection API
Dataverse ASP.NET Core Data Protection を使用して X.509 証明書で暗号化された独自のカスタマー マネージド キーを使用して、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パラメーターのホスト ドメイン名から取得するか、PowerShell 環境変数DATAVERSE_URLを定義して取得します。

結果の表示

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

  • Last updated on