के साथ आरंभ करें Power Pages प्लगइन के लिए GitHub Copilot CLI और Claude Code (पूर्वावलोकन)

GitHub Copilot CLI और Claude Code1 के लिए Power Pages प्लगइन Power Pages पर आधुनिक सिंगल-पेज एप्लिकेशन (SPA) साइटों को बनाने, तैनात करने और प्रबंधित करने के लिए AI-सहायता प्राप्त वर्कफ़्लो प्रदान करता है। परियोजनाओं को मैन्युअल रूप से मचान बनाने, बॉयलरप्लेट एपीआई कोड लिखने और अनुमतियों को कॉन्फ़िगर करने के बजाय, वर्णन करें कि आप प्राकृतिक भाषा में क्या चाहते हैं, और प्लगइन कार्यान्वयन को संभालता है।

प्लगइन संवादी कौशल के माध्यम से पूर्ण साइट विकास जीवनचक्र का समर्थन करता है, एक नई साइट को मचान बनाने से लेकर इसे तैनात करने, डेटावर्स डेटा मॉडल स्थापित करने और प्रमाणीकरण को कॉन्फ़िगर करने तक।

Important

  • यह सुविधा पूर्वावलोकन में है।
  • पूर्वावलोकन सुविधाएँ उत्पादन में उपयोग के लिए नहीं होती हैं और इनकी कार्यक्षमता प्रतिबंधित हो सकती हैं. यह सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध होती हैं ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.
  • अनुमोदन से पहले एजेंट के प्रस्तावों की समीक्षा करें

पूर्वावश्यकताएँ

शुरू करने से पहले, सत्यापित करें कि आपके पास आवश्यक सॉफ़्टवेयर और अनुमतियाँ हैं।

सॉफ़्टवेयर आवश्यकताएँ

अवयव न्यूनतम संस्करण अधिक जानकारी
Node.js 18.0 या बाद का संस्करण डाउनलोड Node.js
पावर प्लेटफार्म सीएलआई (पीएसी सीएलआई) 2.6.3 या बाद का संस्करण (सर्वर तर्क के लिए आवश्यक) पीएसी सीएलआई स्थापित करें
Azure CLI नवीनतम Azure CLI
GitHub Copilot CLI या क्लाउड कोड नवीनतम GitHub Copilot CLI या क्लाउड कोड
Visual Studio Code और Power Platform उपकरण एक्सटेंशन (वैकल्पिक) नवीनतम वीएस कोड डाउनलोड करें और पावर प्लेटफॉर्म टूल्स इंस्टॉल करें

आपको यह भी चाहिए:

  • Power Pages सक्षम के साथ एक Power Platform वातावरण.
  • आपके लक्षित वातावरण से जुड़ा एक प्रमाणित पीएसी सीएलआई सत्र। यदि आप अभी तक कनेक्ट नहीं हुए हैं तो चलाएँ pac auth create ।
  • एक Azure CLI सत्र एक ही टेनेंट के लिए साइन इन किया गया है। प्रमाणित करने के लिए az login चलाएँ।

प्रमाणीकरण सत्यापित करें:

आदेश का उपयोग करके pac auth list सत्यापित करें कि आप प्रमाणित हैं।

pac auth list           # Should show authenticated profile

यदि आप प्रमाणित नहीं हैं, तो यह आदेश चलाएँ:

pac auth create --environment <Instance url>        # Authenticate to Power Platform

सुझाव

इंस्टेंस URL प्राप्त करने के लिए, Power Pages होम पर जाएं, ऊपरी-दाएँ कोने में सेटिंग्स आइकन का चयन करें, और फिर सत्र विवरण चुनें।

प्लगइन स्थापित करें

मार्केटप्लेस से Power Pages प्लगइन स्थापित करें. यदि आप GitHub Copilot CLI का उपयोग करते हैं, तो समतुल्य स्थापना चरणों के लिए Copilot CLI एक्सटेंशन दस्तावेज़ देखें। निम्न आदेश Claude कोड सिंटैक्स का उपयोग करें।

ऑटोअपडेट सक्षम के साथ सभी प्लगइन्स सेट करने के लिए इंस्टॉलर चलाएँ:

Windows (PowerShell):

iwr https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js -OutFile install.js; node install.js; del install.js

macOS/Linux/Windows (cmd):

curl -fsSL https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js | node

इंस्टॉलर स्वचालित रूप से:

  • CLI स्थापित pac करता है यदि यह पहले से स्थापित नहीं है।
  • उपलब्ध टूल का पता लगाता है, जैसे कि Claude Code और GitHub Copilot CLI।
  • प्लगइन मार्केटप्लेस को पंजीकृत करता है और सभी सूचीबद्ध प्लगइन्स इंस्टॉल करता है।
  • ऑटोअपडेट सक्षम करता है ताकि प्लगइन्स वर्तमान रहें।

स्थापना के बाद, अपने एजेंट सत्र में स्लैश कमांड के रूप में प्लगइन के कौशल तक पहुंचने के लिए क्लाउड कोड या GitHub Copilot CLI को पुनरारंभ करें।

