Tham chiếu biến môi trường

Tham chiếu biến môi trường này bao gồm tất cả các thiết đặt cấu hình cho các mẫu Power Platform Playwright. Để phát triển cục bộ, đặt các biến này trong packages/e2e-tests/.env. Trong CI/CD, đặt chúng làm bí mật đường ống dẫn hoặc biến. Để biết hướng dẫn dành riêng cho từng quy trình, hãy xem Tích hợp CI/CD.

Biến xác thực

Các biến này kiểm soát cách khung kiểm tra xác thực với các dịch vụ Power Platform.

Biến	Required	Description
`MS_AUTH_EMAIL`	Có	Địa chỉ email của tài khoản người dùng thử nghiệm
`MS_AUTH_CREDENTIAL_TYPE`	Có	Phương pháp xác thực: `password` hoặc `certificate`
`MS_USER_PASSWORD`	Nếu `credential_type=password`	Mật khẩu cho người dùng thử nghiệm
`MS_AUTH_CREDENTIAL_PROVIDER`	Nếu `credential_type=certificate`	Nguồn chứng chỉ: `local-file` hoặc `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Nếu `provider=local-file`	Đường dẫn tương đối đến tệp `.pfx` chứng chỉ
`MS_AUTH_CERTIFICATE_PASSWORD`	Không	Mật khẩu cho chứng `.pfx` chỉ (nếu được bảo vệ)

Azure Key Vault số

Bắt buộc khi MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Biến	Description
`AZURE_KEYVAULT_URL`	Key Vault URL, ví dụ: `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Tên của chứng chỉ được lưu trữ trong Key Vault
`AZURE_TENANT_ID`	Microsoft Entra ID đối tượng thuê
`AZURE_CLIENT_ID`	(Tùy chọn) ID máy khách chính của dịch vụ cho nhận dạng được liên kết

Biến URL ứng dụng

Các biến này chỉ định URL của các ứng dụng đang được kiểm tra.

Biến	Required	Description
`CANVAS_APP_URL`	Đối với kiểm tra bức vẽ	URL chế độ phát đầy đủ của ứng dụng bảng tùy biến của bạn, bao gồm `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Đối với kiểm tra ứng dụng dựa trên mô hình	URL đầy đủ của ứng dụng dựa trên mô hình của bạn (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Đối với kiểm tra trang tùy chỉnh	Tên hiển thị của mục sơ đồ trang tùy chỉnh, chẳng hạn như `AccountsCustomPage`

Xây dựng URL ứng dụng bảng tùy biến

Sử buildCanvasAppUrlFromEnv() dụng từ bộ công cụ để xây dựng URL từ các phần riêng lẻ nếu cần:

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

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

Hoặc đặt nó một cách rõ ràng trong .env:

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

Lấy URL ứng dụng dựa trên mô hình

Làm theo các bước sau để tìm URL chính xác cho ứng dụng dựa trên mô hình của bạn.

Mở ứng dụng dựa trên mô hình trong chế độ phát.
Sao chép URL từ thanh địa chỉ trình duyệt.
Loại bỏ tham số truy vấn appid=<guid> sau đó là phiên cụ thể.

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

Biến trạng thái lưu trữ

Bộ công cụ tính các biến này từ MS_AUTH_EMAIL. Không đặt trực tiếp chúng.

Đường dẫn	Description
`.playwright-ms-auth/state-<email>.json`	Power Apps xác thực (kiểm tra UX thế hệ/canvas)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 thái xác thực (kiểm tra MDA)

Ghi đè thư mục trạng thái lưu trữ:

MS_AUTH_STORAGE_DIR=../../.auth

Cờ CI/CD

Sử dụng cờ này để điều chỉnh hành vi kiểm tra cho môi trường tích hợp liên tục.

Biến	Mặc định	Description
`CI`	`false`	Đặt thành `true` CI để bật `retries: 1`, , `forbidOnly`và thời gian chờ chặt chẽ hơn

Playwright sẽ tự động CI đọc. Bạn không cần phải thiết lập nó trong - môi .env trường đường ống dẫn thiết lập nó theo quy ước.

Tệp .env mẫu

Sử dụng các ví dụ này làm điểm bắt đầu cho tệp cục bộ của .env bạn.

# 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

Đối với xác thực chứng chỉ:

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

Ví 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/...

Ghi chú bảo mật

Làm theo các phương pháp này để giữ an toàn cho thông tin xác thực và dữ liệu phiên.

Không bao giờ chuyển .env các tệp vào điều khiển nguồn. Trong .gitignore repo loại trừ chúng.
Không bao giờ cam kết .playwright-ms-auth/ các tệp trạng thái. Chúng chứa mã thông báo phiên.
Trong CI / CD, thiết lập tất cả các bí mật thông qua cửa hàng bí mật của đường ống dẫn, không phải trong kiểm tra YAML.