Ενσωμάτωση αναφορών Power BI

  • 8 λεπτά

Οι αναφορές Power BI είναι ο πιο συχνά ενσωματωμένος τύπος περιεχομένου λόγω του μεγάλου αριθμού τύπων απεικονίσεων (συμπεριλαμβανομένης της τεχνητής νοημοσύνης και των προσαρμοσμένων απεικονίσεων) και των αλληλεπιδραστικών δυνατοτήτων.

Μπορείτε να ενσωματώσετε μια αναφορά Power BI σε τρεις διαφορετικές καταστάσεις λειτουργίας:

  • Ενσωμάτωση υπάρχουσας αναφοράς Power BI
  • Επεξεργασία ενσωματωμένης αναφοράς
  • Ενσωμάτωση νέας αναφοράς Power BI

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

Ενσωμάτωση υπάρχουσας αναφοράς

Κατά την ενσωμάτωση μιας υπάρχουσας αναφοράς, χρησιμοποιήστε ένα αντικείμενο ρύθμισης παραμέτρων τύπου IReportLoadConfiguration. Εκτός από τις απαιτούμενες ιδιότητες (περιγράφονται στο Κεφάλαιο 1), η εφαρμογή σας μπορεί να ορίσει τις ακόλουθες προαιρετικές ιδιότητες.

  • contrastMode and theme - Προαιρετικό. Ελέγξτε το επίπεδο θέματος και αντίθεσης που χρησιμοποιεί το ενσωματωμένο περιεχόμενό σας. Από προεπιλογή, οποιοδήποτε περιεχόμενο που ενσωματώνετε εμφανίζεται με το προεπιλεγμένο θέμα και με μηδενική αντίθεση. Μπορείτε να παρακάμψετε αυτήν τη συμπεριφορά ρυθμίζοντας ένα συγκεκριμένο θέμα ή επίπεδο αντίθεσης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Θέματα και λειτουργία υψηλής αντίθεσης.
  • pageName -Προαιρετική. Ελέγχει ποια σελίδα της ενσωματωμένης αναφοράς εμφανίζεται αρχικά. Όταν δεν οριστεί, ανοίγει την επιλεγμένη σελίδα την τελευταία φορά που ο συντάκτης αποθήκευε την αναφορά.
  • filters -Προαιρετική. Ορίζει την κατάσταση φίλτρου. Εξετάστε το ενδεχόμενο να ορίσετε την κατάσταση φίλτρου με βάση το περιβάλλον εφαρμογής, ίσως για να φιλτράρετε κατά την περιοχή πωλήσεων του χρήστη της εφαρμογής. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Έλεγχος φίλτρων αναφοράς.
  • slicers -Προαιρετική. Όπως με τα φίλτρα, μπορείτε να ορίσετε την κατάσταση του αναλυτή. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Έλεγχος αναλυτών αναφοράς.
  • bookmark -Προαιρετική. Εφαρμόστε έναν συγκεκριμένο σελιδοδείκτη.
  • datasetBinding -Προαιρετική. Συνδέει την αναφορά σε ένα διαφορετικό σύνολο δεδομένων που ορίζει το σχήμα δεδομένων στο οποίο συνδέεται η ενσωματωμένη αναφορά. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δυναμική σύνδεση συνόλων δεδομένων σε μια αναφορά.
  • permissions -Προαιρετική. Εκχωρεί λειτουργίες που μπορεί να εκτελέσει ο χρήστης. Οι επιλογές λειτουργίας περιλαμβάνουν δημιουργία, προβολή, επεξεργασία, αποθήκευση ή αποθήκευση ενός αντιγράφου της αναφοράς. Η επεξεργασία και δημιουργία αναφορών καλύπτεται αργότερα σε αυτό το κεφάλαιο.
  • viewMode -Προαιρετική. Καθορίζει εάν η αναφορά ανοίγει σε λειτουργία προβολής (προεπιλογή) ή λειτουργία επεξεργασίας. Όπως περιγράφηκε προηγουμένως, η εφαρμογή σας πρέπει να εκχωρήσει δικαιώματα επεξεργασίας για να ενεργοποιηθεί η λειτουργία επεξεργασίας.
  • settings -Προαιρετική. Ρυθμίζει την εμφάνιση και τη συμπεριφορά της αναφοράς. Μπορείτε να εμφανίσετε και να αναπτύξετε ανοιχτά τμήματα παραθύρου για να εργαστείτε με σελιδοδείκτες, πεδία, φίλτρα, περιήγηση σελίδας, επιλογή, συγχρονισμό αναλυτών ή απεικονίσεις. Μπορείτε επίσης να ορίσετε τον τύπο διάταξης σε προβολή για κινητές συσκευές ή να ορίσετε τοπικές ρυθμίσεις, οι οποίες καθορίζουν τη γλώσσα και τη μορφοποίηση της αναφοράς. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Προσαρμογή ρυθμίσεων.

Σημείωση

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

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

Σημείωση

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

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Τι είναι η παιδική χαρά ενσωματωμένης ανάλυσης του Power BI;

