Referens för miljövariabler

Referensen för miljövariabler omfattar alla konfigurationsinställningar för Power Platform Playwright-exempel. För lokal utveckling anger du dessa variabler i packages/e2e-tests/.env. I CI/CD anger du dem som pipelinehemligheter eller variabler. Anvisningar för pipeline finns i CI/CD-integrering.

Autentiseringsvariabler

Dessa variabler styr hur testramverket autentiserar mot Power Platform-tjänster.

Variable	Obligatoriskt	Beskrivning
`MS_AUTH_EMAIL`	Yes	E-postadress för testanvändarkontot
`MS_AUTH_CREDENTIAL_TYPE`	Yes	Autentiseringsmetod: `password` eller `certificate`
`MS_USER_PASSWORD`	Om `credential_type=password`	Lösenord för testanvändaren
`MS_AUTH_CREDENTIAL_PROVIDER`	Om `credential_type=certificate`	Certifikatkälla: `local-file` eller `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Om `provider=local-file`	Relativ sökväg till `.pfx` certifikatfilen
`MS_AUTH_CERTIFICATE_PASSWORD`	No	Lösenord för certifikatet (om det `.pfx` är skyddat)

Azure Key Vault variabler

Krävs när MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variable	Beskrivning
`AZURE_KEYVAULT_URL`	Key Vault URL, till exempel `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Namnet på certifikatet som lagras i Key Vault
`AZURE_TENANT_ID`	Klient-ID för Microsoft Entra
`AZURE_CLIENT_ID`	(Valfritt) Klient-ID för tjänstens huvudnamn för federerad identitet

App-URL-variabler

Dessa variabler anger URL:er för de appar som testas.

Variable	Obligatoriskt	Beskrivning
`CANVAS_APP_URL`	För arbetsytetester	Fullständig url för uppspelningsläge för din arbetsyteapp, inklusive `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	För modelldrivna apptester	Fullständig URL för din modelldrivna app (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	För anpassade sidtester	Visningsnamn för det anpassade sidwebbplatsmappobjektet, till exempel `AccountsCustomPage`

Skapa webbadressen till arbetsyteappen

Använd buildCanvasAppUrlFromEnv() från verktygslådan för att konstruera URL:en från enskilda delar om det behövs:

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

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

Eller ange det explicit i .env:

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

Hämta den modelldrivna app-URL:en

Följ de här stegen för att hitta rätt URL för din modelldrivna app.

Öppna den modelldrivna appen i uppspelningsläge.
Kopiera URL:en från webbläsarens adressfält.
Ta bort frågeparametrar efter appid=<guid> som är sessionsspecifika.

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

Variabler för lagringstillstånd

Verktygslådan beräknar dessa variabler från MS_AUTH_EMAIL. Ställ inte in dem direkt.

Väg	Beskrivning
`.playwright-ms-auth/state-<email>.json`	Power Apps autentiseringstillstånd (arbetsyte-/gen-UX-tester)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 autentiseringstillstånd (MDA-tester)

Åsidosätt lagringstillståndskatalogen:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD-flagga

Använd den här flaggan för att justera testbeteendet för miljöer för kontinuerlig integrering.

Variable	Default	Beskrivning
`CI`	`false`	Ange till `true` i CI för att aktivera `retries: 1`, `forbidOnly`och striktare tidsgränser

Dramatikern läser CI automatiskt. Du behöver inte ange den i .env – pipelinemiljöer som anges av konventionen.

Exempel på .env-fil

Använd de här exemplen som utgångspunkt för din lokala .env fil.

# 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

För certifikatautentisering:

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

För 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/...

Säkerhetsanvisningar

Följ dessa metoder för att skydda autentiseringsuppgifter och sessionsdata.

Checka aldrig in .env filer till källkontrollen. I .gitignore lagringsplatsen exkluderas dem.
Checka aldrig in .playwright-ms-auth/ tillståndsfiler. De innehåller sessionstoken.
I CI/CD anger du alla hemligheter via pipelinens hemliga arkiv, inte i incheckad YAML.