Посилання на змінні середовища

У цьому посиланні на змінні середовища описано всі параметри конфігурації для зразків Power Platform Playwright. Для локального розвитку встановіть ці змінні в packages/e2e-tests/.env. У ci/CD налаштуйте їх як секрети трубопроводів або змінні. Інструкції з конвеєра див. в статті Інтеграція з CI/CD.

Змінні автентифікації

Ці змінні визначають, як тестова структура автентифікує служби Power Platform.

Змінна	Обов'язковий	Опис
`MS_AUTH_EMAIL`	Так	Адреса електронної пошти тестового облікового запису користувача
`MS_AUTH_CREDENTIAL_TYPE`	Так	Метод автентифікації: `password` або `certificate`
`MS_USER_PASSWORD`	Якщо `credential_type=password`	Пароль для тестового користувача
`MS_AUTH_CREDENTIAL_PROVIDER`	Якщо `credential_type=certificate`	Джерело сертифіката: `local-file` або `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Якщо `provider=local-file`	Відносний шлях до файлу сертифіката `.pfx`
`MS_AUTH_CERTIFICATE_PASSWORD`	Ні	Пароль сертифіката `.pfx` (якщо його захищено)

змінні Azure Key Vault

Обов'язково, якщо MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Змінна	Опис
`AZURE_KEYVAULT_URL`	Key Vault URL-адресу, наприклад `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Ім'я сертифіката, що зберігається в Key Vault
`AZURE_TENANT_ID`	ідентифікатор клієнта Microsoft Entra
`AZURE_CLIENT_ID`	(Необов'язково) Ідентифікатор клієнта основного клієнта служби для федеративної ідентичності

Змінні URL-адреси програми

Ці змінні визначають URL-адреси програм, які перевіряються.

Змінна	Обов'язковий	Опис
`CANVAS_APP_URL`	Для тестів на полотні	Повна URL-адреса веб-програми для відтворення, включно з URL-адресою полотна `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Для тестів програм на основі моделі	Повна URL-адреса програми на основі моделі (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Для користувацьких перевірок сторінок	Коротке ім'я настроюваного елемента карти сайту сторінки, наприклад `AccountsCustomPage`

Створення URL-адреси програми canvas

Скористайтеся buildCanvasAppUrlFromEnv() інструментом, щоб створити URL-адресу з окремих частин, якщо потрібно:

import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';

const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment

Або встановіть його явно в .env:

CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>

Отримати URL-адресу програми на основі моделі

Щоб знайти правильну URL-адресу для програми на основі моделі, виконайте наведені нижче дії.

Відкрийте програму на основі моделі в режимі відтворення.
Скопіюйте URL-адресу з рядка адреси браузера.
Видаліть параметри запиту після appid=<guid> цього конкретного сеансу.

MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>

Змінні стану сховища

Цей набір інструментів обчислює ці змінні з MS_AUTH_EMAIL. Не встановлюйте їх безпосередньо.

Шлях	Опис
`.playwright-ms-auth/state-<email>.json`	Power Apps стану автентифікації (тестів canvas/Gen UX)
`.playwright-ms-auth/state-mda-<email>.json`	стан автентифікації Dynamics 365 (тести MDA)

Перевизначити каталог стану сховища:

MS_AUTH_STORAGE_DIR=../../.auth

Позначка CI/CD

Використовуйте цю позначку, щоб настроїти поведінку перевірки для середовищах безперервної інтеграції.

Змінна	За замовчуванням	Опис
`CI`	`false`	Установити `true` в ci, щоб увімкнути `retries: 1`, `forbidOnly`і суворіший час очікування

Драматург читає CI автоматично. Вам не потрібно встановлювати його в .env - трубопровід середовища встановити його за конвенцією.

Зразок файлу ENV

Використовуйте ці приклади як відправну точку для локального .env файлу.

# Authentication
MS_AUTH_EMAIL=testuser@contoso.com
MS_AUTH_CREDENTIAL_TYPE=password
MS_USER_PASSWORD=<your-password>

# App URLs
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-id>
CUSTOM_PAGE_NAME=AccountsCustomPage

Для автентифікації сертифіката:

# Authentication (certificate)
MS_AUTH_EMAIL=testuser@contoso.com
MS_AUTH_CREDENTIAL_TYPE=certificate
MS_AUTH_CREDENTIAL_PROVIDER=local-file
MS_AUTH_LOCAL_FILE_PATH=../../cert/testuser.pfx
MS_AUTH_CERTIFICATE_PASSWORD=<pfx-password>

# App URLs
CANVAS_APP_URL=https://apps.powerapps.com/play/...
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/...

Для Azure Key Vault:

# Authentication (Key Vault)
MS_AUTH_EMAIL=testuser@contoso.com
MS_AUTH_CREDENTIAL_TYPE=certificate
MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault
AZURE_KEYVAULT_URL=https://mykeyvault.vault.azure.net/
AZURE_CERTIFICATE_NAME=playwright-test-cert
AZURE_TENANT_ID=<tenant-guid>

# App URLs
CANVAS_APP_URL=https://apps.powerapps.com/play/...
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/...

Нотатки до системи безпеки

Дотримуйтеся цих вказівок, щоб захистити облікові дані та дані сеансу.

Ніколи не вчиняйте .env файли в елементі керування джерелом. У .gitignore репозиці вони виключаються.
Ніколи не скоюйте .playwright-ms-auth/ файли стану. Вони містять маркери сеансів.
У CI/CD встановіть всі секрети через секретний магазин трубопроводу, а не зареєстрований YAML.