मार्केटप्लेस से इंस्टॉल करें

  1. अपने टर्मिनल में Claude Code खोलें।

  2. Microsoft मार्केटप्लेस जोड़ें:

    /plugin marketplace add microsoft/power-platform-skills

  3. Power Pages प्लगइन स्थापित करें:

    /plugin install power-pages@power-platform-skills

प्लगइन स्थापित करने के बाद, अपने एजेंट सत्र में स्लैश कमांड के रूप में प्लगइन के कौशल तक पहुंचने के लिए क्लाउड कोड या GitHub Copilot CLI को पुनरारंभ करें।

सुझाव

मार्केटप्लेस और कौशल के लिए स्वचालित रूप से अपडेट प्राप्त करने के लिए, ऑटो-अपडेट चालू करें। कमांड का /plugin उपयोग करें, मार्केटप्लेस पर जाएं, मार्केटप्लेस चुनें और ऑटो-अपडेट चालू करें।

कौशल अवलोकन

प्लगइन ऐसे कौशल प्रदान करता है जो Power Pages साइट के पूर्ण जीवनचक्र को कवर करते हैं। प्रत्येक कौशल को संवादात्मक रूप से लागू करें, या तो एक स्लैश कमांड के रूप में या यह वर्णन करके कि आप क्या to do चाहते हैं।

कौशल Command यह क्या करता है
साइट बनाएं /create-site किसी साइट को मचान बनाता है, आपकी डिज़ाइन दिशा लागू करता है, और पृष्ठ और घटक बनाता है
साइट परिनियोजित करें /deploy-site प्रोजेक्ट बनाता है और इसे PAC CLI का उपयोग करके Power Pages पर अपलोड करता है
साइट सक्रिय करें /activate-site एक वेबसाइट रिकॉर्ड का प्रावधान करता है और एक सार्वजनिक URL असाइन करता है
डेटा मॉडल सेट अप करें /setup-datamodel Dataverse तालिकाएँ, स्तंभ और संबंध बनाता है
नमूना डेटा जोड़ें (वैकल्पिक) /add-sample-data यथार्थवादी परीक्षण रिकॉर्ड के साथ Dataverse तालिकाओं को पॉप्युलेट करता है
वेब एपीआई को एकीकृत करें /integrate-webapi टाइप किए गए API क्लाइंट कोड, सेवाएँ और तालिका अनुमतियाँ जनरेट करता है
प्रमाणीकरण सेट अप करें /setup-auth साइन-इन और साइन-आउट कार्यक्षमता और भूमिका-आधारित access control जोड़ता है
वेब भूमिकाएँ बनाएँ /create-webroles उपयोगकर्ता access प्रबंधन के लिए वेब रोल YAML फ़ाइलें जनरेट करता है
सर्वर तर्क जोड़ें /add-server-logic सत्यापन, बाहरी API कॉल, गुप्त प्रबंधन और डेटा संचालन के लिए सुरक्षित सर्वर-साइड JavaScript समापन बिंदु उत्पन्न करता है
क्लाउड फ्लो जोड़ें /add-cloud-flow अनुमोदन वर्कफ़्लोज़, सूचनाएँ और शेड्यूल किए गए स्वचालन के लिए आपकी साइट में मौजूदा Power Automate क्लाउड फ़्लो को एकीकृत करता है
बैकएंड को एकीकृत करें /integrate-backend आपके प्रोटोटाइप का विश्लेषण करता है, प्रत्येक सुविधा के लिए सही दृष्टिकोण (वेब एपीआई, सर्वर लॉजिक या क्लाउड फ्लो) निर्धारित करता है, और संपूर्ण बिल्ड अनुक्रम को ऑर्केस्ट्रेट करता है
एसईओ जोड़ें /add-seo robots.txt, sitemap.xmlऔर मेटा टैग उत्पन्न करता है

विशिष्ट वर्कफ़्लो

एक सामान्य एंड-टू-एंड वर्कफ़्लो इस अनुक्रम का अनुसरण करता है:

  1. /create-site : मचान, डिज़ाइन और पेज बनाएं
  2. /deploy-site : अपने Power Pages वातावरण में अपलोड करें
  3. /activate-site : एक सार्वजनिक URL सेट करें
  4. /setup-datamodel : Dataverse टेबल बनाएं
  5. /add-sample-data : परीक्षण रिकॉर्ड के साथ तालिकाओं को पॉप्युलेट करें
  6. /integrate-webapi : एपीआई क्लाइंट कोड जनरेट करें और अनुमतियां कॉन्फ़िगर करें
  7. /create-webroles : access भूमिकाएँ निर्धारित करें
  8. /setup-auth : साइन-इन, साइन-आउट और रोल-आधारित UI जोड़ें
  9. /add-server-logic : सुरक्षित सर्वर-साइड समापन बिंदु जोड़ें
  10. /add-cloud-flow : मौजूदा Power Automate प्रवाह को एकीकृत करें
  11. /add-seo : खोज इंजन अनुकूलन
  12. /deploy-site : अंतिम परिवर्तनों को लाइव पुश करें

