Στοιχείο ελέγχου Πλακίδιο Power BI στο Power Apps

Ένα στοιχείο ελέγχου που εμφανίζει ένα πλακίδιο Power BI μέσα σε μια εφαρμογή.

Δεν έχετε το Power BI; Εγγραφή.

Περιγραφή

Επωφεληθείτε της υπάρχουσας ανάλυσης και αναφοράς δεδομένων εμφανίζοντας τα πλακίδια Power BI μέσα στις εφαρμογές σας. Καθορίστε το πλακίδιο που θέλετε να εμφανίζεται ορίζοντας τις ιδιότητές του Workspace, Dashboard και Tile στην καρτέλα Data του πίνακα επιλογών.

Σημείωση

• Το στοιχείο ελέγχου Πλακίδιο Power BI δεν είναι διαθέσιμο σε περιβάλλοντα GCC High και DoD.
• Το στοιχείο ελέγχου Πλακίδιο Power BI δεν είναι διαθέσιμο στην Κίνα.
• Για τις απαιτήσεις εκχώρησης αδειών χρήσης κατά την ενσωμάτωση του πλακιδίου Power BI ανατρέξτε στο θέμα Παραχώρηση άδειας χρήσης.

Κοινή χρήση και ασφάλεια

Όταν κάνετε κοινή χρήση μιας εφαρμογής που περιέχει περιεχόμενο Power BI θα πρέπει να κάνετε κοινή χρήση όχι μόνο της ίδιας της εφαρμογής, αλλά και του Πίνακα εργαλείων από όπου προέρχεται το πλακίδιο. Διαφορετικά, το περιεχόμενο του Power BI δεν θα εμφανίζεται ακόμη και για χρήστες που ανοίγουν την εφαρμογή. Οι εφαρμογές που περιέχουν περιεχόμενο Power BI συμμορφώνονται με τα δικαιώματα για αυτό το περιεχόμενο.

Επιδόσεις

Δεν συνιστάται να έχετε περισσότερα από τρία πλακίδια Power BI φορτωμένα ταυτόχρονα μέσα σε μια εφαρμογή. Μπορείτε να ελέγξετε τη φόρτωση και κατάργηση φόρτωσης πλακιδίων ορίζοντας την ιδιότητα LoadPowerBIContent.

Επιλογές ενσωμάτωσης

Η ενσωμάτωση διαφέρει μεταξύ των εκδόσεων του Power BI API. Λόγω του νέου σχήματος ελέγχου ταυτότητας API Power BI, η πρόσβαση στο πλακίδιό σας ενδέχεται να μην είναι δυνατή μέσω φορητής συσκευής ή μέσα σε άλλα ενσωματωμένα σενάρια (Teams ή SharePoint).

Μπορείτε να ελέγξετε τη χρήση της έκδοσης API χρησιμοποιώντας την ιδιότητα AllowNewAPI. Για περισσότερες πληροφορίες δείτε τις Ιδιότητες κλειδιά.

Τιμή ιδιότητας AllowNewAPI	Συμπεριφορά
Ενεργή	Μπορείτε να ενσωματώσετε έναν πίνακα εργαλείων, μια αναφορά ή ένα πλακίδιο, λαμβάνοντας το στοιχείο Ενσωμάτωση διεύθυνσης URL από το Power BI και καθιστώντας το τιμή TileUrl.
Ανενεργή	Μπορείτε να ενσωματώσετε έναν πλακίδιο πίνακα εργαλείων είτε με το Ενσωμάτωση διεύθυνσης URL και καθιστώντας το τιμή TileUrl ή χρησιμοποιώντας το παρεχόμενο γραφικό περιβάλλον εργασίας.

Σημείωση

Η ενσωμάτωση μιας διεύθυνσης URL Power BI (για παράδειγμα, σε ένα IFrame) Power BI δεν υποστηρίζεται σε φορητή συσκευή Power Apps, καθώς ο χειρισμός της αίτησης για διεύθυνση URL δεν γίνεται από τον χειριστή της φορητής συσκευής.

Φιλτράρισμα

