Keskkonnamuutujate viide

See keskkonnamuutujate viide hõlmab kõiki Power Platform Playwrighti näidiste konfiguratsioonisätteid. Kohalikuks arenguks määrake need muutujad asukohas packages/e2e-tests/.env. Määrake CI-s/CD-s need konveieri saladusteks või muutujateks. Konveierikohased juhised leiate teemast CI/CD integreerimine.

Autentimismuutujad

Need muutujad juhivad seda, kuidas testraamistik Power Platformi teenuste suhtes autendib.

Muutuja	Nõutav	Kirjeldus
`MS_AUTH_EMAIL`	Jah	Testkasutaja konto meiliaadress
`MS_AUTH_CREDENTIAL_TYPE`	Jah	Autentimismeetod: `password` või `certificate`
`MS_USER_PASSWORD`	Kui `credential_type=password`	Testkasutaja parool
`MS_AUTH_CREDENTIAL_PROVIDER`	Kui `credential_type=certificate`	Serdi allikas: `local-file` või `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Kui `provider=local-file`	Serdifaili `.pfx` suhteline tee
`MS_AUTH_CERTIFICATE_PASSWORD`	Nr	Serdi parool (kui see on `.pfx` kaitstud)

muutujate Azure Key Vault

Nõutav, kui MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Muutuja	Kirjeldus
`AZURE_KEYVAULT_URL`	Key Vault URL,nt `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Key Vault talletatud serdi nimi
`AZURE_TENANT_ID`	Microsoft Entra rentniku ID
`AZURE_CLIENT_ID`	(Valikuline) Teenusesubjekti kliendi ID liitidentiteedi jaoks

Rakenduse URL-i muutujad

Need muutujad määravad testitavate rakenduste URL-id.

Muutuja	Nõutav	Kirjeldus
`CANVAS_APP_URL`	Lõuenditestide jaoks	Lõuendirakenduse täielik esitusrežiimi URL, sh `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Mudelipõhiste rakendusetestide jaoks	Mudelipõhise rakenduse täielik URL (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Kohandatud lehetestide jaoks	Kohandatud lehesaidikaardi üksuse kuvatav nimi (nt `AccountsCustomPage`

Lõuendirakenduse URL-i koostamine

Kasutage buildCanvasAppUrlFromEnv() tööriistakomplektist URL-i koostamiseks vajaduse korral üksikutest osadest.

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

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

Või määrake see konkreetselt :.env

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

Mudelipõhise rakenduse URL-i hankimine

Mudelipõhise rakenduse jaoks õige URL-i leidmiseks tehke järgmist.

Avage mudelipõhine rakendus esitusrežiimis.
Kopeerige URL brauseri aadressiribalt.
Eemaldage päringuparameetrid pärast appid=<guid> seda, kui need on seansikohased.

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

Salvestusruumi olekumuutujad

Tööriistakomplekt arvutab need muutujad rakendusest MS_AUTH_EMAIL. Ärge seadke neid otse.

Tee	Kirjeldus
`.playwright-ms-auth/state-<email>.json`	Power Apps autentimisolek (lõuendi/gen UX-i testid)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 autentimisolek (MDA testid)

Alistada salvestusoleku kataloog:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD lipp

Selle lipu abil saate reguleerida pideva integreerimise keskkondade testikäitumist.

Muutuja	Vaikesäte	Kirjeldus
`CI`	`false`	Seadke `true` sisse CI, et lubada `retries: 1`, `forbidOnly`ja rangemad ajalõpud

Playwright loeb CI automaatselt ette. Te ei pea seda häälestama konveierikeskkondades .env , mis on määratud tavakeskkonnas.

ENV-näidisfail

Neid näiteid saate kasutada kohaliku .env faili alguspunktina.

# 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

Serdi autentimiseks tehke järgmist.

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

Turbemärkmed

Identimisteabe ja seansiandmete turvalisuse tagamiseks järgige neid tavasid.

Ärge kunagi kinnitage .env faile lähtekontrollile. .gitignore Hoidlas välistatakse need.
Ärge kunagi kinnitage .playwright-ms-auth/ olekufaile. Need sisaldavad seansitõendeid.
Määrake CI/CD-s kõik saladused konveieri salasalve kaudu, mitte sisseregistreeritud YAML-i kaudu.