सुझाव

  • आपको इस सटीक क्रम का पालन करने की आवश्यकता नहीं है। प्रत्येक कौशल अपनी पूर्वापेक्षाओं की जांच करता है और आपको बताता है कि क्या कुछ कमी है। उदाहरण के लिए, यदि आपकी साइट को पहले प्रमाणीकरण की आवश्यकता है, तो आप पहले चला /setup-auth/integrate-webapi सकते हैं।
  • यदि आप सुनिश्चित नहीं हैं कि प्रत्येक सुविधा के लिए किस दृष्टिकोण का उपयोग करना है, तो चरण 4 से 10 के बजाय अलग-अलग चलाएँ /integrate-backend . यह आपके प्रोटोटाइप का विश्लेषण करता है, यह निर्धारित करता है कि प्रत्येक सुविधा को वेब एपीआई, सर्वर लॉजिक, या क्लाउड फ्लो की आवश्यकता है या नहीं, और कौशल को सही क्रम में व्यवस्थित करता है।

अपनी Power Pages साइट बनाएँ

यह पूर्वाभ्यास प्लग के साथ एक Power Pages साइट बनाने के पूर्ण जीवनचक्र को कवर करता है, मचान से लेकर परिनियोजन तक। प्रत्येक चरण वर्णन करता है कि आप क्या कहते हैं और प्लगइन प्रतिक्रिया में क्या करता है।

चरण 1: अपनी साइट बनाएं

उस साइट का वर्णन करें जिसे आप प्राकृतिक भाषा में चाहते हैं: यह किस लिए है, इसे किन पृष्ठों की आवश्यकता है, और रंग योजना, लेआउट शैली या फ़ॉन्ट जैसी कोई भी डिज़ाइन प्राथमिकताएं। चलाएं /create-site या बस अपनी साइट का वर्णन करें और प्लगइन इरादे को पहचानता है।

यदि आप एक फ्रेमवर्क निर्दिष्ट नहीं करते हैं, तो प्लगइन आपको एक (रिएक्ट, व्यू, एंगुलर, या एस्ट्रो) चुनने के लिए कहता है, तो:

  1. project को टेम्पलेट से मचान बनाता है और आपकी साइट का नाम, रंग और डिज़ाइन टोकन लागू करता है.
  2. निर्भरता स्थापित करता है, एक विकास सर्वर शुरू करता है, और एक लाइव ब्राउज़र पूर्वावलोकन खोलता है।
  3. आपके द्वारा अनुरोधित प्रत्येक पृष्ठ, घटक और मार्ग को प्रासंगिक छवियों के साथ बनाता है।
  4. महत्वपूर्ण मील के पत्थर पर गिट कमिट बनाता है ताकि आपके पास अंतर्निहित रोलबैक इतिहास हो।

चरण 2: अपनी साइट परिनियोजित करें

अपनी साइट को Power Pages पर अपलोड करने के लिए /deploy-site चलाएँ. प्लगइन:

  1. सत्यापित करता है कि PAC CLI स्थापित है और आपका प्रमाणीकरण सत्र सक्रिय है।
  2. आगे बढ़ने से पहले आपके साथ लक्ष्य वातावरण की पुष्टि करता है।
  3. एक उत्पादन बिल्ड चलाता है और संकलित आउटपुट अपलोड करता है।
  4. यदि कोई पहले से मौजूद नहीं है, तो एक परिनियोजन artifacts निर्देशिका बनाता है।

नोट

यदि आपका परिवेश कुछ फ़ाइल अनुभाषों को अवरुद्ध करता है, तो प्लगइन समस्या का पता लगाता है और इसे हल करने के लिए निर्देश प्रदान करता है।

चरण 3: अपनी साइट सक्रिय करें

साइट को सार्वजनिक रूप से सुलभ बनाने के लिए चलाएँ /activate-site । प्लगइन:

  1. आपकी साइट के नाम के आधार पर एक उपडोमेन का सुझाव देता है और आपको इसे अनुकूलित करने देता है।
  2. Power Platform API के माध्यम से एक वेबसाइट रिकॉर्ड का प्रावधान करता है.
  3. साइट लाइव होने तक पोल करें और सार्वजनिक URL लौटाएं।

इस बिंदु पर, आपके पास एक सार्वजनिक URL पर एक कार्यशील साइट है। शेष चरण डेटा, प्रमाणीकरण और एसईओ जोड़ते हैं। ऐसे सभी चरण को छोड़ दें जो आपकी साइट पर लागू नहीं होते हैं.

चरण 4: अपना डेटा मॉडल सेट अप करें

अपनी साइट की ज़रूरत की Dataverse तालिकाएँ बनाने के लिए चलाएँ /setup-datamodel . यदि आपके पास पहले से ही एक ईआर आरेख या विशिष्ट स्कीमा है, तो एजेंट से आपके कोड का विश्लेषण करने के बजाय इसे सीधे प्रदान करें।

