Поделиться через


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

Примечание.

Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.

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

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

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

Создайте файл yaml, используя схему плана тестирования, описанную в разделе Power Apps Формат YAML тестового движка (предварительная версия).

Совет

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

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

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

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

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
    - Preview

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

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

Способ Описаниен
Состояние хранения Сохраняйте аутентифицированное состояние пользователя локально в профиле пользователя, используя 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 .