Del via

XSendAppNotification og relaterede handlingsfunktioner (forhåndsversion)

  • Artikel

Gælder for: Lærredapps Modelbaserede apps

[Denne artikel er dokumentation til den foreløbige udgivelse. Der kan forekomme ændringer.]

Send en meddelelse i appen med valgfrie handlinger til en modtager.

Vigtigt

  • Dette er en forhåndsversion af funktionen.
  • Prøveversionsfunktionerne er ikke beregnet til produktionsformål, kan have begrænset funktionalitet og kan blive ændre markant inden frigivelse. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
  • For at identificere disse som prøveversionsfunktioner får hver enkelt funktion et X som præfiks. Efter udgivelsen skal X fjernes fra alle formler, der bruger disse funktioner og argumenter, som opdateres for eventuelle funktionsændringer.
  • Disse funktioner kan kun bruges sammen med Dataverse-plug-ins med lav kode.

Beskrivelse

Funktionen XSendAppNotification bruges til at sende meddelelser i en app til en modtager. Disse meddelelser vises enten som en toastmeddelelse eller i meddelelsescenter for appbrugeren. Du kan finde flere oplysninger under Sende meddelelser i appen i modelbaserede apps.

Derudover kan en meddelelse i appen indeholde nul til mange handlinger på meddelelseskortet. For at føje handlinger til appens meddelelseskort bruges følgende funktioner som parametre i funktionen XSendAppNotification. Du kan finde flere oplysninger om de enkelte handlingstyper under Meddelelseshandlinger.

  • XCreateUrlAction: Føjer en URL-handling til meddelelses-kortet.
  • XCreateSidePaneActionForDashboard: Tilføjer en siderudehandling, der navigerer til en side med en type i dashboard sideruden.
  • XCreateSidePaneActionForEntity: Tilføjer en siderudehandling, der navigerer til en side med en type i entityrecord sideruden.
  • XCreateSidePaneActionForEntityList: Tilføjer en siderudehandling, der navigerer til en side med en type i entitylist sideruden.
  • XCreateTeamsChatAction: Føjer en Teams-chathandling til meddelelses-kortet.

Syntaks

XSendAppNotification

XSendAppNotification (Titel; Modtager; Brødtekst; Handlinger; Ikontype; Toasttype; Udløbsdato; Prioritet)

Parameter Type Påkrævet Beskrivelse
titel Streng Ja Titlen på appmeddelelsen.
Modtager Enhed Ja Et objekt til systemuser, der er modtageren af meddelelsen.
Body Streng Nej Meddelelsens brødtekst.
Handlinger Funktion Nej En matrix med handlingsfunktioner, der kan tilføje handlinger i meddelelsen.
Ikontype Int Nej Valglisteværdi for ikontypen (Oplysninger, Fuldført, Fejl, Advarsel, Omtale og Brugerdefineret).
Toasttype Int Nej Valglisteværdi for toasttypen (timet versus skjult).
Udløb Int Nej Det antal sekunder, fra hvornår meddelelsen skal slettes, hvis den ikke allerede er afvist.
Prioritet Int Nej Valglisteværdi for meddelelsens prioritet (normal eller høj).

XCreateUrlAction

XCreateUrlAction (Titel; URL; Navigationsmål)

Parameter Type Påkrævet Beskrivelse
titel Streng Ja Den titel, der vises for handlingen.
URL Streng Ja Den URL-adresse, der skal åbnes, når handlingen vælges.
Navigationsdestination Streng Nej Definerer, hvor navigationslinket åbnes. Indstillingerne er:
  • dialog: Åbner i midterdialogen.
  • inline:Standard. Åbned på den aktuelle side.
  • newWindow: Åbner i en ny browserfane.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Titel,Rute-id,Rutetitel,Dashboard-id )

Parameter Type Påkrævet Beskrivelse
titel Streng Ja Den titel, der vises for handlingen.
Rude-id Streng Ja Den nye siderudes id.
Rudetitel Streng Ja Den titel, der skal vises for sideruden.
Dashboard-id GUID Ja Id for det valgte dashboard, der skal åbnes i sideruden.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity(Titel;Rute-id ;Titel på rude; Navn på objekt,Objekt-id )

Parameter Type Påkrævet Beskrivelse
titel Streng Ja Den titel, der vises for handlingen.
Rude-id Streng Ja Den nye siderudes id.
Rudetitel Streng Ja Den titel, der skal vises for sideruden.
Objektnavn Streng Ja Objektets logiske navn.
Objekt-id Streng Ja Id for den objektpost, der skal åbnes i sideruden.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList(Titel;Rute-id ;Titel på rude; Navn på objekt)

Parameter Type Påkrævet Beskrivelse
titel Streng Ja Den titel, der vises for handlingen.
Rude-id Streng Ja Den nye siderudes id.
Rudetitel Streng Ja Den titel, der skal vises for sideruden.
Objektnavn Streng Ja Det logiske navn på det objekt, der skal åbnes som en liste i sideruden.

XCreateTeamsChatAction

XCreateTeamsChatAction (Titel,Chat-id,Medlems-id'er,Post-id,Objektnavn,Første meddelelse)

Parameter Type Påkrævet Beskrivelse
titel Streng Ja Den titel, der vises for handlingen.
Chat-id Streng Nej Hvis du åbner en eksisterende chat, er det id'et for chatsessionen, der skal åbnes.
Medlems-id'er GUID Nej Hvis du opretter en ny chat, skal du inkludere en matrix med Microsoft Entra-objekt-id-værdier for de deltagere, der skal inkluderes i chatten.
Post-id GUID Nej Hvis du linker til en Dynamics 365-post, er det id'et for den post, som chatten skal knyttes til.
Objektnavn Streng Nej Hvis du linker til en Dynamics 365-post, er det det logiske navn på objektet for den post, som chatten skal knyttes til.
Første meddelelse Streng Nej En introduktionsmeddelelse til den nye chat.

Eksempler

Meddelelse i app med titel, modtager og brødtekst

Følgende sender en simpel meddelelse i appen til en modtager med titel og brødtekst. Den indeholder ikke handlinger og benytter standardværdierne for alle andre parametre.

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

Meddelelse i app med to handlinger

Følgende eksempelformel kan bruges sammen med en automatiseret plug-in, når der oprettes en ny opgavepost. Formlen er udviklet til at sende en meddelelse i appen til ejeren af opgaveposten. Meddelelseskortet indeholder to handlinger, som ejeren kan udføre:

  • En handling i sideruden åbner den nye opgavepost i en siderude.
  • En Teams-chat-handling starter en Teams-chat med ejeren af den firmapost, der er tildelt som tabelposten Angående for den nye opgave. Det er vigtigt at bemærke, at det antages, at der er valgt en firmapost i opgavefeltet.
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
		)
	]
)