共用方式為


使用測試引擎測試模型驅動應用程式 (預覽版)

注意

預覽功能不供生產時使用,而且可能功能受限。 這些功能是在正式發行前先行推出,讓客戶能夠搶先體驗並提供意見反應。

使用 測試引擎 測試您的模型驅動應用程式需要遵循以下步驟:

  1. 建立測試計劃
  2. 設定您的用戶
  3. 運行測試
  4. 檢視結果

創建測試計劃

根據Power Apps 測試引擎 YAML 格式(預覽)中所說明的測試計畫架構來建立 yaml 檔案。

提示

請在GitHub資料庫中檢視可用樣本圖紙。

啟用預覽

目前,所有模型驅動應用擴展測試功能都需要使用 預覽功能。 要啟用這些功能,請將 Preview 添加到 allowPowerFxNamespaces 中的 清單欄位中,位於 testSettings

此範例向您展示如何新增此內容:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

設定您的用戶

測試引擎目前具有以下身份驗證方法:

方法 描述
存儲狀態 透過 Microsoft Windows 資料保護 API 將已認證的使用者狀態儲存在本地的使用者設定檔中
Dataverse 在 Dataverse 中儲存已認證的使用者狀態,使用您自己的客戶管理金鑰,並以 X.509 憑證加密,使用 ASP.NET Core 資料保護

不能將測試憑據存儲在測試計劃檔中。 必須選擇 StoragestateDataverse 作為存儲憑據的安全位置。 測試計劃檔包含對用於使用者角色的環境變數的引用。 例如,以下 YAML 代碼片段指示 user1Email 使用了環境變數:

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

查看 使用者 以獲取更多資訊。

使用以下 PowerShell 腳本將使用者名存儲在環境變數

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

運行測試

使用 PAC CLI pac test run 命令運行測試計劃。

必需參數

您需要提供以下資訊:

  • --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 中添加參數:

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 查看測試結果。 此資料夾包含任何由測試 recordVideo 在測試計劃 yaml 中設定為 true 時捕獲的螢幕截圖或影片。