Προηγούμενο

Επόμενο

Εισαγωγή

Ολοκληρώθηκε

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

1. Προσθέστε τη βιβλιοθήκη προγραμμάτων-πελατών στον έλεγχο ενσωμάτωσης μέσω προγραμματισμού.
2. Συμπεριλάβετε τη βιβλιοθήκη προγραμμάτων-πελατών.
3. Προσθέστε ένα κοντέινερ ενσωμάτωσης.
4. Δεδομένα που δημιουργήθηκαν από την πλευρά του διακομιστή εξόδου.
5. Ρυθμίστε ένα αντικείμενο ρύθμισης παραμέτρων.
6. Ενσωμάτωση του περιεχομένου Power BI.

Προσθήκη της βιβλιοθήκης προγραμμάτων-πελατών

Χρησιμοποιήστε το API προγράμματος-πελάτη του Power BI για να ενσωματώσετε περιεχόμενο του Power BI χρησιμοποιώντας JavaScript ή TypeScript. Είναι μια βιβλιοθήκη προγραμμάτων-πελατών που παρέχει προγραμματισμό έλεγχο ολόκληρης της εμπειρίας ενσωμάτωσης.

Τα API περιλαμβάνουν τρία πακέτα:

• powerbi-client - Περιλαμβάνει όλα τα API που ενσωματώνουν περιεχόμενο, εκτός από τα API που βρίσκονται στη βιβλιοθήκη σύνταξης αναφορών του powerbi .
• powerbi-models - Περιέχει μοντέλα αντικειμένου. Κάθε μοντέλο διαθέτει μια διασύνδεση TypeScript, έναν ορισμό σχήματος JSON και μια συνάρτηση επικύρωσης για να εξασφαλιστεί ότι ένα δεδομένο αντικείμενο είναι ένα έγκυρο μοντέλο.
• σύνταξη αναφορών powerbi - Μια επέκταση για τη δημιουργία και την εξατομίκευση απεικονίσεων και τη σύνταξη μιας αναφοράς Power BI μετά τη φόρτωσή της. Επιτρέπει επίσης στην εφαρμογή σας να επεξεργάζεται μέσω προγραμματισμού ενσωματωμένες αναφορές Power BI.

Μπορείτε να εγκαταστήσετε τη βιβλιοθήκη API προγράμματος-πελάτη του Power BI χρησιμοποιώντας NuGet ή npm.

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Τι είναι το API προγράμματος-πελάτη ενσωματωμένης ανάλυσης του Power BI;.

Συμπερίληψη της βιβλιοθήκης προγραμμάτων-πελατών

Η εφαρμογή σας πρέπει να περιλαμβάνει ένα script στοιχείο για την προέλευση της βιβλιοθήκης προγραμμάτων-πελατών.

<script src="/powerbi-client/dist/powerbi.js"></script>

Είναι επίσης δυνατή η προέλευση της βιβλιοθήκης προγραμμάτων-πελατών από ένα δίκτυο παροχής περιεχομένου (CDN). Για ένα παράδειγμα, ανατρέξτε στο θέμα JSDelivr powerbi-client.

<script src="https://cdn.jsdelivr.net/npm/powerbi-client@2.22.3/dist/powerbi.min.js"></script>

Όταν συμπεριλαμβάνεται απευθείας, η βιβλιοθήκη προγραμμάτων-πελατών εμφανίζεται ως καθολικό όνομα powerbi-client. Υπάρχει επίσης ένα άλλο καθολικό όνομα powerbi, το οποίο είναι μια παρουσία της Υπηρεσία Power BI.

Προσθήκη κοντέινερ ενσωμάτωσης

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

<div id="embedContainer"></div>

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

Παρακολουθήστε το παρακάτω βίντεο που δείχνει πώς λειτουργεί η βιβλιοθήκη προγραμμάτων-πελατών.

Δεδομένα που δημιουργήθηκαν από την πλευρά του διακομιστή εξόδου

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

Συμβουλή

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

