دالات XSendAppNotification والإجراءات المرتبطة بها (إصدار أولي)

ينطبق على: تطبيقات اللوحة التطبيقات المستندة إلى النموذج

[هذا المقال عبارة عن وثائق نسخة مسبقة وهو عرضة للتغيير.]

إرسال إعلام في التطبيق مع إجراءات اختيارية إلى المستلم.

مهم

• هذه ميزة إصدار أولي.
• ميزات المعاينة ليست مخصصة للاستخدام الإنتاجي، وقد يكون لها وظائف مقيدة، وقد تتغير بشكل ملحوظ قبل الإصدار. تتوفر هذه الميزات قبل إصدار رسمي وبذلك يستطيع العملاء الحصول على وصول مبكر وتقديم التعليقات.
• للمساعدة في تحديد هذه كميزات معاينة، تكون كل وظيفة مسبوقة بـ X. عند الإصدار، يجب إزالة X من أي صيغ تستخدم هذه الوظائف والوسيطات المحدثة لأية تغييرات في الوظيفة.
• ولا يمكن استخدام هذه الوظائف إلا مع Dataverse المكونات الإضافية قليلة التعليمات البرمجية.

الوصف

يتم استخدام دالة XSendAppNotification‎ لإرسال إعلامات داخل التطبيق إلى المستلم. تظهر هذه الإخطارات إما كمنبثقة أو داخل مركز الإشعارات لمستخدم التطبيق. لمزيد من المعلومات، راجع ‬‏‫إرسال إعلامات في التطبيق في التطبيقات التي تستند إلى نموذج.

بالإضافة إلى ذلك، يمكن أن يتضمن الإشعار داخل التطبيق صفرًا إلى العديد من الإجراءات على بطاقة الإشعارات. لإضافة إجراءات إلى بطاقة إعلامات التطبيق، يتم استخدام الوظائف التالية كمعلمات في دالة XSendAppNotification . لمزيد من المعلومات حول كل نوع إجراء، راجع إجراءات الإعلام.

• XCreateUrlAction: إضافة إجراء عنوان URL إلى بطاقة الإخطار.
• XCreateSidePaneActionForDashboard: إضافة إجراء الجزء الجانبي الذي ينتقل إلى صفحة نوعها dashboard داخل الجزء الجانبي.
• XCreateSidePaneActionForEntity: إضافة إجراء الجزء الجانبي الذي ينتقل إلى صفحة نوعها entityrecord داخل الجزء الجانبي.
• XCreateSidePaneActionForEntityList: إضافة إجراء الجزء الجانبي الذي ينتقل إلى صفحة نوعها entitylist داخل الجزء الجانبي.
• XCreateTeamsChatAction: إضافة إجراء الدردشة عبر Teams إلى بطاقة الإخطار.

بناء الجملة

XSendAppNotification

XSendAppNotification (العنوان, المستلم, نص الرسالة, الإجراءات, ‏‫نوع الأيقونة, ‏‫نوع الإعلام المنبثق‬, انتهاء الصلاحية‬, الأولوية)

المعلمة	نوع	مطلوبة	الوصف
‏‫المسمى الوظيفي	سلسلة‬‬	نعم	عنوان إعلام التطبيق.
مستلم	الكيان	نعم	كيان systemuser يكون مستلم الإعلام.
النص الأساسي	سلسلة‬‬	لا	النص الأساسي للإعلام.
الإجراءات	الدالة	لا	مجموعة من وظائف العمل لإضافة إجراءات بعد الإعلام.
نوع الأيقونة	Int	لا	قيمة قائمة الاختيار لنوع الرمز (معلومات، نجاح، فشل، تحذير، ذكر ، مخصص).
نوع الإعلام المنبثق	Int	لا	قيمة قائمة الاختيار لنوع الإعلام المنبثق (موقوت مقابل مخفي).
انتهاء الصلاحية	Int	لا	عدد الثواني اعتبارًا من الوقت الذي يجب فيه حذف الإشعار إذا لم يكن قد تم رفضه بالفعل.
الأولوية	Int	لا	قيمة قائمة الاختيار لأولوية الإعلام (عادي أو مرتفع).

XCreateUrlAction

XCreateUrlAction (العنوان, عنوان URL, هدف التنقل)

