pac canvas

Power Apps .msapp फ़ाइलों के साथ कार्य करना

[यह आलेख रिलीज़-पूर्व दस्तावेज़ है और परिवर्तन के अधीन है.]

महत्त्वपूर्ण

• और pack आदेशों unpack को बहिष्कृत कर दिया जाता है।
• अपने कैनवास ऐप को नियंत्रित करने के लिए, Power Platform Git एकीकरण का उपयोग करें.
• create कमांड आम तौर पर उपलब्ध है।

आदेश

Command	विवरण
pac canvas create	किसी कस्टम कनेक्टर से कैनवास ऐप जनरेट करें
pac canvas download	कैनवास ऐप को .msapp फ़ाइल के रूप में डाउनलोड करें
pac canvas list	कैनवास ऐप्स की सूची बनाएं
pac canvas pack	(पूर्वावलोकन) स्रोतों को किसी msapp फ़ाइल में पैक करें
pac canvas unpack	(पूर्वावलोकन) स्रोतों में एक msapp फ़ाइल निकालें
pac canvas validate	(पूर्वावलोकन) एक अनज़िप की गई msapp फ़ाइल के लिए .pa.yaml स्रोत को मान्य करें

pac canvas create

किसी कस्टम कनेक्टर से कैनवास ऐप जनरेट करें

यह कमांड मौजूदा .msapp की OpenAPI परिभाषा के आधार पर एक कैनवास ऐप जेनरेट करेगा। ऐप में स्क्रीन, नियंत्रण लेआउट और पावर एफएक्स कोड होगा जो इस आधार पर उत्पन्न होगा कि कस्टम कनेक्टर की क्रियाओं को कैसे परिभाषित किया जाता है, एक पूर्वनिर्धारित रूप और अनुभव के साथ। ऐप का उपयोग कस्टम कनेक्टर में परिभाषित कार्यों को सीधे करने के लिए किया जा सकता है।

निर्माता ऐप चलाने के लिए, या संपादन करने और आगे अनुकूलन करने के लिए जनरेट किए .msapp गए को Power Apps Studio में आयात कर सकते हैं. स्टूडियो के भीतर फ़ाइल>खोलें>ब्राउज़ पर नेविगेट करके जेनरेट किए गए ऐप को Power Apps Studio में आयात करें.

उदाहरण

निम्नलिखित उदाहरण आदेश का pac canvas create उपयोग दिखाते हैं।

• प्रदर्शन नाम के आधार पर एक ओपन एपीआई परिभाषा के आधार पर एक कैनवास ऐप बनाएं
• आईडी द्वारा ओपन एपीआई परिभाषा के आधार पर एक कैनवास ऐप बनाएं

प्रदर्शन नाम के आधार पर एक ओपन एपीआई परिभाषा के आधार पर एक कैनवास ऐप बनाएं

यह उदाहरण कनेक्टर के प्रदर्शन नाम का उपयोग करके एक ओपन एपीआई परिभाषा के आधार पर एक कैनवास ऐप (एक *.msapp फ़ाइल के रूप में) बनाता है।

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

आईडी द्वारा ओपन एपीआई परिभाषा के आधार पर एक कैनवास ऐप बनाएं

यह उदाहरण कनेक्टर की ID का उपयोग करके एक Open API परिभाषा के आधार पर एक कैनवास अनुप्रयोग (एक *.msapp फ़ाइल के रूप में) बनाता है।

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

या तो connector-display-name या आवश्यक connector-id हैं।

के लिए आवश्यक पैरामीटर canvas create

--msapp

जनरेट होने वाली .msapp फ़ाइल का पथ

के लिए वैकल्पिक पैरामीटर canvas create

--connector-display-name

Power App जनरेट करने के लिए कनेक्टर का प्रदर्शन नाम.

--connector-id

Power App जनरेट करने के लिए कनेक्टर की ID.

--environment

लक्ष्य परिवेश ID या URL. डिफ़ॉल्ट मान आपके वर्तमान में सक्रिय Dataverse प्रमाणीकरण प्रोफ़ाइल का वातावरण है।

टिप्पणियां

विचार और सीमाएँ:

• या पैरामीटर connector-display-name के साथ connector-id संदर्भित कस्टम कनेक्टर समाधान का हिस्सा होना चाहिए।
• ऐप को स्टूडियो में आयात करने के बाद, कस्टम कनेक्टर से कोई संबंध नहीं होगा। निर्माता को मैन्युअल रूप से उस कस्टम कनेक्टर का संदर्भ जोड़ना होगा जिससे ऐप चलाने से पहले ऐप जेनरेट किया गया था। चरणों के लिए कैनवास अनुप्रयोग में डेटा कनेक्शन जोड़ें देखें. जब तक यह नहीं किया जाता है, तब तक आप ऐप में फॉर्मूला त्रुटियां देख सकते हैं जो कनेक्टर संदर्भ जोड़ने के बाद हल हो जाएंगी। आपके द्वारा ऐप में जोड़े गए कस्टम कनेक्टर का नाम कमांड में संदर्भित canvas create कस्टम कनेक्टर के प्रदर्शन नाम से मेल खाना चाहिए।
• ऐप में प्रत्येक के POST लिए एक स्क्रीन होगी और GET कनेक्टर द्वारा परिभाषित की गई कार्रवाई होगी।
  • कस्टम कनेक्टर्स में उपलब्ध अन्य क्रियाएं समर्थित नहीं हैं।
