Share via

XSendAppNotification in povezane funkcije dejanj (predogled)

  • Članek

Velja za: Aplikacije Canvas Aplikacije, ki temeljijo na modelu

[Ta članek je del predizdajne dokumentacije in se lahko spremeni.]

Pošljite obvestilo v aplikaciji z izbirnimi dejanji prejemniku.

Pomembno

  • To je funkcija predogleda.
  • Funkcije predogleda niso namenjene produkcijski uporabi, morda imajo omejeno funkcionalnost in se lahko bistveno spremenijo pred izdajo. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.
  • Za lažjo identifikacijo teh funkcij predogleda ima vsaka funkcija predpono X. Po izdaji bo treba X odstraniti iz vseh formul, ki uporabljajo te funkcije, in argumente posodobiti za morebitne spremembe funkcij.
  • Te funkcije je mogoče uporabljati samo z vtičniki Dataverse nizke kode.

Description

Funkcija XSendAppNotification se uporablja za pošiljanje obvestil prejemniku znotraj aplikacije. Ta obvestila se uporabniku aplikacije prikažejo kot zdravica ali znotraj centra za obvestila. Za več informacij glejte Pošiljanje obvestil v aplikaciji znotraj aplikacij, ki temeljijo na modelu.

Poleg tega lahko obvestilo v aplikaciji vključuje od nič do veliko dejanj na kartici z obvestili. Za dodajanje dejanj na obvestilno kartico aplikacije se naslednje funkcije uporabljajo kot parametri v funkciji XSendAppNotification . Za več informacij o vsaki vrsti dejanj glejte Dejanja obveščanja.

  • XCreateUrlAction: na obvestilno kartico doda dejanje URL-ja.
  • XCreateSidePaneActionForDashboard: doda dejanje stranskega podokna, ki se pomakne na stran z vrsto dashboard znotraj stranskega podokna.
  • XCreateSidePaneActionForEntity: doda dejanje stranskega podokna, ki se pomakne na stran z vrsto entityrecord znotraj stranskega podokna.
  • XCreateSidePaneActionForEntityList: doda dejanje stranskega podokna, ki se pomakne na stran z vrsto entitylist znotraj stranskega podokna.
  • XCreateTeamsChatAction: na obvestilno kartico doda dejanje klepeta Teams.

Sintaksa

XSendAppNotification

XSendAppNotification (Naslov, Prejemnik, Telo, Dejanja, Vrsta ikone, Vrsta zdravice, Iztek, Prednost)

Parameter Vnesi Zahtevano Description
Naziv String Da Naslov obvestila aplikacije.
Prejemnik Entity Da Subjekt systemuser ki je prejemnik obvestila.
Telo String No Priglasitveni organ.
Dejanja Function No Niz funkcij dejanj za dodajanje dejanj k obvestilu.
Vrsta ikone Int No Vrednost izbirnega seznama za vrsto ikone (informacije, uspeh, neuspeh, opozorilo, omemba, po meri).
Vrsta pojavnega obvestila Int No Vrednost izbirnega seznama za vrsto zdravice (časovno ali skrito).
Potek Int No Število sekund od takrat, ko naj se obvestilo izbriše, če še ni opuščeno.
Prednost Int No Vrednost izbirnega seznama za prioriteto obvestila (normalna ali visoka).

XCreateUrlAction

XCreateUrlAction (Naslov, URL, Navigacijski cilj )

Parameter Vnesi Zahtevano Description
Naziv String Da Naslov, ki se prikaže za dejanje.
URL String Da URL, ki se odpre, ko je izbrano dejanje.
Navigacijski cilj String No Določa, kje se odpre navigacijska povezava. Možnosti so:
  • dialog: Odpre se v osrednjem pogovornem oknu.
  • inline: privzeto. Odpre se na trenutni strani.
  • newWindow: Odpre se v novem zavihku brskalnika.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Naslov, ID podokna, Podokno Naslov, ID nadzorne plošče)

Parameter Vnesi Zahtevano Description
Naziv String Da Naslov, ki se prikaže za dejanje.
ID podokna String Da ID novega stranskega podokna.
Naslov podokna String Da Naslov za prikaz stranskega podokna.
ID nadzorne plošče GUID Da ID nadzorne plošče, ki se odpre v stranskem podoknu.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Naslov, ID podokna, Podokno Naslov, Ime subjekta, ID subjekta)

Parameter Vnesi Zahtevano Description
Naziv String Da Naslov, ki se prikaže za dejanje.
ID podokna String Da ID novega stranskega podokna.
Naslov podokna String Da Naslov za prikaz stranskega podokna.
Ime entitete String Da Logično ime entitete.
ID entitete String Da ID zapisa entitete, ki se odpre v stranskem podoknu.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Naslov, ID podokna, Podokno Naslov, Ime entitete)

Parameter Vnesi Zahtevano Description
Naziv String Da Naslov, ki se prikaže za dejanje.
ID podokna String Da ID novega stranskega podokna.
Naslov podokna String Da Naslov za prikaz stranskega podokna.
Ime entitete String Da Logično ime entitete, ki se odpre kot seznam v stranskem podoknu.

XCreateTeamsChatAction

XCreateTeamsChatAction (Naziv, ID klepeta, Član ID-ji, ID zapisa, Ime subjekta, Začetno sporočilo)

Parameter Vnesi Zahtevano Description
Naziv String Da Naslov, ki se prikaže za dejanje.
ID klepeta String No Če odprete obstoječi klepet, ID klepeta, ki ga želite odpreti.
ID-ji članov GUID No Če ustvarite nov klepet, niz vrednosti Microsoft Entra Object ID udeležencev, ki bodo vključeni v klepet.
ID zapisa GUID No Pri povezovanju z zapisom Dynamics 365 ID zapisa, s katerim naj bo klepet povezan.
Ime entitete String No Pri povezovanju z zapisom Dynamics 365 logično ime entitete zapisa, s katerim naj bo klepet povezan.
Začetno sporočilo String No Uvodno sporočilo novega klepeta.

Primeri

Obvestilo v aplikaciji z naslovom, prejemnikom in telesom

Naslednje pošlje preprosto obvestilo v aplikaciji prejemniku z naslovom in telesom. Ne vključuje nobenih dejanj in uporablja privzete vrednosti za vse druge parametre.

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

Obvestilo v aplikaciji z dvema dejanjema

Naslednji primer formule je mogoče uporabiti s samodejnim vtičnikom, ko je ustvarjen nov zapis opravila. Formula je zasnovana za pošiljanje obvestila v aplikaciji lastniku zapisa opravila. Kartica z obvestili vsebuje dve dejanji, ki ju lahko izvede lastnik:

  • Dejanje stranskega podokna odpre nov zapis opravila v stranskem podoknu.
  • A Dejanje klepeta Teams , sproži klepet Teams z lastnikom zapisa računa, ki je dodeljen kot Glede zapis tabele za novo nalogo. Pomembno je vedeti, da to predpostavlja, da je bil v polju opravil izbran zapis računa.
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
		)
	]
)