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 | Шарлау сілтемесі қай жерде ашылатынын анықтайды. Опциялар:
|
XCreateSidePaneActionForDashbaord
XCreateSidePaneActionForDashboard (Тақырып, Пане ID, Бөлме Тақырып, Бақылау тақтасының идентификаторы)
| Параметр | Түр | Талап етіледі | Сипаттама |
|---|---|---|---|
| Атау | 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
)
]
)