Naslaginformatie over omgevingsvariabelen

Deze referentie voor omgevingsvariabelen omvat alle configuratie-instellingen voor Power Platform Playwright-voorbeelden. Voor lokale ontwikkeling stelt u deze variabelen in packages/e2e-tests/.env. Stel deze in CI/CD in als pijplijngeheimen of -variabelen. Zie CI/CD-integratie voor specifieke instructies voor pijplijnen.

Verificatievariabelen

Deze variabelen bepalen hoe het testframework wordt geverifieerd voor Power Platform-services.

Variable	Verplicht	Beschrijving
`MS_AUTH_EMAIL`	Ja	E-mailadres van het testgebruikersaccount
`MS_AUTH_CREDENTIAL_TYPE`	Ja	Verificatiemethode: `password` of `certificate`
`MS_USER_PASSWORD`	Als `credential_type=password`	Wachtwoord voor de testgebruiker
`MS_AUTH_CREDENTIAL_PROVIDER`	Als `credential_type=certificate`	Certificaatbron: `local-file` of `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Als `provider=local-file`	Relatief pad naar het `.pfx` certificaatbestand
`MS_AUTH_CERTIFICATE_PASSWORD`	No	Wachtwoord voor het `.pfx` certificaat (indien beveiligd)

variabelen Azure Key Vault

Vereist wanneer MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variable	Beschrijving
`AZURE_KEYVAULT_URL`	Key Vault URL, bijvoorbeeld `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Naam van het certificaat dat is opgeslagen in Key Vault
`AZURE_TENANT_ID`	tenant-id Microsoft Entra
`AZURE_CLIENT_ID`	(Optioneel) Client-id van service-principal voor federatieve identiteit

URL-variabelen voor apps

Deze variabelen geven de URL's van de apps op die worden getest.

Variable	Verplicht	Beschrijving
`CANVAS_APP_URL`	Voor canvastests	Volledige play-mode-URL van uw canvas-app, inclusief `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Voor modelgestuurde app-tests	Volledige URL van uw modelgestuurde app (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Voor aangepaste paginatests	Weergavenaam van het aangepaste siteoverzichtsitem, zoals `AccountsCustomPage`

De URL van de canvas-app bouwen

Gebruik buildCanvasAppUrlFromEnv() vanuit de toolkit om de URL van afzonderlijke onderdelen samen te stellen, indien nodig:

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

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

U kunt deze ook expliciet instellen in .env:

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

De URL van de modelgestuurde app ophalen

Volg deze stappen om de juiste URL voor uw modelgestuurde app te vinden.

Open de modelgestuurde app in de afspeelmodus.
Kopieer de URL uit de adresbalk van de browser.
Verwijder daarna appid=<guid> queryparameters die specifiek zijn voor sessies.

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

Variabelen voor opslagstatus

De toolkit berekent deze variabelen van MS_AUTH_EMAIL. Stel ze niet rechtstreeks in.

Path	Beschrijving
`.playwright-ms-auth/state-<email>.json`	Power Apps verificatiestatus (canvas/Gen UX-tests)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 verificatiestatus (MDA-tests)

De opslagstatusmap overschrijven:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD-vlag

Gebruik deze vlag om het testgedrag voor continue integratieomgevingen aan te passen.

Variable	Verstek	Beschrijving
`CI`	`false`	Ingesteld op `true` in CI om time-outs in te schakelen `retries: 1`, `forbidOnly`en strengere time-outs

Playwright leest CI automatisch. U hoeft deze niet in te stellen in .env : pijplijnomgevingen stellen deze standaard in.

Voorbeeldbestand .env

Gebruik deze voorbeelden als uitgangspunt voor uw lokale .env bestand.

# 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

Voor certificaatverificatie:

# 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/...

Voor 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/...

Opmerkingen over beveiliging

Volg deze procedures om referenties en sessiegegevens veilig te houden.

Voer nooit bestanden door .env naar broncodebeheer. De .gitignore in de opslagplaats sluit ze uit.
Voer nooit statusbestanden door .playwright-ms-auth/ . Ze bevatten sessietokens.
Stel in CI/CD alle geheimen in via het geheime archief van de pijplijn, niet in ingecheckte YAML.