Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu ortam değişkenleri başvurusu, Power Platform Playwright örnekleri için tüm yapılandırma ayarlarını kapsar. Yerel geliştirme için bu değişkenleri içinde packages/e2e-tests/.envayarlayın. CI/CD'de bunları işlem hattı gizli dizileri veya değişkenleri olarak ayarlayın. İşlem hattına özgü yönergeler için bkz. CI/CD tümleştirmesi.
Kimlik doğrulama değişkenleri
Bu değişkenler test çerçevesinin Power Platform hizmetlerinde kimlik doğrulamasını denetler.
| Variable | Zorunlu | Description |
|---|---|---|
MS_AUTH_EMAIL |
Evet | Test kullanıcı hesabının e-posta adresi |
MS_AUTH_CREDENTIAL_TYPE |
Evet | Kimlik doğrulama yöntemi: password veya certificate |
MS_USER_PASSWORD |
Eğer credential_type=password |
Test kullanıcısının parolası |
MS_AUTH_CREDENTIAL_PROVIDER |
Eğer credential_type=certificate |
Sertifika kaynağı: local-file veya azure-keyvault |
MS_AUTH_LOCAL_FILE_PATH |
Eğer provider=local-file |
Sertifika dosyasının .pfx göreli yolu |
MS_AUTH_CERTIFICATE_PASSWORD |
Hayır | Sertifikanın .pfx parolası (korumalıysa) |
değişkenleri Azure Key Vault
Şu durumlarda MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvaultgereklidir:
| Variable | Description |
|---|---|
AZURE_KEYVAULT_URL |
Key Vault URL'si, örneğin https://<vault-name>.vault.azure.net/ |
AZURE_CERTIFICATE_NAME |
Key Vault'de depolanan sertifikanın adı |
AZURE_TENANT_ID |
Microsoft Entra tenant kimliği |
AZURE_CLIENT_ID |
(İsteğe bağlı) Federasyon kimliği için hizmet sorumlusu istemci kimliği |
Uygulama URL değişkenleri
Bu değişkenler test altındaki uygulamaların URL'lerini belirtir.
| Variable | Zorunlu | Description |
|---|---|---|
CANVAS_APP_URL |
Tuval testleri için | Tuval uygulamanızın tam oynatma modu URL'si ?tenantId=<id> |
MODEL_DRIVEN_APP_URL |
Model temelli uygulama testleri için | Model temelli uygulamanızın tam URL'si (/main.aspx?appid=<id>) |
CUSTOM_PAGE_NAME |
Özel sayfa testleri için | Özel sayfa site haritası öğesinin görünen adı, örneğin AccountsCustomPage |
Tuval uygulaması URL'sini oluşturma
Gerekirse url'yi ayrı parçalardan oluşturmak için araç setinden kullanın buildCanvasAppUrlFromEnv() :
import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';
const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment
Veya içinde açıkça .envayarlayın:
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
Model temelli uygulama URL'sini alma
Model temelli uygulamanız için doğru URL'yi bulmak için bu adımları izleyin.
- Model temelli uygulamayı yürütme modunda açın.
- Tarayıcı adres çubuğundan URL'yi kopyalayın.
- Bundan sonra
appid=<guid>oturuma özgü sorgu parametrelerini kaldırın.
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>
Depolama durumu değişkenleri
Araç seti bu değişkenleri konumundan MS_AUTH_EMAILhesaplar. Bunları doğrudan ayarlama.
| Yol | Description |
|---|---|
.playwright-ms-auth/state-<email>.json |
Power Apps kimlik doğrulama durumu (tuval/Gen UX testleri) |
.playwright-ms-auth/state-mda-<email>.json |
Dynamics 365 kimlik doğrulama durumu (MDA testleri) |
Depolama durumu dizinini geçersiz kılın:
MS_AUTH_STORAGE_DIR=../../.auth
CI/CD bayrağı
Sürekli tümleştirme ortamları için test davranışını ayarlamak için bu bayrağı kullanın.
| Variable | Default | Description |
|---|---|---|
CI |
false |
true, retries: 1ve daha katı zaman aşımlarını etkinleştirmek forbidOnlyiçin CI'de olarak ayarlayın |
Playwright otomatik olarak okur CI . bunu içinde ayarlamanız .env gerekmez; işlem hattı ortamları bunu kurala göre ayarlar.
Örnek .env dosyası
Bu örnekleri yerel .env dosyanız için başlangıç noktası olarak kullanı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
Sertifika kimlik doğrulaması için:
# 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 için:
# 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/...
Güvenlik notları
Kimlik bilgilerini ve oturum verilerini güvenli tutmak için bu uygulamaları izleyin.
- Dosyaları hiçbir zaman kaynak denetimine işlemeyin
.env..gitignoredepoda bunlar hariç tutulur. - Durum dosyalarını hiçbir zaman işlemeyin
.playwright-ms-auth/. Bunlar oturum belirteçleri içerir. - CI/CD'de, iade edilmiş YAML'de değil, işlem hattının gizli dizi deposu aracılığıyla tüm gizli dizileri ayarlayın.