प्लगइन एक डेटा मॉडल आर्किटेक्ट एजेंट को जन्म देता है जो:

  1. यह निर्धारित करने के लिए आपकी साइट के कोड का विश्लेषण करता है कि पृष्ठों और घटकों को किस डेटा की आवश्यकता है.
  2. डुप्लिकेट से बचने के लिए मौजूदा तालिकाओं के लिए आपके Dataverse परिवेश से पूछताछ करता है.
  3. तालिकाओं, स्तंभों, डेटा प्रकारों और संबंधों के साथ एक डेटा मॉडल का प्रस्ताव करता है, जिसे ER आरेख के रूप में विज़ुअलाइज़ किया गया है.

आप प्रस्ताव की समीक्षा करें और उसे मंजूरी दें। प्लगइन तब तक कुछ भी नहीं बनाता जब तक आप पुष्टि नहीं करते। अनुमोदन के बाद, प्लगइन एपीआई कॉल के माध्यम से तालिकाओं और कॉलम बनाता है और एक मेनिफेस्ट फ़ाइल को सहेजता है जिसका उपयोग चरण 5 और 6 करते हैं।

चरण 5: नमूना डेटा जोड़ें (वैकल्पिक)

परीक्षण रिकॉर्ड के साथ अपनी तालिकाओं को पॉप्युलेट करने के लिए चलाएं /add-sample-data । इस चरण के लिए चरण 4 से डेटा मॉडल की आवश्यकता होती है।

प्लगइन निम्नलिखित क्रियाएं करता है:

  1. आपकी तालिकाओं, स्तंभों और संबंधों को समझने के लिए मैनिफ़ेस्ट पढ़ता है.
  2. प्रत्येक स्तंभ प्रकार के लिए प्रासंगिक रूप से उपयुक्त मान जनरेट करता है, जैसे यथार्थवादी ईमेल, प्रशंसनीय तिथियां और स्वरूपित मुद्रा राशियाँ.
  3. निर्भरता क्रम में रिकॉर्ड सम्मिलित करता है (चाइल्ड तालिकाओं से पहले पैरेंट तालिकाएँ) और बल्क आवेषण के दौरान स्वचालित रूप से प्रमाणीकरण टोकन ताज़ा करता है।

चरण 6: Dataverse Web API के साथ एकीकृत करें

नकली डेटा को लाइव Dataverse क्वेरी से बदलने के लिए चलाएँ /integrate-webapi . इस चरण के लिए चरण 4 से डेटा मॉडल की आवश्यकता होती है।

प्लगइन निम्नलिखित क्रियाएं करता है:

  1. आपके कोडबेस को उन घटकों के लिए स्कैन करता है जो नकली डेटा, प्लेसहोल्डर फ़ेच कॉल या हार्डकोड की गई सरणियों का उपयोग करते हैं. यह इन घटकों को आपकी Dataverse तालिकाओं में मैप करता है।
  2. प्रत्येक तालिका के लिए एक वेब एपीआई एकीकरण एजेंट पैदा करता है जो उत्पन्न करता है:
    • एंटी-जालसाजी टोकन प्रबंधन और तर्क को पुनः प्रयास करने के साथ एक साझा एपीआई क्लाइंट।
    • TypeScript निकाय प्रकार और डोमेन मैपर्स।
    • एक CRUD सेवा परत।
    • फ्रेमवर्क-विशिष्ट पैटर्न, जैसे रिएक्ट हुक, Vue कंपोजेबल, या कोणीय सेवाएं।
  3. एक अनुमतियाँ आर्किटेक्ट एजेंट जो तालिका अनुमतियों और साइट सेटिंग्स का प्रस्ताव करता है, स्पॉन करता है।

आप अनुमति प्रस्ताव की समीक्षा करें और उसे अनुमोदित करें। प्लगइन तब तक कोई कॉन्फ़िगरेशन फ़ाइल नहीं बनाता जब तक आप पुष्टि नहीं कर देते।

चरण 7: वेब भूमिकाएँ बनाएँ

उपयोगकर्ता access भूमिकाओं को परिभाषित करने के लिए /create-webroles चलाएँ। प्लगइन:

  1. डुप्लिकेट से बचने के लिए मौजूदा वेब भूमिकाओं के लिए आपके परिवेश से क्वेरी करता है.
  2. अद्वितीय पहचानकर्ताओं के साथ भूमिका परिभाषाएँ उत्पन्न करता है।
  3. यह लागू करता है कि प्रत्येक साइट में अधिकतम एक अनाम भूमिका और एक प्रमाणित भूमिका होती है.

चरण 8: प्रमाणीकरण सेट अप करें

साइन-इन और साइन-आउट कार्यक्षमता जोड़ने के लिए चलाएँ /setup-auth . प्लगइन:

  1. एंटी-forgery टोकन प्रबंधन के साथ Microsoft Entra ID प्रवाह के लिए एक प्रमाणीकरण सेवा जनरेट करता है।
  2. आपके साइट लेआउट के साथ एकीकृत एक साइन-इन/साइन-आउट UI घटक बनाता है.
  3. भूमिका-आधारित access control उपयोगिताओं को जोड़ता है जो उपयोगकर्ता की वेब भूमिकाओं के आधार पर UI तत्वों को दिखाते या छुपाते हैं.
  4. आपके ढांचे के पैटर्न का उपयोग करता है (React hooks, Vue composables, या Angular सेवाएं)।