Το φιλτράρισμα διαφέρει μεταξύ των εκδόσεων του Power BI API. Ανατρέξτε στις κατάλληλες ενότητες παρακάτω, ανάλογα με τον τρόπο ρύθμισης παραμέτρων του στοιχείου ελέγχου.

Κατά τη χρήση του νέου API για κλήση της υπηρεσίας Power BI

Όταν η ιδιότητα AllowNewAPI έχει οριστεί σε "True", χρησιμοποιείτε νέο API για την κλήση της υπηρεσίας Power BI. Για περισσότερες πληροφορίες, δείτε Φιλτράρετε μια αναφορά χρησιμοποιώντας τις παραμέτρους συμβολοσειράς ερωτήματος στη διεύθυνση URL.

Κατά τη χρήση του αρχικού API για κλήση της υπηρεσίας Power BI

Όταν η ιδιότητα AllowNewAPI έχει οριστεί σε "False", χρησιμοποιείτε το αρχικό API για την κλήση της υπηρεσίας Power BI. Σε αυτήν την περίπτωση, με τη μεταβίαση μίας παραμέτρου από την εφαρμογή, μπορείτε να φιλτράρετε τα αποτελέσματα που εμφανίζονται σε ένα πλακίδιο του Power BI. Ωστόσο, υποστηρίζονται μόνο οι τιμές συμβολοσειράς και ο τελεστής ίσον και το φίλτρο ενδέχεται να μην λειτουργεί εάν το όνομα του πίνακα ή το όνομα της στήλης περιέχει κενά διαστήματα.

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

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

Σε αυτήν την τιμή, προσαρτήστε αυτήν τη σύνταξη:

&$filter=<TableName>/<ColumnName> eq '<Value>'

Για παράδειγμα, χρησιμοποιώντας μια τιμή από ένα πλαίσιο λίστας:

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

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

• Μόνο ένα φίλτρο μπορεί να εφαρμοστεί.
• Υποστηρίζεται μόνο ο τελεστής eq.
• Ο τύπος πεδίου πρέπει να είναι συμβολοσειρά.
• Το φιλτράρισμα είναι διαθέσιμο μόνο σε καρφιτσωμένα πλακίδια απεικόνισης. Δεν υποστηρίζεται για αναφορές που έχουν καρφιτσωθεί.
• Δεν είναι δυνατό το φιλτράρισμα των οπτικών δεσμών ενεργειών R και Python.

Μπορείτε να χρησιμοποιήσετε υπολογιζόμενα πεδία στην αναφορά Power BI για να μετατρέψετε άλλους τύπους τιμών σε συμβολοσειρά ή να συνδυάσετε πολλά πεδία σε ένα.

Ιδιότητες κλειδιού

AllowNewAPI - Αν θα χρησιμοποιείτε το νέο API όταν καλείτε την υπηρεσία Power BI. Ο ορισμός της τιμής σε Αληθές θα επιτρέψει τη χρήση του νέου API του Power BI (το οποίο δεν υποστηρίζεται σε σενάρια φορητής συσκευής και σε ορισμένα ενσωματωμένα σενάρια, αλλά επιτρέπει πιο σύνθετο φιλτράρισμα). Το Ψευδές θα χρησιμοποιήσει το αρχικό API. Η προεπιλεγμένη τιμή είναι ψευδές.

Dashboard – Ο πίνακας εργαλείων του Power BI από τον οποίο προέρχεται το πλακίδιο.

LoadPowerBIContent – Όταν οριστεί σε Αληθές, το περιεχόμενο του Power BI φορτώνεται και εμφανίζεται. Όταν ορίζεται σε Ψευδές, καταργείται η φόρτωση του περιεχομένου του Power BI και με αυτόν τον τρόπο απελευθερώνεται μνήμη και βελτιστοποιούνται οι επιδόσεις.

PowerBIInteractions - Όταν οριστεί σε True, μπορείτε να αλληλεπιδράσετε με το περιεχόμενο Power BI αλλά το συμβάν Power Apps OnSelect δεν θα ενεργοποιηθεί. Όταν οριστεί σε False, το πλακίδιο δεν μπορεί να αλληλεπιδρά αλλά το συμβάν Power Apps OnSelect θα ενεργοποιηθεί μόλις επιλεγεί το πλακίδιο.

