Тестирование управляемых моделью приложений с помощью Test Engine (устаревший)

Замечание

Модуль тестирования устарел и будет удален в будущем выпуске. Используйте примеры Power Platform Playwright для возможностей автоматизации тестирования в службах Power Platform и Dynamics 365.

Для тестирования вашего приложения на основе модели с помощью Test Engine требуются следующие шаги:

  1. Создайте план тестирования
  2. Настройте своего пользователя
  3. Запустить тест
  4. Посмотреть результаты

Создайте план тестирования

Создайте файл YAML, используя схему плана тестирования, описанную в устаревшем формате YAML для Power Apps Test Engine.

Tip

Ознакомьтесь с доступными примерами планов в репозитории GitHub.

Включение предварительного просмотра

В настоящее время все возможности тестирования расширений приложений на основе моделей требуют использования функций предварительного просмотра. Для активации их добавьте Preview в список allowPowerFxNamespaces в extensionModules ваших testSettings.

В этом примере показано, как это добавить:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

Настройте своего пользователя

В настоящее время Test Engine использует следующие методы аутентификации:

Метод Description
Состояние хранения Сохраняйте аутентифицированное состояние пользователя локально в профиле пользователя, используя Microsoft Windows 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 run , чтобы запустить свой план тестирования.

Обязательные параметры

Вам необходимо предоставить следующую информацию:

  • --test-plan-file: Путь к файлу вашего плана тестирования
  • --tenant: Ваш идентификатор арендатора
  • --environment-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 необходимо открыть Azure CLI с пользователем или служебным принципалом, который имеет доступ к среде Dataverse. Можно использовать команду: az login Дополнительные сведения: войдите с помощью Azure CLI.

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

Просмотр результатов

После завершения тестов вы можете просмотреть результаты своего теста в .trx файле, расположенном в выходном каталоге. В этой папке содержатся все снимки экрана или видео, снятые во время ваших тестов, если в плане тестирования yaml задано значение recordVideotrue .