Προσθήκη εικονιδίου προειδοποίησης εμφάνισης στην απεικόνισή σας
Σε μια απεικόνιση Power BI, ένα εικονίδιο προειδοποίησης προβολής μπορεί να ειδοποιήσει τον χρήστη για ένα πιθανό πρόβλημα ή ένα σφάλμα. Η εμφάνιση εικονιδίων προειδοποίησης μπορεί να είναι χρήσιμη σε πολλές περιπτώσεις, όπως:
Μια απεικόνιση χάρτη μπορεί να εμφανίσει ένα εικονίδιο προειδοποίησης όταν οι τιμές βρίσκονται εκτός της έγκυρης περιοχής γεωγραφικού πλάτους ή μήκους.
Μια απεικόνιση γραφήματος πίτας μπορεί να εμφανίσει ένα εικονίδιο προειδοποίησης όταν εμφανίζει αρνητικές τιμές που αναμειγνύονται με τις θετικές.
Ένα καρτεσιανό γράφημα μπορεί να εμφανίσει ένα εικονίδιο προειδοποίησης όταν υπολογίζονται τιμές άπειρου. Για παράδειγμα, εάν το Y είναι μηδέν, κατά τη διαίρεση του X με το Y, το αποτέλεσμα είναι άπειρο.
Όταν εμφανιστεί το εικονίδιο, ο χρήστης μπορεί να τοποθετήσει τον δείκτη επάνω του για να δει τον τίτλο του προειδοποιητικού μηνύματος.
Όταν ο χρήστης επιλέγει το εικονίδιο προειδοποίησης, εμφανίζεται ένα μήνυμα που περιγράφει το πρόβλημα σε ένα αναδυόμενο παράθυρο.
Δημιουργία εικονιδίου προειδοποίησης
Μπορείτε να δημιουργήσετε ένα εικονίδιο προειδοποίησης με ένα προσαρμοσμένο μήνυμα για μια προσαρμοσμένη απεικόνιση. Η απόφαση για την ενεργοποίηση του εικονιδίου προειδοποίησης εξαρτάται από εσάς. Όπως δείχνουν αυτά τα παραδείγματα, η απεικόνιση συνεχίζει να λειτουργεί όταν εμφανίζεται το εικονίδιο προειδοποίησης.
Προσθήκη κλήσης στη μέθοδο ενημέρωσης
Για να προσθέσετε ένα εικονίδιο προειδοποίησης εμφάνισης στην απεικόνισή σας, καλέστε τη displayWarningIcon μέθοδο . Η μέθοδος είναι μέρος του και εκτίθεται με χρήση του IVisualHost powerbi-visuals-api.
Προσθέστε την ακόλουθη εισαγωγή στο αρχείο σας:
import powerbiVisualsApi from "powerbi-visuals-api";
Αφού προσθέσετε την εισαγωγή, προσθέστε μια συνθήκη που καθορίζει πότε θα εμφανίζεται το εικονίδιο προειδοποίησης. Χρησιμοποιήστε τα παραδείγματα σε αυτό το άρθρο για να προβάλετε δύο προαιρετικές συνθήκες.
Παράδειγμα 1: Έλεγχος συμβατότητας γλώσσας
Η τοπική προσαρμογή χρησιμοποιείται για την εμφάνιση απεικονίσεων στη μητρική γλώσσα του πελάτη, το οποίο αποτρέπει τις ρυθμίσεις του λειτουργικού συστήματος.
Σε αυτό το παράδειγμα, η απεικόνιση συγκρίνει τη γλώσσα της απεικόνισης, η οποία έχει οριστεί σε Αγγλικά Η.Π.Α., με τη γλώσσα του λειτουργικού συστήματος. Εάν οι γλώσσες δεν συμφωνούν, εμφανίζεται το εικονίδιο προειδοποίησης.
if (this.locale != 'en-US') {
this.host.displayWarningIcon('Language inconsistency', 'This visual supports only US English. For the visual to work as expected, set your browser's language to US English.');
}
Παράδειγμα 2: Σύγκριση χρωμάτων σε γειτονικές στήλες
Σε αυτό το παράδειγμα, το εικονίδιο προειδοποίησης εμφανίζεται όταν δύο στήλες που βρίσκονται η μία δίπλα στην άλλη έχουν το ίδιο χρώμα.
Η getColumnColorByIndex μέθοδος επαναλαμβάνεται σε όλες τις στήλες. Εάν δύο γειτονικές στήλες έχουν το ίδιο χρώμα, εμφανίζεται ένα εικονίδιο προειδοποίησης.
let category = options.dataViews[0].categorical.categories[0];
let dataValue = options.dataViews[0].categorical.values[0];
let colorPalette = this.host.colorPalette;
for (let i = 0, len = Math.max(category.values.length, dataValue.values.length); i < len-1; i++) {
const color1: string = getColumnColorByIndex(category, i, colorPalette);
const color2: string = getColumnColorByIndex(category, i+1, colorPalette);
if (color1 == color2) {
this.host.displayWarningIcon('Adjacent columns have the same color.', 'Columns that are next to each other have the same color. To change a column's color, use the data colors option in the Format tab.');
}
}
Ζητήματα προς εξέταση και περιορισμοί
Ορισμένα σφάλματα και προειδοποιήσεις δεν προκαλούνται από την απεικόνιση. Για παράδειγμα, οι τιμές Πάρα πολλές. Η μη εμφάνιση όλων των σφαλμάτων δεδομένων προκύπτει από την Υπηρεσία Power BI. Αυτά τα σφάλματα και οι προειδοποιήσεις μεταδίδονται προηγουμένως στις κλήσεις της απεικόνισής σας. Έχουν προτεραιότητα έναντι σφαλμάτων που προέρχονται από τον κώδικα της απεικόνισής σας. Εάν παρουσιαστεί σφάλμα κατά τη φόρτωση των δεδομένων, προτού εκτελεστεί ο κώδικας της απεικόνισης και ικανοποιηθεί η συνθήκη εικονιδίου προειδοποίησης, η απεικόνιση εμφανίζει αυτό το σφάλμα αντί για το σφάλμα εικονιδίου προειδοποίησης.
Η προειδοποίηση εμφάνισης καταργείται κατά τη διάρκεια κάθε απόδοσης της απεικόνισης, για παράδειγμα, όταν μεταφέρονται νέα δεδομένα στην απεικόνιση. Η μέθοδος της απεικόνισης
update()καλείται μετά την απόδοση της απεικόνισης. Εάν η προειδοποίηση απεικόνισης ενεργοποιείται με βάση μια συνθήκη που είναι ενεργοποιημένη στη μέθοδο ενημέρωσης, κάθε φορά που αποδίδεται η απεικόνιση, εάν ικανοποιείται η συνθήκη, η απεικόνιση εμφανίζει ξανά την προειδοποίηση.Η αλλαγή μεγέθους μιας απεικόνισης δεν επηρεάζει το εικονίδιο προειδοποίησης.
Οι ακόλουθοι περιορισμοί αναφέρονται στο κείμενο εικονιδίου εμφάνισης:
Το μέγιστο μήκος του τίτλου είναι 70 χαρακτήρες
Το μέγιστο μήκος του κειμένου είναι 2.000 χαρακτήρες
Το κείμενο εμφανίζεται μόνο ως απλό κείμενο