Κοινή χρήση μέσω

XSendAppNotification και σχετικές συναρτήσεις ενεργειών (έκδοση προεπισκόπησης)

  • Άρθρο

Ισχύει για: Εφαρμογές καμβά Εφαρμογές βάσει μοντέλου

[Αυτό το άρθρο αποτελεί τεκμηρίωση προέκδοσης και ενδέχεται να αλλάξει.]

Στείλτε μια ειδοποίηση εντός εφαρμογής με προαιρετικές ενέργειες σε έναν παραλήπτη.

Σημαντικό

  • Αυτή είναι μια δυνατότητα προεπισκόπησης.
  • Οι δυνατότητες προεπισκόπησης δεν προορίζονται για χρήση παραγωγής ενδέχεται να έχουν περιορισμένη λειτουργικότητα και μπορεί να αλλάξουν σημαντικά πριν την κυκλοφορία. Αυτές οι δυνατότητες είναι διαθέσιμες πριν από μια επίσημη κυκλοφορία έτσι ώστε οι πελάτες να έχουν πρόσβαση από νωρίς και να κάνουν σχόλια.
  • Για να μπορείτε να αναγνωρίσετε αυτά τα χαρακτηριστικά ως δυνατότητες προεπισκόπησης, κάθε συνάρτηση έχει πρόθεμα ένα X. Μετά την κυκλοφορία, το X θα πρέπει να καταργηθεί από τους τύπους που χρησιμοποιούν αυτές τις συναρτήσεις και τα ορίσματα να ενημερωθούν για οποιεσδήποτε αλλαγές συναρτήσεων.
  • Αυτές οι συναρτήσεις μπορούν να χρησιμοποιηθούν μόνο με τις προσθήκης Dataverse χαμηλών απαιτήσεων χαμηλού κώδικα.

Description

Η συνάρτηση XSendAppNotification χρησιμοποιείται για την αποστολή ειδοποιήσεων εντός μιας εφαρμογής σε έναν παραλήπτη. Αυτές οι ειδοποιήσεις εμφανίζονται είτε ως αναδυόμενη ειδοποίησης είτε στο κέντρο ειδοποιήσεων για τον χρήστη της εφαρμογής. Για περισσότερες πληροφορίες, ανατρέξτε στις Αποστολή ειδοποιήσεων εντός εφαρμογής εντός εφαρμογών που καθορίζονται από το μοντέλο.

Επιπλέον, μια ειδοποίηση εντός εφαρμογής μπορεί να περιλαμβάνει μηδενικές έως πολλές ενέργειες στην κάρτα ειδοποίησης. Για να προσθέσετε ενέργειες στην κάρτα ειδοποίησης εφαρμογής, οι παρακάτω συναρτήσεις χρησιμοποιούνται ως παράμετροι στη συνάρτηση XSendAppNotification. Για περισσότερες πληροφορίες σχετικά με κάθε τύπο ενέργειας, ανατρέξτε στην περιοχή Ενέργειες ειδοποίησης.

  • XCreateUrlAction: Προσθέτει μια ενέργεια URL στο κάρτα ειδοποιήσεων.
  • XCreateSidePaneActionForDashboard: Προσθέτει μια ενέργεια πλευρικού παραθύρου που μεταβαίνει σε μια σελίδα με τύπο εντός του dashboard πλευρικού παραθύρου.
  • XCreateSidePaneActionForEntity: Προσθέτει μια ενέργεια πλευρικού παραθύρου που μεταβαίνει σε μια σελίδα με τύπο entityrecord μέσα στο πλευρικό παράθυρο.
  • XCreateSidePaneActionForEntityList: Προσθέτει μια ενέργεια πλευρικού παραθύρου που μεταβαίνει σε μια σελίδα με τύπο εντός του entitylist πλευρικού παραθύρου.
  • XCreateTeamsChatAction: Προσθέτει μια ενέργεια συνομιλίας του Teams στο κάρτα ειδοποιήσεων.

Σύνταξη

XSendAppNotification

XSendAppNotification(Τίτλος ;Παραλήπτης,Σώμα,Ενέργειες,Τύπος εικονιδίου,Τύπος αναδυόμενου σημείου; Λήξη; Προτεραιότητα)

