Envoyer une notification Push dans PowerAppsSend a push notification in PowerApps

Les notifications Push sont utilisées dans des applications mobiles dans le cadre de scénarios impliquant des consommateurs et des entreprises, principalement dans le but d’impliquer les utilisateurs de l’application et de les aider à hiérarchiser les tâches clés.Push notifications are used in mobile apps for consumer and business scenarios primarily to engage app users and help them prioritize key tasks. Dans PowerApps, vous pouvez envoyer des notifications au moyen du connecteur PowerApps Notification.In PowerApps, you can send notifications by using the PowerApps Notification connector. Vous pouvez envoyer des notifications Push natives à toutes les applications créées dans PowerApps.You can send native push notifications to any app that you create in PowerApps. Nous prévoyons d’ajouter d’autres types de notification à l’avenir.We plan to add more notification types in the future.

Exemple de notification Push

Ajoutez une notification Push à votre application dans les cas suivants :Add a push notification to your app if:

  • Vos utilisateurs doivent prendre connaissance d’informations immédiatement.Your users need to know information immediately.
  • Vos utilisateurs doivent exécuter des tâches importantes à l’aide de votre application, dans un contexte préchargé.Your users must complete important tasks by using your app, in a preloaded context.
  • Vous souhaitez attirer vos utilisateurs sur un intervalle spécifique ou vous voulez que les utilisateurs entrent dans l’application dans un contexte spécifique.You want to engage your users on a specific interval, or you need users to enter the app in a specific context.

Note

Pour recevoir des notifications Push, chaque utilisateur doit ouvrir l’application dans PowerApps Mobile une première fois ou obtenir l’application à partir de AppSource dans Dynamics 365.To receive push notifications, each user must have opened the app in PowerApps Mobile once or gotten the app from AppSource in Dynamics 365.

Avant de commencerBefore you start

Dans une application pour laquelle vous avez l’autorisation de collaborateur, ajoutez une connexion PowerApps Notification.In an app for which you have the Contributor permission, add a PowerApps Notification connection. Si vous ne disposez pas d’une application, vous pouvez rapidement en créer une à partir d’un modèle et vous aurez l’autorisation requise par défaut.If you don't already have an app, you can quickly create one from a template, and you'll have the required permission by default. Ce tutoriel-là et celui-ci utilisent une application basée sur le modèle de gestion d’incidents.That tutorial and this one use an app based on the Case Management template.

Envoyer une notification à partir d’un fluxSend a notification from a flow

Note

Si vous déclenchez une notification Push à partir d’un flux, vous pouvez envoyer la notification à un seul utilisateur ou groupe de sécurité à la fois pour l’instant.If you trigger a push notification from a flow, you can send the notification to only one user or security group at a time currently.

  1. Dans Microsoft Flow, créez un déclencheur qui spécifie le moment où les notifications Push sont envoyées.In Microsoft Flow, create a trigger that specifies when the push notification is sent.

    Par exemple, vous pouvez envoyer une notification quand un enregistrement est ajouté à l’entité Incident dans Common Data Service.For example, you might want to send a notification when a record is added to the Case entity in the Common Data Service.

    Capture d’écran montrant la création d’un flux avec un déclencheur Common Data Service

  2. Créez une action pour le flux à l’aide du connecteur PowerApps Notification, puis entrez l’ID de l’application à laquelle vous souhaitez envoyer des notifications.Create an action for the flow by using the PowerApps Notification connector, and enter the App ID of the app to which you want to send notifications.

    Vous pouvez également renommer la connexion en fonction de votre scénario.You can also rename the connection to reflect your scenario.

    Capture d’écran montrant la création d’une connexion à des applications PowerApps qui recevront ces notifications Push

  3. (facultatif) Transmettez des paramètres à l’application lorsque celle-ci s’ouvre (une fois que l’utilisateur appuie sur la notification Push).(optional) Pass parameters to the app when it opens (after the user taps the push notification).

    Dans l’exemple, vous transmettez les champs Case ID (ID Incident) et Initial Owner (Propriétaire Initial) pour le contact sélectionné.In our example, we pass along the Case ID and Initial Owner fields for the selected contact.

    Capture d’écran montrant la transmission de paramètres facultatifs dans les notifications Push

Envoyer une notification à partir d’une applicationSend a notification from an app

Vous pouvez envoyer une notification Push d’une application à une autre ou à la même application.You can send a push notification from one app to another or to the same app.

  1. Dans PowerApps, accédez à l’application à laquelle vous souhaitez envoyer des notifications Push.In PowerApps, go to the app to which you want to send push notifications.
  2. Sous l’onglet Détails , copiez l’ID d’application de cette application.On the Details tab, copy the App ID of that app.

    Obtenir un ID d’application

  3. Sous l’onglet Connexions, créez une connexion au connecteur PowerApps Notification, en collant l’ID d’application obtenu à l’étape précédente.On the Connections tab, create a connection to the PowerApps Notification connector, and paste in the app ID from the previous step.

    Créer une connexion

  4. Ajoutez la connexion à l’application de déclencheur.Add the connection to the trigger app.

    Dans l’exemple, utilisez la même application comme déclencheur.In our example, we use the same app as the trigger app. L’utilisateur qui réaffecte l’incident déclenche également une notification Push qui est envoyée au nouveau propriétaire de l’incident.The user who reassigns the case also triggers a push notification to the new case owner.

    Ajouter une connexion

  5. À partir de la connexion de la notification Push, appelez la méthode SendPushNotification.From the push notification connection, call the SendPushNotification method.

    Dans l’exemple, déclenchez cette notification à l’aide de la propriété OnSuccess dans un formulaire.In our example, we trigger this notification by using the OnSuccess property in a form.

    Formule PowerApps

