addNotification (αναφορά API προγράμματος-πελάτη)

Εμφανίζει μια ειδοποίηση σφάλματος ή πρότασης για ένα στοιχείο ελέγχου και σας επιτρέπει να καθορίσετε ενέργειες για εκτέλεση με βάση την ειδοποίηση. Όταν καθορίζετε έναν τύπο σφάλματος ειδοποίησης, εμφανίζεται ένα κόκκινο εικονίδιο "X" δίπλα στο στοιχείο ελέγχου. Όταν καθορίζετε έναν τύπο πρότασης ειδοποίησης, εμφανίζεται ένα εικονίδιο "i" δίπλα στο στοιχείο ελέγχου. Στα προγράμματα-πελάτες του Dynamics 365 για κινητές συσκευές, πατώντας το εικονίδιο θα εμφανιστεί το μήνυμα και θα σας επιτρέψει να εκτελέσετε τη ρυθμισμένη ενέργεια κάνοντας κλικ στο κουμπί Εφαρμογή ή κλείστε το μήνυμα.

Υποστηριζόμενοι τύποι στοιχείων ελέγχου

Όλοι

Σύνταξη

formContext.getControl(arg).addNotification(notification);

Παράμετροι

Ονομασία	Δακτυλογραφώ	Απαραίτητο	Περιγραφή
notification	Αντικείμενο	Όχι	Η ειδοποίηση που θα προστεθεί. Εμφάνιση notification παραμέτρου

notification παράμετρος

Η notification παράμετρος αποδέχεται ένα αντικείμενο με τις ακόλουθες ιδιότητες

Ονομασία	Δακτυλογραφώ	Απαραίτητο	Περιγραφή
actions	Πίνακας αντικειμένων	όχι	Εμφάνιση actions ιδιότητας
messages	Πίνακας συμβολοσειρών	Όχι	Το μήνυμα που θα εμφανίζεται στην ειδοποίηση. Στην τρέχουσα έκδοση, θα εμφανίζεται μόνο το πρώτο μήνυμα που καθορίζεται σε αυτόν τον πίνακα. Η συμβολοσειρά που καθορίζετε εδώ εμφανίζεται με έντονη γραφή στην ειδοποίηση και συνήθως χρησιμοποιείται για τον τίτλο ή το θέμα της ειδοποίησης. Θα πρέπει να περιορίσετε το μήνυμά σας σε 50 χαρακτήρες για βέλτιστη εμπειρία χρήστη.
notificationLevel	Συμβλοσειρά	Όχι	Καθορίζει τον τύπο της ειδοποίησης. Οι έγκυρες τιμές είναι ERROR ή RECOMMENDATION.
uniqueId	Συμβλοσειρά	Όχι	Το αναγνωριστικό που θα χρησιμοποιηθεί για την εκκαθάριση αυτής της ειδοποίησης όταν χρησιμοποιείτε τη μέθοδο clearNotification.

actions ιδιοκτησία

Η actions ιδιότητα περιέχει έναν πίνακα αντικειμένων με τις ακόλουθες ιδιότητες:

Ονομασία	Δακτυλογραφώ	Απαραίτητο	Περιγραφή
message	Συμβλοσειρά	όχι	Το μήνυμα σώματος της ειδοποίησης που θα εμφανίζεται στον χρήστη. Περιορίστε το μήνυμά σας σε 100 χαρακτήρες για βέλτιστη εμπειρία χρήστη.
actions	Πίνακας συναρτήσεων	όχι	Οι αντίστοιχες ενέργειες για το μήνυμα.

Τιμή επιστροφής

Τύπος: Δυαδική τιμή

Περιγραφή: Υποδεικνύει εάν η μέθοδος ολοκληρώθηκε με επιτυχία.

Παρατηρήσεις

Στο πρόγραμμα-πελάτη web, η μέθοδος addNotification εμφανίζει μια ειδοποίηση με τα μηνύματα που καθορίσατε και δύο τυπικά κουμπιά: Εφαρμογή και Κλείσιμο. Αν κάνετε κλικ στην επιλογή Εφαρμογή , εκτελείται η ενέργεια που καθορίζετε. Εάν κάνετε κλικ στην επιλογή Κλείσιμο , κλείνει το μήνυμα ειδοποίησης.

Σε ενοποιημένη διασύνδεση:

• Δεν υπάρχει κουμπί Κλείσιμο .
• Το κουμπί Εφαρμογή εμφανίζεται μόνο όταν το επίπεδο ειδοποίησης έχει οριστεί σε RECOMMENDATION, όχι ERROR.

Παράδειγμα

Το παρακάτω δείγμα κώδικα εμφανίζει μια ειδοποίηση στη στήλη Όνομα λογαριασμού της φόρμας λογαριασμού για να ορίσετε το Σύμβολο επιλογής εάν η στήλη Όνομα λογαριασμού περιέχει τη "Microsoft" και το σύμβολο ticker δεν έχει οριστεί ήδη σε "MSFT". Κάνοντας κλικ στην επιλογή Εφαρμογή στην ειδοποίηση θα οριστεί η στήλη Σύμβολο ticker σε "MSFT".

function addTickerSymbolRecommendation(executionContext) {
    var formContext = executionContext.getFormContext();
    var myControl = formContext.getControl('name');
    var accountName = formContext.data.entity.attributes.get('name');
    var tickerSymbol = formContext.data.entity.attributes.get('tickersymbol');

    if (accountName.getValue() == 'Microsoft' && tickerSymbol.getValue() != 'MSFT') {
        var actionCollection = {
            message: 'Set the Ticker Symbol to MSFT?',
            actions: null
        };

        actionCollection.actions = [function () {
            tickerSymbol.setValue('MSFT');
            myControl.clearNotification('my_unique_id');
        }];

        myControl.addNotification({
            messages: ['Set Ticker Symbol'],
            notificationLevel: 'RECOMMENDATION',
            uniqueId: 'my_unique_id',
            actions: [actionCollection]
        });
    }
    else
        console.log("Notification not set");
}

Με αυτόν τον τρόπο εμφανίζεται η ειδοποίηση στις εφαρμογές βάσει μοντέλου:

Σχετικά άρθρα

clearNotification
ορισμός σχολίων