• प्रत्येक क्रिया की स्क्रीन पर प्रदान किए गए नियंत्रण गतिशील रूप से उत्पन्न होते हैं कि प्रत्येक क्रिया के इनपुट और आउटपुट प्रकार कैसे परिभाषित किए जाते हैं। कस्टम कनेक्टर में परिभाषित कुछ प्रकार के इनपुट और आउटपुट द्वारा canvas createसमर्थित नहीं हैं। कमांड कंसोल में चेतावनियां उत्पन्न करेगा जब इनका सामना करना पड़ेगा। विशिष्ट मामले:
  • वस्तुओं की सरणियाँ और सरणियों की सरणियाँ इनपुट के रूप में समर्थित नहीं हैं
  • नियंत्रण ऑब्जेक्ट्स या नेस्टेड सरणियों के लिए 20 की गहराई से अधिक उत्पन्न नहीं होते हैं
  • "फ़ाइल" और "बाइनरी प्रारूप" प्रकार इनपुट या आउटपुट के लिए समर्थित नहीं हैं।

pac canvas download

कैनवास ऐप को .msapp फ़ाइल के रूप में डाउनलोड करें

के लिए आवश्यक पैरामीटर canvas download

--name -n

कैनवास ऐप सटीक, आंशिक नाम या ऐप आईडी

के लिए वैकल्पिक पैरामीटर canvas download

--environment -env

लक्ष्य Dataverse निर्दिष्ट करता है. मान एक Guid या निरपेक्ष https URL हो सकता है। निर्दिष्ट नहीं होने पर, वर्तमान प्रमाणीकरण प्रोफ़ाइल के लिए चयनित सक्रिय संगठन का उपयोग किया जाएगा।

--extract-to-directory -d

कैनवास ऐप को निकालने के लिए निर्देशिका का नाम

--file-name -f

फ़ाइल का नाम (आमतौर पर .msapp एक्सटेंशन के साथ)। यदि प्रदान नहीं किया गया है तो फ़ाइल वर्तमान निर्देशिका में 'appname'.msapp के साथ सहेजी जाती है

--overwrite -o

फ़ाइल अधिलेखित करने की अनुमति दें

इस पैरामीटर के लिए किसी मान की आवश्यकता नहीं है। यह एक स्विच है।

pac canvas list

कैनवास ऐप्स की सूची बनाएं

के लिए वैकल्पिक पैरामीटर canvas list

--environment -env

लक्ष्य Dataverse निर्दिष्ट करता है. मान एक Guid या निरपेक्ष https URL हो सकता है। निर्दिष्ट नहीं होने पर, वर्तमान प्रमाणीकरण प्रोफ़ाइल के लिए चयनित सक्रिय संगठन का उपयोग किया जाएगा।

pac canvas pack

(पूर्वावलोकन) स्रोतों को किसी msapp फ़ाइल में पैक करें

उदाहरण

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

के लिए आवश्यक पैरामीटर canvas pack

--msapp

.msapp फ़ाइल का पथ

--sources

पैक किए जाने वाले स्रोतों के लिए निर्देशिका

टिप्पणियां

पहले से अनपैक की गई स्रोत फ़ाइलों से एक .msapp फ़ाइल बनाता है। परिणाम को Power Apps Studio में फ़ाइल खोलें>>ब्राउज़ पर नेविगेट करके खोला जा सकता है.

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

pac canvas unpack

(पूर्वावलोकन) स्रोतों में एक msapp फ़ाइल निकालें

उदाहरण

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

डिफ़ॉल्ट HelloWorld_src निर्देशिका के लिए अनपैक करता है।

के लिए आवश्यक पैरामीटर canvas unpack

--msapp

.msapp फ़ाइल का पथ

के लिए वैकल्पिक पैरामीटर canvas unpack

--sources

अनपैक किए जाने वाले स्रोतों के लिए निर्देशिका

टिप्पणियां

स्रोत फ़ाइल को .msapp अनपैक करता है।

इस.msapp केरूप में>फ़ाइल> सहेजें पर नेविगेट करके Power Apps Studio से फ़ाइल डाउनलोड करें.

यदि स्रोत पैरामीटर निर्दिष्ट नहीं है, तो फ़ाइल के समान .msapp नाम और स्थान वाली निर्देशिका का उपयोग प्रत्यय के साथ किया _src जाता है।

