Делите путем

XСендАппНотифицатион и сродне функције радње (< ДИЦТ__верзија за преглед > превиеw )

  • Чланак

Важи за: Цанвас апликације Модел-дривен апликације

[Овај чланак представља прелиминарну документацију и може се променити.]

Пошаљите обавештење у апликацији са опционалним радњама примаоцу.

Важно

  • Ово је функција прегледа.
  • < ДИЦТ__верзија за преглед >превиеw < /ДИЦТ __верзија за преглед > функције нису намењене за употребу у производњи, можда имају ограничену функционалност и могу се значајно променити пре издавања. Ове функције су доступне пре званичног објављивања како би клијенти могли раније да им приступе и пруже повратне информације.
  • Да би се идентификовале < ДИЦТ__верзија за преглед > превиеw функције, свака функција је префиксирана са X . Након издавања, X ће морати да буде уклоњен из свих формула које користе ове функције и аргументе ажуриране за све промене функција.
  • Ове функције се могу користити само са Dataverse < ДИЦТ__ниско кодирање > лоw-цоде додатним компонентама.

Опис

Функција XСендАппНотифицатион се користи за слање обавештења у оквиру апликације примаоцу. Ова обавештења се појављују као здравица или у оквиру центра за обавештења за корисника апликације. Више информација потражите у чланку Слање обавештења у апликацији у оквиру апликација са погоном на моделе.

Поред тога, обавештење у апликацији може да садржи нулу за многе радње на обавештењу картица. Да би се додале радње у картица обавештења, следеће функције се користе као параметри у функцији XСендАппНотифицатион . Више информација о сваком типу радње потражите у чланку Радње обавештења.

  • XЦреатеУрлАцтион : Додаје УРЛ радњу обавештењу картица.
  • XЦреатеСидеПанеАцтионФорДасхбоард : Додаје радњу бочног окна која се креће до странице са типом dashboard унутар бочног окна.
  • XЦреатеСидеПанеАцтионФорЕнтитy : Додаје радњу бочног окна која се креће до странице са типом entityrecord унутар бочног окна.
  • XЦреатеСидеПанеАцтионФорЕнтитyЛист : Додаје радњу бочног окна која се креће до странице са типом entitylist унутар бочног окна.
  • XЦреатеТеамсЦхатАцтион : Додаје Теамс цхат радњу обавештењу картица.

Синтакса

XСендАппНотифицатион

XСендАппНотифицатион (наслов,Прималац,Тело,Радње,Тип иконе,Тип тоста,Истек рока важења,Приоритет)

Параметар Тип Потребно Опис
Title String Да Наслов обавештења о апликацији.
Прималац Entity Да Ентитет примаоца systemuser обавештења.
Тело String No Тело за обавештавање.
Акције Function No Низ функција радње за додавање радњи у обавештење.
Тип иконе Int No Вредност листе избора за тип иконе (информације, успех, неуспех, упозорење, помињање, прилагођено).
Тип искачућег обавештења Int No Вредност листе избора за врсту тоста (време наспрам скривеног).
Рок важења Int No Број секунди од када би обавештење требало да буде избрисано ако већ није одбачено.
Приоритет Int No Вредност листе избора за приоритет обавештења (нормална или висока).

XЦреатеУрлАцтион

XЦреатеУрлАцтион (наслов,УРЛ,Циљ навигације)

Параметар Тип Потребно Опис
Title String Да Наслов који приказује радњу.
URL адреса String Да УРЛ адреса коју треба отворити када је радња изабрана.
Циљ навигације String No Дефинише где ће се отворити веза за навигацију. Опције су:
  • dialog: Отвара се у дијалогу центра.
  • inline:Подразумевани. Отвара се на тренутној страници.
  • newWindow: Отвара се на новој картици прегледача.

XЦреатеСидеПанеАцтионФорДасхбаорд

XЦреатеСидеПанеАцтионФорДасхбоард ( Наслов,ИД окна,Наслов окна,ИД контролне табле)

Параметар Тип Потребно Опис
Title String Да Наслов који приказује радњу.
ИД окна String Да ИД новог бочног окна.
Наслов окна String Да Наслов који треба приказати за бочно окно.
ID контролне табле GUID Да ИД контролне табле за отварање у бочном окну.

XЦреатеСидеПанеАцтионФорентитy

XЦреатеСидеПанеАцтионФорентитy ( наслов,ИД окна,Наслов окна,Име ентитета,ИД ентитета)

Параметар Тип Потребно Опис
Title String Да Наслов који приказује радњу.
ИД окна String Да ИД новог бочног окна.
Наслов окна String Да Наслов који треба приказати за бочно окно.
Назив ентитета String Да Логичко име ентитета.
ID ентитета String Да ИД записа ентитета који ће се отворити у бочном окну.

XЦреатеСидеПанеАцтионФорЕнтитyЛист

XЦреатеСидеПанеАцтионФорЕнтитyЛист ( Наслов,ИД окна,Наслов окна,Име ентитета)

Параметар Тип Потребно Опис
Title String Да Наслов који приказује радњу.
ИД окна String Да ИД новог бочног окна.
Наслов окна String Да Наслов који треба приказати за бочно окно.
Назив ентитета String Да Логичко име ентитета које треба отворити као листу у бочном окну.

XЦреатеТеамсЦхатАцтион

XЦреатеТеамсЦхатАцтион ( наслов,ИД ћаскања,ИД-ова чланова,ИД-а записа,Име ентитета,Почетна порука)

Параметар Тип Потребно Опис
Title String Да Наслов који приказује радњу.
ИД ћаскања String No Ако отворите постојећи ћаскање, биће отворен ИД сесије ћаскања.
ID члан-ова GUID No Ако креирате ново ћаскање, низ ИД Microsoft Entra вредности објекта учесника који ће бити укључени у ћаскање.
ID записа GUID No Ако се повезујете са Дyнамицс 365 записом, ИД записа са којим би ћаскање требало да буде повезано.
Назив ентитета String No Ако се повезујете са Дyнамицс 365 записом, требало би повезати логичко име ентитета записа са којим би ћаскање требало да буде повезано.
Почетна порука String No Уводна порука новог ћаскања.

Примери

Обавештење у апликацији са насловом, примаоцем и телом

У следећем извештају се шаље једноставно обавештење у апликацији примаоцу са насловом и телом. Не укључује радње и користи подразумеване вредности за све остале параметре.

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

Обавештење у апликацији са две радње

Следећи пример формуле може да се користи са аутоматизованом додатном компонентом када се креира нови запис задатка. Формула је дизајнирана да пошаље обавештење у апликацији власнику записа задатка. Обавештење садржи картица две радње које власник може да предузме:

  • Радња бочног окна отвара нови запис задатка у бочном окну.
  • Радња ћаскања тимова покреће теамс цхат са власником записа налога који је додељен као запис табеле "Регардинг " за нови задатак. Важно је напоменути да ово претпоставља да је у пољу задатака изабран запис пословног контакта.
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
		)
	]
)