Εκμάθηση: Ενσωμάτωση σελιδοποιημένων αναφορών Power BI σε μια εφαρμογή για τον οργανισμό σαςTutorial: Embed Power BI paginated reports into an application for your organization

Στο Power BI, μπορείτε να ενσωματώσετε σελιδοποιημένες αναφορές σε μια εφαρμογή για τον οργανισμό σας χρησιμοποιώντας το σενάριο ο χρήστης είναι κάτοχος δεδομένων.In Power BI, you can embed paginated reports into an application for your organization by using the user owns data scenario.

Οι σελιδοποιημένες αναφορές είναι αναφορές που έχουν σχεδιαστεί για εκτύπωση υψηλής ποιότητας.Paginated reports are reports designed for high-quality printing. Συνήθως, αυτές οι αναφορές περιέχουν πολλά δεδομένα και αποδίδονται με τρόπο τέτοιο ώστε να προσαρμόζονται σε εκτυπωμένες σελίδες.Usually these reports contain a lot of data, rendered in a way that makes it fit printed pages. Για να κατανοήσετε πώς το Power BI υποστηρίζει σελιδοποιημένες αναφορές, ανατρέξτε στο άρθρο Ποιες είναι οι σελιδοποιημένες αναφορές στο Power BI Premium;To understand how Power BI supports paginated reports, see What are paginated reports in Power BI Premium?

Τα δεδομένα που ανήκουν στον χρήστη επιτρέπουν στην εφαρμογή σας να επεκτείνει την υπηρεσία Power BI ώστε να είναι δυνατή η χρήση ενσωμάτωσης ανάλυσης.User owns data lets your application extend the Power BI service so it can use embedded analytics. Αυτή η εκμάθηση παρουσιάζει πώς μπορείτε να ενσωματώσετε μια σελιδοποιημένη αναφορά σε μια εφαρμογή.This tutorial demonstrates how to integrate a paginated report into an application.

Μπορείτε να χρησιμοποιήσετε το Power BI .NET SDK με το Power BI JavaScript API για να ενσωματώσετε το Power BI σε μια εφαρμογή για τον οργανισμό σας.You use the Power BI .NET SDK with the Power BI JavaScript API to embed Power BI into an application for your organization.

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

Σε αυτήν την εκμάθηση, θα μάθετε πώς να εκτελείτε τις εξής εργασίες:In this tutorial, you learn the following tasks:

  • Καταχώρηση μιας εφαρμογής στο Azure.Register an application in Azure.
  • Ενσωμάτωση μιας σελιδοποιημένης αναφοράς Power BI σε μια εφαρμογή με χρήση του μισθωτή σας Power BI.Embed a Power BI paginated report into an application using your Power BI tenant.

ΠροαπαιτούμεναPrerequisites

Για να ξεκινήσετε, θα πρέπει να έχετε:To get started, you're required to have:

Εάν δεν έχετε εγγραφεί για το Power BI Pro, εγγραφείτε για μια δωρεάν δοκιμαστική έκδοση προτού ξεκινήσετε.If you're not signed up for Power BI Pro, sign up for a free trial before you begin.

Σημείωση

Το Premium ανά χρήστη (PPU) υποστηρίζεται.Premium Per User (PPU) is supported. Ωστόσο, αν χρησιμοποιείτε το PPU, μόνο οι χρήστες του PPU στον οργανισμό σας θα μπορούν να έχουν πρόσβαση στη λύση σας.However, if you're using PPU, only PPU users in your organization will be able to access your solution.

Ρύθμιση του περιβάλλοντος του Power BISet up your Power BI environment

Ακολουθήστε τις οδηγίες σε αυτήν την ενότητα για να ρυθμίσετε το Power BI για ενσωμάτωση των σελιδοποιημένων αναφορών σας.Follow the instructions in this section to set up Power BI for embedding your paginated reports.

Καταχώρηση μιας εφαρμογής Web από την πλευρά του διακομιστήRegister a server-side web application app

Ακολουθήστε τις οδηγίες στην Εγγραφή μιας εφαρμογής Azure AD για χρήση με το Power BI για να καταχωρήσετε μια εφαρμογή Web από την πλευρά του διακομιστή.Follow the instructions in Register an Azure AD application to use with Power BI to register a server-side web application app.

Σημείωση

Κατά την καταχώρηση της εφαρμογής, βεβαιωθείτε ότι κάνετε τα εξής:When registering the app, make sure to do the following:

  • Λήψη του μυστικού της εφαρμογήςGet the application secret
  • Εφαρμόστε τα δικαιώματα Report.ReadAll (εμβέλεια) στην εφαρμογή σας.Apply the Report.ReadAll permissions (scope) to your app.

