Εκμάθηση: ενσωμάτωση Power BI περιεχομένου με χρήση ενός δείγματος ενσωμάτωσης για την εφαρμογή του οργανισμού σαςTutorial: Embed Power BI content using a sample embed for your organization application

Power BI ενσωματωμένη ανάλυση σάς επιτρέπει να ενσωματώνετε Power BI περιεχόμενο, όπως αναφορές, πίνακες εργαλείων και πλακίδια στην εφαρμογή σας.Power BI embedded analytics allows you to embed Power BI content such as reports, dashboards and tiles, into your application.

Σε αυτή την εκμάθηση, θα μάθετε πώς μπορείτε να κάνετε τα εξής:In this tutorial, you'll learn how to:

  • Ρύθμιση του ενσωματωμένου περιβάλλοντός σας.Set up your embedded environment.
  • Ρυθμίστε τις παραμέτρους ενός ενσωματωμένου δείγματος εφαρμογής για τον οργανισμό σας (γνωστό και ως κάτοχος δεδομένων από το χρήστη).Configure an embed for your organization (also known as user owns data) sample application.

Για να χρησιμοποιήσετε την εφαρμογή σας, οι χρήστες σας θα πρέπει να εισέλθετε στο Power BI.To use your application, your users will need to sign in to Power BI.

Η λύση ενσωμάτωσης για τον οργανισμό σας χρησιμοποιείται συνήθως από επιχειρήσεις και μεγάλους οργανισμούς και προορίζεται για εσωτερικούς χρήστες.The embed for your organization solution is usually used by enterprises and big organizations, and is intended for internal users.

Προδιαγραφές δειγμάτων κώδικαCode sample specifications

Αυτή η εκμάθηση περιλαμβάνει οδηγίες για τη ρύθμιση παραμέτρων ενός ενσωματώσματος για το δείγμα εφαρμογής του οργανισμού σας σε ένα από τα ακόλουθα πλαίσια:This tutorial includes instructions for configuring an embed for your organization sample application in one of the following frameworks:

  • .NET Framework.NET Framework
  • .NET Core.NET Core
  • Αντιδρούν γραφομηχανήReact TypeScript

Σημείωση

Τα δείγματα .NET Core και .NET Framework θα επιτρέψουν στον τελικό χρήστη να προβάλει τυχόν Power BI πίνακα εργαλείων, την αναφορά ή το πλακίδιο στα οποία έχει πρόσβαση στο υπηρεσία Power BI.The .NET Core and the .NET Framework samples will allow the end user to view any Power BI dashboard, report or tile they have access to in Power BI service. Το δείγμα γραφομηχανή αντίδρασης σάς επιτρέπει να ενσωματώσετε μόνο μία αναφορά στην οποία ο τελικός χρήστης έχει ήδη πρόσβαση στο υπηρεσία Power BI.The React TypeScript sample lets you embed only one report that your end user already has access to on Power BI service.

Τα δείγματα κώδικα υποστηρίζουν τα ακόλουθα προγράμματα περιήγησης:The code samples support the following browsers:

  • Microsoft EdgeMicrosoft Edge
  • Google ChromeGoogle Chrome
  • Mozilla FirefoxMozilla Firefox

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

Προτού ξεκινήσετε αυτό το πρόγραμμα εκμάθησης, βεβαιωθείτε ότι έχετε και τις δύο εξαρτήσεις Power BI και κώδικα που αναφέρονται παρακάτω:Before you start this tutorial, verify that you have both the Power BI and code dependencies listed below:


ΜέθοδοςMethod

Για να δημιουργήσετε μια ενσωμάτωση για το δείγμα εφαρμογής του οργανισμού σας , ακολουθήστε τα εξής βήματα:To create an embed for your organization sample app, follow these steps:

  1. Καταχωρήστε μια εφαρμογή Azure AD.Register an Azure AD application.

  2. Δημιουργήστε έναν χώρο εργασίας Power BI.Create a Power BI workspace.

  3. Δημιουργήστε και δημοσιεύστε μια αναφορά Power BI.Create and publish a Power BI report.

  4. Λάβετε τις τιμές παραμέτρων ενσωμάτωσης.Get the embedding parameter values.

  5. Ενσωματώστε το περιεχόμενό σας.Embed your content.

Βήμα 1-καταχώρηση εφαρμογής Azure ADStep 1 - Register an Azure AD application

Η καταχώρηση της εφαρμογής σας με το Azure AD σάς επιτρέπει να δημιουργήσετε μια ταυτότητα για την εφαρμογή σας.Registering your application with Azure AD allows you to establish an identity for your app.

