Ympäristömuuttujien viittaus

Tämä ympäristömuuttujaviittaus kattaa kaikki Power Platform Playwright -näytteiden määritysasetukset. Määritä nämä muuttujat paikalliselle kehitykselle kohteessa packages/e2e-tests/.env. Määritä CI/CD:ssä ne putkisalaisiksi tai muuttujiksi. Putkikohtaiset ohjeet ovat kohdassa CI/CD-integrointi.

Todennusmuuttujat

Nämä muuttujat ohjaavat sitä, miten testikehys todennetaan Power Platform -palveluissa.

Muuttuja	Pakollinen	Description
`MS_AUTH_EMAIL`	Kyllä	Testikäyttäjätilin sähköpostiosoite
`MS_AUTH_CREDENTIAL_TYPE`	Kyllä	Todennusmenetelmä: `password` tai `certificate`
`MS_USER_PASSWORD`	Jos `credential_type=password`	Testikäyttäjän salasana
`MS_AUTH_CREDENTIAL_PROVIDER`	Jos `credential_type=certificate`	Varmenteen lähde: `local-file` tai `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Jos `provider=local-file`	Varmennetiedoston `.pfx` suhteellinen polku
`MS_AUTH_CERTIFICATE_PASSWORD`	Ei	Varmenteen `.pfx` salasana (jos suojattu)

Azure Key Vault muuttujia

Pakollinen, kun MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Muuttuja	Description
`AZURE_KEYVAULT_URL`	Key Vault URL-osoite, esimerkiksi `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Key Vault tallennetun varmenteen nimi
`AZURE_TENANT_ID`	vuokraajan Microsoft Entra tunnus
`AZURE_CLIENT_ID`	(Valinnainen) Palvelun päänimen asiakastunnus yhdistettyjä käyttäjätietoja varten

Sovelluksen URL-muuttujat

Nämä muuttujat määrittävät testattavien sovellusten URL-osoitteet.

Muuttuja	Pakollinen	Description
`CANVAS_APP_URL`	Pohjan testeille	Pohjaan perustuvan sovelluksesi koko toistotilan URL-osoite, mukaan lukien `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Mallipohjaisten sovellusten testit	Mallipohjaisen sovelluksesi koko URL-osoite (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Mukautetut sivutestit	Mukautetun sivusivustokarttakohteen näyttönimi, kuten `AccountsCustomPage`

Pohjaan perustuvan sovelluksen URL-osoitteen luominen

Muodosta buildCanvasAppUrlFromEnv() URL-osoite työkalupakista tarvittaessa yksittäisistä osista:

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

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

Tai määritä se eksplisiittisesti kohteessa .env:

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

Mallipohjaisen sovelluksen URL-osoitteen hankkiminen

Etsi mallipohjaiselle sovelluksellesi oikea URL-osoite seuraavasti.

Avaa mallipohjainen sovellus toistotilassa.
Kopioi URL-osoite selaimen osoiteriviltä.
Poista kyselyparametrit, kun appid=<guid> ne ovat istuntokohtaisia.

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

Tallennustilan tilan muuttujat

Toolkit laskee nämä muuttujat kohteesta MS_AUTH_EMAIL. Älä aseta niitä suoraan.

Polku	Description
`.playwright-ms-auth/state-<email>.json`	Power Apps todennustila (canvas/Gen UX -testit)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 todennustila (MDA-testit)

Tallennustilan tilan hakemiston ohittaminen:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD-merkintä

Tämän merkinnän avulla voit säätää jatkuvan integroinnin ympäristöjen testitoimintaa.

Muuttuja	Oletus	Description
`CI`	`false`	Määritä arvoksi `true` CI: `retries: 1`ssä , `forbidOnly`, ja tiukemmat aikakatkaisut

Playwright lukee CI automaattisesti. Sinun ei tarvitse määrittää sitä – .env putkiympäristöt määrittävät sen käytännön mukaan.

.env-mallitiedosto

Käytä näitä esimerkkejä aloituspisteenä paikalliselle .env tiedostolle.

# 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

Varmennetodentaminen:

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

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

Suojaustiedot

Noudata näitä käytäntöjä tunnistetietojen ja istunnon tietojen suojaamiseksi.

Älä koskaan vahvista .env tiedostoja lähteen hallintaan. - .gitignore säilössä ei sisällä niitä.
Älä koskaan vahvista .playwright-ms-auth/ tilatiedostoja. Ne sisältävät istuntotunnuksia.
Määritä CI/CD:ssä kaikki salaiset koodit putken salaisen säilön kautta (ei tarkastetussa YAML:ssä).