Δημιουργία εκχωρημένων πόρωνCreate a capacity

Δημιουργώντας εκχωρημένους πόρους, μπορείτε να αξιοποιήσετε την ύπαρξη ενός πόρου για το περιεχόμενο στον χώρο εργασίας της εφαρμογής σας.By creating a capacity, you can take advantage of having a resource for the content in your app workspace. Για σελιδοποιημένες αναφορές, πρέπει να υποστηρίξετε τον χώρο εργασίας της εφαρμογής σας με τουλάχιστον έναν εκχωρημένο πόρο P1.For paginated reports, you must back your app workspace with at least a P1 capacity. Μπορείτε να δημιουργήσετε εκχωρημένους πόρους, χρησιμοποιώντας το Power BI Premium.You can create a capacity by using Power BI Premium.

Ο παρακάτω πίνακας αναφέρει τα Power BI Premium SKU που μπορούν να χρησιμοποιηθούν για τη δημιουργία ενός συνόλου εκχωρημένων πόρων για σελιδοποιημένες αναφορές στο Microsoft Office 365:The following table lists the Power BI Premium SKUs that can be used to create a capacity for paginated reports in Microsoft Office 365:

Κόμβος εκχωρημένων πόρωνCapacity node Σύνολο εικονικών πυρήνωνTotal vCores
(παρασκήνιο + προσκήνιο)(back end + front end)
Εικονικοί πυρήνες παρασκηνίουBack-end vCores Εικονικοί πυρήνες προσκηνίουFront-end vCores Όρια συνδέσεων DirectQuery/δυναμικών συνδέσεωνDirectQuery/live connection limits
P1P1 8 εικονικοί πυρήνες8 vCores 4 εικονικοί πυρήνες, 25 GB RAM4 vCores, 25 GB of RAM 4 εικονικοί πυρήνες4 vCores 30 ανά δευτερόλεπτο30 per second
P2P2 16 εικονικοί πυρήνες16 vCores 8 εικονικοί πυρήνες, 50 GB RAM8 vCores, 50 GB of RAM 8 εικονικοί πυρήνες8 vCores 60 ανά δευτερόλεπτο60 per second
P3P3 32 εικονικοί πυρήνες32 vCores 16 εικονικοί πυρήνες, 100 GB RAM16 vCores, 100 GB of RAM 16 εικονικοί πυρήνες16 vCores 120 ανά δευτερόλεπτο120 per second
P4P4 64 εικονικοί πυρήνες64 vCores 32 εικονικοί πυρήνες, 200 GB RAM32 vCores, 200 GB of RAM 32 εικονικοί πυρήνες32 vCores 240 ανά δευτερόλεπτο240 per second
P5P5 128 εικονικοί πυρήνες128 vCores 64 εικονικοί πυρήνες, 400 GB RAM64 vCores, 400 GB of RAM 64 εικονικοί πυρήνες64 vCores 480 ανά δευτερόλεπτο480 per second

Ενεργοποίηση φόρτου εργασίας σελιδοποιημένων αναφορώνEnable paginated reports workload

Χρειάζεται να ενεργοποιήσετε τον φόρτο εργασίας σελιδοποιημένης αναφοράς στους εκχωρημένους πόρους σας.You need to enable the paginated report workload on your capacity.

  1. Πραγματοποιήστε είσοδο στο μενού Power BI > Πύλη διαχειριστή > Ρυθμίσεις εκχωρημένων πόρων.Sign into Power BI > Admin portal > Capacity settings.

  2. Επιλέξτε τους εκχωρημένους πόρους που διαθέτει ο χώρος εργασίας στον οποίο θέλετε να στείλετε τη σελιδοποιημένη αναφορά.Select the capacity that has the workspace you want to upload the paginated report to.

    Επιλογή εκχωρημένων πόρων

  3. Αναπτύξτε τους Φόρτους εργασίας.Expand Workloads.

    Ανάπτυξη φόρτων εργασίας

  4. Ενεργοποιήστε τον φόρτο εργασίας σελιδοποιημένων αναφορών.Activate the paginated reports workload.

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

Εκχώρηση χώρου εργασίας εφαρμογής σε σύνολο εκχωρημένων πόρωνAssign an app workspace to a capacity

