Partager via

XSendAppNotification et fonctions d’action associées (version préliminaire)

  • Article

S’applique à : Applications canevas  Applications pilotées par modèle

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Envoyez une notification dans l’application avec des actions facultatives à un destinataire.

Important

  • Cette fonctionnalité est une fonctionnalité en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production, peuvent être limitées et peuvent être modifiées considérablement avant leur lancement. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.
  • Pour aider à les identifier en tant que fonctionnalités en version préliminaire, chaque fonction est précédée d’un X. Lors de la publication, il est nécessaire de supprimer le X de toute formule qui utilise ces fonctions et de mettre à jour les arguments pour tout changement de fonction.
  • Ces fonctions ne peuvent être utilisées qu’avec les plug-ins low-code Dataverse.

Description

La fonction XSendAppNotification est utilisée pour envoyer des notifications au sein d’une application à un destinataire. Ces notifications apparaissent sous forme de toast ou dans le centre de notifications pour l’utilisateur de l’application. Pour plus d’informations, voir Envoyer des notifications dans l’application au sein des applications pilotées par modèle.

De plus, une notification dans l’application peut inclure zéro à plusieurs actions sur la carte de notification. Pour ajouter des actions à la carte de notification de l’application, les fonctions suivantes sont utilisées comme paramètres dans la fonction XSendAppNotification. Pour plus d’informations sur chaque type d’action, voir Actions de notification.

  • XCreateUrlAction : ajoute une action URL à la notification carte.
  • XCreateSidePaneActionForDashboard : ajoute une action de volet latéral qui navigue vers une page avec un type de dashboard dans le volet latéral.
  • XCreateSidePaneActionForEntity : ajoute une action de volet latéral qui navigue vers une page avec un type de entityrecord dans le volet latéral.
  • XCreateSidePaneActionForEntityList : ajoute une action de volet latéral qui navigue vers une page avec un type de entitylist dans le volet latéral.
  • XCreateTeamsChatAction : ajoute une action de chat Teams à la notification carte.

Syntaxe

XSendAppNotification

XSendAppNotification (Titre, Destinataire, Corps, Actions, Type d’icône, Type de toast, Expiration, Priorité)

Paramètre Type Requis Description
Titre Chaîne Oui Le titre de la notification de l’application.
Destinataire Entité Oui Une entité systemuser qui est le destinataire de la notification.
Corps Chaîne Non Le corps de la notification.
Actions Fonction Non Un tableau des fonctions d’action pour ajouter des actions à la notification.
Type d’icône Entier Non Valeur de la liste déroulante pour le type d’icône (infos, réussite, échec, avertissement, mention, personnalisé).
Type de toast Entier Non Valeur de la liste déroulante pour le type de toast (programmé ou masqué).
Expirer Entier Non Le nombre de secondes à partir duquel la notification doit être supprimée si elle n’est pas déjà rejetée.
Priorité Entier Non Valeur de la liste déroulante pour la priorité de la notification (normale ou élevée).

XCreateUrlAction

XCreateUrlAction (Titre, URL, Cible de navigation)

Paramètre Type Requis Description
Titre Chaîne Oui Le titre qui s’affiche pour l’action.
URL Chaîne Oui L’URL à ouvrir lorsque l’action est sélectionnée.
Cible de navigation Chaîne Non Définit où le lien de navigation s’ouvre. Les options sont les suivantes :
  • dialog : S’ouvre dans la boîte de dialogue centrale.
  • inline : Défaut. S’ouvre dans la page actuelle.
  • newWindow : S’ouvre dans un nouvel onglet de navigateur.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Titre, ID du volet, Titre du volet, ID du tableau de bord)

Paramètre Type Requis Description
Titre Chaîne Oui Le titre qui s’affiche pour l’action.
ID de volet Chaîne Oui L’ID du nouveau volet latéral.
Titre du volet Chaîne Oui Le titre à afficher pour le volet latéral.
ID tableau de bord GUID Oui ID du tableau de bord à ouvrir dans le volet latéral.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Titre, ID du volet, Titre du volet, Nom de l’entité, ID de l’entité)

Paramètre Type Requis Description
Titre Chaîne Oui Le titre qui s’affiche pour l’action.
ID de volet Chaîne Oui L’ID du nouveau volet latéral.
Titre du volet Chaîne Oui Le titre à afficher pour le volet latéral.
Nom de l’entité Chaîne Oui Nom logique de l’entité.
ID entité Chaîne Oui ID de l’enregistrement d’entité à ouvrir dans le volet latéral.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Titre, ID du volet, Titre du volet, Nom de l’entité)

Paramètre Type Requis Description
Titre Chaîne Oui Le titre qui s’affiche pour l’action.
ID de volet Chaîne Oui L’ID du nouveau volet latéral.
Titre du volet Chaîne Oui Le titre à afficher pour le volet latéral.
Nom de l’entité Chaîne Oui Nom logique de l’entité à ouvrir sous forme de liste dans le volet latéral.

XCreateTeamsChatAction

XCreateTeamsChatAction (Titre, ID de chat, ID de membre, ID d’enregistrement, Nom d’entité, Message initial)

Paramètre Type Requis Description
Civilité String Oui Le titre qui s’affiche pour l’action.
ID de conversation instantanée Chaîne Non Si vous ouvrez une conversation instantanée existante, l’ID de la session de conversation instantanée à ouvrir.
ID de membre GUID Non Si vous créez une nouvelle conversation instantanée, un tableau de valeurs d’ID d’objet Microsoft Entra des participants à inclure dans la conversation instantanée.
ID d’enregistrement GUID Non Si vous créez un lien vers un enregistrement Dynamics 365, l’ID de l’enregistrement auquel la conversation instantanée doit être liée.
Nom de l’entité Chaîne Non Si vous créez un lien vers un enregistrement Dynamics 365, le nom logique de l’entité de l’enregistrement auquel la conversation instantanée doit être liée.
Message initial Chaîne Non Un message d’introduction de la nouvelle conversation instantanée.

Exemples

Notification dans l’application avec un titre, un destinataire et un corps

La formule suivante envoie une simple notification dans l’application à un destinataire avec un titre et un corps. Elle n’inclut aucune action et utilise les valeurs par défaut pour tous les autres paramètres.

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

Notification dans l’application avec deux actions

L’exemple de formule suivant peut être utilisé avec un plugin automatisé lorsqu’un nouvel enregistrement de tâche est créé. La formule est conçue pour envoyer une notification dans l’application au propriétaire de l’enregistrement de tâche. La carte de notification contient deux actions que le propriétaire peut effectuer :

  • Une action de volet latéral ouvre le nouvel enregistrement de tâche dans un volet latéral.
  • Une action de conversation instantanée Teams lance une conversation instantanée Teams avec le propriétaire de l’enregistrement de compte qui est attribué en tant qu’enregistrement de table Concernant pour la nouvelle tâche. Il est important de noter que cela suppose qu’un enregistrement de compte a été sélectionné dans le champ de tâche.
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
		)
	]
)