Share via

XSendAppNotification және қатысты әрекет функциялары (алдын ала қарау)

  • Мақала

Қолданылады: Canvas қолданбалары Үлгіге негізделген қолданбалар

[Бұл мақала — шығарылым алдындағы құжаттама және ол өзгеруі мүмкін.]

Алушыға қосымша әрекеттері бар қолданбадағы хабарландыру жіберіңіз.

Маңызды

  • Бұл алдын ала қарау мүмкіндігі болып табылады.
  • Алдын ала қарау мүмкіндіктері өндірісте пайдалануға арналмаған, мүмкіндіктері шектеулі болуы мүмкін және шығарылым алдында айтарлықтай өзгеруі мүмкін. Бұл мүмкіндіктер ресми жарияланудан бұрын қолжетімді, сондықтан тұтынушылар ерте қатынаса алады және кері байланыс бере алады.
  • Оларды алдын ала қарау мүмкіндіктері ретінде анықтауға көмектесу үшін әрбір функцияға X префиксі қойылады. Шығарылғаннан кейін, X осы функцияларды пайдаланатын формулалардан және кез келген функция өзгерістері үшін жаңартылған аргументтерден жойылуы керек.
  • Бұл функцияларды Dataverse төмен кодты плагиндермен ғана пайдалануға болады.

Сипаттама

XSendAppNotification функциясы қолданба ішіндегі хабарландыруларды алушыға жіберу үшін пайдаланылады. Бұл хабарландырулар тост ретінде немесе қолданба пайдаланушысы үшін хабарландыру орталығында көрсетіледі. Қосымша ақпарат алу үшін Үлгіге негізделген қолданбаларда қолданба ішіндегі хабарландыруларды жіберу бөлімін қараңыз.

Бұған қоса, қолданбадағы хабарландыру хабарландыру картасындағы нөлден көп әрекеттерді қамтуы мүмкін. Қолданба хабарландыру картасына әрекеттерді қосу үшін келесі функциялар XSendAppNotification функциясында параметрлер ретінде пайдаланылады. Әрбір әрекет түрі туралы қосымша ақпаратты Хабарландыру әрекеттері бөлімінен қараңыз.

  • XCreateUrlAction: URL әрекетін хабарландыру картасына қосады.
  • XCreateSidePaneActionForDashboard: бүйірлік тақтадағы dashboard түрі бар бетке шарлайтын бүйірлік тақта әрекетін қосады.
  • XCreateSidePaneActionForEntity: бүйірлік тақтадағы entityrecord түрі бар бетке шарлайтын бүйірлік тақта әрекетін қосады.
  • XCreateSidePaneActionForEntityList: бүйірлік тақтадағы entitylist түрі бар бетке шарлайтын бүйірлік тақта әрекетін қосады.
  • XCreateTeamsChatAction: Хабарландыру картасына Топтар чат әрекетін қосады.

Синтаксис

XSendAppNotification

XSendAppNotification (Тақырып, Алушы, Дене, Әрекеттер, Белгіше түрі, Тост түрі, Мерзімі, Басымдылық)

Параметр Түр Талап етіледі Сипаттама
Атау String Иә Қолданба хабарландыруының тақырыбы.
Қабылдаушы Entity Иә Хабарландыруды алушы systemuser ұйымы.
Негізгі мәтін String No Хабарлама органы.
Әрекеттер Function No Хабарландыруға әрекеттерді қосу үшін әрекет функцияларының жиымы.
Белгіше түрі Int No Белгіше түріне арналған таңдау тізімінің мәні (ақпарат, сәттілік, сәтсіздік, ескерту, ескерту, теңшелетін).
Қалқымалы хабар түрі Int No Тост түріне арналған таңдау тізімінің мәні (уақыты бойынша және жасырын).
Жарамдылық мерзімі Int No Хабарландыру әлі қабылданбаған болса, жойылуы тиіс секунд саны.
Басымдылық Int No Хабарландыру басымдылығы үшін таңдау тізімінің мәні (қалыпты немесе жоғары).

XCreateUrlAction

XCreateUrlAction (Тақырып, URL, Шарлау мақсаты )

Параметр Түр Талап етіледі Сипаттама
Атау String Иә Әрекет үшін көрсетілетін тақырып.
URL мекенжайы String Иә Әрекет таңдалған кезде ашылатын URL мекенжайы.
Навигациялық мақсат String No Шарлау сілтемесі қай жерде ашылатынын анықтайды. Опциялар:
  • dialog: Орталық диалогтық терезеде ашылады.
  • inline: Әдепкі. Ағымдағы бетте ашылады.
  • newWindow: Жаңа шолғыш қойындысында ашылады.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Тақырып, Пане идентификаторы, Бөлме Тақырып, Бақылау тақтасының идентификаторы)

Параметр Түр Талап етіледі Сипаттама
Атау String Иә Әрекет үшін көрсетілетін тақырып.
Панель идентификаторы String Иә Жаңа бүйірлік тақтаның идентификаторы.
Панель тақырыбы String Иә Бүйірлік тақта үшін көрсетілетін тақырып.
Бақылау тақтасы идентификаторы GUID Иә Бүйірлік тақтада ашылатын бақылау тақтасының идентификаторы.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Тақырып, Бөлме идентификаторы, Бөлме Тақырып, Нысан атауы, Нысан идентификаторы)

Параметр Түр Талап етіледі Сипаттама
Атау String Иә Әрекет үшін көрсетілетін тақырып.
Панель идентификаторы String Иә Жаңа бүйірлік тақтаның идентификаторы.
Панель тақырыбы String Иә Бүйірлік тақта үшін көрсетілетін тақырып.
Нысанның атауы String Иә Нысанның логикалық атауы.
Нысан идентификаторы String Иә Бүйірлік тақтада ашылатын нысан жазбасының идентификаторы.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Тақырып, Пане идентификаторы, Бөлме Атауы, Нысан атауы)

Параметр Түр Талап етіледі Сипаттама
Атау String Иә Әрекет үшін көрсетілетін тақырып.
Панель идентификаторы String Иә Жаңа бүйірлік тақтаның идентификаторы.
Панель тақырыбы String Иә Бүйірлік тақта үшін көрсетілетін тақырып.
Нысанның атауы String Иә Бүйірлік тақтада тізім ретінде ашылатын нысанның логикалық атауы.

XCreateTeamsChatAction

XCreateTeamsChatAction (Тақырып, Чат идентификаторы, Мүше Идентификаторлар, Жазба идентификаторы, Нысан атауы, Бастапқы хабар)

Параметр Түр Талап етіледі Сипаттама
Атау String Иә Әрекет үшін көрсетілетін тақырып.
Чат идентификаторы String No Бар чатты ашсаңыз, ашылатын чат сеансының идентификаторы.
Мүше идентификаторлары GUID No Жаңа чат жасасаңыз, чатқа қосылатын қатысушылардың Microsoft Entra нысан идентификаторы мәндерінің жиымы.
Жазба идентификаторы GUID No Dynamics 365 жазбасына байланыстырылатын болса, чат байланыстырылатын жазбаның идентификаторы.
Нысанның атауы 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 бүйірлік тақта әрекеті, жаңа тапсырма жазбасын бүйірлік тақтада ашады.
  • 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
		)
	]
)