テスト エンジンを使用してキャンバス アプリケーションをテストする (非推奨)

注意

テスト エンジンは非推奨 となり、今後のリリースで削除される予定です。 Power Platform および Dynamics 365 サービスのテスト自動化機能には、Power Platform Playwright サンプルを使用します。

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

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

テスト計画を作成する

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

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

「Power Apps テスト エンジン YAML フォーマット (非推奨)」で説明されているテスト プラン スキーマを使用して、yaml ファイルを作成してください。

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

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

ヒント

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

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

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

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

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

    Test Studio の [テスト スイートのダウンロード] ボタンのスクリーンショット

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

    Test Studio の個別の [テスト スイートのダウンロード] ボタンのスクリーンショット

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

ユーザーの設定

現在、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

コマンド例

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

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パラメーターのホスト ドメイン名から取得するか、もしくは、PowerShell 環境変数として定義された DATAVERSE_URLから取得します。

結果の表示

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

  • Last updated on