Del via

XSendAppNotification og relaterte handlingsfunksjoner (forhåndsvisning)

  • Artikkel

Gjelder: Lerretsapper Modelldrevne apper

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

Send et varsel i appen med valgfrie handlinger til en mottaker.

Viktig

  • Dette er en forhåndsversjonsfunksjon.
  • Forhåndsfunksjonene er ikke ment for produksjonsbruk, kan ha begrenset funksjonalitet og kan endres betydelig før utgivelse. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemelding.
  • Hver funksjon er prefikset med en X for å hjelpe deg med å identifisere disse som forhåndsvisningsfunksjonene. Når versjonen er klar, må X fjernes fra formler som bruker disse funksjonene og argumentene som er oppdatert for funksjonsendringer.
  • Disse funksjonene kan bare brukes med Dataverse-plugin-moduler med lav kode.

Bekrivelse

XSendAppNotification-funksjonen brukes til å sende varsler i en app til en mottaker. Disse varslene vises som toast eller i varslingssenteret for appbrukeren. Hvis du vil ha mer informasjon, kan du se Sende appinterne varsler i modelldrevne apper.

I tillegg kan et varsel i appen inneholde null til mange handlinger på varslingskortet. Hvis du vil legge til handlinger på appvarslingskortet, brukes følgende funksjoner som parametere i funksjonen XSendAppNotification. Hvis du vil ha mer informasjon om hver handlingstype, kan du se Varslingshandlinger.

  • XCreateUrlAction: Legger til en URL-handling i varslingskortet.
  • XCreateSidePaneActionForDashboard: Legger til en siderutehandling som navigerer til en side med en type dashboard innenfor sideruten.
  • XCreateSidePaneActionForEntity: Legger til en siderutehandling som navigerer til en side med en type entityrecord innenfor sideruten.
  • XCreateSidePaneActionForEntityList: Legger til en siderutehandling som navigerer til en side med en type entitylist innenfor sideruten.
  • XCreateTeamsChatAction: Legger til en Teams-chathandling i varslingskortet.

Syntaks

XSendAppNotification

XSendAppNotification (tittel, mottaker, brødtekst, handlinger, ikontype, toasttype, utløp, prioritet)

Parameter Type Kreves Bekrivelse
Title String Ja Tittelen på appvarslingen.
Mottaker Entity Ja Enheten systemuser som er mottaker av varselet.
Body String No Brødteksten for varslingen.
Handlinger Function No En matrise med handlingsfunksjonene for å legge til handlinger i varselet.
Ikontype Int No Verdi for nedtrekksmeny for typen ikon (informasjon, vellykket, feil, advarsel, omtale, egendefinert).
Varseltype Int No Nedtrekksmenyverdi for typen toast (tidsvis kontra skjult).
Utløper Int No Antall sekunder som varslingen skal slettes etter hvis den ikke allerede er avvist.
Prioritet Int No Verdi for nedtrekksmeny for prioriteten til varslingen (normal eller høy).

XCreateUrlAction

XCreateUrlAction (tittelURLnavigasjonsmål)

Parameter Type Kreves Bekrivelse
Title String Ja Tittelen som vises for handlingen.
URL String Ja URL-adressen som skal åpnes når handlingen er valgt.
Navigasjonsmål String No Definerer hvor navigasjonskoblingen åpnes. Alternativene er:
  • dialog: Åpnes i midtdialogboksen.
  • inline: Standard. Åpner gjeldende side.
  • newWindow: Åpner i en ny fane.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Tittel, Rute-ID, Rutetittel, Instrumentbord-ID)

Parameter Type Kreves Bekrivelse
Title String Ja Tittelen som vises for handlingen.
Rute-ID String Ja ID-en for de nye sideruten.
Rutetittel String Ja Tittelen som skal vises for sideruten.
ID for instrumentbord GUID Ja ID-en for instrumentbordet som skal åpnes i sideruten.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (tittel, rute-ID, rutetittel, enhetsnavn, enhets-ID)

Parameter Type Kreves Bekrivelse
Title String Ja Tittelen som vises for handlingen.
Rute-ID String Ja ID-en for de nye sideruten.
Rutetittel String Ja Tittelen som skal vises for sideruten.
Navn på enhet String Ja Det logiske navnet på enheten.
Enhets-ID String Ja ID-en for enhetsoppføringen som skal åpnes i sideruten.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (tittel, rute-ID, rutetittel, enhetsnavn)

Parameter Type Kreves Bekrivelse
Title String Ja Tittelen som vises for handlingen.
Rute-ID String Ja ID-en for de nye sideruten.
Rutetittel String Ja Tittelen som skal vises for sideruten.
Navn på enhet String Ja Det logiske navnet på enheten som skal åpnes som en liste i sideruten.

XCreateTeamsChatAction

XCreateTeamsChatAction (tittel, Chat-ID, medlems-ID-er, oppførings-ID, enhetsnavn, første melding)

Parameter Type Kreves Bekrivelse
Title String Ja Tittelen som vises for handlingen.
Chat-ID String No Hvis du åpner en eksisterende chat, vil IDen for chatøkten bli åpnet.
Medlems-ID-er GUID No Hvis du oppretter en ny chat, vil en matrise med Microsoft Entra-objekt-ID-verdier for deltakerne tas med i chatten.
Oppførings-ID GUID No IDen for oppføringen som chatten skal kobles til, hvis du kobler til en Dynamics 365-oppføring.
Navn på enhet String No Ved kobling til Dynamics 365-oppføringen, det logiske navnet på enheten til oppføringe som chatten skal kobles til.
Første melding String No En innledende melding for den nye chatten.

Eksempler

Varsel i app med tittel, mottaker og brødtekst

Følgende sender et enkelt varsel i appen til en mottaker med en tittel og en brødtekst. Den inneholder ingen handlinger, og bruker standardverdier for alle andre parametere.

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

Varsel i app med to handlinger

Følgende eksempelformel kan brukes med en automatisk plugin-modul når en ny oppgaveoppføring opprettes. Formelen er utformet for å sende et varsel i appen til eieren av oppgaveoppføringen. Varslingskortet inneholder to handlinger som eieren kan utføre:

  • En siderute-handling åpner den nye oppgaveoppføringen i en siderute.
  • En Team-chat-handling starter en Teams-chat med eieren av forretningsforbindelsesoppføringen som er tilordnet som Angående-tabelloppføringen for den nye oppgaven. Det er viktig å merke seg at dette forutsetter at en forretningsforbindelsesoppføring er valgt i oppgavefeltet.
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
		)
	]
)