Charger une page et un contexte spécifiques lorsqu’un utilisateur appuie sur la notificationLoad a specific page and context when a user taps the notification

Transmettre des paramètresPass parameters

Votre notification Push peut transmettre des paramètres spécifiques à l’application.Your push notification can pass specific parameters to the app. Par exemple, pour lire la valeur CaseID, utilisez Param("CaseID").For example, to read the CaseID value, use Param("CaseID"). Pour identifier rapidement ce paramètre, ajoutez un contrôle d’étiquette à votre application.To quickly identify this parameter, add a Label control to your app. Définissez la propriété Text de ce contrôle sur Param("CaseID").Set the Text property of that control to Param("CaseID"). Si l’utilisateur ouvre l’application à partir de la liste Toutes les applications, la valeur est vide.If the user opens the app from the All apps list, the value is empty. Si l’utilisateur ouvre l’application à partir d’un autre emplacement sur l’appareil, la valeur est remplie avec la valeur de CaseID.If the user opens the app from another location on the device, the value is populated with the CaseID value.

Définir la page de démarrageSet the start page

Vous pouvez configurer votre application pour ouvrir, par exemple, la page Détails de l’incident dès que l’application s’ouvre :You can set your app to open, for example, the Case details page as soon as the app opens:

  1. Ajoutez un contrôle Timer (Minuteur), puis définissez sa propriété OnTimerEnd sur la formule suivante :Add a Timer control, and set its OnTimerEnd property to this formula:
    Navigate(EditCase, ScreenTransition.None)Navigate(EditCase, ScreenTransition.None)
  2. (Facultatif) Masquez le contrôle Timer en définissant sa propriété Visible sur false.(optional) Hide the Timer control by setting its Visible property to false.
  3. Définissez la propriété OnVisible de l’écran sur Timer.Start().Set the OnVisible property of the screen to Timer.Start().

Conseil

Il est judicieux de créer une première page unique dans l’application pour la notification :It's a good idea to create a unique first page in the app for the notification:

  1. Créez une page vide que votre application n’ouvre pas déjà, ajoutez un contrôle Text Input (Saisie de texte) et définissez sa valeur timer.Duration.Create an empty page that your app doesn't already open, add a Text Input control, and set its timer.Duration value.
  2. Lorsque vous créez l’application, définissez le minuteur sur une valeur non nulle.When you create the app, set the timer to a non-zero value. Lorsque vous êtes prêt à publier l’application, définissez la valeur sur 0 pour déclencher immédiatement le minuteur.When you're ready to publish the app, set the value to 0 to immediately trigger the timer.

SyntaxeSyntax

NomName DescriptionDescription
SendPushNotificationSendPushNotification Envoie une notification Push à l’application spécifiée dans les paramètres de connexion de la notification.Sends a push notification to the app that's specified in the connection settings for the notification.

ParamètresParameters

NomName TypeType DescriptionDescription
destinatairesrecipients Tableau de chaînes, requisString array, required Liste des éléments suivants :A list of:
  • Adresses e-mail des utilisateurs ou groupes de sécuritéEmail addresses for users or security groups
  • ID d’objet des utilisateurs ou groupes de sécurité dans Azure Active DirectoryObject IDs for users or security groups in Azure Active Directory
messagemessage Chaîne, requisString, required Corps du message des notifications Push.The message body of the push notification.
openAppopenApp Booléen (facultatif)Boolean, optional Indique si l’application s’ouvre lorsque l’utilisateur appuie sur la notification Push.Whether to open the app when the user taps the push notification.
paramsparams Paramètres (facultatifs)Parameters, optional Paramètres de clé-valeur à transmettre à la notification.Key-value parameters to pass with the notification. Ces éléments peuvent être traités davantage dans l’application pour ouvrir une page spécifique et charger un état donné.These can be further processed in the app to open a specific page and load a specific state.

Exemples de formulesSample formulas

Envoyez une notification de base.Send a basic notification.

PowerAppsNotification.SendPushNotification(
{
  recipients: [""f60ccf6f-7579-4f92-967c-2920473c966b", 72f988bf-86f1-41af-91ab-2d7cd011db47],
  message: "A new case was assigned to you."
 }
)

Envoyez une notification qui ouvre une application et transmet des paramètres spécifiques.Send a notification that opens an app and passes along specific parameters.

PowerAppsNotification.SendPushNotification(
{
  recipients:["email1@contoso.com", "email2@contoso.com"],
  message:"message in the notif toast",
  params:Table({key:"notificationKey", value:"The value for notificationKey"}),
  openApp:true
 }
)

Limitations connuesKnown limitations

  • Actuellement, les notifications ne sont pas affichées sur PowerApps Mobile pour Windows Phone.Currently, notifications aren't displayed on PowerApps Mobile for Windows Phone.
  • Nous ne fournissons pas actuellement de notifications Push pour les utilisateurs qui exécutent uniquement des applications dans le navigateur web.Currently, we don't provide push notifications for users who run apps only in a web browser.
  • Les notifications affichent l’icône PowerApps générique au lieu d’une icône d’application spécifique.Notifications show the generic PowerApps icon instead of a specific app icon.
  • Lorsque vous utilisez Microsoft Flow, vous pouvez envoyer une notification à un seul destinataire à la fois.When you use Microsoft Flow, you can send a push notification to only one recipient at a time.

Pour plus d’informations, consultez la référence sur PowerApps Notification.For reference information, see PowerApps Notification reference.