Ingurune-aldagaien erreferentzia

Ingurune-aldagaien erreferentzia honek Power Platform Playwright-en laginen konfigurazio-ezarpen guztiak estaltzen ditu. Garapen lokalari dagokionez, ezarri aldagai hauek .packages/e2e-tests/.env CI/CD-n, ezarri kanalizazioaren sekretu edo aldagai gisa. Kanalizaziorako argibide zehatzak lortzeko, ikus CI/CD integrazioa.

Autentifikazio-aldagaiak

Aldagai horiek kontrolatzen dute proba-esparrua Power Platform zerbitzuen aurka nola autentifikatzen den.

Aldagaia	Beharrezkoa	Deskribapenak
`MS_AUTH_EMAIL`	Bai	Probako erabiltzaile-kontuaren helbide elektronikoa
`MS_AUTH_CREDENTIAL_TYPE`	Bai	Autentifikazio-metodoa: `password` edo `certificate`
`MS_USER_PASSWORD`	Baldin eta `credential_type=password`	Probako erabiltzailearen pasahitza
`MS_AUTH_CREDENTIAL_PROVIDER`	Baldin eta `credential_type=certificate`	Ziurtagiriaren iturburua: `local-file` edo `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Baldin eta `provider=local-file`	Ziurtagiri-fitxategiaren `.pfx` bide-izen erlatiboa
`MS_AUTH_CERTIFICATE_PASSWORD`	Ez	Ziurtagiriaren `.pfx` pasahitza (babestuta badago)

Azure Key Vault aldagaiak

Beharrezkoa denean MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Aldagaia	Deskribapenak
`AZURE_KEYVAULT_URL`	Key Vault URLa, adibidez, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Key Vault-en gordetako ziurtagiriaren izena
`AZURE_TENANT_ID`	Microsoft Entra tenant ID
`AZURE_CLIENT_ID`	(Aukerakoa) Identitate federatuaren bezeroaren ID zerbitzu nagusia

Aplikazioaren URLaren aldagaiak

Aldagai horiek proban dauden aplikazioen URLak zehazten dituzte.

Aldagaia	Beharrezkoa	Deskribapenak
`CANVAS_APP_URL`	Mihisearen probetarako	Zure mihisearen aplikazioaren erreprodukzio moduko URL osoa, besteak beste: `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Ereduetan oinarritutako aplikazioen probetarako	Zure eredu-aplikazioaren URL osoa (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Orrialde pertsonalizatuen probetarako	Orrialdearen webgune-mapa pertsonalizatuaren elementuaren bistaratze-izena, adibidez: `AccountsCustomPage`

Eraiki oihaleko aplikazioaren URLa

Erabili buildCanvasAppUrlFromEnv() tresna-multzotik URLa zati indibidualetatik eraikitzeko, behar izanez gero:

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

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

Ezarri esplizituki honako hauetan .env:

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

Eskuratu ereduan oinarritutako aplikazioaren URLa

Jarraitu urrats hauek zure ereduan oinarritutako aplikazioaren URL egokia aurkitzeko.

Ireki ereduan oinarritutako aplikazioa erreprodukzio moduan.
Kopiatu URLa arakatzailearen helbide-barran.
Kendu kontsulta-parametroak appid=<guid> ondoren saioaren espezifikoak dira.

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

Biltegiratze-egoeraren aldagaiak

Tresna-multzoak aldagai hauek kalkulatzen ditu MS_AUTH_EMAIL. Ez ezarri zuzenean.

Bide-izena	Deskribapenak
`.playwright-ms-auth/state-<email>.json`	Power Apps autentifikazio-egoera (kanvas/Gen UX testak)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 autentifikazio-egoera (MDA testak)

Gainidatzi biltegiratze-egoeraren direktorioa:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD bandera

Erabili bandera hau etengabeko integrazio inguruneetarako proben portaera doitzeko.

Aldagaia	Lehenetsiak	Deskribapenak
`CI`	`false`	Ezarri CI-n `true` , `retries: 1`, eta denbora-muga zorrotzagoak gaitzeko `forbidOnly`

Antzerkigileak automatikoki irakurtzen du CI . Ez duzu ezarri .env beharrik - kanalizazio inguruneek konbentzioaren arabera ezartzen dute.

Adibidea .env fitxategia

Erabili adibide hauek zure fitxategi lokalerako .env abiapuntu gisa.

# 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

Ziurtagiriaren autentifikaziorako:

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

Segurtasun oharrak

Jarraitu praktika hauek kredentzialak eta saioen datuak seguru mantentzeko.

Inoiz ez egikaritu .env fitxategiak iturburu-kontrolean. .gitignore Repo baztertzen ditu.
Inoiz ez egikaritu .playwright-ms-auth/ egoera-fitxategiak. Saioko tokenak dituzte.
CI/CD-n, ezarri sekretu guztiak kanalizazioaren biltegi sekretuaren bidez, ez egiaztatutako YAML-n.