Το ακόλουθο script στοιχείο περιέχει τρεις μεταβλητές. Η accessToken μεταβλητή αποθηκεύει το διακριτικό πρόσβασης που δημιουργήθηκε από την πλευρά του διακομιστή. Οι reports μεταβλητές και datatsets αποθηκεύουν αναπαραστάσεις JSON αντικειμένων σχεδίασης με δυνατότητα ενσωμάτωσης. Σε αυτό το παράδειγμα, οι τύποι αντικειμένων σχεδίασης είναι αναφορές και σύνολα δεδομένων. Συγκεκριμένα, οι μεταβλητές αποθηκεύουν αναγνωριστικό αντικειμένου σχεδίασης και ενσωματώνουν ιδιότητες διεύθυνσης URL ενσωμάτωσης που πρέπει να είναι διαθέσιμες από την πλευρά του προγράμματος-πελάτη για την υποστήριξη της ενσωμάτωσης. Περιλαμβάνει επίσης την ιδιότητα ονόματος , ώστε η εφαρμογή να μπορεί να παρουσιάσει ονόματα αντικειμένων σχεδίασης στον χρήστη με φιλικό τρόπο, όπως σε ένα μενού.

<script>
    var accessToken = "@Model.AccessToken";
    var reports = @Html.Raw(Model.ReportsJson)
    var datasets = @Html.Raw(Model.DatasetsJson)
</script>

Ρύθμιση αντικειμένου ρύθμισης παραμέτρων

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

• tokenType - Ορίστε την τιμή βάσει ενός από αυτά τα σενάρια:
  • Για τον οργανισμό σας Το διακριτικό πρόσβασης είναι ένα διακριτικό Azure AD. Ορίστε την τιμή σε models.TokenType.Aad.
  • Για τους πελάτες σας Το διακριτικό πρόσβασης είναι ένα διακριτικό ενσωμάτωσης. Ορίστε την τιμή σε models.TokenType.Embed.
• accessToken - Το διακριτικό πρόσβασης που δημιουργήθηκε από την πλευρά του διακομιστή.
• type - Ορίστε μία από τις παρακάτω τιμές. Οι μονάδες 2 και 3 περιγράφουν πώς μπορείτε να ενσωματώσετε κάθε τύπο περιεχομένου Power BI.
  • Έκθεση Για μια αναφορά Power BI ή σελιδοποιημένη αναφορά.
  • Visual Για μια απεικόνιση αναφοράς Power BI.
  • Ταμπλό Για έναν πίνακα εργαλείων.
  • Κεραμίδι Για ένα πλακίδιο πίνακα εργαλείων.
  • qna Για την εμπειρία Q&A.
• id - Το αναγνωριστικό τεχνουργήματος Power BI.
• embedUrl - Η διεύθυνση URL ενσωμάτωσης του αντικειμένου σχεδίασης Power BI. Αυτή η διεύθυνση URL γίνεται η προέλευση του στοιχείου iframe που φιλοξενεί το ενσωματωμένο αντικείμενο σχεδίασης. Συγκεκριμένα, το API αντιστοιχίζει τη διεύθυνση URL στο src χαρακτηριστικό του στοιχείου iframe .

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

// Get models. models contains enums that can be used.
models = window['powerbi-client'].models;

// Create the embed configuration object.
let config = {
    tokenType: models.TokenType.Embed,
    accessToken: accessToken, // Server-side generated access token
    type: 'report',
    id: '<Server-side retrieved Report ID>',
    embedUrl: '<Server-side retrieved Report embed URL>'
};

Υπάρχουν περισσότερες ιδιότητες ρύθμισης παραμέτρων για το συγκεκριμένο περιεχόμενο που μπορείτε να ορίσετε. Περιγράφονται στις μονάδες 2 και 3.

Ενσωμάτωση του περιεχομένου Power BI

Χρησιμοποιήστε τη powerbi.embed(embedContainer, config) συνάρτηση για να ενσωματώσετε το περιεχόμενο Power BI.

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

// Get models. models contains enums that can be used.
models = window['powerbi-client'].models;

// Get a reference to the embedding container.
let embedContainer = $('#embedContainer')[0];

// Create the embed configuration object.
let config = {
    tokenType: models.TokenType.Embed,
    accessToken: accessToken, // Server-side generated access token
    type: 'report',
    id: '<Server-side retrieved Report ID>',
    embedUrl: '<Server-side retrieved Report embed URL>'
};

// Embed the report in the embedding container.
report = powerbi.embed(embedContainer, config);

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

Συνέχεια