Παράμετρος Type Απαραίτητο Description
Τϊτλος Συμβλοσειρά Όχι Ο τίτλος της ειδοποίησης εφαρμογής.
Παραλήπτης Entity Όχι Μια οντότητα του systemuser ποιος είναι ο παραλήπτης της ειδοποίησης.
Body Συμβλοσειρά όχι Το σώμα ειδοποίησης.
Ενέργειες Function όχι Ένας πίνακας των συναρτήσεων ενέργειας για την προσθήκη ενεργειών στην ειδοποίηση.
Τύπος εικονιδίου Int όχι Τιμή λίστας επιλογής για τον τύπο εικονιδίου (πληροφορίες, επιτυχία, αποτυχία, προειδοποίηση, αναφορά, προσαρμοσμένο).
Τύπος αναδυόμενης εμφάνισης Int όχι Τιμή λίστας επιλογών για τον τύπο της παρακολούθησης (χρονομετρημένη έναντι κρυφή).
Λήξη Int όχι Ο αριθμός δευτερολέπτων από τη στιγμή που πρέπει να καταργηθεί η ειδοποίηση, αν δεν έχει ήδη απορριφθεί.
Προτεραιότητα Int όχι Τιμή λίστας επιλογής για την προτεραιότητα ειδοποίησης (κανονική ή υψηλή).

XCreateUrlAction

XCreateUrlAction(Τίτλος ;URL; Στόχος πλοήγησης)

Παράμετρος Type Απαραίτητο Description
Τϊτλος Συμβλοσειρά Όχι Ο τίτλος που εμφανίζεται για την ενέργεια.
URL Συμβλοσειρά Όχι Η διεύθυνση URL που θα ανοίξει όταν επιλεγεί η ενέργεια.
Προορισμός περιήγησης Συμβλοσειρά όχι Καθορίζει πού ανοίγει η σύνδεση περιήγησης. Οι επιλογές είναι οι εξής:
  • dialog: Ανοίγει στο κεντρικό παράθυρο διαλόγου.
  • inline:Προεπιλογή. Ανοίγει στην τρέχουσα σελίδα.
  • newWindow: Ανοίγει σε νέα καρτέλα του προγράμματος περιήγησης.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Τίτλος; Αναγνωριστικό παραθύρου; Τίτλος παραθύρου; Αναγνωριστικό πίνακα εργαλείων)

Παράμετρος Type Απαραίτητο Description
Τϊτλος Συμβλοσειρά Όχι Ο τίτλος που εμφανίζεται για την ενέργεια.
Αναγνωριστικό τμήματος παραθύρου Συμβλοσειρά Όχι Το αναγνωριστικό του νέου πλαϊνού τμήματος παραθύρου.
Τίτλος τμήματος παραθύρου Συμβλοσειρά Όχι Ο τίτλος που θα εμφανίζεται για το πλαϊνό τμήμα παραθύρου.
Αναγνωριστικό πίνακα εργαλείων GUID Όχι Το αναγνωριστικό του πίνακα εργαλείων για άνοιγμα στο πλαϊνό τμήμα παραθύρου.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Τίτλος; Αναγνωριστικό παραθύρου; Τίτλος παραθύρου;Όνομα οντότητας; Αναγνωριστικό οντότητας)

Παράμετρος Type Απαραίτητο Description
Τϊτλος Συμβλοσειρά Όχι Ο τίτλος που εμφανίζεται για την ενέργεια.
Αναγνωριστικό τμήματος παραθύρου Συμβλοσειρά Όχι Το αναγνωριστικό του νέου πλαϊνού τμήματος παραθύρου.
Τίτλος τμήματος παραθύρου Συμβλοσειρά Όχι Ο τίτλος που θα εμφανίζεται για το πλαϊνό τμήμα παραθύρου.
Όνομα οντότητας Συμβλοσειρά Όχι Το λογικό όνομα της οντότητας.
Αναγνωριστικό οντότητας Συμβλοσειρά Όχι Το αναγνωριστικό της καρτέλας οντότητας για άνοιγμα στο πλαϊνό τμήμα παραθύρου.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList(Τίτλος ;Αναγνωριστικό παραθύρου; Τίτλος παραθύρου; Όνομα οντότητας)

