उदाहरण Dataverse लो-कोड प्लग-इन (पूर्वावलोकन)

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

इन उदाहरण प्लग-इन का लक्ष्य उन्हें आपके ऐप्स में एकीकृत करके आरंभ करने में आपकी सहायता करना है। आप समझेंगे कि संलेखन अनुभव में संलेखन Microsoft Dataverse अभिव्यक्तियों द्वारा समर्थित कस्टम API शामिल हैं, जो आंतरिक या बाह्य क्रियाओं को ट्रिगर कर सकते हैं। Power Fx Dataverse

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

  • त्वरित लो-कोड प्लग-इन को प्राथमिकता नहीं दी गई है तथा उन्हें फीचर के रूप में वितरित नहीं किया जा रहा है। त्वरित लो-कोड प्लग-इन को फंक्शन्स से प्रतिस्थापित कर दिया जाता है। अधिक जानकारी: Microsoft Dataverse में फ़ंक्शन(पूर्वावलोकन)
  • यह एक पूर्वावलोकन सुविधा है.
  • पूर्वावलोकन सुविधाएँ उत्पादन में उपयोग के लिए नहीं होती हैं और इनकी कार्यक्षमता प्रतिबंधित हो सकती हैं. यह सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध होती हैं ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.

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

डेटा इवेंट के लिए उदाहरण प्लग-इन में से किसी एक का उपयोग करने के लिए Dataverse एक्सेलेरेटर ऐप को वातावरण में इंस्टॉल किया जाना चाहिए। अधिक जानकारी: लो-कोड प्लग-इन बनाने के लिए पूर्वापेक्षाएँ

नोट

ईमेल टेम्पलेट केवल कुछ तालिकाओं के लिए ही उपलब्ध हैं. अधिक जानकारी: ईमेल के लिए टेम्पलेट बनाएँ

एक गैर-ऋणात्मक मान लौटाएँ

यह उदाहरण अपने तर्क का गैर-ऋणात्मक मान लौटाने के लिए Abs() फ़ंक्शन का उपयोग करता है। यदि कोई संख्या ऋणात्मक है, तो Abs धनात्मक समतुल्य लौटाता है।

  1. Dataverse एक्सेलेरेटर ऐप चलाएँ, कमांड बार पर नई क्रिया >इंस्टेंट प्लगइन का चयन करें।

  2. एक प्रदर्शन नाम प्रदान करें, जैसे सूत्र नाम और विवरण.

  3. अपेक्षित व्यवहार को मान्य करने के लिए एक पैरामीटर बनाएं जो सार्थक हो, जैसे स्ट्रिंग। परीक्षण को आसान बनाने के लिए वैकल्पिक रूप से इनपुट पैरामीटर का उपयोग करें, जो सूत्र के साथ सार्थक हो। Out

  4. सूत्र संपादक में, Out पैरामीटर को घुमावदार कोष्ठकों में लपेटें:

    {Out: "" }

  5. सूत्र का परीक्षण करने वाला व्यंजक दर्ज करें:

    • सत्यापित करें कि इंटेलीसेंस सूत्र को स्वीकार करता है (पाठ हल्का नीला हो जाता है)।
    • उदाहरण के लिए, एक अभिव्यक्ति लागू करें जो परिणाम को मान्य करने में मदद करने के लिए आउटपुट प्रदान करती है।
    {Out: "Abs(-5) = 5: " & Text( Abs(-5) = 5 )  }

  6. अगला चुनें, और फिर सहेजें चुनें.

  7. सूत्र का परीक्षण करने के लिए परीक्षण का चयन करें. परिणाम को मान्य करने के लिए आउटपुट पैरामीटर का उपयोग करें.

इनपुट सत्यापन और कस्टम त्रुटियाँ

डुप्लिकेट का पता लगाना