चरण 9: सर्वर तर्क जोड़ें

अपनी साइट पर सुरक्षित सर्वर-साइड एंडपॉइंट जोड़ने के लिए चलाएँ /add-server-logic . सर्वर तर्क का उपयोग तब करें जब आपकी साइट को ऐसे तर्क की आवश्यकता होती है जो ब्राउज़र में नहीं चल सकता, जैसे बाहरी API कॉल, सर्वर-साइड सत्यापन, गुप्त प्रबंधन या क्रॉस-निकाय डेटा कार्रवाई.

Important

सर्वर तर्क समर्थन के लिए PAC CLI संस्करण 2.6.3 या बाद के संस्करण की आवश्यकता होती है। नवीनतम संस्करण में अद्यतन करने के लिए त्वरित स्थापना स्क्रिप्ट का उपयोग करें।

वर्णन करें कि आपको क्या चाहिए, सरल भाषा में, और प्लगइन:

  1. एक सर्वर लॉजिक आर्किटेक्ट एजेंट को स्पॉन करता है जो आपके उपयोग के मामले का विश्लेषण करता है और इसकी जटिलता को वर्गीकृत करता है।
  2. आपकी समीक्षा के लिए एक समापन बिंदु डिज़ाइन, सुरक्षा कॉन्फ़िगरेशन और किसी भी आवश्यक तालिका अनुमतियों का प्रस्ताव करता है।
  3. आपके द्वारा अनुमोदित करने के बाद, सर्वर-साइड JavaScript समापन बिंदु जनरेट करता है /_api/serverlogics/<name>।
  4. आपके घटकों से समापन बिंदु को लागू करने के लिए एक टाइप की गई क्लाइंट-साइड सेवा बनाता है।
  5. नई सेवा को कॉल करने के लिए अपने घटकों को अपडेट करता है।
  6. समापन बिंदु के लिए वेब रोल असाइनमेंट और तालिका अनुमतियों को कॉन्फ़िगर करता है।

आप प्रस्ताव की समीक्षा करें और उसे मंजूरी दें। जब तक आप पुष्टि नहीं करते तब तक कोई कोड उत्पन्न नहीं होता है।

सामान्य उपयोग के मामले:

  • बाहरी सेवाओं से कनेक्ट करें। क्रेडेंशियल्स को प्रदर्शित किए बिना REST APIs, Azure Functions या तृतीय-पक्ष सेवाओं को कॉल करें. (ट्यूटोरियल: बाहरी सेवाओं के साथ बातचीत करें)
  • सुरक्षित डेटा संचालन करें। लगातार सर्वर-साइड सत्यापन के साथ Dataverse रिकॉर्ड को क्वेरी करें, अपडेट करें या हटाएं। (ट्यूटोरियल: Dataverse तालिकाओं के साथ बातचीत करें)
  • कस्टम तर्क चलाएँ. क्लाइंट को परिणाम लौटाने से पहले तालिकाओं में डेटा एकत्रित करें, व्यवसाय नियम लागू करें या व्युत्पन्न मानों की गणना करें.
  • रहस्य सर्वर-साइड प्रबंधित करें। सर्वर पर क्रेडेंशियल्स और एपीआई कुंजियों को स्टोर करें, क्लाइंट कोड में कभी नहीं। (ट्यूटोरियल: Microsoft Graph और SharePoint के साथ बातचीत करें)

नोट

प्रति उपयोग मामले में एक बार चलाएं /add-server-logic । उदाहरण के लिए, यदि आपकी साइट को इन्वेंट्री सत्यापन समापन बिंदु और वैश्विक खोज समापन बिंदु दोनों की आवश्यकता है, तो कौशल को दो बार चलाएं।

चरण 10: क्लाउड प्रवाह को एकीकृत करें

अपनी साइट में मौजूदा Power Automate क्लाउड प्रवाह को एकीकृत करने के लिए /add-cloud-flow चलाएँ. यह कौशल आपकी Power Pages साइट को उन प्रवाहों से कनेक्ट करता है जिन्हें आपने पहले ही Power Automate में बनाया है. यह नए क्लाउड प्रवाह नहीं बनाता है।

प्लगइन:

  1. आपकी साइट के साथ मौजूदा क्लाउड प्रवाह को पंजीकृत करता है।
  2. आपके पृष्ठों से प्रवाह को ट्रिगर करने के लिए क्लाइंट-साइड कोड उत्पन्न करता है।
  3. एसिंक्रोनस वर्कफ़्लो स्थिति और कॉलबैक पैटर्न को संभालता है।
  4. पृष्ठ और प्रवाह के बीच डेटा विनिमय को तार करता है।

अनुमोदन वर्कफ़्लोज़, ईमेल सूचनाएँ, शेड्यूल किए गए कार्य और सर्वर-साइड समापन बिंदुओं की तुलना में Power Automate द्वारा बेहतर तरीके से नियंत्रित किए जाने वाले ईवेंट-चालित स्वचालन के लिए /add-cloud-flow का उपयोग करें.

