Inviare una notifica pull in PowerAppsSend a pull notification in PowerApps

Le notifiche push vengono usate nelle app desktop per scenari consumer e business principalmente per coinvolgere gli utenti delle app e aiutarli a classificare in ordine di priorità le attività essenziali.Push notifications are used in decktop apps for consumer and business scenarios primarily to engage app users and help them prioritize key tasks. In PowerApps è possibile inviare notifiche tramite il connettore Notifica di PowerApps.In PowerApps, you can send notifications by using the PowerApps Notification connector. È possibile inviare notifiche push native a qualsiasi app creata in PowerApps.You can send native push notifications to any app that you create in PowerApps. È prevista l'aggiunta di altri tipi di notifica in futuro.We plan to add more notification types in the future.

Esempio di notifica push

Aggiungere una notifica push all'app se:Add a push notification to your app if:

  • Gli utenti devono ottenere immediatamente le informazioni.Your users need to know information immediately.
  • Gli utenti devono completare attività importanti usando l'app in un contesto precaricato.Your users must complete important tasks by using your app, in a preloaded context.
  • Si vogliono coinvolgere gli utenti in base a un intervallo specifico o è necessario che gli utenti usino l'app in un contesto specifico.You want to engage your users on a specific interval, or you need users to enter the app in a specific context.

Nota

Per ricevere notifiche push, è necessario che ogni utente abbia aperto l'app in PowerApps Mobile una volta o che abbia ottenuto l'app da AppSource in 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.

Prima di iniziareBefore you start

Nell'app per cui si ha il ruolo Collaboratore aggiungere una connessione di tipo notifica di PowerApps.In an app for which you have the Contributor permission, add a PowerApps Notification connection. Se non si ha già un'app, è possibile crearne una da un modello rapidamente. Le autorizzazioni necessarie saranno disponibili per impostazione predefinita.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. L'esercitazione indicata e questa esercitazione usano un'app basata sul modello Case Management.That tutorial and this one use an app based on the Case Management template.

Inviare una notifica da un flussoSend a notification from a flow

Nota

Se si attiva una notifica push da un flusso, è attualmente possibile inviare la notifica solo a un utente o a un gruppo di sicurezza alla volta.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. In Microsoft Flow creare un trigger che specifica quando viene inviata la notifica push.In Microsoft Flow, create a trigger that specifies when the push notification is sent.

    È ad esempio possibile che si voglia inviare una notifica quando un record viene aggiunto all'entità Case in 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.

    Screenshot della creazione di un flusso con un trigger di Common Data Service

  2. Creare un'azione per il flusso usando il connettore Notifica di PowerApps e immettere il valore ID app dell'app a cui si vogliono inviare le notifiche.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.

    È anche possibile rinominare la connessione in modo da rispecchiare lo scenario specifico.You can also rename the connection to reflect your scenario.

    Screenshot della creazione di una connessione all'app PowerApps che riceverà queste notifiche push

  3. (Facoltativo) Passare parametri all'app quando viene aperta, dopo che l'utente tocca la notifica push.(optional) Pass parameters to the app when it opens (after the user taps the push notification).

    In questo esempio vengono passati i campi Case ID e Initial Owner per il contatto selezionato.In our example, we pass along the Case ID and Initial Owner fields for the selected contact.

    Screenshot del passaggio di parametri facoltativi nella notifica push

Inviare una notifica da un'appSend a notification from an app

È possibile inviare una notifica push da un'app a un'altra o alla stessa app.You can send a push notification from one app to another or to the same app.

  1. In PowerApps passare all'app a cui si vogliono inviare notifiche push.In PowerApps, go to the app to which you want to send push notifications.
  2. Nella scheda Dettagli copiare l'ID app dell'app.On the Details tab, copy the App ID of that app.

    Recuperare l'ID dell'app

  3. Nella scheda Connessioni creare una connessione al connettore di notifica di PowerApps e incollare l'ID app dal passaggio precedente.On the Connections tab, create a connection to the PowerApps Notification connector, and paste in the app ID from the previous step.

    Creare una connessione

  4. Aggiungere la connessione all'app trigger.Add the connection to the trigger app.

    Nell'esempio viene usata la stessa app come app trigger.In our example, we use the same app as the trigger app. L'utente che riassegna il caso attiva anche una notifica push per il nuovo proprietario del caso.The user who reassigns the case also triggers a push notification to the new case owner.

    Aggiungere una connessione

  5. Dalla connessione della notifica push chiamare il metodo SendPushNotification.From the push notification connection, call the SendPushNotification method.

    Nell'esempio la notifica viene attivata tramite la proprietà OnSuccess in un form.In our example, we trigger this notification by using the OnSuccess property in a form.

    Formula di PowerApps

