Приложения, управлявани от тестови модели, с Test Engine (остарял)

Бележка

Test Engine е остарял и ще бъде премахнат в бъдещо издание. Използвайте Power Platform Playwright samples за възможности за автоматизация на тестове в Power Platform и Dynamics 365 услуги.

Тестването на вашето приложение, управлявано от модел, с Test Engine изисква следните стъпки:

  1. Създаване на план за тестване
  2. Настройване на вашия потребител
  3. Изпълнете теста
  4. Вижте резултатите

Създаване на план за тестване

Създайте yaml файл, използвайки схемата за тестов план, обяснена в Power Apps Test Engine YAML формат (остарял).

Съвет

Прегледайте плановете available sample в хранилището GitHub.

Разрешаване на визуализация

Понастоящем всички възможности за тестване на разширения на приложения, управлявани от модел, изискват използване на функции за визуализация. За да ги активирате, добавете Preview към списъка allowPowerFxNamespaces в extensionModules на вашия testSettings.

Този пример ви показва как да добавите това:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Настройване на вашия потребител

В момента Test Engine има следните методи за удостоверяване:

Метод Описание
Състояние на съхранение Съхранявайте удостовереното потребителско състояние локално в потребителския профил, използвайки Microsoft Windows Data Protection API
Dataverse Съхранявайте автентикираното потребителско състояние в Dataverse, използвайки собствен ключ, управляван от клиента, криптиран с X.509 сертификат с ASP.NET Core Data Protection

Не можете да съхранявате идентификационните данни за тест във файловете на плана за тестване. Трябва да изберете Storagestate или Dataverse като защитено местоположение за съхраняване на идентификационни данни. Файлът с плана за тестване съдържа препратки към това кои променливи на средата се използват за потребителска личност. Например следният YAML фрагмент показва, че user1Email се използват променливите на средата:

environmentVariables:
  users:
    - personaName: User1
      emailKey: user1Email

Вижте Потребители за повече информация.

Използвайте следния скрипт на PowerShell, за да съхраните потребителското име в променливите на вашатасреда.

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

Изпълнете теста

Използвайте командата за тестово изпълнение на PAC CLI pac, за да изпълните плана си за тестване.

Задължителни параметри

Трябва да предоставите следната информация:

  • --test-plan-file: Път до файла на вашия тестов план
  • --tenant: Вашият ИД на клиент
  • --environment-id: Идентификационният номер на средата ви
  • --domainURL адресът на домейна на страницата на приложението, управлявано от модел, за тестване

Формати на 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, трябва да отворите Azure CLI с потребител или главен оператор на услуга, който има права върху средата на Dataverse. Можете да използвате командата: az login Повече информация: Влезте с Azure CLI.

Dataverse URL адресът на API, използван за интеграция, се получава или от името на домейна на хоста на параметъра за изпълнение--domain на pac test, или чрез дефиниране на променлива на средата на PowerShell с име DATAVERSE_URL.

Преглед на резултатите

Когато тестовете приключат, можете да видите резултатите от вашия тест във файла, .trx намиращ се в изходната директория. Тази папка съдържа всички екранни снимки или видеоклипове, заснети от вашите тестове, когато recordVideo е зададено в true плана за тестване yaml.