Power Apps 測試引擎 YAML 格式 （預覽版）

測試是在 YAML 中定義，遵循與 Power Fx 相同的指導方針。 深入瞭解 Power Fx YAML 公式文法。

如需詳細範例，請檢視 PowerApps-TestEngine/samples 資料夾。

YAML 結構描述定義

測試套件

用來定義一個測試。

如何在測試計劃中識別您的應用程式

您需要設定 或 appLogicalNameappId 來識別您的應用程式。 您使用的取決於您的應用程式是否在解決方案中定義。

解決方案型應用程式 （建議）

當您在解決方案中定義應用程式時，您的測試會跨環境可攜式。 設定 appLogicalName 屬性以指出應用程式是以解決方案為基礎。

若要尋找應用程式的邏輯名稱：

1. 在 Power Apps 中開啟包含您應用程式的解決方案
2. 使用清單中的 名稱 （而非 顯示名稱）。 名稱值包含解決方案發行者的自訂前置詞。

獨立應用程式

當您的應用程式未在解決方案中定義時，您必須使用 屬性 appId 。

若要尋找應用程式的 ID：

1. 在 Power Apps 清單中找到應用程式
2. 開啟 [詳細資料] 並記下應用程式識別碼 GUID

NetworkRequest模擬

對於選用內容，如果未指定任何值，則路由會套用至所有內容。 例如，如果為 null，只要 method 其他屬性都匹配，無論方法是什麼，我們都會傳回模擬回應。

對於 Sharepoint/Dataverse/Connector 應用程式， requestURL 並且 method 所有要求都可以相同。 x-ms-request-method 在這種情況下 x-ms-request-url ，可能需要配置標頭來識別不同的請求。

測試案例

測試步驟

• TestSteps 可以使用任何現有 的測試引擎 Power Fx 函數 函數或此架構定義 的特定測試函數 。
• 值應該以管道符號 （|） 開頭，以允許多行 YAML 運算式，後面接著等號 （=） ，以指出它是 Power Fx 運算式
• 函式應以分號 （）; 分隔。
• 可以使用註解，且應以雙反斜線字元 （）// 開頭。

TestSteps 範例

testCases:
   - testCaseName: Fill in a city name and do the search
   testSteps: |
      = Screenshot("connectorapp_loaded.png");
         SetProperty(TextInput1.Text, "Atlanta");
         Select(Button1);
         Assert(Label4.Text = "You are seeing the mock response", "Validate the output is from the mock");
         Screenshot("connectorapp_end.png");

測試設定

用來定義測試計劃中測試的設定。

擴充模組

包含要啟用的延伸模組的相關資料。

此範例示範如何啟用 PowerFx Preview 命名空間：

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

進一步了解預覽功能

地區和語言考量

測試引擎支援各種語言和區域設定，例如小數點和清單分隔符號。 testSettings.locale屬性會控制這些行為。 如需詳細資訊，請參閱 Microsoft Power Fx 中的全域支援。

請查看 PowerApps-TestEngine GitHub 存放庫上的這些範例設定：

• 對於使用分號作為清單分隔符號的區域
• 對於使用逗號作為小數點分隔符號的區域

powerFxTestTypes 範例

powerFxTestTypes:
 - name: ControlName
   value: |
      {ControlName: Text} 
 - name: Options
   value: |
      [{Name: Text, Value: Number}]   

此範例示範如何定義自訂 Power Fx 類型以用於測試案例。 ControlName類型定義為具有單一Text欄位的記錄，而Options類型定義為記錄表格，每個記錄包含類型的Name欄位Text和類型的ValueNumber欄位。 自訂類型可用於建立更複雜和具體的測試場景，從而增強測試定義的靈活性和功能。

testFunctions 範例

testFunctions:
 - description: Wait until control is visible using Document Object Model (DOM) selector
   code: |
    WaitUntilVisible(control: Text): Void = 
      Preview.PlaywrightAction(Concatenate("//div[@data-id='", control, "']"), "wait");
 - description: Get the options for a control using Power Fx control from Model Driven App (MDA)
   code: |
    GetOptions(control: ControlName): Options =
      Preview.GetOptions(control);

這些測試函數範例示範如何定義自訂 Power Fx 函數以用於測試案例。 函 WaitUntilVisible 式會使用 DOM 選取器，使用 Playwright 動作，等候指定的控制項可見為止。 GetOptions 函式會利用 Power Fx 控制項，從 模型導向應用程式 （MDA） 擷取指定控制項的選項。 這些自訂函數增強了測試定義的靈活性和功能，允許更複雜和具體的測試場景。

瀏覽器配置

每個 testSettings 至少需要一個 BrowserConfiguration.

environmentVariables

您可以將不同類型的值儲存為環境值，但最常見的情況是將認證資訊與 使用者清單一起儲存。

users

為了確保以安全的方式儲存認證，測試定義會使用 personaName. 不支援將認證儲存在測試計劃檔案中。

範例：

environmentVariables:
    - users:
        - personaName: "User1"
          emailKey: "user1Email"
        - personaName: "User2"
          emailKey: "user2Email"

用作 personaName 測試定義的一部分，以指示要以哪個使用者身分執行測試。

支援的認證儲存機制

若要將認證儲存為環境變數，您可以依下列方式設定認證：

# In PowerShell - replace variableName and variableValue with the correct values
$env:variableName = "variableValue"

在 YAML 中，需要定義兩個屬性，以指出此使用者的認證儲存在環境變數中：

• emailKey：用來儲存使用者電子郵件的環境變數。

範例 YAML：

    - personaName: "User1"
      emailKey: "user1Email"

根據 YAML 設定使用者認證的範例 PowerShell：

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

另請參閱

Power Apps 測試引擎概觀 （預覽）
Power Apps 測試引擎 Power Fx 函數 (預覽版)