Ενσωμάτωση αναφοράς σε ασφαλή πύλη ή τοποθεσία Web

Με την επιλογή Ενσωμάτωση για αναφορές Power BI, μπορείτε εύκολα και με ασφάλεια να ενσωματώσετε αναφορές σε εσωτερικές πύλες Web. Αυτές οι πύλες μπορούν να βασίζονται στο cloud ή να φιλοξενούνται σε εσωτερική εγκατάσταση, όπως το SharePoint 2019. Οι ενσωματωμένες αναφορές τηρούν όλα τα δικαιώματα και την ασφάλεια δεδομένων στοιχείων μέσω της ασφάλειας σε επίπεδο γραμμών (RLS) και της ασφάλειας σε επίπεδο αντικειμένου μοντέλου σε μορφή πίνακα (OLS) των Υπηρεσιών ανάλυσης. Παρέχουν ενσωμάτωση χωρίς κώδικα σε οποιαδήποτε πύλη που αποδέχεται μια διεύθυνση URL ή iframe.

Η επιλογή Ενσωμάτωση υποστηρίζει φίλτρα διευθύνσεων URL και ρυθμίσεις διευθύνσεων URL. Σας επιτρέπει την ενοποίηση με πύλες χρησιμοποιώντας μια προσέγγιση με λίγο κώδικα που απαιτεί μόνο βασικές γνώσεις HTML και JavaScript.

Πώς μπορείτε να ενσωματώσετε αναφορές Power BI σε πύλες

  1. Ανοίξτε μια αναφορά στον Υπηρεσία Power BI.

  2. Στο μενού Αρχείο, επιλέξτε Ενσωμάτωση τοποθεσίας web ή πύλης αναφοράς>.

    Στιγμιότυπο οθόνης της επιλογής

  3. Στο παράθυρο διαλόγου Ασφαλής κώδικας ενσωμάτωσης, επιλέξτε την τιμή στην περιοχή Ακολουθεί μια σύνδεση που μπορείτε να χρησιμοποιήσετε για να ενσωματώσετε αυτό το περιεχόμενο. Εναλλακτικά, εάν θέλετε να χρησιμοποιήσετε ένα iframe σε ένα ιστολόγιο ή μια τοποθεσία Web, επιλέξτε την τιμή στην περιοχή HTML που μπορείτε να επικολλήσετε σε μια τοποθεσία Web.

    Στιγμιότυπο οθόνης του πλαισίου διαλόγου επιλογής

  4. Εάν ένας χρήστης ανοίξει μια διεύθυνση URL αναφοράς απευθείας ή μία που είναι ενσωματωμένη σε μια πύλη Web, η πρόσβαση στην αναφορά απαιτεί έλεγχο ταυτότητας. Η ακόλουθη οθόνη εμφανίζεται εάν ένας χρήστης δεν έχει εισέλθει στο Power BI στην περίοδο λειτουργίας του προγράμματος περιήγησής του. Όταν επιλέξει Είσοδος, θα πρέπει να ανοίξει ένα νέο παράθυρο προγράμματος περιήγησης ή καρτέλα. Ζητήστε από τους χρήστες να ελέγξουν αν υπάρχει αποκλεισμός αναδυόμενων παραθύρων, εάν δεν τους ζητηθεί να εισέλθουν.

    Στιγμιότυπο οθόνης της σελίδας εισόδου power BI που εμφανίζει είσοδο για να προβάλετε αυτό το παράθυρο διαλόγου αναφοράς.

  5. Αφού ο χρήστης έχει εισέλθει, η αναφορά ανοίγει, εμφανίζοντας τα δεδομένα και επιτρέποντας την περιήγηση στη σελίδα και τη ρύθμιση φιλτραρίσματος. Μόνο χρήστες με δικαίωμα προβολής μπορούν να δουν την αναφορά στο Power BI. Εφαρμόζονται επίσης όλοι οι κανόνες ασφάλειας σε επίπεδο γραμμών (RLS ). Οι χρήστες πρέπει να διαθέτουν την σωστή άδεια χρήσης. Χρειάζονται μια άδεια χρήσης Power BI Pro ή Premium ανά χρήστη (PPU) ή το περιεχόμενο πρέπει να βρίσκεται σε έναν χώρο εργασίας που βρίσκεται σε εκχωρημένους πόρους Power BI Premium. Οι χρήστες πρέπει να εισέρχονται κάθε φορά που ανοίγουν ένα νέο παράθυρο προγράμματος περιήγησης. Ωστόσο, μετά την είσοδο, άλλες αναφορές φορτώνονται αυτόματα.

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

  6. Όταν χρησιμοποιείτε ένα iframe, ίσως χρειαστεί να επεξεργαστείτε το ύψος και τις τιμές πλάτους ώστε να χωράει στην ιστοσελίδα της πύλης σας.

    Στιγμιότυπο οθόνης του πλαισίου διαλόγου se height και width

