Freigeben über

„XSendAppNotification“ und zugehörige Aktionsfunktionen (Vorschau)

  • Artikel

Gilt für: Canvas-Apps Modellgesteuerte Apps

[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]

In-App-Benachrichtigung mit optionalen Aktionen an einen Empfänger senden.

Wichtig

  • Dies ist eine Vorschauversion.
  • Die Vorschaufunktionen sind nicht für die Produktion vorgesehen, weisen möglicherweise eingeschränkte Funktionen auf und können sich vor dem Release signifikant ändern. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.
  • Um diese als Vorschaufunktionen zu identifizieren, wird jeder Funktion ein X vorangestellt. Bei der Veröffentlichung muss das X aus allen Formeln entfernt werden, die diese Funktionen verwenden, und Argumente müssen bei Funktionsänderungen aktualisiert werden.
  • Diese Funktionen können nur mit den Dataverse-Low-Code-Plugins genutzt werden.

Beschreibung

Die Funktion XSendAppNotification wird verwendet, um Benachrichtigungen innerhalb einer App an einen Empfänger zu senden. Diese Benachrichtigungen erscheinen entweder als Toast oder in der Mitteilungszentrale für den App-Benutzer. Weitere Informationen finden Sie unter In-App-Benachrichtigungen in modellgesteuerten Apps senden.

Darüber hinaus kann eine In-App-Benachrichtigung null bis viele Aktionen auf der Benachrichtigungskarte enthalten. Um Aktionen zur App-Benachrichtigungskarte hinzuzufügen, werden die folgenden Funktionen als Parameter in der Funktion XSendAppNotification verwendet. Weitere Informationen zu den einzelnen Aktionstypen finden Sie unter Benachrichtigungsaktionen.

  • XCreateUrlAction: Fügt der Benachrichtigung Karte eine URL-Aktion hinzu.
  • XCreateSidePaneActionForDashboard: Fügt eine Seitenbereichsaktion hinzu, die zu einer Seite mit einem Typ von dashboard innerhalb des Seitenbereichs navigiert.
  • XCreateSidePaneActionForEntity: Fügt eine Seitenbereichsaktion hinzu, die zu einer Seite mit einem Typ von entityrecord innerhalb des Seitenbereichs navigiert.
  • XCreateSidePaneActionForEntityList: Fügt eine Seitenbereichsaktion hinzu, die zu einer Seite mit einem Typ von entitylist innerhalb des Seitenbereichs navigiert.
  • XCreateTeamsChatAction: Fügt der Benachrichtigung Karte eine Teams-Chat-Aktion hinzu.

Syntax

XSendAppNotification

XSendAppNotification (Titel, Empfänger, Text, Aktionen, Symboltyp, Toasttyp, Ablauf, Priorität)

Parameter Type Erforderlich Beschreibung
Title String Ja Der Titel der App-Benachrichtigung.
Empfänger Entity Ja Eine Entität von systemuser, die der Empfänger der Benachrichtigung ist.
Body String Nein Der Textkörper der Benachrichtigung.
Aktionen Function Nein Ein Array der Aktionsfunktionen zum Hinzufügen von Aktionen zur Benachrichtigung.
Symboltyp Int Nein Auswahllistenwert für den Symboltyp (Info, Erfolg, Fehler, Warnung, Nennung, Benutzerdefiniert).
Popuptyp Int Nein Auswahllistenwert für die Art des Toasts (zeitgesteuert oder ausgeblendet).
Ablauf Int Nein Die Anzahl der Sekunden, ab wann die Benachrichtigung gelöscht werden soll, wenn sie nicht bereits verworfen wurde.
Priorität Int Nein Auswahllistenwert für die Priorität der Benachrichtigung (normal oder hoch).

XCreateUrlAction

XCreateUrlAction (Titel, URL, Navigationsziel)

