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


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

Примечание.

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

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

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

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

Планы тестирования определяются с использованием формата YAML . Вы можете создать собственный план тестирования или загрузить записанные тесты из Test Studio.

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

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

При выборе создания собственного плана тестирования вы можете воспользоваться следующими возможностями:

  • Дополнительные Power Fx функции: используйте дополнительные зарегистрированные Power Fx действия для взаимодействия с Power Apps компонентами компонентной инфраструктуры (PCF), расширяя возможности ваших планов тестирования.
  • Определение пользовательских структур данных и функций: использование определяемых пользователем типов данных (UDT) и определяемых пользователем функций (UDF) для создания повторно используемых и поддерживаемых этапов тестирования.

Совет

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

Загрузите записанные тесты из Test Studio

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

Если у вас есть тесты, записанные в Test Studio, вы можете загрузить их из Test Studio для повторного использования в Test Engine.

  • Используйте кнопку Загрузить набор в Test Studio, чтобы загрузить план тестирования. Если у вас несколько тестовых наборов, выберите нужный набор тестов для загрузки.

    Скриншот кнопки загрузки тестового набора Test Studio

  • В качестве альтернативы используйте кнопку Загрузить , доступную под каждым набором тестов.

    Скриншот кнопки загрузки тестового набора Test Studio

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

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

В настоящее время 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: Идентификатор вашей среды

Пример команды

Вот пример запуска теста для приложения Canvas:

pac test run `
   --provider canvas `
   --test-plan-file your-testplan.te.yaml `
   --tenant your-tenantid-guid-value `
   --environment-id your-environmentid-guid-value

Вы также можете использовать более короткие псевдонимы параметров:

pac test run `
   -p canvas `
   -test your-testplan.te.yaml `
   -t your-tenantid-guid-value `
   -env your-environmentid-guid-value

Интеграция с Dataverse

Чтобы включить Dataverse интеграцию с тестами вашего приложения Canvas, вы можете добавить enableDataverseFunctions параметр в настройки теста:

testSettings:
  extensionModules:
    enable: true
    parameters:
      enableDataverseFunctions: true

При включении Dataverse интеграции вам потребуется открыть Azure CLI с правами пользователя или субъекта-службы, имеющего права на Dataverse среду. Вы можете использовать команду az login . Дополнительные сведения: войдите с помощью Azure CLI.

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

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

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