पर्यावरण चर संदर्भ

यह परिवेश चर संदर्भ Power Platform Playwright नमूनों के लिए सभी कॉन्फ़िगरेशन सेटिंग्स को कवर करता है। स्थानीय विकास के लिए, इन चरों को सेट 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 variables

आवश्यक है जब:MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault

वेरिएबल	विवरण
AZURE_KEYVAULT_URL	Key Vault URL, उदाहरण के लिए, https://<vault-name>.vault.azure.net/
AZURE_CERTIFICATE_NAME	Key Vault में संग्रहीत प्रमाणपत्र का नाम
AZURE_TENANT_ID	Microsoft Entra टेनेंट ID
AZURE_CLIENT_ID	(वैकल्पिक) सेवा प्रिंसिपल क्लाइंट ID फ़ेडरेटेड पहचान के लिए

ऐप्लिकेशन यूआरएल वैरिएबल

ये चर परीक्षण के तहत ऐप्स के URL निर्दिष्ट करते हैं।

वेरिएबल	आवश्यक	विवरण
CANVAS_APP_URL	कैनवास परीक्षणों के लिए	आपके कैनवास ऐप का पूर्ण प्ले-मोड यूआरएल, जिसमें शामिल हैं ?tenantId=<id>
MODEL_DRIVEN_APP_URL	मॉडल-संचालित ऐप परीक्षणों के लिए	आपके मॉडल-चालित ऐप का पूरा URL ()/main.aspx?appid=<id>
CUSTOM_PAGE_NAME	कस्टम पृष्ठ परीक्षणों के लिए	कस्टम पृष्ठ साइटमैप आइटम का नाम प्रदर्शित करें, जैसे AccountsCustomPage

कैनवास ऐप URL बनाएं

यदि आवश्यक हो तो अलग-अलग भागों से URL बनाने के लिए टूलकिट से उपयोग करें buildCanvasAppUrlFromEnv() :

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 खोजने के लिए इन चरणों का पालन करें।

1. मॉडल-चालित ऐप को प्ले मोड में खोलें।
2. ब्राउज़र एड्रेस बार से URL कॉपी करें।
3. उसके बाद 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 प्रमाणीकरण स्थिति (canvas/Gen UX परीक्षण)
.playwright-ms-auth/state-mda-<email>.json	Dynamics 365 प्रमाणीकरण स्थिति (MDA परीक्षण)

संग्रहण स्थिति निर्देशिका को ओवरराइड करें:

MS_AUTH_STORAGE_DIR=../../.auth

CI/CD ध्वज

निरंतर एकीकरण वातावरण के लिए परीक्षण व्यवहार को समायोजित करने के लिए इस ध्वज का उपयोग करें।

वेरिएबल	डिफ़ॉल्ट	विवरण
CI	false	सक्षम करने trueके लिए सीआई में सेट करें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/...

For 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 में नहीं।

अगले कदम

• प्रमाणीकरण गाइड
• CI/CD एकीकरण
• कॉन्फ़िगरेशन संदर्भ

भी देखें

• प्रमाणीकरण अवलोकन
• प्रारंभ करें