Parameter Type Erforderlich Beschreibung
Title String Ja Der Titel, der für die Aktion angezeigt wird.
URL String Ja Die URL, die geöffnet werden soll, wenn die Aktion ausgewählt wird.
Navigationsziel String Nein Definiert, wo der Navigationslink geöffnet wird. Folgende Optionen sind verfügbar:
  • dialog: Öffnet den zentralen Dialog.
  • inline: Standard. Öffnet sich in der aktuellen Seite.
  • newWindow: Wird in einem neuen Browser-Tab geöffnet.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Titel, Bereichs-ID, Bereichstitel, Dashboard-ID)

Parameter Type Erforderlich Beschreibung
Title String Ja Der Titel, der für die Aktion angezeigt wird.
Bereichs-ID String Ja Die ID des neuen Seitenbereichs.
Bereichstitel String Ja Der für den Seitenbereich anzuzeigende Titel.
Dashboard-ID GUID Ja Die ID des Dashboards, das im Seitenbereich geöffnet wird.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Titel, Bereichs-ID, Bereichstitel, Entitätsname, Entitäts-ID)

Parameter Type Erforderlich Beschreibung
Title String Ja Der Titel, der für die Aktion angezeigt wird.
Bereichs-ID String Ja Die ID des neuen Seitenbereichs.
Bereichstitel String Ja Der für den Seitenbereich anzuzeigende Titel.
Entitätsname String Ja Der logische Name der Entität.
Entitäts-ID String Ja Die ID des Entitätsdatensatzes, der im Seitenbereich geöffnet wird.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Titel, Bereichs-ID, Bereichstitel, Entitätsname)

Parameter Type Erforderlich Beschreibung
Title String Ja Der Titel, der für die Aktion angezeigt wird.
Bereichs-ID String Ja Die ID des neuen Seitenbereichs.
Bereichstitel String Ja Der für den Seitenbereich anzuzeigende Titel.
Entitätsname String Ja Der logische Name der Entität, die als Liste im Seitenbereich geöffnet werden soll.

XCreateTeamsChatAction

XCreateTeamsChatAction (Titel, Chat-ID, Mitglieds-IDs, Datensatz-ID, Entitätsname, Erste Nachricht)

Parameter Type Erforderlich Beschreibung
Title String Ja Der Titel, der für die Aktion angezeigt wird.
Chat-ID String Nein Beim Öffnen eines bestehenden Chats die ID der zu öffnenden Chat-Sitzung.
Mitglieds-IDs GUID Nein Beim Erstellen eines neuen Chats ein Array von Microsoft Entra-Objekt-ID-Werten der Teilnehmer, die in den Chat einbezogen werden sollen.
Datensatz-ID GUID Nein Bei einer Verknüpfung mit einem Dynamics 365-Datensatz die ID des Datensatzes, mit dem der Chat verknüpft werden soll.
Entitätsname String Nein Bei einer Verknüpfung mit einem Dynamics 365-Datensatz der logische Name der Entität des Datensatzes, mit dem der Chat verknüpft werden soll.
Erste Nachricht String Nein Eine einleitende Nachricht des neuen Chats.

Beispiele

In-App-Benachrichtigung mit einem Titel, Empfänger und Text

Im Folgenden wird eine einfache In-App-Benachrichtigung mit Titel und Text an einen Empfänger gesendet. Sie enthält keine Aktionen und verwendet Standardwerte für alle anderen Parameter.

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

In-App-Benachrichtigung mit zwei Aktionen

Die folgende Beispielformel kann mit einem automatisierten Plug-In verwendet werden, wenn ein neuer Aufgabendatensatz erstellt wird. Die Formel dient dazu, eine In-App-Benachrichtigung an den Eigentümer des Aufgabendatensatzes zu senden. Die Benachrichtigungskarte enthält zwei Aktionen, die der Eigentümer ausführen kann:

  • Eine Seitenbereichsaktion. Durch diese wird der neue Aufgabendatensatz in einem Seitenbereich geöffnet.
  • Eine Teams-Chat-Aktion. Durch diese wird ein Teams-Chat mit dem Eigentümer des Kontodatensatzes initiiert, der als Betreff-Tabellendatensatz für die neue Aufgabe zugewiesen ist. Es ist wichtig zu beachten, dass dabei davon ausgegangen wird, dass im Aufgabenfeld ein Kontodatensatz ausgewählt wurde.
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
		)
	]
)