Atsauce uz vides mainīgajiem lielumiem

Šī vides mainīgo atsauce aptver visus Power Platform Playwright paraugu konfigurācijas iestatījumus. Vietējai attīstībai iestatiet šos mainīgos lielumus .packages/e2e-tests/.env CI/CD iestatiet tos kā konveijera noslēpumus vai mainīgos. Norādījumus par konveijeru skatiet sadaļā CI/CD integrācija.

Autentifikācijas mainīgie

Šie mainīgie kontrolē, kā testa struktūra autentificējas Power Platform pakalpojumos.

Mainīgā	Obligāts	Apraksts
`MS_AUTH_EMAIL`	Jā	Testa lietotāja konta e-pasta adrese
`MS_AUTH_CREDENTIAL_TYPE`	Jā	Autentifikācijas metode: `password` vai `certificate`
`MS_USER_PASSWORD`	Ja `credential_type=password`	Testa lietotāja parole
`MS_AUTH_CREDENTIAL_PROVIDER`	Ja `credential_type=certificate`	Sertifikāta avots: `local-file` vai `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Ja `provider=local-file`	Relatīvais `.pfx` ceļš uz sertifikāta failu
`MS_AUTH_CERTIFICATE_PASSWORD`	Nē.	Sertifikāta parole `.pfx` (ja aizsargāta)

Azure Key Vault mainīgie

Nepieciešams, ja MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Mainīgā	Apraksts
`AZURE_KEYVAULT_URL`	Key Vault URL, piemēram, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Key Vault glabātā sertifikāta nosaukums
`AZURE_TENANT_ID`	Microsoft Entra nomnieka ID
`AZURE_CLIENT_ID`	(Pēc izvēles) Pakalpojuma galvenā klienta ID federētajai identitātei

Lietotnes URL mainīgie

Šie mainīgie norāda testējamo lietotņu URL.

Mainīgā	Obligāts	Apraksts
`CANVAS_APP_URL`	Audekla testiem	Jūsu audekla programmas pilns atskaņošanas režīma URL, tostarp `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Modeļa vadītu programmu testiem	Pilns jūsu modeļa vadītās programmas URL (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Pielāgotiem lapu testiem	Pielāgotās lapas vietnes kartes vienuma parādāmais nosaukums, piemēram, `AccountsCustomPage`

Audekla programmas URL izveide

Izmantojiet buildCanvasAppUrlFromEnv() rīkkopu, lai izveidotu URL no atsevišķām daļām, ja nepieciešams:

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

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

Vai arī iestatiet to skaidri :.env

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

Modeļa vadītas programmas URL iegūšana

Veiciet tālāk norādītās darbības, lai atrastu pareizo URL savai modeļa vadītai programmai.

Atveriet modeļa vadītu programmu atskaņošanas režīmā.
Kopējiet URL no pārlūkprogrammas adreses joslas.
Pēc tam appid=<guid> noņemiet vaicājuma parametrus, kas ir specifiski sesijai.

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

Krātuves stāvokļa mainīgie lielumi

Rīkkopa aprēķina šos mainīgos no MS_AUTH_EMAIL. Neiestatiet tos tieši.

Ceļš	Apraksts
`.playwright-ms-auth/state-<email>.json`	Power Apps autentifikācijas stāvoklis (audekla/Gen UX testi)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 autentifikācijas stāvoklis (MDA testi)

Ignorējiet krātuves stāvokļa direktoriju:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD karodziņš

Izmantojiet šo karodziņu, lai pielāgotu testa darbību nepārtrauktas integrācijas vidēs.

Mainīgā	Noklusējuma vērtība	Apraksts
`CI`	`false`	Iestatiet uz `true` CI, lai iespējotu `retries: 1`, `forbidOnly`un stingrākus taimautus

Dramaturgs lasa CI automātiski. Jums tas nav jāiestata .env — konveijera vide to nosaka pēc konvencijas.

.env faila paraugs

Izmantojiet šos piemērus kā lokālā .env faila sākumpunktu.

# 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

Sertifikāta autentifikācijai:

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

Drošības piezīmes

Ievērojiet šo praksi, lai saglabātu akreditācijas datus un sesijas datus drošībā.

Nekad nenododiet .env failus avota kontrolei. Repo .gitignore tos izslēdz.
Nekad neveiciet .playwright-ms-auth/ valsts failus. Tie satur sesijas marķierus.
CI/CD iestatiet visus noslēpumus, izmantojot cauruļvada slepeno krātuvi, nevis reģistrēto YAML.