Referensi variabel lingkungan

Referensi variabel lingkungan ini mencakup semua pengaturan konfigurasi untuk sampel Power Platform Playwright. Untuk pengembangan lokal, atur variabel ini di packages/e2e-tests/.env. Di CI/CD, atur sebagai rahasia atau variabel alur. Untuk instruksi khusus alur, lihat integrasi CI/CD.

Variabel Otentikasi

Variabel ini mengontrol bagaimana kerangka kerja pengujian mengautentikasi terhadap layanan Power Platform.

Variable Required Deskripsi
MS_AUTH_EMAIL Yes Alamat email akun pengguna uji
MS_AUTH_CREDENTIAL_TYPE Yes Metode autentikasi: password atau certificate
MS_USER_PASSWORD Jika credential_type=password Kata sandi untuk pengguna uji
MS_AUTH_CREDENTIAL_PROVIDER Jika credential_type=certificate Sumber sertifikat: local-file atau azure-keyvault
MS_AUTH_LOCAL_FILE_PATH Jika provider=local-file Jalur relatif ke .pfx file sertifikat
MS_AUTH_CERTIFICATE_PASSWORD No Kata sandi untuk .pfx sertifikat (jika dilindungi)

variabel Azure Key Vault

Diperlukan ketika MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Variable Deskripsi
AZURE_KEYVAULT_URL URL Key Vault, misalnya, https://<vault-name>.vault.azure.net/
AZURE_CERTIFICATE_NAME Nama sertifikat yang disimpan di Key Vault
AZURE_TENANT_ID ID penyewa Microsoft Entra
AZURE_CLIENT_ID (Opsional) ID klien perwakilan layanan untuk identitas federasi

Variabel URL Aplikasi

Variabel ini menentukan URL aplikasi yang sedang diuji.

Variable Required Deskripsi
CANVAS_APP_URL Untuk tes kanvas URL mode putar penuh aplikasi kanvas Anda, termasuk ?tenantId=<id>
MODEL_DRIVEN_APP_URL Untuk pengujian aplikasi berbasis model URL lengkap aplikasi berbasis model Anda (/main.aspx?appid=<id>)
CUSTOM_PAGE_NAME Untuk pengujian halaman kustom Tampilkan nama item peta situs halaman kustom, seperti AccountsCustomPage

Membangun URL aplikasi kanvas

Gunakan buildCanvasAppUrlFromEnv() dari toolkit untuk membuat URL dari masing-masing bagian jika diperlukan:

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

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

Atau atur secara eksplisit di .env:

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

Mendapatkan URL aplikasi berbasis model

Ikuti langkah-langkah ini untuk menemukan URL yang benar untuk aplikasi berbasis model Anda.

  1. Buka aplikasi berbasis model dalam mode putar.
  2. Salin URL dari bilah alamat browser.
  3. Hapus parameter kueri setelah appid=<guid> itu khusus sesi.
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>

Variabel status penyimpanan

Toolkit menghitung variabel ini dari MS_AUTH_EMAIL. Jangan mengaturnya secara langsung.

Jalur Deskripsi
.playwright-ms-auth/state-<email>.json status autentikasi Power Apps (pengujian UX kanvas/Gen)
.playwright-ms-auth/state-mda-<email>.json status autentikasi Dynamics 365 (pengujian MDA)

Ambil alih direktori status penyimpanan:

MS_AUTH_STORAGE_DIR=../../.auth

Bendera CI/CD

Gunakan bendera ini untuk menyesuaikan perilaku pengujian untuk lingkungan integrasi berkelanjutan.

Variable Default Deskripsi
CI false Atur ke true di CI untuk mengaktifkan retries: 1, forbidOnly, dan batas waktu yang lebih ketat

Playwright membaca CI secara otomatis. Anda tidak perlu mengaturnya di .env — lingkungan alur mengaturnya berdasarkan konvensi.

Contoh file .env

Gunakan contoh-contoh ini sebagai titik awal untuk file lokal .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 autentikasi sertifikat:

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

Catatan keamanan

Ikuti praktik ini untuk menjaga kredensial dan data sesi tetap aman.

  • Jangan pernah menerapkan .env file ke kontrol sumber. dalam .gitignore repositori mengecualikannya.
  • Jangan pernah menerapkan .playwright-ms-auth/ file status. Mereka berisi token sesi.
  • Di CI/CD, atur semua rahasia melalui penyimpanan rahasia alur, bukan di YAML yang dicek masuk.

Langkah berikutnya

Baca juga

  • Last updated on