Εκχώρηση πρόσβασης αναφοράς

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

Στο Υπηρεσία Power BI, μπορείτε να κάνετε κοινή χρήση ενσωματωμένων αναφορών με χρήστες που απαιτούν πρόσβαση. Εάν χρησιμοποιείτε μια Ομάδα Microsoft 365, μπορείτε να καταχωρήσετε τον χρήστη ως μέλος του χώρου εργασίας.

Παραχώρηση αδειών χρήσης

Για να προβάλετε την ενσωματωμένη αναφορά, χρειάζεστε μια άδεια χρήσης Power BI Pro ή Premium ανά χρήστη (PPU). Εναλλακτικά, το περιεχόμενο πρέπει να βρίσκεται σε έναν χώρο εργασίας που βρίσκεται σε εκχωρημένους πόρους Power BI Premium (SKU EM ή P).

Προσαρμόστε την εμπειρία ενσωμάτωσης χρησιμοποιώντας ρυθμίσεις διεύθυνσης URL

Μπορείτε να προσαρμόσετε την εμπειρία χρήστη χρησιμοποιώντας τις ρυθμίσεις εισόδου της διεύθυνσης URL ενσωμάτωσης. Στο παρεχόμενο iframe, μπορείτε να ενημερώσετε τις ρυθμίσεις src της διεύθυνσης URL.

Ιδιότητα Περιγραφή
pageName Μπορείτε να χρησιμοποιήσετε την παράμετρο συμβολοσειράς ερωτήματος pageName για να ορίσετε ποια σελίδα αναφοράς θα ανοίγει. Μπορείτε να βρείτε αυτή την τιμή στο τέλος της διεύθυνσης URL της αναφοράς όταν προβάλετε μια αναφορά στο Υπηρεσία Power BI, όπως φαίνεται παρακάτω σε αυτό το άρθρο.
Φίλτρα διεύθυνσης URL Μπορείτε να χρησιμοποιήσετε φίλτρα διεύθυνσης URL στη διεύθυνση URL ενσωμάτωσης που λάβατε από το περιβάλλον εργασίας χρήστη του Power BI για να φιλτράρετε το περιεχόμενο ενσωμάτωσης. Με αυτόν τον τρόπο, μπορείτε να δημιουργήσετε ενοποιήσεις με λίγο κώδικα μόνο με βασική εμπειρία HTML και JavaScript.

Ορισμός της σελίδας που ανοίγει για μια ενσωματωμένη αναφορά

Μπορείτε να βρείτε την τιμή pageName στο τέλος της διεύθυνσης URL της αναφοράς όταν προβάλλετε μια αναφορά στον Υπηρεσία Power BI.

  1. Ανοίξτε την αναφορά από το Υπηρεσία Power BI στο πρόγραμμα περιήγησής σας και, στη συνέχεια, αντιγράψτε τη διεύθυνση URL της γραμμής διευθύνσεων.

    Στιγμιότυπο οθόνης της ενότητας αναφοράς.

  2. Προσαρτήστε την ιδιότητα pageName και την τιμή της στο τέλος της διεύθυνσης URL.

    Στιγμιότυπο οθόνης προσάρτησης της ρύθμισης pageName στη διεύθυνση URL με επισημασμένη τη pageName=ReportSection 2.

Φιλτράρισμα περιεχομένου αναφοράς με χρήση φίλτρων διεύθυνσης URL

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

Ο συνδυασμός της pageName και των φίλτρων διεύθυνσης URL μπορεί να είναι ισχυρός. Μπορείτε να δημιουργήσετε εμπειρίες χρησιμοποιώντας βασική HTML και JavaScript.

Για παράδειγμα, δείτε ένα κουμπί που μπορείτε να προσθέσετε σε μια σελίδα HTML:

<button class="textLarge" onclick='show("ReportSection", "Energy");' style="display: inline-block;">Show Energy</button>

Όταν επιλεγεί, το κουμπί καλεί μια συνάρτηση για να ενημερώσει το iframe με μια ενημερωμένη διεύθυνση URL, η οποία περιλαμβάνει το φίλτρο για τον κλάδο της ενέργειας.

function show(pageName, filterValue)

{

var newUrl = baseUrl + "&pageName=" + pageName;

if(null != filterValue && "" != filterValue)

{

newUrl += "&$filter=Industries/Industry eq '" + filterValue + "'";

}

//Assumes there's an iFrame on the page with id="iFrame"

var report = document.getElementById("iFrame")

report.src = newUrl;

}

