Környezeti változók referenciája

Ez a környezeti változókra vonatkozó referencia a Power Platform Playwright-minták összes konfigurációs beállítására vonatkozik. A helyi fejlesztéshez állítsa be ezeket a változókat a következőben packages/e2e-tests/.env: . A CI/CD-ben állítsa be őket folyamattitkokként vagy változókként. A folyamatspecifikus utasításokért lásd a CI/CD-integrációt.

Hitelesítési változók

Ezek a változók szabályozzák, hogy a tesztelési keretrendszer hogyan hitelesít a Power Platform-szolgáltatásokon.

Variable	Szükséges	Description
`MS_AUTH_EMAIL`	Igen	A teszt felhasználói fiók e-mail-címe
`MS_AUTH_CREDENTIAL_TYPE`	Igen	Hitelesítési módszer: `password` vagy `certificate`
`MS_USER_PASSWORD`	Ha `credential_type=password`	A tesztfelhasználó jelszava
`MS_AUTH_CREDENTIAL_PROVIDER`	Ha `credential_type=certificate`	Tanúsítvány forrása: `local-file` vagy `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Ha `provider=local-file`	A tanúsítványfájl relatív elérési útja `.pfx`
`MS_AUTH_CERTIFICATE_PASSWORD`	No	`.pfx` A tanúsítvány jelszava (ha védett)

Azure Key Vault változók

Kötelező, ha MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variable	Description
`AZURE_KEYVAULT_URL`	Key Vault URL-cím, például `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	A Key Vault tárolt tanúsítvány neve
`AZURE_TENANT_ID`	Microsoft Entra-bérlőazonosító
`AZURE_CLIENT_ID`	(Nem kötelező) Szolgáltatásnév ügyfélazonosítója összevont identitáshoz

Alkalmazás URL-változói

Ezek a változók határozzák meg a tesztelt alkalmazások URL-címét.

Variable	Szükséges	Description
`CANVAS_APP_URL`	Vászontesztekhez	A vászonalapú alkalmazás teljes lejátszási módú URL-címe, beleértve a `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Modellalapú alkalmazástesztekhez	A modellalapú alkalmazás teljes URL-címe (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Egyéni oldaltesztekhez	Az egyéni oldal webhelytérképelemének megjelenítendő neve, például `AccountsCustomPage`

Vászonalapú alkalmazás URL-címének létrehozása

Az buildCanvasAppUrlFromEnv() eszközkészletből szükség esetén az URL-címet az egyes részekből hozhatja létre:

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

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

Vagy állítsa be explicit módon a következőben .env:

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

A modellalapú alkalmazás URL-címének lekérése

Kövesse az alábbi lépéseket a modellalapú alkalmazás megfelelő URL-címének megkereséséhez.

Nyissa meg a modellalapú alkalmazást lejátszási módban.
Másolja ki az URL-címet a böngésző címsorából.
A munkamenet-specifikus lekérdezési paraméterek eltávolítása.appid=<guid>

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

Tárolási állapot változói

Az eszközkészlet ezeket a változókat a következőből számítja ki MS_AUTH_EMAIL: . Ne állítsa be őket közvetlenül.

Útvonal	Description
`.playwright-ms-auth/state-<email>.json`	Power Apps hitelesítési állapot (vászon-/gen UX-tesztek)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 hitelesítési állapot (MDA-tesztek)

A tárolási állapot könyvtárának felülbírálása:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD-jelző

Ezzel a jelző használatával módosíthatja a tesztelési viselkedést a folyamatos integrációs környezetekben.

Variable	Default	Description
`CI`	`false`	Állítsa be a `true` CI-ben a szigorúbb `retries: 1`időtúllépések engedélyezéséhez `forbidOnly`és a szigorúbb időtúllépésekhez

A drámaíró automatikusan felolvassa CI . Nem kell konvenció szerint beállítania .env a folyamatkörnyezetekben.

Minta .env fájl

Használja ezeket a példákat kiindulópontként a helyi .env fájlhoz.

# 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

Tanúsítványhitelesítéshez:

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

Azure Key Vault esetén:

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

Biztonsági megjegyzések

Kövesse az alábbi eljárásokat a hitelesítő adatok és a munkamenetek adatainak védelme érdekében.

Soha ne véglegesítse .env a fájlokat a forrásvezérlőben. Az .gitignore adattár kizárja őket.
Soha ne véglegesítse .playwright-ms-auth/ az állapotfájlokat. Munkamenet-jogkivonatokat tartalmaznak.
A CI/CD-ben állítsa be az összes titkos kulcsot a folyamat titkos tárolóján keresztül, nem pedig a bejelentkezett YAML-ben.