वैकल्पिक: पूर्ण सेवा परत की योजना बनाने के लिए /integrate-backend का उपयोग करें

यदि आप सुनिश्चित नहीं हैं कि किन सुविधाओं के लिए Web API, Server Logic, या क्लाउड फ़्लो की आवश्यकता है, तो चरण 4 से 10 तक मैन्युअल रूप से चलाने के बजाय चलाएँ /integrate-backend . यह कौशल एक ऑर्केस्ट्रेटर के रूप में कार्य करता है जो:

  1. उन सभी सुविधाओं की पहचान करने के लिए अपने प्रोटोटाइप का विश्लेषण करता है जिनके लिए सेवा परत की आवश्यकता होती है।
  2. प्रत्येक सुविधा को सही दृष्टिकोण में वर्गीकृत करता है: मानक CRUD के लिए वेब एपीआई, सर्वर-साइड सत्यापन और बाहरी एपीआई के लिए सर्वर तर्क, या अनुमोदन वर्कफ़्लो और स्वचालन के लिए क्लाउड प्रवाह।
  3. सभी कौशलों, निर्भरताओं और कॉन्फ़िगरेशन के साथ एक अनुक्रमित निष्पादन योजना का प्रस्ताव करता है।
  4. आपके द्वारा अनुमोदित करने के बाद, कौशल को सही क्रम में व्यवस्थित करें।

योजना निरंतर, पुन: शुरू करने योग्य और संपादन योग्य है। जेनरेट किए गए कोड की समीक्षा करने या साइट का परीक्षण करने के लिए किसी भी चरण के बाद रुकें, और फिर से दौड़कर /integrate-backend वहीं से शुरू करें जहां आपने छोड़ा था।

चरण 11: SEO जोड़ें

खोज इंजन के लिए अपनी साइट को अनुकूलित करने के लिए चलाएँ /add-seo । प्लगइन:

  1. आपके फ़्रेमवर्क के राउटर कॉन्फ़िगरेशन से मार्गों का पता लगाता है।
  2. खोज इंजन निर्देश और सभी खोजे गए मार्गों के लिए एक साइटमैप तैयार करता है।
  3. मेटा टैग जोड़ता है: व्यूपोर्ट, चारसेट, विवरण, ओपन ग्राफ, ट्विटर कार्ड और फ़ेविकॉन संदर्भ।

चरण 12: अंतिम साइट परिनियोजित करें

यदि आप कोई वैकल्पिक चरण निष्पादित करते हैं, तो परिवर्तनों को लाइव करने के लिए फिर से दौड़ें /deploy-site । प्लगइन एक उत्पादन बिल्ड चलाता है और साइट को सभी परिनियोजन कलाकृतियों (तालिका अनुमतियाँ, साइट सेटिंग्स, वेब भूमिकाएँ, सर्वर तर्क फ़ाइलें) के साथ आपके Power Pages वातावरण में अपलोड करता है।

अपनी साइट की पुष्टि करें

कौशल पूरा करने के बाद, सत्यापित करें कि आपकी Power Pages साइट सही ढंग से काम कर रही है.

  1. Power Pages पर जाएं।
  2. सक्रिय साइट्स सूची में अपनी साइट का पता लगाएँ.
  3. पूर्वावलोकन विकल्प का उपयोग करके डेस्कटॉप पर अपनी साइट का पूर्वावलोकन करें.
  4. कार्यक्षमता का परीक्षण करें।

युक्तियाँ और सर्वोत्तम प्रथाएँ

निम्नलिखित युक्तियाँ आपको Power Pages साइटें बनाते समय प्लगइन और AI कोडिंग एजेंट का अधिकतम लाभ उठाने में मदद करती हैं।

पहली बार में अनुपलब्ध टूल के लिए टर्मिनल आउटपुट देखें

प्लगइन कौशल और वर्कफ़्लो प्रदान करता है, लेकिन एआई कोडिंग एजेंट - GitHub Copilot CLI या Claude Code - आपकी मशीन पर वास्तविक कमांड निष्पादित करता है। जब आप पहली बार इन उपकरणों का उपयोग करते हैं, तो टर्मिनल आउटपुट को बारीकी से देखें। एआई कोडिंग एजेंट पर्दे के पीछे कमांड और स्क्रिप्ट चलाता है, और इनमें से कुछ कमांड उन टूल पर निर्भर करते हैं जो आपकी मशीन पर इंस्टॉल नहीं हो सकते हैं। यदि कोई चरण विफल हो जाता है, तो टर्मिनल आउटपुट आमतौर पर दिखाता है कि उसे कौन सा टूल या कमांड नहीं मिल सका।

यदि आपको या जैसी command not foundकोई is not recognized त्रुटि दिखाई देती है, तो अनुपलब्ध टूल स्थापित करें और वर्कफ़्लो को फिर से ट्रिगर करें। एआई कोडिंग एजेंट टूल उपलब्ध होने के बाद वहीं से शुरू होता है जहां उसने छोड़ा था।