फ़ोल्डर संरचना

अनपैक करें और पैक गुण निम्न फ़ोल्डर संरचना का उपयोग करें:

• \src - नियंत्रण और घटक फ़ाइलें। इसमें स्रोत शामिल हैं।
  • *.fx.yaml - फ़ाइल से control.json निकाले गए सूत्र।

    नोट

    यह आपके सूत्रों को संपादित करने का स्थान है।

  • CanvasManifest.json - एक मेनिफ़ेस्ट फ़ाइल जिसमें हेडर, गुण और publishInfo में सामान्य रूप से मौजूद जानकारी होती है.
  • *.json - कच्ची control.json फ़ाइल।
  • \EditorState*.editorstate.json - उपयोग करने के लिए Power Apps Studio के लिए कैश्ड जानकारी.
• \DataSources - ऐप द्वारा उपयोग किए जाने वाले सभी डेटा स्रोत।
• \Connections - कनेक्शन इंस्टेंस ऐप के साथ सहेजे गए और Power Apps Studio में पुनः लोड करते समय उपयोग किए जाते हैं.
• \Assets - ऐप में एम्बेडेड मीडिया फ़ाइलें।
• \pkgs - बाहरी संदर्भों की एक डाउनलोड की गई प्रति, जैसे टेम्प्लेट, एपीआई परिभाषा फ़ाइलें, और घटक पुस्तकालय। ये NuGet/NPM संदर्भों के समान हैं।
• \other - सभी विविध फ़ाइलों को फिर से बनाने के लिए आवश्यक है .msapp।
  • entropy.json - वाष्पशील तत्व (जैसे टाइमस्टैम्प) इस फ़ाइल में निकाले जाते हैं। यह अन्य फ़ाइलों में शोर के अंतर को कम करने में मदद करता है और यह सुनिश्चित करता है कि हम अभी भी राउंड-ट्रिप कर सकते हैं।
  • msapp से अन्य फ़ाइलें रखता है, जैसे कि \references में क्या है।

फ़ाइल स्वरूप

फ़ाइलें .fx.yaml के सबसेट का उपयोग करती हैं। एक्सेल के समान, सभी अभिव्यक्तियों को एक समान चिह्न =से शुरू होना चाहिए . अधिक जानकारी: Power Fx YAML सूत्र व्याकरण

Power Apps Studio के साथ परिवर्तनों को मर्ज करना

दो अलग-अलग Power Apps Studio सत्रों में किए गए परिवर्तनों को मर्ज करते समय:

• सुनिश्चित करें कि सभी नियंत्रण नाम अद्वितीय हैं। उदाहरण के लिए, दो अलग-अलग सत्रों में एक बटन डालने से दो Button1 नियंत्रण हो सकते हैं। हम अनुशंसा करते हैं कि आप नियंत्रणों को बनाने के तुरंत बाद उन्हें नाम दें। उपकरण एक ही नाम के दो नियंत्रणों को स्वीकार नहीं करता है।
• इन फ़ाइलों के लिए, उन्हें मर्ज करें जैसा कि आप सामान्य रूप से करते हैं:
  • \src*.fx.yaml
• यदि कोई विरोध या त्रुटियाँ हैं, तो आप इन फ़ाइलों को हटा सकते हैं:
  • \src\editorstate*.json - इन फ़ाइलों में Power Apps Studio में वैकल्पिक जानकारी होती है.
  • \other\entropy.jsपर
• इन फ़ाइलों में किसी भी विरोध के लिए, नवीनतम संस्करण को स्वीकार करना ठीक है:
  • \checksum.jsपर
• यदि इन पथों के अंतर्गत कोई मर्ज विरोध है, तो मर्ज करना सुरक्षित नहीं है. आइए जानते हैं कि क्या ऐसा अक्सर होता है; हम विवादों से बचने के लिए फ़ाइल स्वरूप के पुनर्गठन पर काम करेंगे।
  • \कनेक्शन*
  • \डेटासोर्स*
  • \pkgs*
  • CanvasManifest.json

खुला स्रोत

Microsoft Power Platform CLI में कैनवास आदेश खुला स्रोत हैं। सुधारों पर चर्चा करें, समस्याएँ उठाएं और Power Apps भाषा टूलिंग रिपॉजिटरी से कोड तक पहुँचें.

pac canvas validate

(पूर्वावलोकन) एक अनज़िप की गई msapp फ़ाइल के लिए .pa.yaml स्रोत को मान्य करें

के लिए आवश्यक पैरामीटर canvas validate

--directory -d

सत्यापित करने के लिए .pa.yaml फ़ाइलों वाली निकाली गई msapp निर्देशिका का पथ

इसे भी देखें

Microsoft Power Platform CLI कमांड समूह
Microsoft Power Platform CLI अवलोकन