Tile – Το όνομα του Πλακιδίου Power BI που θέλετε να εμφανίσετε.

Workspace – Ο χώρος εργασίας του Power BI από τον οποίο προέρχεται το πλακίδιο.

Πρόσθετες ιδιότητες

BorderColor – Το χρώμα περιγράμματος ενός στοιχείου ελέγχου.

BorderStyle – Ορίζει εάν το περίγραμμα ενός στοιχείου ελέγχου είναι Συνεχές, Διακεκομμένο, Διάστικτο ή Κανένα.

BorderThickness – Το πάχος του περιγράμματος ενός στοιχείου ελέγχου.

DisplayMode – Ορίζει εάν το στοιχείο ελέγχου επιτρέπει την εισαγωγή δεδομένων από τον χρήστη (Edit), εμφανίζει μόνο δεδομένα (View) ή είναι ανενεργό (Disabled).

Height – Η απόσταση μεταξύ του επάνω και κάτω άκρου ενός στοιχείου ελέγχου.

OnSelect – Ενέργειες προς εκτέλεση όταν ο χρήστης πατήσει ή επιλέξει ένα στοιχείο ελέγχου. Από προεπιλογή, ανοίγει η αναφορά του Power BI που είναι συσχετισμένη με το πλακίδιο.

TileUrl – Η διεύθυνση URL μέσω της οποίας πραγματοποιείται αίτηση του πλακιδίου από την υπηρεσία Power BI. Για να προσθέσετε το φιλτράρισμα συμβολοσειράς ερωτήματος στη διεύθυνση URL, ανατρέξτε στην ενότητα φιλτράρισμα παραπάνω.

Visible – Εάν εμφανίζεται ή είναι κρυφό ένα στοιχείο ελέγχου.

Width – Η απόσταση μεταξύ του αριστερού και δεξιού άκρου ενός στοιχείου ελέγχου.

X – Η απόσταση μεταξύ του αριστερού άκρου ενός στοιχείου ελέγχου και του αριστερού άκρου του γονικού περιέκτη του (οθόνη—εάν δεν υπάρχει γονικός περιέκτης).

Y – Η απόσταση μεταξύ του επάνω άκρου ενός στοιχείου ελέγχου και του επάνω άκρου του γονικού του περιέκτη (οθόνη—εάν δεν υπάρχει γονικός περιέκτης).

Παράδειγμα

1. Στην καρτέλα Εισαγωγή, ανοίξτε το μενού Γραφήματα και μετά προσθέστε το στοιχείο ελέγχου Πλακίδιο Power BI.

   Δεν γνωρίζετε πώς να προσθέσετε και ρυθμίσετε τις παραμέτρους ενός στοιχείου ελέγχου;

2. Στην καρτέλα Δεδομένα του πίνακα επιλογών, επιλέξτε Ο χώρος εργασίας μου για τη ρύθμιση Χώρος εργασίας.

3. Επιλέξτε έναν πίνακα εργαλείων από τη λίστα των πινάκων εργαλείων και, στη συνέχεια, επιλέξτε ένα πλακίδιο από τη λίστα των πλακιδίων.

   Το στοιχείο ελέγχου αποδίδει το πλακίδιο Power BI.

Οδηγίες προσβασιμότητας

Το Πλακίδιο Power BI είναι απλώς ένας περιέκτης για το περιεχόμενο Power BI. Μάθετε περισσότερα σχετικά με τη δημιουργία προσβάσιμου περιεχομένου με αυτές τις Συμβουλές για την προσβασιμότητα στο Power BI.

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

Σημείωση

Μπορείτε να μας πείτε ποια γλώσσα προτιμάτε για την τεκμηρίωση; Πάρτε μέρος σε μια σύντομη έρευνα. (σημειώνεται ότι αυτή η έρευνα είναι στα Αγγλικά)

Η έρευνα θα διαρκέσει περίπου επτά λεπτά. Δεν συλλέγονται προσωπικά δεδομένα (δήλωση προστασίας προσωπικών δεδομένων).