अनुमोदन से पहले एजेंट के प्रस्तावों की समीक्षा करें

डेटा मॉडल आर्किटेक्ट और वेब एपीआई अनुमतियां आर्किटेक्ट एजेंट परिवर्तन करने से पहले प्रस्ताव प्रस्तुत करते हैं। इन प्रस्तावों की सावधानीपूर्वक समीक्षा करने के लिए समय निकालें।

  • डेटा मॉडल प्रस्ताव: जाँचें कि तालिका नाम, स्तंभ प्रकार और संबंध आपकी व्यावसायिक आवश्यकताओं से मेल खाते हैं. डेटा पहले से ही सम्मिलित किए जाने के बाद स्तंभों का नाम बदलने की तुलना में किसी प्रस्ताव को समायोजित करना बहुत आसान है.
  • अनुमतियाँ प्रस्ताव: सत्यापित करें कि प्रत्येक भूमिका में प्रत्येक तालिका के लिए सही access स्तर (बनाएँ, पढ़ें, अद्यतन करें, हटाएँ) है। अत्यधिक अनुमेय तालिका अनुमतियाँ एक सामान्य सुरक्षा जोखिम हैं।

संदर्भ के साथ सीधे त्रुटियों को पेस्ट करें

जब कुछ विफल हो जाता है, चाहे वह बिल्ड त्रुटि हो, परिनियोजन विफलता हो, या ब्राउज़र में रनटाइम अपवाद हो, तो पूर्ण त्रुटि आउटपुट कॉपी करें। आप जो कर रहे थे उसके संक्षिप्त विवरण के साथ इसे पेस्ट करें। आप जितना अधिक संदर्भ प्रदान करेंगे, उतनी ही तेजी से समाधान होगा।

उदाहरण: बिल्ड त्रुटि

I ran npm run build and got this error. Fix it.

error TS2339: Property 'jobTitle' does not exist on type 'JobPosting'.

  src/components/JobCard.tsx:24:31
    24   <Text>{posting.jobTitle}</Text>

सुझाव

फ़ाइल का नाम, आपके द्वारा चलाया गया आदेश और आपके द्वारा अपेक्षित कार्य शामिल करें. प्लगइन इस संदर्भ का उपयोग समस्या का पता लगाने और अनुमान लगाने के बजाय लक्षित समाधान लागू करने के लिए करता है।

वेब API त्रुटियों को पूर्ण अनुरोध URL के साथ साझा करें

परिनियोजन के बाद एक सामान्य समस्या Power Pages वेब एपीआई से 403 त्रुटि है जब कोई कॉलम एपीआई एक्सेस के लिए सक्षम नहीं होता है। जब आप इस त्रुटि का सामना करते हैं, तो पूर्ण API URL और पूर्ण JSON त्रुटि प्रतिक्रिया पेस्ट करें। त्रुटि संदेश आपको बताता है कि वास्तव में किस तालिका और स्तंभ को ठीक करने की आवश्यकता है, और प्लगइन आपके लिए तालिका अनुमति YAML और साइट सेटिंग्स को अपडेट कर सकता है।

उदाहरण: वेब एपीआई (403) के लिए स्तंभ सक्षम नहीं किया गया है

I'm getting a 403 error when the documents page loads. Here's the API call and the response. Fix the issue so this API works.

URL:
https://my-site.powerappsportals.com/_api/crd50_documents?$select=crd50_documentid,crd50_name,crd50_documentcategory,crd50_filetype,crd50_filesize,crd50_updateddate,crd50_description,_crd50_propertyid_value

Response:
{
  "error": {
    "code": "90040101",
    "message": "Attribute _crd50_propertyid_value in table crd50_document is not enabled for Web Api.",
    "innererror": {
      "code": "90040101",
      "message": "Attribute _crd50_propertyid_value in table crd50_document is not enabled for Web Api.",
      "type": "AttributePermissionIsMissing"
    }
  }
}

इस त्रुटि ()AttributePermissionIsMissing का अर्थ है कि लुकअप कॉलम _crd50_propertyid_value Dataverse तालिका में मौजूद है, लेकिन वेब API के लिए तालिका अनुमति कॉन्फ़िगरेशन में सूचीबद्ध नहीं है. प्लगइन तालिका अनुमति YAML में लापता .powerpages-site/table-permissions/ कॉलम जोड़कर और पुन: परिनियोजन करके इस त्रुटि को हल करता है।

नोट

Power Pages Web API के लिए API कॉल द्वारा लौटाए गए प्रत्येक स्तंभ को तालिका अनुमति में स्पष्ट रूप से सूचीबद्ध करने की आवश्यकता होती है. लुकअप प्रॉपर्टी (उपसर्ग के साथ और प्रत्यय के साथ __value) को याद करना आसान है क्योंकि उनका एपीआई नाम डेटावर्स में कॉलम के तार्किक नाम से भिन्न होता है। जब आप देखें AttributePermissionIsMissing, तो उस कॉलम को हमेशा तालिका अनुमति में जोड़ें। एपीआई क्वेरी न बदलें.

