Αναφορά μεταβλητών περιβάλλοντος

Αυτή η αναφορά μεταβλητών περιβάλλοντος καλύπτει όλες τις ρυθμίσεις παραμέτρων για τα δείγματα Playwright του Power Platform. Για τοπική ανάπτυξη, ορίστε αυτές τις μεταβλητές σε packages/e2e-tests/.env. Στη CI/CD, ορίστε τα ως μυστικά διοχέτευσης ή μεταβλητές. Για οδηγίες σχετικά με τη διοχέτευση, ανατρέξτε στο θέμα Ενοποίηση CI/CD.

Μεταβλητές ελέγχου ταυτότητας

Αυτές οι μεταβλητές ελέγχουν τον τρόπο με τον οποίο το πλαίσιο δοκιμών πραγματοποιεί έλεγχο ταυτότητας σε σχέση με τις υπηρεσίες Power Platform.

Μεταβλητή	Υποχρεωτικό	Περιγραφή
`MS_AUTH_EMAIL`	Ναι	Διεύθυνση ηλεκτρονικού ταχυδρομείου του δοκιμαστικού λογαριασμού χρήστη
`MS_AUTH_CREDENTIAL_TYPE`	Ναι	Μέθοδος ελέγχου ταυτότητας: `password` ή `certificate`
`MS_USER_PASSWORD`	Εάν `credential_type=password`	Κωδικός πρόσβασης για τον δοκιμαστικό χρήστη
`MS_AUTH_CREDENTIAL_PROVIDER`	Εάν `credential_type=certificate`	Προέλευση πιστοποιητικού: `local-file` ή `azure-keyvault`
`MS_AUTH_LOCAL_FILE_PATH`	Εάν `provider=local-file`	Σχετική διαδρομή για το αρχείο πιστοποιητικού `.pfx`
`MS_AUTH_CERTIFICATE_PASSWORD`	Αρ.	Κωδικός πρόσβασης για το `.pfx` πιστοποιητικό (εάν προστατεύεται)

Azure Key Vault μεταβλητών

Απαιτείται όταν MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault:

Μεταβλητή	Περιγραφή
`AZURE_KEYVAULT_URL`	διεύθυνση URL Key Vault, για παράδειγμα, `https://<vault-name>.vault.azure.net/`
`AZURE_CERTIFICATE_NAME`	Το όνομα του πιστοποιητικού που είναι αποθηκευμένο στο Key Vault
`AZURE_TENANT_ID`	Microsoft Entra αναγνωριστικό μισθωτή
`AZURE_CLIENT_ID`	(Προαιρετικό) Αναγνωριστικό προγράμματος-πελάτη κύριας υπηρεσίας για ομόσπονδη ταυτότητα

Μεταβλητές διεύθυνσης URL εφαρμογής

Αυτές οι μεταβλητές καθορίζουν τις διευθύνσεις URL των υπό δοκιμή εφαρμογών.

Μεταβλητή	Υποχρεωτικό	Περιγραφή
`CANVAS_APP_URL`	Για δοκιμές καμβά	Διεύθυνση URL πλήρους λειτουργίας αναπαραγωγής της εφαρμογής καμβά σας, συμπεριλαμβανομένων `?tenantId=<id>`
`MODEL_DRIVEN_APP_URL`	Για δοκιμές εφαρμογής βάσει μοντέλου	Πλήρης διεύθυνση URL της εφαρμογής βάσει μοντέλου σας (`/main.aspx?appid=<id>`)
`CUSTOM_PAGE_NAME`	Για δοκιμές προσαρμοσμένης σελίδας	Εμφανιζόμενο όνομα του στοιχείου χάρτη τοποθεσίας προσαρμοσμένης σελίδας, όπως `AccountsCustomPage`

Δημιουργία της διεύθυνσης URL της εφαρμογής καμβά

Χρησιμοποιήστε buildCanvasAppUrlFromEnv() την από το κιτ εργαλείων για τη δημιουργία της διεύθυνσης URL από μεμονωμένα μέρη, εάν χρειάζεται:

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

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

Εναλλακτικά, ορίστε το ρητά στο .env:

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

Λήψη της διεύθυνσης URL εφαρμογής βάσει μοντέλου

Ακολουθήστε αυτά τα βήματα για να βρείτε τη σωστή διεύθυνση URL για την εφαρμογή βάσει μοντέλου σας.

Ανοίξτε την εφαρμογή βάσει μοντέλου σε λειτουργία αναπαραγωγής.
Αντιγράψτε τη διεύθυνση URL από τη γραμμή διευθύνσεων του προγράμματος περιήγησης.
Καταργήστε τις παραμέτρους ερωτήματος μετά από appid=<guid> αυτήν την περίοδο λειτουργίας.

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

Μεταβλητές κατάστασης αποθήκευσης

Το κιτ εργαλείων υπολογίζει αυτές τις μεταβλητές από MS_AUTH_EMAIL. Μην τις ορίσετε απευθείας.

Διαδρομή	Περιγραφή
`.playwright-ms-auth/state-<email>.json`	κατάσταση ελέγχου ταυτότητας Power Apps (δοκιμές UX καμβά/gen)
`.playwright-ms-auth/state-mda-<email>.json`	Dynamics 365 κατάσταση ελέγχου ταυτότητας (δοκιμές MDA)

Παράκαμψη του καταλόγου κατάστασης αποθήκευσης:

MS_AUTH_STORAGE_DIR=../../.auth

Σημαία CI/CD

Χρησιμοποιήστε αυτήν τη σημαία για να προσαρμόσετε τη συμπεριφορά δοκιμής για περιβάλλοντα συνεχούς ενοποίησης.

Μεταβλητή	Προεπιλεγμένος	Περιγραφή
`CI`	`false`	Ορίστε το `true` σε CI για ενεργοποίηση `retries: 1`, `forbidOnly`και αυστηρότερα χρονικά όρια

Η θεατρική συγγραφέας CI διαβάζει αυτόματα. Δεν χρειάζεται να τον ορίσετε σε .env — τα περιβάλλοντα διοχέτευσης έχουν οριστεί βάσει σύμβασης.

Δείγμα αρχείου .env

Χρησιμοποιήστε αυτά τα παραδείγματα ως σημείο εκκίνησης για το τοπικό .env αρχείο σας.

# 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

Για έλεγχο ταυτότητας πιστοποιητικού:

# 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:

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

Σημειώσεις ασφαλείας

Ακολουθήστε αυτές τις πρακτικές για να διατηρήσετε τα διαπιστευτήρια και τα δεδομένα περιόδου λειτουργίας ασφαλή.

Να μην δεσμεύετε .env ποτέ αρχεία στον έλεγχο προέλευσης. Το .gitignore στο αποθετήριο τις εξαιρεί.
Να μην δεσμεύετε .playwright-ms-auth/ ποτέ αρχεία πολιτείας. Περιέχουν διακριτικά περιόδου λειτουργίας.
Στη CI/CD, ορίστε όλα τα μυστικά μέσω του μυστικού χώρου αποθήκευσης της διοχέτευσης και όχι σε επιλεγμένο YAML.