Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette référence des variables d’environnement couvre tous les paramètres de configuration des exemples Power Platform Playwright. Pour le développement local, définissez ces variables dans packages/e2e-tests/.env. Dans CI/CD, définissez-les en tant que secrets ou variables de pipeline. Pour obtenir des instructions spécifiques au pipeline, consultez intégration CI/CD.
Variables d’authentification
Ces variables contrôlent la façon dont l’infrastructure de test s’authentifie auprès des services Power Platform.
| Variable | Obligatoire | Description |
|---|---|---|
MS_AUTH_EMAIL |
Yes | Adresse e-mail du compte d’utilisateur de test |
MS_AUTH_CREDENTIAL_TYPE |
Yes | Méthode d’authentification : password ou certificate |
MS_USER_PASSWORD |
Si credential_type=password |
Mot de passe de l’utilisateur de test |
MS_AUTH_CREDENTIAL_PROVIDER |
Si credential_type=certificate |
Source de certificat : local-file ou azure-keyvault |
MS_AUTH_LOCAL_FILE_PATH |
Si provider=local-file |
Chemin relatif du fichier de .pfx certificat |
MS_AUTH_CERTIFICATE_PASSWORD |
No | Mot de passe du .pfx certificat (si protégé) |
variables Azure Key Vault
Obligatoire quand MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:
| Variable | Description |
|---|---|
AZURE_KEYVAULT_URL |
URL Key Vault, par exemple, https://<vault-name>.vault.azure.net/ |
AZURE_CERTIFICATE_NAME |
Nom du certificat stocké dans Key Vault |
AZURE_TENANT_ID |
ID de client Microsoft Entra |
AZURE_CLIENT_ID |
(Facultatif) ID client du principal de service pour l’identité fédérée |
Variables d’URL de l’application
Ces variables spécifient les URL des applications testées.
| Variable | Obligatoire | Description |
|---|---|---|
CANVAS_APP_URL |
Pour les tests de canevas | URL en mode lecture complète de votre application canevas, y compris ?tenantId=<id> |
MODEL_DRIVEN_APP_URL |
Pour les tests d’application pilotés par modèle | URL complète de votre application pilotée par modèle (/main.aspx?appid=<id>) |
CUSTOM_PAGE_NAME |
Pour les tests de page personnalisés | Nom complet de l’élément de plan de page personnalisé, par exemple AccountsCustomPage |
Générer l’URL de l’application canevas
Utilisez buildCanvasAppUrlFromEnv() le kit de ressources pour construire l’URL à partir de parties individuelles si nécessaire :
import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';
const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment
Ou définissez-le explicitement dans .env:
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
Obtenir l’URL de l’application pilotée par modèle
Suivez ces étapes pour rechercher l’URL correcte pour votre application pilotée par modèle.
- Ouvrez l’application pilotée par modèle en mode lecture.
- Copiez l’URL à partir de la barre d’adresses du navigateur.
- Supprimez les paramètres de requête après
appid=<guid>cela spécifiques à la session.
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>
Variables d’état de stockage
Le kit de ressources calcule ces variables à partir de MS_AUTH_EMAIL. Ne les définissez pas directement.
| Chemin d’accès | Description |
|---|---|
.playwright-ms-auth/state-<email>.json |
Power Apps’état d’authentification (tests canvas/Gen UX) |
.playwright-ms-auth/state-mda-<email>.json |
Dynamics 365'état d’authentification (tests MDA) |
Remplacez le répertoire d’état de stockage :
MS_AUTH_STORAGE_DIR=../../.auth
Indicateur CI/CD
Utilisez cet indicateur pour ajuster le comportement de test pour les environnements d’intégration continue.
| Variable | Default | Description |
|---|---|---|
CI |
false |
true Défini sur ci pour activer retries: 1, forbidOnlyet des délais d’expiration plus stricts |
Le playwright lit CI automatiquement. Vous n’avez pas besoin de le définir dans .env les environnements de pipeline définis par convention.
Exemple de fichier .env
Utilisez ces exemples comme point de départ pour votre fichier local .env .
# 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
Pour l’authentification par certificat :
# 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/...
Pour 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/...
Notes de sécurité
Suivez ces pratiques pour sécuriser les informations d’identification et les données de session.
- Ne validez
.envjamais les fichiers dans le contrôle de code source. Le.gitignoredépôt les exclut. - Ne jamais valider
.playwright-ms-auth/les fichiers d’état. Ils contiennent des jetons de session. - Dans CI/CD, définissez tous les secrets via le magasin de secrets du pipeline, et non dans YAML archivé.