Στο αριστερό τμήμα παραθύρου, επιλέξτε Εξερεύνηση των API μας.

Στιγμιότυπο οθόνης του αριστερού τμήματος παραθύρου με επισημασμένη την επιλογή Εξερεύνηση των API μας.

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

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

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

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

Στο παράθυρο τμήματος κώδικα, σαρώστε τον κώδικα κάνοντας κατακόρυφη κύλιση από επάνω προς τα κάτω. Αναζητήστε τις γραμμές κώδικα που δημιουργούν το αντικείμενο ρύθμισης παραμέτρων και ενσωματώνουν την αναφορά (περίπου στα μισά του δρόμου).

// Create the embed configuration object for the report
// For more information see https://go.microsoft.com/fwlink/?linkid=2153590
let config = {
    type: 'report',
    tokenType: models.TokenType.Embed,
    accessToken: accessToken,
    embedUrl: embedUrl,
    id: embedReportId,
    permissions: permissions,
    settings: {
        panes: {
            filters: {
                visible: true
            },
            pageNavigation: {
                visible: true
            }
        }
    }
};

// Get a reference to the embedded report HTML element
let embedContainer = $('#embedContainer')[0];

// Embed the report and display it within the div container.
report = powerbi.embed(embedContainer, config);```

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

Επεξεργασία ενσωματωμένης αναφοράς

Για να επιτρέψετε στο χρήστη να επεξεργαστεί μια ενσωματωμένη αναφορά, χρησιμοποιήστε ένα αντικείμενο ρύθμισης παραμέτρων τύπου IReportLoadConfiguration. Ορίστε την viewMode ιδιότητα σε models.ViewMode.Edit.

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

Στην παιδική χαρά της ενσωματωμένης λειτουργίας ανάλυσης του Power BI, στην αναπτυσσόμενη λίστα Λειτουργία ενσωμάτωσης , επιλέξτε Λειτουργία επεξεργασίας.

Στιγμιότυπο οθόνης της αναπτυσσόμενης λίστας ενσωματωμένης λειτουργίας που έχει οριστεί σε λειτουργία επεξεργασίας.

Η ενσωματωμένη αναφορά έχει τώρα τη γραμμή ενεργειών στην κορυφή της αναφοράς. Περιλαμβάνει την εντολή Save , η οποία βρίσκεται στην δεξιά πλευρά της αναφοράς. Τώρα, μπορείτε να αλλάξετε την αναφορά και (προσπαθήστε να) αποθηκεύσετε την επεξεργασμένη αναφορά.

Σημείωση

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

Ανοίξτε το παράθυρο τμήματος κώδικα και εντοπίστε την πρόταση που δημιουργεί το αντικείμενο ρύθμισης παραμέτρων . Παρατηρήστε ότι η ιδιότητα viewMode έχει οριστεί σε Επεξεργασία.

viewMode: models.ViewMode.Edit,

Επιλέξτε Άκυρο για να κλείσετε το παράθυρο τμήματος κώδικα.

Ενσωμάτωση νέας αναφοράς

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

  • datasetId -Απαιτείται. Το DatasetID στο οποίο συνδέεται η νέα αναφορά.

  • embedUrl -Απαιτείται. Η διεύθυνση URL ενσωμάτωσης του συνόλου δεδομένων.

Πρέπει να ορίσετε την permissions ιδιότητα ώστε να επιτρέπει τη δημιουργία μιας αναφοράς (Create και All).

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

Στην παιδική χαρά της ενσωματωμένης λειτουργίας ανάλυσης του Power BI, στην αναπτυσσόμενη λίστα Λειτουργία ενσωμάτωσης , επιλέξτε Λειτουργία δημιουργίας.

Στιγμιότυπο οθόνης της αναπτυσσόμενης λίστας ενσωματωμένης λειτουργίας που έχει οριστεί σε λειτουργία δημιουργίας.

Η ενσωματωμένη αναφορά έχει τώρα τη γραμμή ενεργειών στην κορυφή της αναφοράς. Περιλαμβάνει το μενού Αρχείο , το οποίο βρίσκεται στο αριστερό άκρο της αναφοράς. Τώρα, είναι δυνατό να (προσπαθήσετε) να αποθηκεύσετε την αναφορά.

Σημείωση

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

Ανοίξτε το παράθυρο τμήματος κώδικα και εντοπίστε την πρόταση που δημιουργεί το αντικείμενο embedCreateConfiguration . Παρατηρήστε ότι ο κώδικας ορίζει την ιδιότητα datasetId .

// This object is used when calling powerbi.createReport.
let embedCreateConfiguration = {
    tokenType: models.TokenType.Embed,
    accessToken: accessToken,
    embedUrl: embedUrl,
    datasetId: embedDatasetId,
};

Επιλέξτε Άκυρο για να κλείσετε το παράθυρο τμήματος κώδικα.

Για μια πλήρη περιγραφή σχετικά με την ενσωμάτωση αναφορών Power BI, ανατρέξτε στο θέμα Ενσωμάτωση αναφοράς.