Dela via

XSendAppNotification och relaterade åtgärdsfunktioner (förhandsversion)

  • Artikel

Gäller för: Arbetsyteappar Modellbaserade appar

[Den här artikeln är en förhandsversion av dokumentationen och kan komma att ändras.]

Skicka en avisering via app med valfria åtgärder till en mottagare.

Viktigt!

  • Detta är en förhandsversion.
  • Förhandsversionsfunktioner ska inte användas i produktion och funktionerna kan vara begränsade ha betydande ändringar innan utgivning. Funktionerna är tillgängliga före den officiella publiceringen så att kunderna kan få tillgång tidigare och ge oss feedback.
  • För att hjälpa till att identifiera dessa som förhandsgranskningsfunktioner har varje funktion ett prefix X. Vid utgivning måste X tas bort från alla formeln som använder de här funktionerna och argumenten som uppdateras för funktionsändringar.
  • De här funktionerna kan bara användas med Dataverse plugin-program med låg kod.

Beskrivning

Funktionen XSendAppNotification används för att skicka meddelanden i en app till en mottagare. Meddelandena visas antingen som meddelanden eller i meddelandecentret för appanvändaren. Mer information finns i Skicka aviseringar via app i modellbaserade appar.

Dessutom kan en avisering via app innehålla noll till många åtgärder på meddelandekorten. För att lägga till åtgärder till appens meddelandekort används följande funktioner som parametrar i funktionen XSendAppNotification. Mer information om varje åtgärdstyp finns i Meddelandeåtgärder.

  • XCreateUrlAction: Lägger till en URL-åtgärd på kortet för meddelanden.
  • XCreateSidePaneActionForDashboard: Lägger till en sidofönsteråtgärd som navigerar till en sida med en typ av dashboard i sidofönstret.
  • XCreateSidePaneActionForEntity: Lägger till en sidofönsteråtgärd som navigerar till en sida med en typ av entityrecord i sidofönstret.
  • XCreateSidePaneActionForEntityList: Lägger till en sidofönsteråtgärd som navigerar till en sida med en typ av entitylist i sidofönstret.
  • XCreateTeamsChatAction: Lägger till en Teams chattåtgärd på kortet för meddelanden.

Syntax

XSendAppNotification

XSendAppNotification (Titel, Mottagare, Brödtext, Åtgärder, Ikontyp, Popup-typ, Förfallodatum, Prioritet)

Parameter Typ Obligatoriskt Beskrivning
Rubrik String Ja Appaviseringens rubrik.
Mottagare Enhet Ja En entitet av systemuser som är meddelandets mottagare.
Body String Nej Aviseringens text.
Åtgärder Function Nej En matris med åtgärdsfunktioner för att lägga till åtgärder i meddelandet.
Ikontyp Int Nej Plocklistevärde för typ av ikon (information, klar, misslyckad, varning, omnämnande, anpassad).
Typ av popup Int Nej Plocklistevärde för typ av popup (tidsinställd jämfört med dold).
Utgår Int Nej Antal sekunder innan aviseringen ska raderas om den inte redan stängts.
Prioritet Int Nej Plocklistevärde för aviseringens prioritet (normal eller hög).

XCreateUrlAction

XCreateUrlAction (Titel,URL ; Navigeringsmål)

Parameter Typ Obligatoriskt Beskrivning
Rubrik String Ja Titeln som visas för åtgärden.
webbadress String Ja URL:en som ska öppnas när åtgärden väljs.
Navigeringsmål String Nej Definierar var navigeringslänken öppnas. Alternativen är:
  • dialog: Öppnas i mittendialogen.
  • inline:Standard. Öppnas på den aktuella sidan.
  • newWindow: Öppnas i en ny flik i webbläsaren.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Titel,Fönster-ID,Paneltitel,Instrumentpanels-ID )

Parameter Typ Obligatoriskt Beskrivning
Rubrik String Ja Titeln som visas för åtgärden.
Fönster-ID String Ja ID för det nya sidofönstret.
Fönstertitel String Ja Den titel som ska visas i sidofönstret.
Instrumentpanel-ID GUID Ja ID för den instrumentpanel som ska öppnas i sidorutan.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Titel, Fönster-ID, Pane-titel, Enhetsnamn, Enhets-ID)

Parameter Typ Obligatoriskt Beskrivning
Rubrik String Ja Titeln som visas för åtgärden.
Fönster-ID String Ja ID för det nya sidofönstret.
Fönstertitel String Ja Den titel som ska visas i sidofönstret.
Entitetsnamn String Ja Det logiska namnet på entiteten.
Entitets-ID String Ja ID för den entitetspost som ska öppnas i sidorutan.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Titel, Fönster-ID, Pane-titel , Enhetsnamn)

Parameter Typ Obligatoriskt Beskrivning
Rubrik String Ja Titeln som visas för åtgärden.
Fönster-ID String Ja ID för det nya sidofönstret.
Fönstertitel String Ja Den titel som ska visas i sidofönstret.
Entitetsnamn String Ja Enhetens logiska namn som ska öppnas som en lista i sidofönster.

XCreateTeamsChatAction

XCreateTeamsChatAction (Titel, Chatt-ID, Medlems-ID, Record ID, Enhetsnamn, Första meddelande)

Parameter Typ Obligatoriskt Beskrivning
Rubrik String Ja Titeln som visas för åtgärden.
Chatt-ID String Nej Om du öppnar en befintlig chatt öppnas ID:t för den chattsession som ska öppnas.
Medlems-ID:n GUID Nej Om du skapar en ny chatt visas en matris med Microsoft Entra objekt-ID-värden för deltagarna som ska tas med i chatten.
Post-ID GUID Nej Om du länkar till en Dynamics 365-post ska ID för posten som chatten ska länkas till.
Entitetsnamn String Nej Om du länkar till en Dynamics 365-post, det logiska namnet på entiteten för posten som chatten ska länkas till.
Inledande meddelande String Nej Ett inledande meddelande om den nya chatten.

Exempel

Avisering via app med en rubrik, mottagare och brödtext

Följande skickar en enkel avisering via appen till en mottagare med rubrik och brödtext. Den innehåller inga åtgärder och använder standardvärden för alla andra parametrar.

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

Avisering via appen med två åtgärder

Följande exempelformel kan användas med ett automatiskt plugin-program när en ny uppgiftspost skapas. Formeln är utformad för att skicka ett meddelande i appen till ägaren av uppgiftsposten. Meddelandekort innehåller två åtgärder som ägaren kan utföra:

  • En åtgärd för sidofönster öppnar den nya uppgiftsposten i en sidofönster.
  • En åtgärd för Teams-chatt initierar en Teams-chatt med ägaren av kontoposten som är tilldelad som tabell Angående för den nya uppgiften. Det är viktigt att notera att en kontopost har markerats i uppgiftsfältet.
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
		)
	]
)