المعلمة	نوع	مطلوبة	الوصف
‏‫المسمى الوظيفي	سلسلة‬‬	نعم	العنوان الذي يتم عرضه للعمل.
عنوان URL	سلسلة‬‬	نعم	عنوان URL الذي سيتم فتحه عند تحديد الإجراء.
هدف التنقل	سلسلة‬‬	لا	يحدد مكان فتح ارتباط التنقل. الخيارات هي: dialog: يفتح في مربع الحوار الأوسط. inline: افتراضي. يفتح في الصفحة الحالية. newWindow: يفتح في علامة تبويب متصفح جديدة.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (العنوان, معرف اللوحة, عنوان اللوحة, معرف لوحة المعلومات)

المعلمة	نوع	مطلوبة	الوصف
‏‫المسمى الوظيفي	سلسلة‬‬	نعم	العنوان الذي يتم عرضه للعمل.
معرف الجزء	سلسلة‬‬	نعم	معرف الجزء الجانبي الجديد.
عنوان الجزء	سلسلة‬‬	نعم	العنوان المراد عرضه للجزء الجانبي.
معرف لوحة المعلومات	معرف Guid	نعم	معرّف لوحة المعلومات المراد فتحها في الجزء الجانبي.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (العنوان, معرف اللوحة, عنوان اللوحة, اسم الكيان, معرف الكيان)

المعلمة	نوع	مطلوبة	الوصف
‏‫المسمى الوظيفي	سلسلة‬‬	نعم	العنوان الذي يتم عرضه للعمل.
معرف الجزء	سلسلة‬‬	نعم	معرف الجزء الجانبي الجديد.
عنوان الجزء	سلسلة‬‬	نعم	العنوان المراد عرضه للجزء الجانبي.
اسم الكيان	سلسلة‬‬	نعم	الاسم المنطقي للكيان.
معرف الكيان	سلسلة‬‬	نعم	معرّف سجل الكيان المراد فتحه في الجزء الجانبي.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (العنوان, معرف اللوحة, عنوان اللوحة, اسم الكيان)

المعلمة	نوع	مطلوبة	الوصف
‏‫المسمى الوظيفي	سلسلة‬‬	نعم	العنوان الذي يتم عرضه للعمل.
معرف الجزء	سلسلة‬‬	نعم	معرف الجزء الجانبي الجديد.
عنوان الجزء	سلسلة‬‬	نعم	العنوان المراد عرضه للجزء الجانبي.
اسم الكيان	سلسلة‬‬	نعم	الاسم المنطقي للكيان المراد فتحه كقائمة في الجزء الجانبي.

XCreateTeamsChatAction

XCreateTeamsChatAction (العنوان, معرف الدردشة, معرفات الأعضاء, معرف السجل, اسم الكيان, ‏‫الرسالة الأولية)

المعلمة	نوع	مطلوبة	الوصف
‏‫المسمى الوظيفي	سلسلة‬‬	نعم	العنوان الذي يتم عرضه للعمل.
معرف الدردشة	سلسلة‬‬	لا	في حالة فتح محادثة حالية، سيتم فتح معرف جلسة الدردشة.
معرفات الأعضاء	معرف Guid	لا	في حالة إنشاء الدردشة الجديدة، يتم تضمين صفيف قيم معرفات كائنات Microsoft Entra في الدردشة.
معرّف السجل	معرف Guid	لا	في حالة الارتباط بسجل Dynamics 365، معرّف السجل الذي يجب ربط الدردشة به.
اسم الكيان	سلسلة‬‬	لا	في حالة الارتباط بسجل Dynamics 365، الاسم المنطقي لكيان السجل الذي يجب ربط الدردشة به.
الرسالة الأولية	سلسلة‬‬	لا	رسالة تمهيدية للدردشة الجديدة.

الأمثلة

إشعار داخل التطبيق بعنوان ومستلم ونص

يرسل ما يلي إشعارًا بسيطًا داخل التطبيق إلى مستلم بعنوان ونص رئيسي. لا يتضمن أي إجراءات ويستخدم القيم الافتراضية لجميع المعلمات الأخرى.

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

إشعار داخل التطبيق مع إجراءين

يمكن استخدام صيغة المثال التالي مع مكون إضافي تلقائي عند إنشاء سجل مهمة جديد. تم تصميم الصيغة لإرسال إعلام داخل التطبيق إلى مالك سجل المهمة. تحتوي بطاقة الإشعار على إجراءين يمكن للمالك اتخاذهما:

• إجراء جزء جانبي ، يتم فتح سجل المهمة الجديد في جزء جانبي.
• إجراء دردشة Teams، يبدأ دردشة Teams مع مالك سجل الحساب الذي تم تعيينه على أنه سجل جدول بخصوصللمهمة الجديدة. من المهم ملاحظة أن هذا يفترض أنه تم تحديد سجل حساب في حقل المهمة.

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
		)
	]
)