XSendAppNotification e relative funzioni di azione (anteprima)

  • Articolo

Si applica a: App Canvas App basate su modello

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Invia una notifica in-app con azioni facoltative a un destinatario.

Importante

  • Questa è una funzionalità di anteprima.
  • Le funzionalità di anteprima non sono destinate a un uso in produzione, possono essere limitate ed essere modificate significativamente prima del rilascio. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.
  • Per aiutare a identificarle come funzionalità di anteprima, ogni funzione è preceduta da una X. Al momento del rilascio, la X dovrà essere rimossa da tutte le formule che utilizzano queste funzioni e gli argomenti aggiornati per eventuali modifiche alle funzioni.
  • Queste funzioni possono essere utilizzate solo con i plug-in con poco codice di Dataverse.

Description

La funzione XSendAppNotification viene utilizzata per inviare notifiche all'interno di un'app a un destinatario. Queste notifiche sono visualizzate come avviso popup o nel centro notifiche per l'utente dell'app. Per ulteriori informazioni, vedi Inviare notifiche in-app in app basate su modello.

Inoltre, una notifica in-app può includere da zero a molte azioni nella scheda di notifica. Per aggiungere azioni alla scheda di notifica dell'app, le seguenti funzioni vengono utilizzate come parametri nella funzione XSendAppNotification. Per ulteriori informazioni su ciascun tipo di azione, vedi Azioni di notifica.

  • XCreateUrlAction: Aggiunge un'azione URL alla notifica scheda.
  • XCreateSidePaneActionForDashboard: aggiunge un'azione del riquadro laterale che consente di passare a una pagina con un tipo di dashboard all'interno del riquadro laterale.
  • XCreateSidePaneActionForEntity: aggiunge un'azione del riquadro laterale che consente di passare a una pagina con un tipo di entityrecord all'interno del riquadro laterale.
  • XCreateSidePaneActionForEntityList: aggiunge un'azione del riquadro laterale che consente di passare a una pagina con un tipo di entitylist all'interno del riquadro laterale.
  • XCreateTeamsChatAction: aggiunge un'azione di chat di Teams alla notifica scheda.

Sintassi

XSendAppNotification

XSendAppNotification (Titolo, Destinatario, Corpo, Azioni, Tipo di icona, Tipo di avviso popup, Scadenza, Priorità)

Parametro Type Obbligatorio Description
Title String Sì Il titolo della notifica dell'app.
Destinatario Entity Sì Un'entità di systemuser che è il destinatario della notifica.
Body String No Il corpo della notifica.
Azioni Funzione No Una matrice delle funzioni di azione per aggiungere azioni alla notifica.
Tipo di icona Int No Il valore dell'elenco a discesa per il tipo di icona (informazioni, operazione riuscita, errore, avviso, menzione, personalizzato).
Tipo di notifica di tipo avviso popup Int No Il valore dell'elenco a discesa per il tipo di avviso popup (a tempo o nascosto).
Scadenza Int No Numero di secondi a partire dal momento in cui la notifica deve essere eliminata se non è già stata ignorata.
Priorità Int No Il valore dell'elenco a discesa per la priorità della notifica (normale o alta).

XCreateUrlAction

XCreateUrlAction (Titolo, URL, Destinazione di navigazione)

Parametro Type Obbligatorio Description
Title String Sì Il titolo che viene visualizzato per l'azione.
URL String Sì L'URL da aprire quando viene selezionata l'azione.
Obiettivo di navigazione String No Definisce dove si apre il collegamento di navigazione. Le opzioni sono:
  • dialog: Si apre nella finestra di dialogo centrale.
  • inline: Predefinito. Si apre nella pagina corrente.
  • newWindow: Si apre in una nuova scheda del browser.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Titolo, ID riquadro, Titolo riquadro, ID dashboard)

Parametro Type Obbligatorio Description
Title String Sì Il titolo che viene visualizzato per l'azione.
ID riquadro String Sì L'ID del nuovo riquadro laterale.
Titolo riquadro String Sì Il titolo da visualizzare per il riquadro laterale.
ID dashboard GUID Sì L'ID del dashboard da aprire nel riquadro laterale.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Titolo, ID riquadro, Titolo riquadro, Nome entità, ID entità)

Parametro Type Obbligatorio Description
Title String Sì Il titolo che viene visualizzato per l'azione.
ID riquadro String Sì L'ID del nuovo riquadro laterale.
Titolo riquadro String Sì Il titolo da visualizzare per il riquadro laterale.
Nome entità String Sì Nome logico dell'entità.
ID entità String Sì L'ID del record di entità da aprire nel riquadro laterale.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Titolo, ID riquadro, Titolo riquadro, Nome entità)

Parametro Type Obbligatorio Description
Title String Sì Il titolo che viene visualizzato per l'azione.
ID riquadro String Sì L'ID del nuovo riquadro laterale.
Titolo riquadro String Sì Il titolo da visualizzare per il riquadro laterale.
Nome entità String Sì Il nome logico dell'entità da aprire come elenco nel riquadro laterale.

XCreateTeamsChatAction

XCreateTeamsChatAction (Titolo, ID chat, ID membro, ID record, Nome entità, Messaggio iniziale)

Parametro Type Obbligatorio Description
Title String Sì Il titolo che viene visualizzato per l'azione.
ID chat String No Se si apre una chat esistente, l'ID della sessione di chat da aprire.
ID membro GUID No Se si crea una nuova chat, una matrice di valori ID oggetto di Microsoft Entra dei partecipanti da includere nella chat.
ID record GUID No In caso di collegamento a un record di Dynamics 365, l'ID del record a cui deve essere collegata la chat.
Nome entità String No In caso di collegamento a un record di Dynamics 365, il nome logico dell'entità del record a cui deve essere collegata la chat.
Messaggio iniziale String No Un messaggio introduttivo della nuova chat.

Esempi

Notifica in-app con titolo, destinatario e corpo

Quanto segue invia una semplice notifica in-app a un destinatario con un titolo e un corpo. Non include alcuna azione e utilizza i valori predefiniti per tutti gli altri parametri.

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

Notifica in-app con due azioni

La seguente formula di esempio può essere utilizzata con un plug-in automatizzato quando viene creato un nuovo record di attività. La formula è progettata per inviare una notifica in-app al proprietario del record di attività. La scheda di notifica contiene due azioni che il proprietario può intraprendere:

  • Un'azione riquadro laterale che apre il nuovo record di attività in un riquadro laterale.
  • Un'azione chat di Teams che avvia una chat di Teams con il proprietario del record di account assegnato come record di tabella Tema per la nuova attività. È importante notare che ciò presuppone che nel campo dell'attività sia stato selezionato un record di account.
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
		)
	]
)