Power Apps Test Engine のサンプル

注意

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

このページでは、Power Apps Test Engine リポジトリで入手できるサンプルプロジェクトの概要について説明します。これらのサンプルでは、Power Platform ソリューションの効果的なテストを作成する方法を理解するのに役立つさまざまなテスト機能とシナリオを示しています。

入手可能なサンプル

次のサンプルは、PowerApps-TestEngine GitHub リポジトリで入手できます。

Sample	プロパティ
基本ギャラリー	キャンバスアプリの基本ギャラリー内のコントロール動作を確認する方法を示します。サンプルでは、ラベルテキスト値を挿入し、ギャラリーアイテム間を移動する方法を示します。
ボタンクリッカー	ボタンがクリックされたときにカウンターが増加することを確認する簡単なテスト。テストライフサイクルフック (`OnTestCaseStart`, `OnTestCaseComplete`) と基本コントロールの動作を使用する方法を示します。
電卓	複数の演算 (Add、Subtract、Multiply、Divide) を持つ電卓コンポーネントをテストします。入力コントロールと出力コントロールを使用してコンポーネントをテストする方法を示します。
Copilot Studio キット	Power CAT Copilot Studio キットのテストを示す高度なサンプル。複数のカスタムページのテスト、レポート生成、エンティティベースのテストを特徴としています。
コンテナー	コンテナーコンポーネント内のコントロールを操作し、プロパティの変更とイベント処理を確認する方法を示します。
Dataverse	Power Fx アクションを使用して Dataverse 操作をテストする方法をお見せします。 Dataverse を使用して、レコードを直接作成、読み取り、更新、および削除する方法を示します。
異なる変数タイプ	さまざまなデータ型 (`String`、`Number`、`Boolean`、`Date`、`Record`、`Table`) でのテストを、`TextInput`、`Rating`、`Toggle`、`DatePicker`、`Dropdown`、`ComboBox` などのコントロールを使用して紹介します。
多数の画面	キャンバスアプリ内の複数の画面間のナビゲーションをテストし、画面の切り替えとコンテンツが正しいことを確認します。
MDA ヘッダーコントロール	モデル駆動型アプリのヘッダーコントロールの動作をテストし、モデル駆動型アプリ UI 要素のテストを示します。
入れ子になったギャラリー	行ギャラリーと列ギャラリーの両方を使用して入れ子になったギャラリーをテストする方法を示します。入れ子になったギャラリーで項目を選択し、選択状態を検証する方法を示します。
[PCF コンポーネント]	Power Apps Component Framework (PCF) コンポーネント (特にインクリメントコントロールコンポーネント) をテストする方法を示します。
アクセス許可	さまざまなユーザーアクセス許可シナリオでのテストを示します。さまざまなセキュリティロールとアクセスレベルでアプリケーションがどのように動作するかをテストします。
画面のナビゲーション	画面ナビゲーション機能のテストと、画面間の正しい切り替えの検証に重点を置きます。
天気	MSN 天気予報コネクタのコネクタ応答をモックする方法を示します。シミュレートされた外部サービス呼び出しによるテストを示します。

サンプル構造

ほとんどのサンプルは、共通の構造に追従します。

README.md: サンプルの目的、前提条件、および使用方法について説明します
RunTests.ps1: テストを実行する PowerShell スクリプト
config.json: テスト環境の構成設定
テスト YAML ファイル: テスト定義 (.fx.yaml または .te.yaml)
ソリューションパッケージ: サンプルアプリを含む .zip ファイル (一部のサンプルの場合)

一般的な機能の実演

これらのサンプルでは、いくつかの主要なテスト機能が示されています。

基本テスト操作

基本的なテスト操作には、次のものが含まれます。

コントロールプロパティの設定と取得
コントロール値と可視性の検証
ボタンのクリックとコントロールの操作
続行する前に条件を待機します

高度なテスト機能

高度なテスト機能には、次のものが含まれます。

画面とフォーム間のナビゲーション
ギャラリーおよびフォーム操作
さまざまなデータ型のテスト
外部サービスとコネクタのモック作成
さまざまなユーザーコンテキストでのテスト

ライフサイクル管理のテスト

これらは、ライフサイクル管理のテストの例です。

OnTestCaseStart と OnTestCaseComplete フックの使用
さまざまな環境向けの構成
エラー処理とテスト診断
ビデオ録画とスクリーンショット機能

サンプルで始める

サンプルを使用するには、次の基本ステップに従ってください。

PowerApps-TestEngine レポジトリをクローンします
サンプルの README の説明に従って、前提条件をインストールします
config.json ファイルで環境を構成します
サンプルソリューションが提供されている場合は、インポートします
RunTests.ps1 スクリプトを使用してテストを実行します

詳細な手順については、各サンプルの README.md ファイルおよび Test Engine のドキュメントを参照してください。

学習にサンプルを使用する

サンプルは、優れた学習リソースを提供します。

簡単に始める: ボタンクリッカーまたは基本ギャラリーサンプルから初めて基本的な概念を理解する
徐々に進める: 自信がついたら、より複雑なサンプルに移行します
テストのカスタマイズ: 独自のアプリケーションの要件に合わせてサンプルを変更します
例から学ぶ: サンプルコードパターンを独自のテストのテンプレートとして使用する

Test Engine の概要
 テスト向け Power Fx 機能
 YAML テスト形式
 認証ガイド
 AI 支援によるテスト作成

フィードバック

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

Last updated on 2025-08-12