Στιγμιότυπο οθόνης του Φίλτρου με φίλτρο $ που ισούται με τις κλαδικές καθέτους του κλάδου e Energy με επισήμανση.

Μπορείτε να προσθέσετε όσα κουμπιά θέλετε για να δημιουργήσετε μια προσαρμοσμένη εμπειρία με λίγο κώδικα.

Ζητήματα προς εξέταση και περιορισμοί

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

  • Η επιλογή ασφαλούς ενσωμάτωσης λειτουργεί για αναφορές που δημοσιεύονται στο Υπηρεσία Power BI.

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

  • Ο χρήστης πρέπει να εισέρχεται για να προβάλει την αναφορά κάθε φορά που ανοίγει ένα νέο παράθυρο προγράμματος περιήγησης.

  • Για τον έλεγχο ταυτότητας, οι χρήστες πρέπει να έχουν ενεργοποιημένα τα αναδυόμενα παράθυρα.

  • Εάν οι χρήστες έχουν αποκτήσει επιτυχώς πρόσβαση σε αναφορές στο παρελθόν, αλλά αντιμετωπίζουν τώρα προβλήματα, θα πρέπει να καθαρίσουν το cache του προγράμματος περιήγησής τους.

  • Ορισμένα προγράμματα περιήγησης απαιτούν να ανανεώσετε τη σελίδα μετά την είσοδο, ειδικά όταν χρησιμοποιείτε τις λειτουργίες InPrivate ή Incognito.

  • Ενδέχεται να αντιμετωπίσετε προβλήματα εάν χρησιμοποιείτε μη υποστηριζόμενες εκδόσεις προγραμμάτων περιήγησης. Για μια λίστα με τα προγράμματα περιήγησης που υποστηρίζει το Power BI, ανατρέξτε στο θέμα Υποστηριζόμενα προγράμματα περιήγησης για το Power BI.

  • Εάν η τοποθεσία web σας ορίζει την κεφαλίδα Cross-Origin-Opener-Policy (COOP) σε "ίδια προέλευση", δεν μπορείτε να συνδεθείτε για να προβάλετε το ενσωματωμένο περιεχόμενό σας, επειδή το MSAL δεν υποστηρίζει αυτή την κεφαλίδα. Αντί για αυτό, επιλέξτε είτε "περιορισμός-ιδιοτήτων" (για προγράμματα περιήγησης που βασίζονται σε Chromium) είτε "ίδια-προέλευση-allow-popups." Εναλλακτικά, εάν δεν μπορείτε να αλλάξετε την πολιτική Cross-Origin-Opener-Policy, συνδεθείτε απευθείας με την ενσωματωμένη διεύθυνση URL αντί να την ενσωματώσετε σε ένα iframe.

  • Ο κλασικός SharePoint Server δεν υποστηρίζεται, επειδή απαιτεί εκδόσεις του Internet Explorer προγενέστερες της έκδοσης 11 ή ενεργοποίηση της λειτουργίας προβολής συμβατότητας.

  • Για να επιτύχετε μια εμπειρία καθολικής σύνδεσης, χρησιμοποιήστε την επιλογή Ενσωμάτωση στο SharePoint Online ή δημιουργήστε μια προσαρμοσμένη ενοποίηση χρησιμοποιώντας τη μέθοδο ενσωμάτωσης τα δεδομένα ανήκουν στον χρήστη.

  • Οι δυνατότητες αυτόματου ελέγχου ταυτότητας που παρέχονται με την επιλογή Ενσωμάτωση δεν λειτουργούν με το Power BI JavaScript API. Αποκλείονται στο SDK ενσωματωμένου προγράμματος-πελάτη PBI, ξεκινώντας με την έκδοση 2.10.4. Για το Power BI JavaScript API, χρησιμοποιήστε τη μέθοδο ενσωμάτωσης τα δεδομένα ανήκουν στον χρήστη.

  • Οι δυνατότητες αυτόματου ελέγχου ταυτότητας δεν λειτουργούν όταν είναι ενσωματωμένες σε εφαρμογές, συμπεριλαμβανομένων των εφαρμογών για κινητές συσκευές και υπολογιστές.

  • Η διάρκεια ζωής του διακριτικού ελέγχου ταυτότητας ελέγχεται από τις ρυθμίσεις του Microsoft Entra. Όταν λήξει το διακριτικό ελέγχου ταυτότητας, ο χρήστης θα πρέπει να εισέλθει ξανά για να λάβει ένα ενημερωμένο διακριτικό ελέγχου ταυτότητας. Η προεπιλεγμένη διάρκεια ζωής είναι μία ώρα, αλλά μπορεί να είναι μικρότερη ή μεγαλύτερη στον οργανισμό σας. Δεν μπορείτε να ανανεώσετε αυτόματα το διακριτικό σε αυτό το σενάριο.