सर्वर-साइड इनपुट सत्यापन को कार्यान्वित करें, जैसे डुप्लिकेट त्रुटि का पता लगाना जो एक कस्टम त्रुटि संदेश देता है।

  1. Dataverse एक्सेलेरेटर ऐप चलाएँ, कमांड बार पर नई क्रिया >स्वचालित प्लगइन का चयन करें।
  2. नाम बॉक्स में, डुप्लिकेट चेक दर्ज करें.
  3. तालिका के लिए, संपर्क चुनें.
  4. पंक्ति होने पर इस प्लगइन को चलाने के लिए , निर्मित का चयन करें।
  5. सूत्र बॉक्स में, यह सूत्र दर्ज करें:
 If( !IsBlank(LookUp([@Contacts],'Last Name'=ThisRecord.'Last Name' && 'First Name'=ThisRecord.'First Name')),
    Error("You have existing contacts with the same first name and last name")
)
  1. सहेजें चुनें.

प्लग-इन का परीक्षण करें

  1. प्लग-इन का परीक्षण करने के लिए, यहां दिए गए चरणों का पालन करके संपर्क तालिका का उपयोग करके एक कैनवास ऐप बनाएं: एक तालिका निर्दिष्ट करें.
  2. एक संपर्क पंक्ति बनाएँ.
  3. पिछले चरण के समान नाम से एक और संपर्क बनाएं।
  4. एक संदेश प्रदर्शित होता है जो बताता है कि डुप्लिकेट रिकॉर्ड पाए गए हैं। त्रुटि संदेश प्रॉम्प्ट पर अनदेखा करें और सहेजें का चयन करें।

यह कस्टम त्रुटि संदेश प्रदर्शित होता है: आपके पास एक ही प्रथम और अंतिम नाम वाले दो संपर्क हैं.

डेटा सत्यापन

ErrorKind गणना का उपयोग करके विशिष्ट प्रकार की त्रुटियाँ प्रदर्शित करें.

  1. एक नया स्वचालित प्लग-इन बनाएँ.

  2. निम्नलिखित मान प्रदान करें:

    • नाम: इनपुट सत्यापन
    • विवरण: मान्य तिथि की जांच करता है और अमान्य होने पर त्रुटि उत्पन्न करता है
    • तालिका: नियुक्ति
    • इस प्लगइन को तब चलाएँ जब पंक्ति: अद्यतित हो

  3. नीचे दिया गया सूत्र दर्ज करें:

    If(ThisRecord.'Due Date' < Now(), 
 Error({ Kind: ErrorKind.Validation , Message: "The due date cannot be in the past" })
);

  4. उन्नत विकल्प के अंतर्गत, इसे कब चलाना चाहिए से पूर्व-संचालन सेट करें; आप अमान्य डेटा को रोकने के लिए डेटा सहेजे जाने से पहले इस नियम को चलाना चाहते हैं।

  5. सहेजें चुनें.

कस्टम त्रुटियों के बारे में अधिक जानने के लिए Error() फ़ंक्शन पर जाएं.

डेटा ईवेंट के आधार पर ईमेल भेजें

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

उदाहरण ईमेल टेम्पलेट

यहां एक ईमेल टेम्पलेट उदाहरण दिया गया है जिसे आप SenMail आधारित डेटा ईवेंट के लिए बना सकते हैं:

  • टेम्पलेट प्रकार: वैश्विक
  • नाम: ऑर्डर करें धन्यवाद
  • विवरण: आपके पास ऑर्डर देने के लिए ग्राहक को धन्यवाद देने के लिए इस टेम्पलेट का उपयोग करें।
  • विषय: Thank you for your order <orderconfirmation-{!salesorder:Order Number; }>
  • Body: इस कोड का उपयोग करें.
   Hello {!Sales Order:First Name;},
   Order Type: {! Sales Order: Order Type;},
   Location Type: {! Sales Order: Location Type;},
   Address1: {! Sales Order: Address 1;},
   Address2: {! Sales Order: Address 2;},
   Preferred Service Start Date 1: {! Sales Order: Preferred Service Start Date;},
   Next Step- We take upto 48 hrs to schedule an in-person and will notify you as soon as we have a In-person Technician allocated at your site. For any questions, please contact us at 1-800-CON-SOLAR
   Yours Sincerely, 
   Contoso Sales