Παράμετρος Type Απαραίτητο Description
Τϊτλος Συμβλοσειρά Όχι Ο τίτλος που εμφανίζεται για την ενέργεια.
Αναγνωριστικό τμήματος παραθύρου Συμβλοσειρά Όχι Το αναγνωριστικό του νέου πλαϊνού τμήματος παραθύρου.
Τίτλος τμήματος παραθύρου Συμβλοσειρά Όχι Ο τίτλος που θα εμφανίζεται για το πλαϊνό τμήμα παραθύρου.
Όνομα οντότητας Συμβλοσειρά Όχι Το λογικό όνομα της οντότητας που θα ανοίξει ως λίστα στο πλαϊνό τμήμα παραθύρου.

XCreateTeamsChatAction

XCreateTeamsChatAction(Τίτλος ;Αναγνωριστικό συνομιλίας; Αναγνωριστικά μέλους; Αναγνωριστικό εγγραφής; Όνομα οντότητας; Αρχικό μήνυμα)

Παράμετρος Type Απαραίτητο Description
Τϊτλος Συμβλοσειρά Όχι Ο τίτλος που εμφανίζεται για την ενέργεια.
Αναγνωριστικό συνομιλίας Συμβλοσειρά όχι Αν ανοίξετε μια υπάρχουσα συνομιλία, θα ανοίξει το αναγνωριστικό της περιόδου λειτουργίας συνομιλίας.
Αναγνωριστικά μελών GUID όχι Εάν δημιουργείτε μια νέα συνομιλία, ένας πίνακας των τιμών του αναγνωριστικού αντικειμένου Microsoft Entra των συμμετεχόντων θα συμπεριληφθεί στη συνομιλία.
Αναγνωριστικό καρτέλας GUID όχι Αν συνδέεται με μια καρτέλα του Dynamics 365, το αναγνωριστικό της καρτέλας με την οποία πρέπει να συνδεθεί η συνομιλία.
Όνομα οντότητας Συμβλοσειρά όχι Αν συνδέεται με μια καρτέλα του Dynamics 365, το λογικό όνομα της οντότητας της καρτέλας με την οποία πρέπει να συνδεθεί η συνομιλία.
Αρχικό μήνυμα Συμβλοσειρά όχι Ένα εισαγωγικό μήνυμα της νέας συνομιλίας.

Παραδείγματα

Ειδοποίηση εντός εφαρμογής με τίτλο, παραλήπτη και σώμα

Τα παρακάτω στέλνουν μια απλή ειδοποίηση εντός εφαρμογής σε έναν παραλήπτη με τίτλο και σώμα. Δεν περιλαμβάνει ενέργειες και χρησιμοποιεί προεπιλεγμένες τιμές για όλες τις άλλες παραμέτρους.

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

Ειδοποίηση εντός εφαρμογής με δύο ενέργειες

Το παρακάτω παράδειγμα τύπου μπορεί να χρησιμοποιηθεί με μια αυτοματοποιημένη προσθήκη όταν δημιουργείται μια νέα καρτέλα εργασίας. Ο τύπος έχει σχεδιαστεί για να στέλνει μια ειδοποίηση εντός εφαρμογής στον κάτοχο της καρτέλας εργασίας. Η κάρτα ειδοποιήσεων περιέχει δύο ενέργειες τις οποίες μπορεί να κάνει ο κάτοχος:

  • Μια ενέργεια πλαϊνού τμήματος παραθύρου, ανοίγει τη νέα καρτέλα εργασίας σε ένα πλαϊνό τμήμα παραθύρου.
  • Μια ενέργεια συνομιλίας Teams, προετοιμάζει μια συνομιλία Teams με τον κάτοχο της καρτέλας λογαριασμού που έχει εκχωρηθεί ως καρτέλα πίνακα Σχετικά με για τη νέα εργασία. Είναι σημαντικό να σημειωθεί ότι αυτό προϋποθέτει ότι έχει επιλεγεί μια καρτέλα λογαριασμού στο πεδίο εργασίας.
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
		)
	]
)