आप जो चाहते हैं उसके बारे में विशिष्ट रहें

अस्पष्ट अनुरोध अस्पष्ट परिणाम उत्पन्न करते हैं। प्लगइन को ठीक-ठीक बताएं कि आपको क्या चाहिए, जिसमें लेआउट प्राथमिकताएं, डेटा फ़ील्ड और व्यवहार शामिल हैं।

इसके बजाय आजमाएँ
"नौकरियों के लिए एक पेज बनाएं" "शीर्ष पर एक खोज बार के साथ एक नौकरी लिस्टिंग पृष्ठ बनाएं, स्थान और विभाग के लिए चिप्स फ़िल्टर करें, और शीर्षक, कंपनी, वेतन सीमा और प्रत्येक नौकरी के लिए एक पोस्ट की गई तारीख दिखाने वाला एक कार्ड ग्रिड"
"स्टाइल को ठीक करें" "जॉब कार्ड डेस्कटॉप पर लंबवत रूप से ढेर हो जाते हैं। उन्हें 768px से अधिक चौड़ी स्क्रीन पर 16px गैप के साथ तीन-कॉलम ग्रिड में प्रदर्शित करें"
"कुछ डेटा जोड़ें" "यथार्थवादी शीर्षकों के साथ चार विभागों (इंजीनियरिंग, विपणन, बिक्री, मानव संसाधन) में 20 नमूना नौकरी पोस्टिंग जोड़ें, वेतन $ 60k- $ 180k के बीच है, और पिछले 30 दिनों में पोस्ट की गई तारीखें"
"एपीआई सेट अप करें" "JobListings घटक को cr_jobposting Dataverse तालिका से कनेक्ट करें। हार्डकोडेड सरणी को एक वास्तविक एपीआई कॉल से बदलें जो शीर्षक, विभाग, वेतन और पोस्ट की गई तारीख प्राप्त करता है"

दृश्य समस्याओं के लिए स्क्रीनशॉट का उपयोग करें

जब साइट ब्राउज़र में सही दिखाई न दे, तो एक स्क्रीनशॉट लें और इसे सीधे बातचीत में पेस्ट करें या फ़ाइल पथ प्रदान करें। दृश्य संदर्भ लेआउट, रिक्ति और स्टाइलिंग समस्याओं की पहचान करने में मदद करता है जिनका पाठ में वर्णन करना कठिन है।

The header overlaps the hero section on mobile. Here's a screenshot:

[paste screenshot or provide path to screenshot file]

Fix the header so it doesn't overlap. It should be a fixed header with the content starting below it.

छोटे चरणों में पुनरावृति करें

एक प्रॉम्प्ट में पूरी साइट का वर्णन करने के बजाय, वृद्धिशील रूप से निर्माण करें। संरचना और लेआउट से शुरू करें, फिर एक-एक करके सुविधाएँ जोड़ें। यह दृष्टिकोण आपको प्रत्येक चरण में समीक्षा करने और पाठ्यक्रम-सही करने का मौका देता है।

Step 1: /create-site → Get the basic scaffold and layout right
Step 2: "Add a hero section to the home page with a search bar"
Step 3: "Add a job listings page with filter and sort"
Step 4: "Add a job detail page that shows full description"
Step 5: /setup-datamodel → Create tables now that you know the data shape
Step 6: /integrate-webapi → Wire up real data

सुझाव

प्रत्येक चरण के बाद, ब्राउज़र पूर्वावलोकन की जाँच करें। अगर कुछ सही नहीं है, तो आगे बढ़ने से पहले उसे ठीक कर लें। पूरी साइट पर समस्याओं को सुलझाने की तुलना में एक घटक में समस्याओं को ठीक करना आसान है।

अनुमोदन करने से पहले स्पष्टीकरण मांगें

जब आप किसी प्रस्तावित परिवर्तन के बारे में अनिश्चित हों, विशेष रूप से अनुमतियों, डेटा मॉडल संशोधनों या प्रमाणीकरण कॉन्फ़िगरेशन के लिए, तो प्लगइन से यह समझाने के लिए कहें कि वह क्या करने to do है और अनुमोदन करने से पहले क्यों।

Before you create the table permissions, explain what access each role will have and why. I want to understand the security implications.

समस्याओं से उबरने के लिए स्वतंत्र रूप से कौशल चलाएं

यदि कोई कौशल आंशिक रूप से विफल हो जाता है, तो आपको फिर से शुरू करने की आवश्यकता नहीं है। प्रत्येक कौशल स्वतंत्र रूप से चलता है और जहां उसने छोड़ा था वहीं से शुरू कर सकता है। उदाहरण के लिए, यदि तीसरी तालिका पर विफल रहता है, तो /integrate-webapi आप इसे फिर से चला सकते हैं और यह पहले से ही पूर्ण कार्य का पता लगाता है।

/integrate-webapi failed while processing the cr_applications table. Here's the error: [paste error]. Resume the integration from where it stopped.

संबंधित सामग्री

  • Last updated on