Caricare una pagina e un contesto specifici quando un utente tocca la notificaLoad a specific page and context when a user taps the notification

Passare parametriPass parameters

La notifica push può passare parametri specifici all'app.Your push notification can pass specific parameters to the app. Ad esempio, per leggere il valore CaseID usare Param("CaseID").For example, to read the CaseID value, use Param("CaseID"). Per identificare rapidamente questo parametro, aggiungere un controllo Label all'app.To quickly identify this parameter, add a Label control to your app. Impostare la proprietà Text del controllo su Param("CaseID").Set the Text property of that control to Param("CaseID"). Se l'utente apre l'app dall'elenco Tutte le app, il valore è vuoto.If the user opens the app from the All apps list, the value is empty. Se l'utente apre l'app da un'altra posizione nel dispositivo, il valore viene popolato con il valore CaseID.If the user opens the app from another location on the device, the value is populated with the CaseID value.

Impostare la pagina inizialeSet the start page

È possibile impostare l'app in modo che apra, ad esempio, la pagina Case details non appena viene aperta l'app:You can set your app to open, for example, the Case details page as soon as the app opens:

  1. Aggiungere un controllo Timer e impostare la rispettiva proprietà OnTimerEnd su questa formula:Add a Timer control, and set its OnTimerEnd property to this formula:
    Navigate(EditCase, ScreenTransition.None)Navigate(EditCase, ScreenTransition.None)
  2. (Facoltativo) Nascondere il controllo Timer impostando la rispettiva proprietà Visible su false.(optional) Hide the Timer control by setting its Visible property to false.
  3. Impostare la proprietà OnVisible della schermata su Timer.Start().Set the OnVisible property of the screen to Timer.Start().

Suggerimento

È consigliabile creare una prima pagina univoca nell'app per la notifica:It's a good idea to create a unique first page in the app for the notification:

  1. Creare una pagina vuota che non viene già aperta dall'app, aggiungere un controllo Input di testo e impostare il rispettivo valore su 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. Quando si crea l'app, impostare il timer su un valore diverso da zero.When you create the app, set the timer to a non-zero value. Quando si è pronti per pubblicare l'app, impostare il valore su 0 per attivare immediatamente il timer.When you're ready to publish the app, set the value to 0 to immediately trigger the timer.

SintassiSyntax

NomeName DescrizioneDescription
SendPushNotificationSendPushNotification Invia una notifica push all'app specificata nelle impostazioni di connessione per la notifica.Sends a push notification to the app that's specified in the connection settings for the notification.

ParametriParameters

NomeName TipoType DescrizioneDescription
recipientsrecipients Matrice di stringhe, obbligatorioString array, required Elenco di:A list of:
  • Indirizzi di posta elettronica per utenti o gruppi di sicurezzaEmail addresses for users or security groups
  • ID oggetto per utenti o gruppi di sicurezza in Azure Active DirectoryObject IDs for users or security groups in Azure Active Directory
messagemessage Stringa, obbligatorioString, required Corpo del messaggio della notifica push.The message body of the push notification.
openAppopenApp Booleano, facoltativoBoolean, optional Indica se aprire l'app quando l'utente tocca la notifica push.Whether to open the app when the user taps the push notification.
paramsparams Parametri, facoltativoParameters, optional Parametri chiave-valore da passare con la notifica.Key-value parameters to pass with the notification. Possono essere elaborati ulteriormente nell'app per aprire una pagina specifica e caricare uno stato specifico.These can be further processed in the app to open a specific page and load a specific state.

Formule di esempioSample formulas

Inviare una notifica di 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."
 }
)

Inviare una notifica che apre un'app e passa parametri specifici.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
 }
)

Limitazioni noteKnown limitations

  • Le notifiche non vengono attualmente visualizzate in PowerApps Mobile per Windows Phone.Currently, notifications aren't displayed on PowerApps Mobile for Windows Phone.
  • Non sono attualmente disponibili le notifiche push per gli utenti che eseguono le app solo in un Web browser.Currently, we don't provide push notifications for users who run apps only in a web browser.
  • Le notifiche mostrano l'icona generica di PowerApps invece dell'icona di un'app specifica.Notifications show the generic PowerApps icon instead of a specific app icon.
  • Quando si usa Microsoft Flow, è possibile inviare una notifica push solo a un destinatario alla volta.When you use Microsoft Flow, you can send a push notification to only one recipient at a time.

Per informazioni di riferimento, vedere la pagina di riferimento sulle notifiche di PowerApps.For reference information, see PowerApps Notification reference.