Референца варијабли окружења

Ова референца варијабли окружења покрива сва подешавања конфигурације за узорке Повер Платформ Плаyвригхт-а. За локални развој, подесите ове варијабле у packages/e2e-tests/.env. У ЦИ / ЦД-у, поставите их као тајне или варијабле цевовода. За упутства специфична за цевовод погледајте ЦИ / ЦД интеграцију .

Променљиве аутентификације

Ове варијабле контролишу како се тест оквир аутентификује у односу на Повер Платформ услуге.

Променљива	Обавезно	Опис
`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` сертификат (ако је заштићена)

< ДИЦТ__Азуре ⚐ Кеy ⚐ Ваулт > Азуре Кеy Ваулт варијабле

Потребно када MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Променљива	Опис
`AZURE_KEYVAULT_URL`	< ДИЦТ__Кеy ⚐ Ваулт > Кеy Ваулт УРЛ, на пример, &лт;c0 /&гт;
`AZURE_CERTIFICATE_NAME`	Назив сертификата који се чува у < ДИЦТ__Кеy ⚐ Ваулт > Кеy Ваулт
`AZURE_TENANT_ID`	< ДИЦТ__Мицрософт ⚐ Ентра > Мицрософт Ентра ИД станара
`AZURE_CLIENT_ID`	(Опционо) ИД клијента главног сервиса за федеративни идентитет

Променљиве УРЛ адресе апликације

Ове варијабле одређују УРЛ адресе апликација које се тестирају.

Променљива	Обавезно	Опис
`CANVAS_APP_URL`	За тестове платна	Пуна УРЛ адреса за репродукцију ваше апликације за платно, укључујући `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	За тестове апликација заснованих на моделу	Пуна УРЛ адреса ваше апликације засноване на моделу ( `/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	За прилагођене тестове страница	Приказно име ставке мапе прилагођене странице, као што је `AccountsCustomPage`

Изградите УРЛ адресу апликације за платно

Користите buildCanvasAppUrlFromEnv() из алата да направите УРЛ из појединачних делова ако је потребно:

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>

Набавите УРЛ адресу апликације засноване на моделу

Следите ове кораке да бисте пронашли тачан УРЛ за апликацију засновану на моделу.

Отворите апликацију засновану на моделу у режиму репродукције.
Копирајте УРЛ адресу из траке за адресу претраживача.
Уклоните параметре упита након 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`	< ДИЦТ__Поwер ⚐ Аппс > Поwер Аппс стање аутентификације (платно / Ген УКС тестови)
`.playwright-ms-auth/state-mda-<email>.json`	< ДИЦТ__Дyнамицс ⚐ 365 > Дyнамицс 365 аутх држава (МДА тестови)

Премостите директоријум стања складиштења:

MS_AUTH_STORAGE_DIR=../../.auth

ЦИ / ЦД застава

Користите ову заставицу да бисте прилагодили понашање теста за окружења континуиране интеграције.

Променљива	Подразумевана	Опис
`CI`	`false`	Подесите на `true` у ЦИ да бисте омогућили `retries: 1`, `forbidOnly` и строжије тајм-ауте

Драматург чита CI аутоматски. Не морате да га подесите у .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/...

За < ДИЦТ__Азуре ⚐ Кеy ⚐ Ваулт > Азуре Кеy Ваулт :

# 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/ државне фајлове. Они садрже токене сесије.
У ЦИ/ЦД-у, подесите све тајне преко тајног складишта цевовода, а не у YАМЛ-у.