Για να καταχωρήσετε την εφαρμογή σας στο Azure AD, ακολουθήστε τις οδηγίες στην ενότητα Καταχώρηση της εφαρμογής σας.To register your application with Azure AD, follow the instructions in Register your application.

Βήμα 2-Δημιουργία χώρου εργασίας Power BIStep 2 - Create a Power BI workspace

Το Power BI διατηρεί τις αναφορές, τους πίνακες εργαλείων και τα πλακίδια σε έναν χώρο εργασίας.Power BI keeps your reports, dashboards, and tiles in a workspace. Για να ενσωματώσετε αυτά τα στοιχεία, θα χρειαστεί να τα δημιουργήσετε και να τα στείλετε σε έναν χώρο εργασίας.To embed these items, you'll need to create them and upload them into a workspace.

Συμβουλή

Εάν έχετε ήδη έναν χώρο εργασίας, μπορείτε να παραλείψετε αυτό το βήμα.If you already have a workspace, you can skip this step.

Για να δημιουργήσετε ένα χώρο εργασίας, κάντε τα εξής:To create a workspace, do the following:

  1. Εισέλθετε στο Power BI.Sign in to Power BI.

  2. Επιλέξτε Χώροι εργασίας.Select Workspaces.

  3. Επιλέξτε Δημιουργία χώρου εργασίας.Select Create a workspace.

  4. Ονομάστε τον χώρο εργασίας σας και επιλέξτε Αποθήκευση.Name your workspace and select Save.

Βήμα 3-δημιουργία και δημοσίευση μιας αναφοράς Power BIStep 3 - Create and publish a Power BI report

Το επόμενο βήμα είναι να δημιουργήσετε μια αναφορά και να την αποστείλετε στον χώρο εργασίας σας.Your next step is to create a report and upload it to your workspace. Μπορείτε να δημιουργήσετε τη δική σας αναφορά με τη χρήση του Power BI Desktop και, στη συνέχεια, να την δημοσιεύσετε στον χώρο εργασίας σας.You can create your own report using Power BI Desktop, and then publish it to your workspace. Εναλλακτικά, μπορείτε να αποστείλετε ένα δείγμα αναφοράς στον χώρο εργασίας σας.Or, you can upload a sample report to your workspace.

Συμβουλή

Εάν έχετε ήδη έναν χώρο εργασίας με μια αναφορά, μπορείτε να παραλείψετε αυτό το βήμα.If you already have a workspace with a report, you can skip this step.

Για να κάνετε λήψη ενός δείγματος αναφοράς και να το δημοσιεύσετε στον χώρο εργασίας σας, ακολουθήστε τα εξής βήματα:To download a sample report and publish it to your workspace, follow these steps:

  1. Ανοίξτε τον φάκελο GitHub δείγματα Power BI Desktop.Open the GitHub Power BI Desktop samples folder.

  2. Επιλέξτε Κώδικας και, στη συνέχεια, επιλέξτε Λήψη zip.Select Code and then select Download zip.

    Ένα στιγμιότυπο οθόνης που εμφανίζει την επιλογή λήψης ZIP στο GitHub δειγμάτων του Power BI Desktop

  3. Εξαγάγετε το ZIP που έχετε κατεβάσει και μεταβείτε στον φάκελο Δείγματα αναφορών.Extract the downloaded ZIP and navigate to the Samples Reports folder.

  4. Επιλέξτε μια αναφορά για ενσωμάτωση και δημοσιεύστε την στον χώρο εργασίας σας.Select a report to embed, and publish it to your workspace.

Βήμα 4-λήψη των τιμών παραμέτρων ενσωμάτωσηςStep 4 - Get the embedding parameter values

Για να ενσωματώσετε το περιεχόμενό σας, θα πρέπει να λάβετε μερικές τιμές παραμέτρων.To embed your content, you'll need to obtain a few parameter values. Οι τιμές παραμέτρων που θα χρειαστείτε εξαρτώνται από τη γλώσσα του δείγματος εφαρμογής που θέλετε να χρησιμοποιήσετε.The parameter values you'll need depend on the language of the sample application you want to use. Ο παρακάτω πίνακας παραθέτει τις τιμές παραμέτρων που απαιτούνται για κάθε δείγμα.The table below lists which parameter values are required for each sample.

