Pastaba.
Prieigai prie šio puslapio reikalingas įgaliojimas. Galite bandyti prisijungti arba pakeisti katalogus.
Prieigai prie šio puslapio reikalingas įgaliojimas. Galite bandyti pakeisti katalogus.
Šios aplinkos kintamųjų nuorodos apima visus "Power Platform Playwright" pavyzdžių konfigūracijos parametrus. Norėdami kurti vietinį kūrimą, nustatykite šiuos kintamuosius dalyje packages/e2e-tests/.env. CI/CD nustatykite juos kaip srauto paslaptis arba kintamuosius. Jei reikia konkretaus srauto instrukcijų, žr. CI / CD integravimas.
Autentifikavimo kintamieji
Šie kintamieji valdo, kaip tikrinimo sistema autentifikuojasi "Power Platform" tarnybose.
| Kintamasis | Būtina | Aprašą |
|---|---|---|
MS_AUTH_EMAIL |
Taip | Bandomojo vartotojo paskyros el. pašto adresas |
MS_AUTH_CREDENTIAL_TYPE |
Taip | Autentifikavimo metodas: password arba certificate |
MS_USER_PASSWORD |
Jei credential_type=password |
Bandomojo vartotojo slaptažodis |
MS_AUTH_CREDENTIAL_PROVIDER |
Jei credential_type=certificate |
Sertifikato šaltinis: local-file arba azure-keyvault |
MS_AUTH_LOCAL_FILE_PATH |
Jei provider=local-file |
Santykinis kelias į sertifikato .pfx failą |
MS_AUTH_CERTIFICATE_PASSWORD |
Ne | Sertifikato .pfx slaptažodis (jei apsaugotas) |
kintamųjų Azure Key Vault
Būtina, kai MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:
| Kintamasis | Aprašą |
|---|---|
AZURE_KEYVAULT_URL |
Key Vault URL, pvz., https://<vault-name>.vault.azure.net/ |
AZURE_CERTIFICATE_NAME |
Sertifikato, saugomo Key Vault, pavadinimas |
AZURE_TENANT_ID |
Microsoft Entra nuomotojo ID |
AZURE_CLIENT_ID |
(Pasirinktinai) Pagrindinio tarnybos kliento ID, skirtas išeiuotai tapatybei |
Taikomosios programos URL kintamieji
Šie kintamieji nurodo tikrinamų taikomųjų programų URL.
| Kintamasis | Būtina | Aprašą |
|---|---|---|
CANVAS_APP_URL |
Drobės testams | Drobės programos viso leidimo režimo URL, įskaitant ?tenantId=<id> |
MODEL_DRIVEN_APP_URL |
Modeliu pagrįstiems programėlių testams | Visas modeliu pagrįstos programos URL (/main.aspx?appid=<id>) |
CUSTOM_PAGE_NAME |
Pasirinktiniams puslapių testams | Rodomas pasirinktinio puslapio svetainės struktūros elemento pavadinimas, pvz., AccountsCustomPage |
Drobės taikomosios programos URL kūrimas
Jei reikia, naudokite buildCanvasAppUrlFromEnv() iš įrankių rinkinio, kad sukurtumėte URL iš atskirų dalių:
import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';
const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment
Arba aiškiai .envnustatykite:
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
Modelio taikomosios programos URL gavimas
Atlikite šiuos veiksmus, kad rastumėte teisingą modeliu pagrįstos programos URL.
- Atidarykite modeliu pagrįstą programėlę paleidimo režimu.
- Nukopijuokite URL iš naršyklės adreso juostos.
- Pašalinkite užklausos parametrus po
appid=<guid>seanso.
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>
Saugyklos būsenos kintamieji
Įrankių rinkinys apskaičiuoja šiuos kintamuosius iš MS_AUTH_EMAIL. Nenustatykite jų tiesiogiai.
| Kelias | Aprašą |
|---|---|
.playwright-ms-auth/state-<email>.json |
Power Apps autentifikavimo būsena (drobės / genų UX testai) |
.playwright-ms-auth/state-mda-<email>.json |
Dynamics 365 autentifikavimo būsena (MDA testai) |
Perrašyti saugyklos būsenos katalogą:
MS_AUTH_STORAGE_DIR=../../.auth
CI/CD vėliavėlė
Naudokite šią žymę, kad koreguotumėte testo veikimą nepertraukiamo integravimo aplinkose.
| Kintamasis | Numatytoji reikšmė | Aprašą |
|---|---|---|
CI |
false |
Nustatyta į true CI, kad įgalintumėte retries: 1, forbidOnlyir griežtesnį skirtąjį laiką |
"Playwright" CI skaito automatiškai. Jums nereikia jo nustatyti – srauto aplinkose, nustatytose .env pagal susitarimą.
.env failo pavyzdys
Naudokite šiuos pavyzdžius kaip vietinio .env failo pradžios tašką.
# 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
Sertifikato autentifikavimui:
# 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/...
Jei naudojate 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/...
Saugos pastabos
Norėdami apsaugoti kredencialus ir seanso duomenis, vadovaukitės šiomis praktikomis.
- Niekada neįpareigoja
.envfailų šaltinio valdikliui. Pasikartojime.gitignorejų neįeis. - Niekada neuždarykite
.playwright-ms-auth/būsenos failų. Juose yra seanso atpažinimo ženklų. - CI/CD nustatykite visas paslaptis per srauto slaptą saugyklą, o ne įregistruotą YAML.