XSendAppNotification और संबंधित क्रिया फ़ंक्शन (पूर्वावलोकन)

इस पर लागू होता है: कैनवास ऐप्स मॉडल-चालित ऐप्स

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

किसी प्राप्तकर्ता को वैकल्पिक कार्रवाइयों के साथ इन-ऐप सूचना भेजें.

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

• यह एक पूर्वावलोकन सुविधा है.
• पूर्वावलोकन विशेषताएं उत्पादन उपयोग के लिए नहीं हैं, उनकी कार्यक्षमता सीमित हो सकती है, तथा रिलीज से पहले उनमें महत्वपूर्ण परिवर्तन हो सकता है। यह सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध होती हैं ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.
• इन्हें पूर्वावलोकन विशेषताओं के रूप में पहचानने में मदद करने के लिए, प्रत्येक फ़ंक्शन के आगे X लगा होता है। रिलीज़ होने पर, X को उन सभी फ़ॉर्मूले से हटाना होगा जो इन फ़ंक्शन का उपयोग करते हैं और फ़ंक्शन में किसी भी बदलाव के लिए तर्क अपडेट किए जाते हैं।
• इन फ़ंक्शनों का उपयोग केवल Dataverse लो-कोड प्लग-इन के साथ किया जा सकता है।

विवरण

XSendAppNotification फ़ंक्शन का उपयोग किसी ऐप के भीतर प्राप्तकर्ता को सूचनाएं भेजने के लिए किया जाता है। ये सूचनाएं ऐप उपयोगकर्ता के लिए टोस्ट के रूप में या सूचना केंद्र में दिखाई देती हैं। अधिक जानकारी के लिए, देखें मॉडल-चालित ऐप्स के भीतर इन-ऐप सूचनाएँ भेजें.

इसके अतिरिक्त, इन-ऐप अधिसूचना में अधिसूचना कार्ड पर शून्य से लेकर कई क्रियाएं शामिल हो सकती हैं। ऐप अधिसूचना कार्ड में क्रियाएँ जोड़ने के लिए, XSendAppNotification फ़ंक्शन में पैरामीटर के रूप में निम्नलिखित फ़ंक्शन का उपयोग किया जाता है. प्रत्येक क्रिया प्रकार पर अधिक जानकारी के लिए, अधिसूचना क्रियाएँ देखें.

• XCreateUrlAction: अधिसूचना कार्ड में एक URL क्रिया जोड़ता है.
• XCreateSidePaneActionForDashboard: एक साइड पेन क्रिया जोड़ता है जो साइड पेन के भीतर dashboard प्रकार वाले पृष्ठ पर नेविगेट करता है।
• XCreateSidePaneActionForEntity: एक साइड पेन क्रिया जोड़ता है जो साइड पेन के भीतर entityrecord प्रकार वाले पृष्ठ पर नेविगेट करता है।
• XCreateSidePaneActionForEntityList: एक साइड पेन क्रिया जोड़ता है जो साइड पेन के भीतर entitylist प्रकार वाले पृष्ठ पर नेविगेट करता है।
• XCreateTeamsChatAction: अधिसूचना कार्ड में एक टीम्स चैट क्रिया जोड़ता है.

सिंटैक्स

XSendAppअधिसूचना

XSendAppNotification (शीर्षक, प्राप्तकर्ता, मुख्य भाग, क्रियाएँ, चिह्न प्रकार, टोस्ट प्रकार, समाप्ति, प्राथमिकता)

मापदंड	Type	आवश्य	विवरण
पद	String	हां	ऐप अधिसूचना का शीर्षक.
प्राप्तकर्ता	इकाई	हां	वह इकाई जो अधिसूचना का प्राप्तकर्ता है। systemuser
मुख्यभाग	String	No	अधिसूचना निकाय.
कार्रवाई	फ़ंक्शन	No	अधिसूचना में क्रियाएं जोड़ने के लिए क्रिया कार्यों की एक सरणी।
आइकन के प्रकार	Int	No	आइकन के प्रकार के लिए पिकलिस्ट मान (सूचना, सफलता, विफलता, चेतावनी, उल्लेख, कस्टम).
टोस्ट का प्रकार	Int	No	टोस्ट के प्रकार के लिए पिकलिस्ट मान (समयबद्ध बनाम छिपा हुआ)।
समाप्ति	Int	No	सेकंड की संख्या जब सूचना को हटा दिया जाना चाहिए, यदि पहले से खारिज नहीं की गई है.
प्राथमिकता	Int	No	अधिसूचना की प्राथमिकता के लिए चयन सूची मान (सामान्य या उच्च).

XCreateUrlAction

XCreateUrlAction (शीर्षक, URL, नेविगेशन लक्ष्य)

मापदंड	प्रकार	आवश्य	विवरण
पद	String	हां	कार्रवाई के लिए प्रदर्शित शीर्षक.
URL	String	हां	कार्रवाई का चयन करने पर खोला जाने वाला URL.
नेविगेशन लक्ष्य	String	No	नेविगेशन लिंक कहां खुलेगा यह परिभाषित करता है. विकल्प हैं: dialog: मध्य संवाद में खुलता है. inline: गलती करना। वर्तमान पृष्ठ में खुलता है. newWindow: एक नए ब्राउज़र टैब में खुलता है.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (शीर्षक, फलक आईडी, फलक शीर्षक, डैशबोर्ड आईडी)