स्वचालित प्लग-इन बनाएँ

  1. Dataverse एक्सेलेरेटर ऐप चलाएँ, और फिर +नया प्लगइनस्वचालित प्लगइन्स के अंतर्गत चुनें.
  2. निम्नलिखित जानकारी दर्ज करें:

    • नाम: बनाएँईमेल भेजें

    • तालिका: विक्रय ऑर्डर का तार्किक तालिका नाम चुनें, जो कि SalesOrder है. यह ईवेंट बिक्री ऑर्डर तालिका पर आधारित है.

    • इस प्लगइन को पंक्ति के साथ चलाएँ : Created

    • सूत्र: नीचे दिए गए कोड को सूत्र बॉक्स में चिपकाएँ। SendEmailFromTemplate फ़ंक्शन के बारे में अधिक जानकारी के लिए, SendEmailFromTemplate Action पर जाएँ।

      XSendEmailFromTemplate(
    LookUp('Email Templates',StartsWith(title,"Order Thank You")).'Email Template',
ThisRecord,
LookUp(Users,'Primary Email'="sampleemail@sample.com"),[ThisRecord.Email]
)
  3. उन्नत>ऑपरेशन के बाद का चयन करें.
  4. सहेजें चुनें.

पुष्टिकरण संदेश प्लगइन सफलतापूर्वक सहेजा गया प्रकट होता है।

तत्काल कार्रवाई के आधार पर इन-ऐप सूचनाएं भेजें

इन-ऐप सूचनाएँ निर्माताओं को मॉडल-चालित ऐप्स में उपयोगकर्ताओं के लिए प्रासंगिक, कार्रवाई योग्य सूचनाएँ कॉन्फ़िगर करने में सक्षम बनाती हैं.

लो-कोड प्लगइन बनाएं जो इन-ऐप नोटिफिकेशन भेजे

  1. Dataverse एक्सीलरेटर ऐप चलाएँ, और फिर +नया प्लगइनइंस्टेंट प्लगइन्स के अंतर्गत चुनें.
  2. निम्नलिखित जानकारी दर्ज करें, अगला चुनें:
    • नाम: NotifyTechnican1
    • विवरण: यह त्वरित प्लग-इन ऐप उपयोगकर्ता को सूचित करता है।
  3. परिभाषाएँ पृष्ठ पर, इन डेटा प्रकारों के साथ इनपुट पैरामीटर बनाएँ:
    • ऑर्डरआईडी: स्ट्रिंग
    • तकनीशियनईमेल: स्ट्रिंग
  4. सूत्र. निम्न कोड को फ़ॉर्मूला बॉक्स में चिपकाएँ। इस फ़ंक्शन के बारे में अधिक जानकारी के लिए, SendAppNotification क्रिया पर जाएँ. 
     XSendAppNotification(
 	"New service",
 	LookUp(Users,'Primary Email'=TechnicianEmail),
 	"You have a new solar panel installation scheduled on "& LookUp('Scheduling Results','OrderId'=OrderID).'ServiceDate'&" in "& LookUp('Service Orders','Order Number'=OrderID).City &". Contact the coordinator with any questions.",
 [
 	XCreateSidePaneActionForEntity(
     		"View order",
 		OrderID,
 		"Sales Order",
 		"cr8b8_serviceorder1",
 		LookUp('Service Orders','Order Number'=OrderID).'Service Order'
     	)
 	]
 )
  5. अगला चुनें.
  6. सारांश पृष्ठ पर, सहेजें चुनें.

