Referanse for miljøvariabler

Referansen for miljøvariabler dekker alle konfigurasjonsinnstillinger for Eksempler på Power Platform Playwright. Angi disse variablene i packages/e2e-tests/.envfor lokal utvikling. Angi dem som datasamlebåndhemmeligheter eller variabler i CI/CD. Hvis du vil ha informasjon om datasamlebåndspesifikke instruksjoner, kan du se CI/CD-integrasjon.

Godkjenningsvariabler

Disse variablene kontrollerer hvordan testrammeverket godkjenner mot Power Platform-tjenester.

Variabel	Påkrevd	Beskrivelse
`MS_AUTH_EMAIL`	Ja	E-postadressen til testbrukerkontoen
`MS_AUTH_CREDENTIAL_TYPE`	Ja	Godkjenningsmetode: `password` eller `certificate`
`MS_USER_PASSWORD`	Hvis `credential_type=password`	Passord for testbrukeren
`MS_AUTH_CREDENTIAL_PROVIDER`	Hvis `credential_type=certificate`	Sertifikatkilde: `local-file` eller `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Hvis `provider=local-file`	Relativ bane til `.pfx` sertifikatfilen
`MS_AUTH_CERTIFICATE_PASSWORD`	Nei	Passord for sertifikatet `.pfx` (hvis beskyttet)

Azure Key Vault variabler

Obligatorisk når MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variabel	Beskrivelse
`AZURE_KEYVAULT_URL`	Key Vault URL-adresse, for eksempel `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Navnet på sertifikatet som er lagret i Key Vault
`AZURE_TENANT_ID`	Microsoft Entra leier-ID
`AZURE_CLIENT_ID`	(Valgfritt) Klient-ID for tjenestekontohaver for organisasjonsbasert identitet

Url-variabler for app

Disse variablene angir nettadressene til appene under test.

Variabel	Påkrevd	Beskrivelse
`CANVAS_APP_URL`	For lerretstester	Nettadresse for full avspillingsmodus for lerretsappen, inkludert `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	For modelldrevne apptester	Fullstendig NETTADRESSE for den modelldrevne appen (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	For egendefinerte sidetester	Visningsnavn for det egendefinerte sideområdekartelementet, for eksempel `AccountsCustomPage`

Bygge nettadressen for lerretsappen

Bruk buildCanvasAppUrlFromEnv() fra verktøysettet til å konstruere nettadressen fra individuelle deler om nødvendig:

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

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

Eller angi det eksplisitt i .env:

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

Få nettadressen til den modelldrevne appen

Følg disse trinnene for å finne riktig NETTADRESSE for den modelldrevne appen.

Åpne den modelldrevne appen i avspillingsmodus.
Kopier nettadressen fra adresselinjen i nettleseren.
Fjern spørringsparametere etter appid=<guid> det som er øktspesifikke.

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

Variabler for lagringstilstand

Verktøysettet beregner disse variablene fra MS_AUTH_EMAIL. Ikke angi dem direkte.

Sti	Beskrivelse
`.playwright-ms-auth/state-<email>.json`	Power Apps godkjenningstilstand (lerrets-/gen-UX-tester)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 godkjenningstilstand (MDA-tester)

Overstyr lagringsstatuskatalogen:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD-flagg

Bruk dette flagget til å justere testvirkemåten for miljøer for kontinuerlig integrering.

Variabel	Forhåndsinnstilt	Beskrivelse
`CI`	`false`	Angi til `true` i CI for å aktivere `retries: 1`, `forbidOnly`og strengere tidsavbrudd

Dramatiker leser CI automatisk. Du trenger ikke å angi den i .env – samlebåndmiljøer angir den etter konvensjon.

Eksempel på ENV-fil

Bruk disse eksemplene som utgangspunkt for den lokale .env filen.

# 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

For sertifikatgodkjenning:

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

Sikkerhetsnotater

Følg disse fremgangsmåtene for å sikre legitimasjon og øktdata.

Utfør .env aldri filer til kildekontroll. I .gitignore repo utelater de dem.
Utfør .playwright-ms-auth/ aldri tilstandsfiler. De inneholder økttokener.
I CI/CD kan du angi alle hemmeligheter via rørledningens hemmelige butikk, ikke i innsjekket YAML.

Del via