मापदंड	Type	आवश्य	विवरण
पद	String	हां	कार्रवाई के लिए प्रदर्शित शीर्षक.
फलक आईडी	String	हां	नये साइड पैन की आईडी.
फलक शीर्षक	String	हां	पार्श्व फलक के लिए प्रदर्शित किया जाने वाला शीर्षक.
डैशबोर्ड ID	मार्गदर्शक	हां	साइड पैन में खुलने वाले डैशबोर्ड की आईडी.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (शीर्षक, फलक आईडी, फलक शीर्षक, इकाई नाम, इकाई आईडी)

मापदंड	Type	आवश्य	विवरण
पद	String	हां	कार्रवाई के लिए प्रदर्शित शीर्षक.
फलक आईडी	String	हां	नये साइड पैन की आईडी.
फलक शीर्षक	String	हां	पार्श्व फलक के लिए प्रदर्शित किया जाने वाला शीर्षक.
एंटिटी का नाम	String	हां	निकाय का तार्किक नाम.
निकाय पहचान	String	हां	साइड पैन में खोले जाने वाले निकाय रिकॉर्ड की आईडी.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (शीर्षक, फलक आईडी, फलक शीर्षक, इकाई नाम)

मापदंड	Type	आवश्य	विवरण
पद	String	हां	कार्रवाई के लिए प्रदर्शित शीर्षक.
फलक आईडी	String	हां	नये साइड पैन की आईडी.
फलक शीर्षक	String	हां	पार्श्व फलक के लिए प्रदर्शित किया जाने वाला शीर्षक.
एंटिटी का नाम	String	हां	पार्श्व फलक में सूची के रूप में खुलने वाली इकाई का तार्किक नाम.

XCreateTeamsचैटएक्शन

XCreateTeamsChatAction (शीर्षक, चैट आईडी, सदस्य आईडी, रिकॉर्ड आईडी, इकाई नाम, आरंभिक संदेश)

मापदंड	Type	आवश्य	विवरण
पद	String	हां	कार्रवाई के लिए प्रदर्शित शीर्षक.
चैट आईडी	String	No	यदि कोई मौजूदा चैट खोल रहे हैं, तो खोले जाने वाले चैट सत्र की आईडी।
सदस्य आईडी	मार्गदर्शक	No	यदि कोई नई चैट बनाई जा रही है, तो चैट में शामिल किए जाने वाले प्रतिभागियों के Microsoft Entra ऑब्जेक्ट आईडी मानों की एक सरणी।
रिकॉर्ड ID	मार्गदर्शक	No	यदि Dynamics 365 रिकॉर्ड से लिंक किया जा रहा है, तो उस रिकॉर्ड की ID जिससे चैट को लिंक किया जाना चाहिए.
एंटिटी का नाम	String	No	यदि Dynamics 365 रिकॉर्ड से लिंक किया जा रहा है, तो रिकॉर्ड के निकाय का तार्किक नाम जिससे चैट को लिंक किया जाना चाहिए.
प्रारंभिक संदेश	String	No	नये चैट का परिचयात्मक संदेश.

उदाहरण

शीर्षक, प्राप्तकर्ता और मुख्य भाग के साथ इन-ऐप अधिसूचना

निम्नलिखित एक प्राप्तकर्ता को शीर्षक और मुख्य भाग के साथ एक सरल इन-ऐप अधिसूचना भेजता है। इसमें कोई भी क्रिया शामिल नहीं है तथा अन्य सभी पैरामीटरों के लिए डिफ़ॉल्ट मानों का उपयोग किया जाता है।

XSendAppNotification(
    "Welcome", 
    LookUp(Users, 'Primary Email'="<User's email address>"), 
    "Welcome to the world of in-app notifications!"
)

दो क्रियाओं के साथ इन-ऐप अधिसूचना

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

• A साइड पेन एक्शन, साइड पेन में नया कार्य रिकॉर्ड खोलता है।
• एक टीम चैट कार्रवाई, उस खाता रिकॉर्ड के स्वामी के साथ टीम चैट आरंभ करती है जिसे नए कार्य के लिए संबंध तालिका रिकॉर्ड के रूप में असाइन किया गया है। यह ध्यान रखना महत्वपूर्ण है कि यह मान लिया गया है कि कार्य क्षेत्र में एक खाता रिकॉर्ड का चयन किया गया है।

XSendAppNotification(
	"New task assigned",
	AsType(ThisRecord.Owner, Users),
	"A new task has been assigned to you to follow up with your customer",
	[XCreateSidePaneActionForEntity(
		"View task",
		1123,
		"Your task",
		"task",
		ThisRecord.Task    
		),
	XCreateTeamsChatAction(
		"Chat with account manager",
		[AsType(AsType(ThisRecord.Regarding, Accounts).Owner, Users).'Microsoft Entra Object ID'],
		AsType(ThisRecord.Regarding, Accounts).Account, 
		"account", 
		ThisRecord.Description
		)
	]
)