Rujukan pembolehubah persekitaran

Rujukan pembolehubah persekitaran ini merangkumi semua seting konfigurasi untuk sampel Power Platform Playwright. Untuk pembangunan tempatan, tetapkan pembolehubah ini dalam packages/e2e-tests/.env. Dalam CI/CD, tetapkannya sebagai rahsia atau pembolehubah saluran paip. Untuk arahan khusus saluran paip, lihat penyepaduan CI/CD.

Pembolehubah pengesahan

Pembolehubah ini mengawal cara rangka kerja ujian mengesahkan terhadap perkhidmatan Power Platform.

Pemboleh ubah	Diperlukan	Perihalan
`MS_AUTH_EMAIL`	Ya	Alamat e-mel akaun pengguna ujian
`MS_AUTH_CREDENTIAL_TYPE`	Ya	Kaedah pengesahan: `password` atau `certificate`
`MS_USER_PASSWORD`	Jika `credential_type=password`	Kata laluan untuk pengguna ujian
`MS_AUTH_CREDENTIAL_PROVIDER`	Jika `credential_type=certificate`	Sumber sijil: `local-file` atau `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Jika `provider=local-file`	Laluan relatif kepada `.pfx` fail sijil
`MS_AUTH_CERTIFICATE_PASSWORD`	Tidak	Kata laluan untuk `.pfx` sijil (jika dilindungi)

Pembolehubah Azure Key Vault

Diperlukan apabila MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Pemboleh ubah	Perihalan
`AZURE_KEYVAULT_URL`	Key Vault URL, contohnya, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Nama sijil yang disimpan dalam Key Vault
`AZURE_TENANT_ID`	ID penyewa Microsoft Entra
`AZURE_CLIENT_ID`	(Pilihan) ID klien utama perkhidmatan untuk identiti bersekutu

Pembolehubah URL apl

Pembolehubah ini menentukan URL apl yang sedang diuji.

Pemboleh ubah	Diperlukan	Perihalan
`CANVAS_APP_URL`	Untuk ujian kanvas	URL mod main penuh apl kanvas anda, termasuk `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Untuk ujian apl dipacu model	URL penuh apl dipacu model anda (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Untuk ujian halaman tersuai	Nama paparan item peta laman halaman tersuai, seperti `AccountsCustomPage`

Bina URL apl kanvas

Gunakan buildCanvasAppUrlFromEnv() daripada kit alat untuk membina URL daripada bahagian individu jika perlu:

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

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

Atau tetapkan secara eksplisit dalam .env:

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

Dapatkan URL apl dipacu model

Ikut langkah ini untuk mencari URL yang betul untuk apl dipacu model anda.

Buka apl dipacu model dalam mod main.
Salin URL daripada bar alamat penyemak imbas.
Alih keluar parameter pertanyaan selepas appid=<guid> itu khusus sesi.

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

Pembolehubah keadaan storan

Kit alat mengira pembolehubah ini daripada MS_AUTH_EMAIL. Jangan tetapkan mereka secara langsung.

Laluan	Perihalan
`.playwright-ms-auth/state-<email>.json`	Keadaan pengesahan Power Apps (ujian UX kanvas/Gen)
`.playwright-ms-auth/state-mda-<email>.json`	Keadaan pengesahan Dynamics 365 (ujian MDA)

Ganti direktori keadaan storan:

MS_AUTH_STORAGE_DIR=../../.auth

Bendera CI/CD

Gunakan bendera ini untuk melaraskan tingkah laku ujian untuk persekitaran penyepaduan berterusan.

Pemboleh ubah	lalai	Perihalan
`CI`	`false`	Tetapkan kepada `true` dalam CI untuk mendayakan `retries: 1`, `forbidOnly`, dan tamat masa yang lebih ketat

Penulis drama membaca CI secara automatik. Anda tidak perlu menetapkannya — .env persekitaran saluran paip menetapkannya mengikut konvensyen.

Contoh fail .env

Gunakan contoh ini sebagai titik permulaan untuk fail setempat .env anda.

# 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

Untuk pengesahan sijil:

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

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

Nota keselamatan

Ikut amalan ini untuk memastikan kelayakan dan data sesi selamat.

Jangan sekali-kali menyerahkan .env fail kepada kawalan sumber. Dalam .gitignore repo mengecualikan mereka.
Jangan sekali-kali melakukan .playwright-ms-auth/ fail keadaan. Ia mengandungi token sesi.
Dalam CI/CD, tetapkan semua rahsia melalui stor rahsia saluran paip, bukan dalam YAML yang didaftar masuk.