ΠαράμετροςParameter .NET Core.NET Core .NET Framework.NET Framework Αντιδρούν γραφομηχανήReact TypeScript
Αναγνωριστικό υπολογιστή-πελάτηClient ID Ισχύει για. Ισχύει για. Ισχύει για.
Μυστικός κωδικός προγράμματος-πελάτηClient secret Ισχύει για. Ισχύει για. Δεν ισχύει για.
Αναγνωριστικό χώρου εργασίαςWorkspace ID Δεν ισχύει για. Δεν ισχύει για. Ισχύει για.
Αναγνωριστικό αναφοράςReport ID Δεν ισχύει για. Δεν ισχύει για. Ισχύει για.

Αναγνωριστικό υπολογιστή-πελάτηClient ID

Συμβουλή

Ισχύει για:  Ισχύει για. . Ο NET Core  ισχύει για το. . Ισχύει το NET Framework. Αντιδρούν γραφομηχανήApplies to: Applies to..NET Core Applies to..NET Framework Applies to.React TypeScript

Για να λάβετε το αναγνωριστικό GUID προγράμματος-πελάτη (επίσης γνωστό ως αναγνωριστικό εφαρμογής), ακολουθήστε τα εξής βήματα:To get the client ID GUID (also know as application ID), follow these steps:

  1. Συνδεθείτε στο Microsoft Azure.Log into Microsoft Azure.

  2. Πραγματοποιήστε αναζήτηση για τις Καταχωρήσεις εφαρμογών και επιλέξτε τη σύνδεση Καταχωρήσεις εφαρμογών.Search for App registrations and select the App registrations link.

  3. Επιλέξτε την εφαρμογή Azure AD που χρησιμοποιείτε για την ενσωμάτωση του περιεχομένου Power BI.Select the Azure AD app your using for embedding your Power BI content.

  4. Από την ενότητα Επισκόπηση, αντιγράψτε το αναγνωριστικό GUID της εφαρμογής (πρόγραμμα-πελάτης) .From the Overview section, copy the Application (client) ID GUID.

Μυστικός κωδικός προγράμματος-πελάτηClient secret

Συμβουλή

Ισχύει για:  Ισχύει για. . Ο NET Core  ισχύει για το. . Το NET Framework δεν  ισχύει για το. Αντιδρούν γραφομηχανήApplies to: Applies to..NET Core Applies to..NET Framework Does not apply to.React TypeScript

Για να λάβετε τον μυστικό κωδικό προγράμματος-πελάτη, ακολουθήστε τα εξής βήματα:To get the client secret, follow these steps:

  1. Συνδεθείτε στο Microsoft Azure.Log into Microsoft Azure.

  2. Πραγματοποιήστε αναζήτηση για τις Καταχωρήσεις εφαρμογών και επιλέξτε τη σύνδεση Καταχωρήσεις εφαρμογών.Search for App registrations and select the App registrations link.

  3. Επιλέξτε την εφαρμογή Azure AD που χρησιμοποιείτε για την ενσωμάτωση του περιεχομένου Power BI.Select the Azure AD app your using for embedding your Power BI content.

  4. Επιλέξτε Πιστοποιητικά και μυστικοί κωδικοί στην περιοχή Διαχείριση.Under Manage, select Certificates & secrets.

  5. Στην περιοχή Μυστικά προγράμματος-πελάτη, επιλέξτε Νέο μυστικό προγράμματος-πελάτη.Under Client secrets, select New client secret.

  6. Στο αναδυόμενο παράθυρο Προσθήκη ενός μυστικού κωδικού προγράμματος-πελάτη, δώστε μια περιγραφή για τον μυστικό κωδικό της εφαρμογής σας, επιλέξτε πότε λήγει ο μυστικός κωδικός της εφαρμογής και επιλέξτε Προσθήκη.In the Add a client secret pop-up window, provide a description for your application secret, select when the application secret expires, and select Add.

  7. Από την ενότητα Μυστικοί κωδικοί προγράμματος-πελάτη, αντιγράψτε τη συμβολοσειρά στη στήλη Τιμή της μυστικής εφαρμογής που μόλις δημιουργήσατε.From the Client secrets section, copy the string in the Value column of the newly created application secret. Η τιμή μυστικού κωδικού προγράμματος-πελάτη είναι το αναγνωριστικό προγράμματος-πελάτη σας.The client secret value is your client ID.

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

Συμβουλή

Ισχύει για:  Δεν ισχύει για το. . Ο NET Core δεν  ισχύει για το. . Ισχύει το NET Framework. Αντιδρούν γραφομηχανήApplies to: Does not apply to..NET Core Does not apply to..NET Framework Applies to.React TypeScript