इन-ऐप अधिसूचना तत्काल कार्रवाई लागू करें

  1. एक कैनवास ऐप चुनें और फिर कमांड बार पर संपादित करें चुनें (या एक नया बनाएँ)।
  2. बाएं नेविगेशन फलक पर स्क्रीन का चयन करें, या एक नई स्क्रीन बनाएं.
  3. सम्मिलित करें मेनू पर, पाठ तकनीशियन को सूचित करें का उपयोग करके पृष्ठ पर एक बटनजोड़ें।
  4. बटन का चयन करें, और fx सूत्र पट्टी में निम्नलिखित दर्ज करें, जहां DataCardValue17 वह स्तंभ है जिसमें ऑर्डर आईडी शामिल है, और DataCardValue15 वह स्तंभ है जिसमें तकनीशियन का ईमेल पता शामिल है। इस उदाहरण में, सेवा आदेश ऐप नामक कैनवास ऐप का उपयोग किया गया है. 
     Environment.cr8b8_Notifytechnician1({
       OrderID: DataCardValue17.Text,
    TechnicianEmail: DataCardValue15.Text 
 });

   	Notify("The technician was notified!", NotificationType.Success, 2000);
    तकनीशियन को सूचना भेजने के लिए Power Fx सूत्र वाला बटन जोड़ें
  5. अपने परिवर्तन सहेजें और प्रकाशित करें .

जब ऐप में तकनीशियन को सूचित करें कार्रवाई का चयन किया जाता है, तो सेवा आदेश को सौंपे गए तकनीशियन को इन-ऐप अधिसूचना भेजी जाती है। अधिसूचना पर कार्रवाई करने से साइड पैन में सेवा आदेश विवरण खुल जाता है।

तकनीशियन को सूचना भेजी गई जो ऐप में प्राप्त करता है

MSN मौसम कनेक्टर के साथ नमूना तत्काल प्लग-इन

यह प्लगइन MSN मौसम कनेक्टर का उपयोग करके किसी विशिष्ट स्थान के लिए वर्तमान मौसम की जानकारी लौटाता है।

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

  1. यदि वातावरण में अभी तक MSN मौसम उपलब्ध नहीं है तो इसके लिए कनेक्शन संदर्भ बनाएं: दाईं ओर स्थित कनेक्शन संदर्भ फलक से ऐप में कनेक्शन संदर्भ बनाएँ

  2. स्निपेट कॉपी करें: कनेक्शन पैन से एक्शन स्निपेट कॉपी करें

  3. इंटेलीसेंस का उपयोग करके सूत्र का संपादन समाप्त करें और आवश्यकतानुसार कनेक्टर प्रतिक्रिया गुणों का उपभोग करें: संपादक में प्लग-इन परिभाषा को पूरा करें

  4. सहेजें

  5. प्लग-इन का परीक्षण करें

टिप

यदि आप प्रतिक्रिया के विभिन्न गुणों तक पहुँचना चाहते हैं, तो एक क्रिया से संपूर्ण प्रतिक्रिया को कैप्चर करने के लिए With() फ़ंक्शन का उपयोग करें। नीचे दिए गए उदाहरण में, एक इनपुट पैरामीटर Location (स्ट्रिंग) और एक आउटपुट पैरामीटर Out (स्ट्रिंग) है।

With({ /* Capture current weather response from connector */
c: new_MsnWeather.CurrentWeather( Location, "Imperial" ).responses.weather.current
},{	/* Return concatenated weather details */
Out: "Current temp: " & c.temp & " degrees. Feels like " & c.feels & " degrees. Wind speed is " & c.windSpd & " mph."
})

सर्वश्रेष्ठ व्यवहार

स्वचालित लो-कोड प्लगइन्स में अनंत लूप त्रुटियों को संभालना

'अपडेट' इवेंट पर स्वचालित प्लगइन पर पैच स्टेटमेंट न लिखें, जहां पैच प्लगइन के समान तालिका पर हो रहा हो। इससे अनंत लूप और प्लगइन निष्पादन विफलताएं उत्पन्न होती हैं।

समस्याग्रस्त पैटर्न: Patch() सूत्र का उपयोग करने से दूसरा अपडेट ट्रिगर हो जाता है।

अनुशंसित पैटर्न: इस समस्या से बचने के लिए Set() सूत्र का उपयोग करें।

भी देखें

लो-कोड प्लग-इन Power Fx (पूर्वावलोकन)

  • पिछली बार को अपडेट किया गया