Αφού δημιουργήσετε εκχωρημένους πόρους, μπορείτε να εκχωρήσετε τον χώρο εργασίας εφαρμογής σε αυτούς τους εκχωρημένους πόρους.After you create a capacity, you can assign your app workspace to that capacity. Για να ολοκληρώσετε αυτήν τη διαδικασία, ακολουθήστε τα παρακάτω βήματα.To complete this process, follow these steps:

  1. Εντός της υπηρεσίας Power BI, αναπτύξτε τους χώρους εργασίας και επιλέξτε Περισσότερα για τον χώρο εργασίας που χρησιμοποιείτε για την ενσωματώνω του περιεχομένου σας.Within the Power BI service, expand workspaces and select More for the workspace you're using for embedding your content. Στη συνέχεια, επιλέξτε Ρυθμίσεις χώρου εργασίας.Then select Workspace settings.

    Επεξεργασία χώρου εργασίας

  2. Επιλέξτε Premium και ενεργοποιήστε τη δυνατότητα Εκχωρημένοι πόροι.Select Premium and enable Capacity. Επιλέξτε τους εκχωρημένους πόρους που δημιουργήσατε.Select the capacity you created. Στη συνέχεια, επιλέξτε Αποθήκευση.Then select Save.

    Εκχώρηση εκχωρημένων πόρων

  3. Αφού επιλέξετε Αποθήκευση θα πρέπει να δείτε ένα σχήμα ρόμβου δίπλα στο όνομα του χώρου εργασίας εφαρμογής.After you select Save, you should see a diamond next to the app workspace name.

    Χώρος εργασίας εφαρμογής που συνδέεται με εκχωρημένους πόρους

Δημιουργία και δημοσίευση των σελιδοποιημένων αναφορών σας Power BICreate and publish your Power BI paginated reports

Μπορείτε να δημιουργήσετε τις σελιδοποιημένες αναφορές σας με το Power BI Report Builder.You can create your paginated reports by using the Power BI Report Builder. Στη συνέχεια, μπορείτε να στείλετε την αναφορά σε έναν χώρο εργασίας εφαρμογής που έχει εκχωρηθεί σε έναν εκχωρημένο πόρο P1 και ενεργοποιήστε τον φόρτο εργασίας σελιδοποιημένων αναφορών.Then you can upload the report to an app workspace assigned to at least a P1 capacity, and turn on the paginated reports workload. Ο τελικός χρήστης που ανεβάζει την αναφορά πρέπει να έχει άδεια χρήσης Power BI Pro ή Premium ανά χρήστη (PPU) για δημοσίευση σε έναν χώρο εργασίας εφαρμογής.The end user uploading the report must have a Power BI Pro or Premium Per User (PPU) license to publish to an app workspace.

Ενσωμάτωση του περιεχομένου σας με χρήση του δείγματος εφαρμογήςEmbed your content by using the sample application

Αυτό το δείγμα διατηρείται σκόπιμα απλό για σκοπούς επίδειξης.This sample is deliberately kept simple for demonstration purposes.

Ακολουθήστε τα παρακάτω βήματα για να ξεκινήσετε την ενσωμάτωση του περιεχομένου σας, χρησιμοποιώντας το δείγμα εφαρμογής.Follow the steps below to start embedding your content using the sample application.

  1. Κάντε λήψη του Visual Studio, (έκδοση 2013 ή νεότερη).Download Visual Studio (version 2013 or later). Φροντίστε να κάνετε λήψη του τελευταίου πακέτου NuGet.Make sure to download the latest NuGet package.

  2. Κάντε λήψη του PowerBI-Developer-Samples και ανοίξτε το .NET Framework > Embed for your organization > integrate-web-app > PBIWebApp.Download PowerBI-Developer-Samples, and open .NET Framework > Embed for your organization > integrate-web-app > PBIWebApp.

    Δείγματα προγραμματιστή PowerBI

  3. Ανοίξτε το αρχείο Cloud.config στο δείγμα εφαρμογής και συμπληρώστε τα παρακάτω πεδία για να εκτελέσετε την εφαρμογή σας:Open the Cloud.config file in the sample application, and fill in the following fields to run your application:

    Αρχείο cloud.config

Αναγνωριστικό εφαρμογήςApplication ID

Συμπληρώστε τις πληροφορίες applicationId με το Αναγνωριστικό εφαρμογής από το Azure.Fill in the applicationId information with the Application ID from Azure. Το applicationId χρησιμοποιείται από την εφαρμογή για να προσδιορίσει τον εαυτό της στους χρήστες από τους οποίους ζητάτε δικαιώματα.The applicationId is used by the application to identify itself to the users from which you're requesting permissions.

Για να λάβετε το applicationId, ακολουθήστε τα εξής βήματα:To get the applicationId, follow these steps:

  1. Πραγματοποιήστε είσοδο στην πύλη Azure.Sign into the Azure portal.

  2. Στο παράθυρο περιήγησης στα αριστερά, επιλέξτε Όλες οι υπηρεσίες και επιλέξτε Καταχωρήσεις εφαρμογών.In the left-hand navigation pane, select All Services, and select App Registrations.

  3. Επιλέξτε την εφαρμογή που χρειάζεται να χρησιμοποιήσει το applicationId.Select the application that needs the applicationId.

    Επιλογή εφαρμογής

  4. Υπάρχει ένα Αναγνωριστικό εφαρμογής που παρατίθεται ως GUID.There's an Application ID that is listed as a GUID. Χρησιμοποιήστε αυτό το Αναγνωριστικό εφαρμογής ως το applicationId για την εφαρμογή.Use this Application ID as the applicationId for the application.

    applicationId