Για να λάβετε το αναγνωριστικό GUID του χώρου εργασίας, ακολουθήστε τα εξής βήματα:To get the workspace ID GUID, follow these steps:

  1. Πραγματοποιήστε είσοδο στην υπηρεσία Power BI.Sign in to Power BI service.

  2. Ανοίξτε την αναφορά που θέλετε να ενσωματώσετε.Open the report you want to embed.

  3. Αντιγράψτε το GUID από τη διεύθυνση URL.Copy the GUID from the URL. Το GUID είναι ο αριθμός μεταξύ /groups/ και /reports/ .The GUID is the number between /groups/ and /reports/.

    Ένα στιγμιότυπο οθόνης που εμφανίζει το ΑΝΑΓΝΩΡΙΣΤΙΚΟ GUID χώρου εργασίας στο URL της υπηρεσίας Power BI

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

Συμβουλή

Ισχύει για:  Δεν ισχύει για το. . Ο NET Core δεν  ισχύει για το. . Ισχύει το NET Framework. ReactTypeScriptApplies to: Does not apply to..NET Core Does not apply to..NET Framework Applies to.ReactTypeScript

Για να λάβετε το αναγνωριστικό GUID αναγνωριστικού αναφοράς, ακολουθήστε τα εξής βήματα:To get the report ID GUID, follow these steps:

  1. Πραγματοποιήστε είσοδο στην υπηρεσία Power BI.Sign in to Power BI service.

  2. Ανοίξτε την αναφορά που θέλετε να ενσωματώσετε.Open the report you want to embed.

  3. Αντιγράψτε το GUID από τη διεύθυνση URL.Copy the GUID from the URL. Το GUID είναι ο αριθμός μεταξύ των στοιχείων /reports/ και /ReportSection.The GUID is the number between /reports/ and /ReportSection.

    Ένα στιγμιότυπο οθόνης που εμφανίζει το ΑΝΑΓΝΩΡΙΣΤΙΚΟ GUID αναφοράς στο URL της υπηρεσίας Power BI

Βήμα 5 - Ενσωμάτωση του περιεχομένου σαςStep 5 - Embed your content

Το Power BI ενσωματωμένο δείγμα εφαρμογής σάς επιτρέπει να δημιουργήσετε μια ενσωμάτωση για τον οργανισμό σας Power BI εφαρμογή.The Power BI embedded sample application allows you to create an embed for your organization Power BI app.

Ακολουθήστε τα παρακάτω βήματα για να τροποποιήσετε την ενσωμάτωση για το δείγμα εφαρμογής του οργανισμού σας, για να ενσωματώσετε την αναφορά Power BI.Follow these steps to modify the embed for your organization sample application, to embed your Power BI report.

  1. Ανοίξτε τον φάκελο Δείγματα προγραμματιστών Power BI.Open the Power BI developer samples folder.

  2. Επιλέξτε Κώδικας και, στη συνέχεια, επιλέξτε Λήψη zip.Select Code and then select Download zip.

    Ένα στιγμιότυπο οθόνης που εμφανίζει την επιλογή λήψης ZIP στο GitHub δειγμάτων προγραμματιστή του Power BI Desktop

  3. Εξαγάγετε το ZIP που έχετε κατεβάσει και μεταβείτε στον φάκελο PowerBI-Προγραμματιστής-Δείγματα-κύριος.Extract the downloaded ZIP and navigate to the PowerBI-Developer-Samples-master folder.

  1. Ανάλογα με τη γλώσσα που θέλετε να χρησιμοποιεί η εφαρμογή σας, ανοίξτε έναν από αυτούς τους φακέλους:Depending on the language you want your application to use, open one of these folders:

    • .NET Core.NET Core
    • .NET Framework.NET Framework
    • Αντιδρούν-TSReact-TS

    Σημείωση

    Οι εφαρμογές ενσωμάτωσης για το δείγμα οργανισμού υποστηρίζουν μόνο τα πλαίσια που αναφέρονται παραπάνω.The embed for your organization sample applications only support the frameworks listed above. Τα δείγματα εφαρμογών Java, node JS και Python υποστηρίζουν μόνο τη λύση ενσωμάτωση για τους πελάτες σας .The Java, Node JS and Python sample applications, only support the embed for your customers solution.

