Dijeli putem

XSendAppNotification i povezane akcijske funkcije (pretpregled)

  • Članak

Primjenjuje se na sljedeće: Aplikacije radnog područja Aplikacije stvorene prema modelu

[Ovaj je članak dokumentacija predizdanja i podložan je promjenama.]

Pošaljite obavijest u aplikaciji s neobaveznim radnjama primatelju.

Važno

  • To je značajka pretpregleda.
  • Značajke pretpregleda nisu namijenjene za proizvodnu upotrebu, mogu imati ograničenu funkcionalnost i mogu se značajno promijeniti prije izdavanja. Te su značajke dostupne prije službenog izdavanja da bi se klijentima omogućio prijevremeni pristup i slanje povratnih informacija.
  • Da biste ih lakše identificirali kao značajke pretpregleda, svakoj funkciji ima prefiks X . Nakon izdavanja, X će se morati ukloniti iz svih formula koje koriste te funkcije i argumente ažurirati za sve promjene funkcije.
  • Ove se funkcije mogu koristiti samo s Dataverse dodacima low-code.

Opis

Funkcija XSendAppNotification koristi se za slanje obavijesti unutar aplikacije primatelju. Te se obavijesti prikazuju kao zdravica ili unutar centra za obavijesti za korisnika aplikacije. Dodatne informacije potražite u članku Slanje obavijesti unutar aplikacija utemeljenih na modelu.

Osim toga, obavijest u aplikaciji može sadržavati nula do više radnji na kartica obavijesti. Za dodavanje radnji na kartica obavijesti aplikacije, sljedeće funkcije koriste se kao parametri u funkciji XSendAppNotification . Dodatne informacije o svakoj vrsti akcije potražite u odjeljku Akcije obavijesti.

  • XCreateUrlAction: Dodaje radnju URL-a na kartica obavijesti.
  • XCreateSidePaneActionForDashboard: Dodaje radnju bočnog okna koja prelazi na stranicu s vrstom unutar dashboard bočnog okna.
  • XCreateSidePaneActionForEntity: Dodaje radnju bočnog okna koja prelazi na stranicu s vrstom unutar entityrecord bočnog okna.
  • XCreateSidePaneActionForEntityList: Dodaje radnju bočnog okna koja se kreće na stranicu s vrstom unutar entitylist bočnog okna.
  • XCreateTeamsChatAction: Dodaje radnju čavrljanja u aplikaciji Teams na kartica obavijesti.

Sintaksa

XSendAppNotification

XSendAppNotification (naslov, primatelj , tijelo, radnje, vrsta ikone, vrsta tosta, istek, prioritet)

Parametar Tip Obvezno Opis
Naziv String Jest Naslov obavijesti aplikacije.
Primatelj Entity Jest Subjekt systemuser koji je primatelj obavijesti.
Tijelo String No Tijelo za obavješćivanje.
Radnje Function No Niz akcijskih funkcija za dodavanje radnji obavijesti.
Vrsta ikone Int No Vrijednost popisa za odabir za vrstu ikone (informacije, uspjeh, neuspjeh, upozorenje, spominjanje, prilagođeno).
Vrsta skoka Int No Vrijednost popisa za odabir za vrstu tosta (vremenski u odnosu na skriveno).
Istek Int No Broj sekundi nakon kojeg obavijest treba izbrisati ako već nije odbačena.
Prioritet Int No Vrijednost popisa za odabir za prioritet obavijesti (normalan ili visok).

XCreateUrlAction

XCreateUrlAction (naslov,URL,cilj navigacije)

Parametar Tip Obvezno Opis
Naziv String Jest Naslov koji se prikazuje za radnju.
URL String Jest URL koji će se otvoriti kada je akcija odabrana.
Navigacijski cilj String No Definira gdje se otvara navigacijska veza. Opcije su:
  • dialog: Otvara se u središnjem dijaloškom okviru.
  • inline:Propust. Otvara se na trenutnoj stranici.
  • newWindow: Otvara se na novoj kartici preglednika.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Naslov,ID okna; Naslov okna; ID nadzorne ploče)

Parametar Tip Obvezno Opis
Naziv String Jest Naslov koji se prikazuje za radnju.
ID okna String Jest ID novog bočnog okna.
Naslov okna String Jest Naslov koji će se prikazati za bočno okno.
ID nadzorne ploče GUID Jest ID nadzorne ploče za otvaranje u bočnom oknu.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Naslov,ID okna;Naslov okna; Naziv entiteta; ID entiteta)

Parametar Tip Obvezno Opis
Naziv String Jest Naslov koji se prikazuje za radnju.
ID okna String Jest ID novog bočnog okna.
Naslov okna String Jest Naslov koji će se prikazati za bočno okno.
Naziv entiteta String Jest Logički naziv tog entiteta.
ID entiteta String Jest ID zapisa entiteta koji se otvara u bočnom oknu.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Title,ID okna;Naslov okna; Naziv entiteta)

Parametar Tip Obvezno Opis
Naziv String Jest Naslov koji se prikazuje za radnju.
ID okna String Jest ID novog bočnog okna.
Naslov okna String Jest Naslov koji će se prikazati za bočno okno.
Naziv entiteta String Jest Logički naziv entiteta koji će se otvoriti kao popis u bočnom oknu.

XCreateTeamsChatAction

XCreateTeamsChatAction (naslov, ID chata, ID-ovi članova , ID zapisa, naziv entiteta, početna poruka)

Parametar Tip Obvezno Opis
Naziv String Jest Naslov koji se prikazuje za radnju.
ID chata String No Ako otvarate postojeće čavrljanje, ID sesije čavrljanja koju treba otvoriti.
ID-ovi člana GUID No Ako stvarate novi chat, niz Microsoft Entra vrijednosti ID-a objekta sudionika koji će biti uključeni u chat.
ID zapisa GUID No Ako se povezujete sa zapisom sustava Dynamics 365, ID zapisa s kojim treba povezati čavrljanje.
Naziv entiteta String No Ako se povezujete sa zapisom sustava Dynamics 365, logički naziv entiteta zapisa s kojim treba povezati čavrljanje.
Inicijalna poruka String No Uvodna poruka novog chata.

Primjeri

Obavijest u aplikaciji s naslovom, primateljem i tijelom

Sljedeće šalje jednostavnu obavijest u aplikaciji primatelju s naslovom i tijelom. Ne uključuje nikakve radnje i koristi zadane vrijednosti za sve ostale parametre.

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

Obavijest u aplikaciji s dvije radnje

Sljedeći primjer formule može se koristiti s automatiziranim dodatkom kada se stvori novi zapis zadatka. Formula je osmišljena za slanje obavijesti u aplikaciji vlasniku zapisa zadatka. Kartica obavijesti sadrži dvije radnje koje vlasnik može poduzeti:

  • Akcija bočnog okna otvara novi zapis zadatka u bočnom oknu.
  • Akcija čavrljanja u aplikaciji Teams pokreće čavrljanje u aplikaciji Teams s vlasnikom zapisa računa koji je dodijeljen kao zapis tablice u vezi s novim zadatkom. Važno je napomenuti da ovo pretpostavlja da je zapis računa odabran u polju zadatka.
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
		)
	]
)