Reference til miljøvariabler

Denne reference til miljøvariabler dækker alle konfigurationsindstillinger for Eksempler på afspilning af Power Platform. I forbindelse med lokal udvikling skal du angive disse variabler i packages/e2e-tests/.env. I CI/CD skal du angive dem som pipelinehemmeligheder eller variabler. Du kan finde pipelinespecifikke instruktioner under CI/CD-integration.

Godkendelsesvariable

Disse variabler styrer, hvordan teststrukturen godkendes i forhold til Power Platform-tjenester.

Variabel	Påkrævet	Beskrivelse
`MS_AUTH_EMAIL`	Ja	Mailadresse på testbrugerkontoen
`MS_AUTH_CREDENTIAL_TYPE`	Ja	Godkendelsesmetode: `password` eller `certificate`
`MS_USER_PASSWORD`	Hvis `credential_type=password`	Adgangskode til testbrugeren
`MS_AUTH_CREDENTIAL_PROVIDER`	Hvis `credential_type=certificate`	Certifikatkilde: `local-file` eller `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Hvis `provider=local-file`	Relativ sti til `.pfx` certifikatfilen
`MS_AUTH_CERTIFICATE_PASSWORD`	Nej	Adgangskode til certifikatet (hvis det `.pfx` er beskyttet)

Azure Key Vault variabler

Påkrævet, når MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variabel	Beskrivelse
`AZURE_KEYVAULT_URL`	Key Vault URL-adresse, f.eks. `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Navnet på det certifikat, der er gemt i Key Vault
`AZURE_TENANT_ID`	Microsoft Entra lejer-id
`AZURE_CLIENT_ID`	(Valgfrit) Klient-id for tjenesteprincipal for organisationsnetværksidentitet

URL-variabler for app

Disse variabler angiver URL-adresserne for de apps, der testes.

Variabel	Påkrævet	Beskrivelse
`CANVAS_APP_URL`	Til lærredstest	URL-adresse til fuld afspilningstilstand for din lærredsapp, herunder `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Til modeldrevne apptests	Fuld URL-adresse til din modeldrevne app (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Til brugerdefinerede sidetest	Vist navn på det brugerdefinerede sideoversigtselement, f.eks. `AccountsCustomPage`

Opret URL-adressen til lærredsappen

Brug buildCanvasAppUrlFromEnv() fra værktøjskassen til at konstruere URL-adressen fra individuelle dele, hvis det er nødvendigt:

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

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

Eller angiv det eksplicit i .env:

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

Hent URL-adressen til den modeldrevne app

Følg disse trin for at finde den korrekte URL-adresse til din modeldrevne app.

Åbn den modeldrevne app i afspilningstilstand.
Kopiér URL-adressen fra browserens adresselinje.
Fjern forespørgselsparametre, efter appid=<guid> at de er sessionsspecifikke.

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

Variabler for lagringstilstand

Toolkit beregner disse variabler fra MS_AUTH_EMAIL. Angiv dem ikke direkte.

Sti	Beskrivelse
`.playwright-ms-auth/state-<email>.json`	Power Apps godkendelsestilstand (lærreds-/gen-UX-test)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 godkendelsestilstand (MDA-test)

Tilsidesæt mappen med lagertilstande:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD-flag

Brug dette flag til at justere testfunktionsmåden for fortløbende integrationsmiljøer.

Variabel	Standard	Beskrivelse
`CI`	`false`	Angiv til `true` i CI for at aktivere `retries: 1`, `forbidOnly`og strengere timeout

Dramatiker CI læser automatisk. Du behøver ikke at angive den i .env – pipelinemiljøer angiver den efter konvention.

Eksempel på .env-fil

Brug disse eksempler som udgangspunkt for din lokale .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

Til certifikatgodkendelse:

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

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

Sikkerhedsnoter

Følg disse fremgangsmåder for at beskytte legitimationsoplysninger og sessionsdata.

Bekræft .env aldrig filer til versionsstyring. i .gitignore lageret udelukker dem.
Bekræft .playwright-ms-auth/ aldrig tilstandsfiler. De indeholder sessionstokens.
I CI/CD skal du angive alle hemmeligheder via pipelinens hemmelige lager, ikke indtjekket YAML.