Αναγνωριστικό χώρου εργασίαςWorkspace ID

Συμπληρώστε τις πληροφορίες workspaceId με τον χώρο εργασίας εφαρμογής (ομάδα) από το Power BI.Fill in the workspaceId information with the app workspace (group) GUID from Power BI. Μπορείτε να λάβετε αυτές τις πληροφορίες από τη διεύθυνση URL κατά την είσοδο στην υπηρεσία Power BI ή χρησιμοποιώντας το PowerShell.You can get this information either from the URL when signed into the Power BI service or using PowerShell.

Διεύθυνση URLURL

workspaceId

PowerShellPowerShell

Get-PowerBIworkspace -name "User Owns Embed Test"

workspaceId από το PowerShell

Αναγνωριστικό αναφοράςReport ID

Συμπληρώστε τις πληροφορίες reportId με το GUID αναφοράς από το Power BI.Fill in the reportId information with the report GUID from Power BI. Μπορείτε να λάβετε αυτές τις πληροφορίες από τη διεύθυνση URL κατά την είσοδο στην υπηρεσία Power BI ή χρησιμοποιώντας το PowerShell.You can get this information either from the URL when signed into the Power BI service or using PowerShell.

reportId

PowerShellPowerShell

Get-PowerBIworkspace -name "User Owns Embed Test" | Get-PowerBIReport -Name "Sales Paginated Report"

reportId από το PowerShell

AADAuthorityUrlAADAuthorityUrl

Συμπληρώστε τις πληροφορίες AADAuthorityUrl με τη διεύθυνση URL που σάς επιτρέπει είτε να κάνετε ενσωμάτωση εντός του μισθωτή του οργανισμού σας είτε μέσω ενός χρήστη-επισκέπτη.Fill in the AADAuthorityUrl information with the URL that either allows you to embed within your organizational tenant or embed with a guest user.

Για την ενσωμάτωση με τον εταιρικό σας μισθωτή, χρησιμοποιήστε τη διεύθυνση URL - https://login.microsoftonline.com/common/oauth2/authorize .For embedding with your organizational tenant, use the URL - https://login.microsoftonline.com/common/oauth2/authorize.

Για την ενσωμάτωση με επισκέπτη, χρησιμοποιήστε τη διεύθυνση URL - https://login.microsoftonline.com/report-owner-tenant-id - όπου μπορείτε να προσθέσετε το Αναγνωριστικό μισθωτή από τον κάτοχο της αναφοράς σε αντικατάσταση του αναγνωριστικού-μισθωτή-κατόχου-αναφοράς.For embedding with a guest, use the URL - https://login.microsoftonline.com/report-owner-tenant-id - where you add the tenant ID of the report owner in replacement of report-owner-tenant-id.

Εκτέλεση της εφαρμογήςRun the application

  1. Επιλέξτε Εκτέλεση στο Visual Studio.Select Run in Visual Studio.

    Εκτέλεση της εφαρμογής

  2. Στη συνέχεια, επιλέξτε Ενσωμάτωση αναφοράς.Then select Embed Report. Ανάλογα με το περιεχόμενο που θέλετε να δοκιμάσετε - αναφορές, πίνακες εργαλείων ή πλακίδια - ενεργοποιήστε την αντίστοιχη επιλογή στην εφαρμογή.Depending on which content you choose to test with - reports, dashboards or tiles - then select that option in the application.

    Επιλέξτε περιεχόμενο

  3. Τώρα μπορείτε να προβάλετε την αναφορά στο δείγμα εφαρμογής.Now you can view the report in the sample application.

    Προβολή της σελιδοποιημένης αναφοράς στην εφαρμογή

Επόμενα βήματαNext steps

Σε αυτήν την εκμάθηση, μάθατε πώς μπορείτε να ενσωματώσετε σελιδοποιημένες αναφορές Power BI σε μια εφαρμογή χρησιμοποιώντας τον εταιρικό λογαριασμό Power BI που διαθέτετε.In this tutorial, you learned how to embed Power BI paginated reports into an application by using your Power BI organization account.

Εάν έχετε περισσότερες ερωτήσεις, δοκιμάστε να ρωτήσετε την Κοινότητα Power BI.If you have more questions, try asking the Power BI Community.