Ρυθμίστε τις παραμέτρους της εφαρμογής σας Azure ADConfigure your Azure AD app

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

  2. Επιλέξτε Καταχωρήσεις εφαρμογών.Select App registrations. Αν δεν μπορείτε να δείτε αυτή την επιλογή, αναζητήστε την.If you can't see this option, search for it.

  3. Ανοίξτε την εφαρμογή Azure AD που δημιουργήσατε στο βήμα 1-Καταχωρήστε μια εφαρμογή Azure AD.Open the Azure AD application you created in Step 1 - Register an Azure AD application.

  4. Από το μενού " Διαχείριση ", επιλέξτε Έλεγχος ταυτότητας.From the Manage menu, select Authentication.

  1. Στις ρυθμίσεις παραμέτρων πλατφόρμας, ανοίξτε την πλατφόρμα Web και στην ενότητα ανακατεύθυνση URI , προσθήκη https://localhost:5000/signin-oidc .In Platform configurations, open your Web platform and in the Redirect URIs section, add https://localhost:5000/signin-oidc.

    Σημείωση

    Εάν δεν διαθέτετε μια πλατφόρμα Web , επιλέξτε Προσθήκη πλατφόρμας και στο παράθυρο Ρύθμιση παραμέτρων πλατφορμών , επιλέξτε Web.If you don't have a Web platform, select Add a platform and in the Configure platforms window, select Web.

  2. Αποθηκεύστε τις αλλαγές σας.Save your changes.

Στιγμιότυπο οθόνης που εμφανίζει τις παραμέτρους ελέγχου ταυτότητας της εφαρμογής Azure AD, συμπεριλαμβανομένης της ανακατεύθυνσης Web R I για το δείγμα εφαρμογής .NET Core.

Ρυθμίστε τις παραμέτρους της εφαρμογής δείγματος ενσωμάτωσηςConfigure the sample embedding app

  1. Ανοίξτε τον φάκελο ενσωμάτωση για τον οργανισμό σας .Open the Embed for your organization folder.

  2. Ανοίξτε το δείγμα εφαρμογής ενσωμάτωση για τον οργανισμό σας , χρησιμοποιώντας μία από τις παρακάτω μεθόδους:Open the embed for your organization sample app using one of these methods:

  3. Ανοίξτε appsettings.js και συμπληρώστε τις ακόλουθες τιμές παραμέτρων:Open appsettings.json and fill in the following parameter values:

Εκτελέσετε το δείγμα εφαρμογήςRun the sample app

  1. Εκτελέσετε το έργο, επιλέγοντας την κατάλληλη επιλογή:Run the project by selecting the appropriate option:

    • Εάν χρησιμοποιείτε Visual Studio, επιλέξτε IIS Express (αναπαραγωγή).If you're using Visual Studio, select IIS Express (play).

    • Εάν χρησιμοποιείτε Visual Studio Code, επιλέξτε Εκτέλεση > Έναρξη εντοπισμού σφαλμάτων.If you're using Visual Studio Code, select Run > Start Debugging.

  1. Πραγματοποιήστε είσοδο στο δείγμα εφαρμογής ενσωμάτωσης.Sign into the embedding sample application.

    Σημείωση

    Κατά τη διάρκεια της πρώτης εισόδου, θα σας ζητηθούν τα δικαιώματα Azure AD για την εφαρμογή.During your first sign in, you'll be prompted to allow Azure AD permissions for the app.

  2. Όταν φορτωθεί το δείγμα εφαρμογής ενσωμάτωσης, επιλέξτε το περιεχόμενο Power BI που θέλετε να ενσωματώσετε και, στη συνέχεια, επιλέξτε ενσωμάτωση.When the embedding sample application loads, select the Power BI content you want to embed and then select Embed.

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

Ανάπτυξη της εφαρμογής σαςDeveloping your application

Μετά τη ρύθμιση παραμέτρων και την εκτέλεση του δείγματος εφαρμογής ενσωμάτωση για τους πελάτες σας, μπορείτε να ξεκινήσετε την ανάπτυξη της δικής σας εφαρμογής.After configuring and running the embed for your customers sample application, you can start developing your own application.

Όταν είστε έτοιμοι, εξετάστε τις απαιτήσεις για μετακίνηση στην παραγωγή.When you're ready, review the move to production requirements. Θα χρειαστείτε επίσης μια Χωρητικότητακαι θα πρέπει να εξετάσετε το άρθρο προγραμματισμού χωρητικότητας για να ΚΑΘΟΡΊΣΕΤΕ ποιες καλύτερες σουίτες SKU χρειάζεστε.You'll also need a capacity, and should review the capacity planning article to establish which SKU best suites your needs.

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