Referenz zu Umgebungsvariablen

Diese Referenz zu Umgebungsvariablen behandelt alle Konfigurationseinstellungen für Power Platform Playwright-Beispiele. Legen Sie für die lokale Entwicklung diese Variablen in packages/e2e-tests/.env. Legen Sie sie in CI/CD als Pipelineschlüssel oder Variablen fest. Pipelinespezifische Anweisungen finden Sie unter CI/CD-Integration.

Authentifizierungsvariablen

Diese Variablen steuern, wie sich das Testframework bei Power Platform-Diensten authentifiziert.

Variable	Erforderlich	Beschreibung
`MS_AUTH_EMAIL`	Ja	E-Mail-Adresse des Testbenutzerkontos
`MS_AUTH_CREDENTIAL_TYPE`	Ja	Authentifizierungsmethode: `password` oder `certificate`
`MS_USER_PASSWORD`	Wenn `credential_type=password`	Kennwort für den Testbenutzer
`MS_AUTH_CREDENTIAL_PROVIDER`	Wenn `credential_type=certificate`	Zertifikatquelle: `local-file` oder `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Wenn `provider=local-file`	Relativer Pfad zur `.pfx` Zertifikatdatei
`MS_AUTH_CERTIFICATE_PASSWORD`	No	Kennwort für das `.pfx` Zertifikat (falls geschützt)

Azure Key Vault Variablen

Erforderlich, wenn MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variable	Beschreibung
`AZURE_KEYVAULT_URL`	Key Vault-URL, z. B. `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Name des in Key Vault gespeicherten Zertifikats
`AZURE_TENANT_ID`	Microsoft Entra Mandanten-ID
`AZURE_CLIENT_ID`	(Optional) Dienstprinzipalclient-ID für Verbundidentität

App-URL-Variablen

Diese Variablen geben die URLs der apps an, die getestet werden.

Variable	Erforderlich	Beschreibung
`CANVAS_APP_URL`	Für Canvastests	Vollständige URL für den Wiedergabemodus Ihrer Canvas-App, einschließlich `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Für modellgesteuerte App-Tests	Vollständige URL Ihrer modellgesteuerten App (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Für benutzerdefinierte Seitentests	Anzeigename des benutzerdefinierten Seiten-Sitemap-Elements, z. B. `AccountsCustomPage`

Erstellen der Canvas-App-URL

Verwenden Sie buildCanvasAppUrlFromEnv() das Toolkit, um bei Bedarf die URL aus einzelnen Teilen zu erstellen:

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

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

Oder legen Sie sie explizit in .env:

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

Abrufen der modellgesteuerten App-URL

Führen Sie die folgenden Schritte aus, um die richtige URL für Ihre modellgesteuerte App zu finden.

Öffnen Sie die modellgesteuerte App im Wiedergabemodus.
Kopieren Sie die URL aus der Adressleiste des Browsers.
Entfernen Sie Abfrageparameter, nachdem appid=<guid> sie sitzungsspezifisch sind.

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

Speicherstatusvariablen

Das Toolkit berechnet diese Variablen aus MS_AUTH_EMAIL. Legen Sie sie nicht direkt fest.

Pfad	Beschreibung
`.playwright-ms-auth/state-<email>.json`	Power Apps Authentifizierungsstatus (Canvas/Gen UX-Tests)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 Authentifizierungsstatus (MDA-Tests)

Überschreiben Sie das Verzeichnis des Speicherstatus:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD-Kennzeichnung

Verwenden Sie dieses Kennzeichen, um das Testverhalten für fortlaufende Integrationsumgebungen anzupassen.

Variable	Vorgabe	Beschreibung
`CI`	`false`	In CI festgelegt, `true` um Timeouts zu aktivieren `retries: 1`, `forbidOnly`und strengere Timeouts

Playwright liest CI automatisch vor. Sie müssen sie nicht festlegen .env – Pipelineumgebungen legen sie nach Konvention fest.

Beispieldatei "env"

Verwenden Sie diese Beispiele als Ausgangspunkt für Ihre lokale .env Datei.

# 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 die Zertifikatauthentifizierung:

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

Sicherheitshinweise

Befolgen Sie diese Methoden, um Anmeldeinformationen und Sitzungsdaten sicher zu halten.

Übernehmen Sie niemals Dateien .env zur Quellcodeverwaltung. Das .gitignore Im Repository schließt sie aus.
Übernehmen Sie niemals .playwright-ms-auth/ Statusdateien. Sie enthalten Sitzungstoken.
Legen Sie in CI/CD alle geheimen Schlüssel über den geheimen Speicher der Pipeline fest, nicht im eingecheckten YAML.

Freigeben über