Partajați prin

XSendAppNotification și funcții de acțiune asociate (versiune preliminară)

  • Articol

Se aplică pentru: planșă de lucru apps Aplicații bazate pe model

[Acest articol este documentație de prelansare și poate suferi modificări.]

Trimiteți unui destinatar o notificare în aplicație cu acțiuni opționale.

Important

  • Aceasta este o caracteristică de previzualizare.
  • Funcțiile versiune preliminară nu sunt destinate utilizării în producție, pot avea funcționalități limitate și se pot schimba semnificativ înainte de lansare. Aceste caracteristici sunt disponibile înainte de lansarea oficială, astfel încât clienții să poată obține acces din timp și să poată oferi feedback.
  • Pentru a le identifica ca funcții versiune preliminară, fiecare funcție este prefixată cu un X. La eliberare, X va trebui să fie eliminat din orice formule care utilizează aceste funcții și argumente actualizate pentru orice modificare a funcției.
  • Aceste funcții pot fi utilizate numai cu pluginurile Dataverse cu cod redus.

Descriere

Funcția XSendAppNotification este folosită pentru a trimite notificări dintr-o aplicație către un destinatar. Aceste notificări apar fie ca un toast, fie în centrul de notificare pentru utilizatorul aplicației. Pentru mai multe informații, consultați Trimiterea notificărilor în aplicație în aplicațiile bazate pe model.

În plus, o notificare în aplicație poate include de la zero la multe acțiuni în notificarea card. Pentru a adăuga acțiuni la notificarea aplicației card, următoarele funcții sunt utilizate ca parametri în funcția XSendAppNotification . Pentru mai multe informații despre fiecare tip de acțiune, consultați Acțiuni de notificare.

  • XCreateUrlAction: adaugă o acțiune URL la notificarea card.
  • XCreateSidePaneActionForDashboard: adaugă o acțiune din panoul lateral care navighează la o pagină cu un tip de dashboard în panoul lateral.
  • XCreateSidePaneActionForEntity: adaugă o acțiune din panoul lateral care navighează la o pagină cu un tip de entityrecord în panoul lateral.
  • XCreateSidePaneActionForEntityList: adaugă o acțiune din panoul lateral care navighează la o pagină cu un tip de entitylist în panoul lateral.
  • XCreateTeamsChatAction: adaugă o acțiune de chat Teams la notificarea card.

Sintaxă

XSendAppNotification

XSendAppNotification (Titlu, Destinatar, Corps, Acțiuni, Tip pictogramă, Tip toast, Expirare, Prioritate)

Parametru Tipul Obligatoriu Descriere
Funcție Șir Da Titlul notificării aplicației.
Destinatar Entity Da O entitate a systemuser care este destinatarul notificării.
Conținut Șir No Organismul de notificare.
Acţiuni Funcţie No O serie de funcții de acțiune pentru a adăuga acțiuni la notificare.
Tip de pictogramă Int No Valoarea listei de selectare pentru tipul de pictogramă (informații, succes, eșec, avertisment, mențiune, personalizare).
Tip toast Int No Valoarea listei de selectare pentru tipul de pâine prăjită (temporizat versus ascuns).
Expirare Int No Numărul de secunde din momentul în care notificarea ar trebui să fie ștearsă dacă nu a fost deja dezactivată.
Prioritate Int No Valoarea listei de selectare pentru prioritatea notificării (normală sau ridicată).

XCreateUrlAction

XCreateUrlAction (Titlu, URL, Tinta de navigare )

Parametru Tipul Obligatoriu Descriere
Funcție Șir Da Titlul care se afișează pentru acțiune.
Adresă URL Șir Da Adresa URL care trebuie deschisă atunci când acțiunea este selectată.
Țintă de navigare Șir No Definește unde se deschide linkul de navigare. Opțiunile sunt:
  • dialog: Se deschide în dialogul central.
  • inline: Mod implicit. Se deschide în pagina curentă.
  • newWindow: Se deschide într-o filă nouă de browser.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Title, Pane ID, Pane Titlu, ID tablou de bord)

Parametru Tipul Obligatoriu Descriere
Funcție Șir Da Titlul care se afișează pentru acțiune.
ID panou Șir Da ID-ul noului panou lateral.
Titlul panoului Șir Da Titlul de afișat pentru panoul lateral.
ID tablou de bord GUID Da ID-ul tabloului de bord de deschis în panoul lateral.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Title, Pane ID, Pane Titlu, Nume entitate, ID entitate)

Parametru Tipul Obligatoriu Descriere
Funcție Șir Da Titlul care se afișează pentru acțiune.
ID panou Șir Da ID-ul noului panou lateral.
Titlul panoului Șir Da Titlul de afișat pentru panoul lateral.
Nume entitate Șir Da Numele logic al entității.
ID entitate Șir Da ID-ul înregistrării entității de deschis în panoul lateral.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Title, Pane ID, Pane Titlu, Numele entității)

Parametru Tipul Obligatoriu Descriere
Funcție Șir Da Titlul care se afișează pentru acțiune.
ID panou Șir Da ID-ul noului panou lateral.
Titlul panoului Șir Da Titlul de afișat pentru panoul lateral.
Nume entitate Șir Da Numele logic al entității de deschis ca listă în panoul lateral.

XCreateTeamsChatAction

XCreateTeamsChatAction (Titlu, ID chat, Membru ID-uri, ID înregistrare, Numele entității, Mesaj inițial)

Parametru Tipul Obligatoriu Descriere
Funcție Șir Da Titlul care se afișează pentru acțiune.
ID chat Șir No Dacă deschideți un chat existent, ID-ul sesiunii de chat va fi deschis.
ID-uri de membru GUID No Dacă creați un nou chat, o matrice de Microsoft Entra valori de ID obiect ale participanților să fie incluse în chat.
ID înregistrare GUID No Dacă se conectează la o înregistrare Dynamics 365, ID-ul înregistrării la care ar trebui să fie conectat chatul.
Nume entitate Șir No Dacă se conectează la o înregistrare Dynamics 365, numele logic al entității din înregistrare la care ar trebui să fie conectat chatul.
Mesaj inițial Șir No Un mesaj introductiv al noului chat.

Exemple

Notificare în aplicație cu titlu, destinatar și corp

Următoarele trimite o notificare simplă în aplicație unui destinatar cu un titlu și un corp. Nu include nicio acțiune și utilizează valori implicite pentru toți ceilalți parametri.

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

Notificare în aplicație cu două acțiuni

Următorul exemplu de formulă poate fi utilizat cu un plugin automat atunci când este creată o nouă înregistrare de sarcină. Formula este concepută pentru a trimite o notificare în aplicație proprietarului înregistrării sarcinii. Notificarea card conține două acțiuni pe care proprietarul le poate întreprinde:

  • O acțiune panou lateral deschide noua înregistrare a sarcinii într-un panou lateral.
  • O acțiune de chat Teams, inițiază un chat Teams cu proprietarul înregistrării contului care este atribuit ca Cu privire la înregistrarea tabelului pentru noua sarcină. Este important să rețineți că acest lucru presupune că a fost selectată o înregistrare de cont în câmpul de activitate.
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
		)
	]
)