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

Η ενσωμάτωση ανάλυσης και το Power BI Embedded (η προσφορά Azure) σάς επιτρέπει να ενσωματώνετε περιεχόμενο Power BI, όπως αναφορές, πίνακες εργαλείων και πλακίδια στην εφαρμογή σας.Embedded analytics and Power BI Embedded (the Azure offer) allow 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 customers (also known as app owns data) sample application.

Για να χρησιμοποιήσουν την εφαρμογή σας, οι χρήστες σας δεν θα χρειάζεται να εισέρχονται στο Power BI ή να έχουν μια άδεια χρήσης Power BI.To use your application, your users will not need to sign in to Power BI or have a Power BI license.

Συνιστούμε να χρησιμοποιήσετε τη μέθοδο ενσωμάτωση για τους πελάτες σας για να ενσωματώσετε το περιεχόμενό σας Power BI, εάν είστε ένας ανεξάρτητος προμηθευτής λογισμικού (ISV) ή ένας προγραμματιστής, που θέλει να δημιουργήσει εφαρμογές για τρίτα μέρη.We recommend using the embed for your customers method to embed your Power BI content, if you're an independent software vendor (ISV) or a developer, who wants to create applications for third parties.

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

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

  • .NET Framework.NET Framework
  • .NET Core.NET Core
  • JavaJava
  • Node JSNode JS
  • PythonPython

Τα δείγματα κώδικα υποστηρίζουν τα ακόλουθα προγράμματα περιήγησης: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 customers sample app, follow these steps:

  1. Επιλέξτε μέθοδο ελέγχου ταυτότητας.Select your authentication method.

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

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

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

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

  6. Πρόσβαση στο API κύριας υπηρεσίαςService principal API access

  7. Ενεργοποίηση πρόσβασης στον χώρο εργασίας.Enable workspace access.

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

Βήμα 1 - Επιλέξτε μέθοδο ελέγχου ταυτότηταςStep 1 - Select your authentication method

Η λύση ενσωμάτωσης θα ποικίλλει ανάλογα με τη μέθοδο ελέγχου ταυτότητας που επιλέγετε.Your embedded solution will vary depending on the authentication method you select. Επομένως, είναι σημαντικό να κατανοήσετε τις διαφορές μεταξύ των μεθόδων ελέγχου ταυτότητας και να αποφασίσετε ποια ταιριάζει καλύτερα στη λύση σας.Therefore, it's important to understand the differences between the authentication methods, and decide which one best suits your solution.

Ο παρακάτω πίνακας περιγράφει μερικές σημαντικές διαφορές μεταξύ των μεθόδων ελέγχου ταυτότητας κύρια υπηρεσία και κύριος χρήστης.The table below describes a few key differences between the service principal and master user authentication methods.

ΖήτημαConsideration Κύρια υπηρεσίαService principal Κύριος χρήστηςMaster user
ΜηχανισμόςMechanism Το αντικείμενο κύριας υπηρεσίας της εφαρμογής σας Azure AD επιτρέπει στο Azure AD τον έλεγχο ταυτότητας της εφαρμογής σας "λύση ενσωμάτωσης" με το Power BI.Your Azure AD app's service principal object allows Azure AD to authenticate your embedded solution app against Power BI. Η εφαρμογή σας Azure AD χρησιμοποιεί τα διαπιστευτήρια (όνομα χρήστη και κωδικός πρόσβασης) ενός χρήστη Power BI, για τον έλεγχο ταυτότητας με το Power BI.Your Azure AD app uses the credentials (username and password) of a Power BI user, to authenticate against Power BI.
ΑσφάλειαSecurity Η κύρια υπηρεσία είναι η συνιστώμενη μέθοδος εξουσιοδότησης Azure AD.Service principal is the Azure AD recommended authorization method. Εάν χρησιμοποιείτε μια κύρια υπηρεσία, μπορείτε να κάνετε έλεγχο ταυτότητας χρησιμοποιώντας είτε ένα μυστικό εφαρμογής είτε ένα πιστοποιητικό.If you're using a service principal,* you can authenticate using either an application secret or a certificate.

Αυτή η εκμάθηση περιγράφει μόνο τη χρήση της κύριας υπηρεσίας με ένα μυστικό εφαρμογής.This tutorial only describes using service principal with an application secret. Για να πραγματοποιήσετε ενσωμάτωση χρησιμοποιώντας μια κύρια υπηρεσία και ένα πιστοποιητικό, ανατρέξτε στο άρθρο κύρια υπηρεσία με πιστοποιητικό.To embed using a service principal and a certificate, refer to the service principal with a certificate article.
Αυτή η μέθοδος ελέγχου ταυτότητας δεν θεωρείται τόσο ασφαλής όσο η χρήση μιας κύριας υπηρεσίας.This authentication method is not considered as secure as using a service principal. Αυτό συμβαίνει επειδή πρέπει να είστε προσεκτικοί με τα διαπιστευτήρια του κύριου χρήστη (όνομα χρήστη και κωδικός πρόσβασης).This is because you have to be vigilant with the master user credentials (username and password). Για παράδειγμα, δεν πρέπει να τα εκθέτετε στην εφαρμογή ενσωμάτωσης και θα πρέπει να αλλάζετε συχνά τον κωδικό πρόσβασης.For example, you must not expose them in your embedding application, and you should change the password frequently.
Δικαιώματα με ανάθεση Azure ADAzure AD delegated permissions Δεν απαιτούνται.Not required. Ο κύριος χρήστης ή ένας διαχειριστής πρέπει να παραχωρήσει συγκατάθεση για να μπορεί η εφαρμογή σας να αποκτήσει πρόσβαση στα δικαιώματα του Power BI REST API (γνωστά και ως εμβέλειες).Your master user or an administrator has to grant consent for your app to access Power BI REST API permissions (also known as scopes). Για παράδειγμα, Report.ReadWrite.All.For example, Report.ReadWrite.All.
Πρόσβαση στην Υπηρεσία Power BIPower BI service access Δεν μπορείτε να αποκτήσετε πρόσβαση στην Υπηρεσία Power BI με μια κύρια υπηρεσία.You can't access Power BI service with a service principal. Μπορείτε να αποκτήσετε πρόσβαση στην Υπηρεσία Power BI με τα διαπιστευτήριά σας κύριου χρήστη.You can access Power BI service with your master user credentials.
Άδεια χρήσηςLicense Δεν απαιτείται άδεια χρήσης Pro.Doesn't require a Pro license. Μπορείτε να χρησιμοποιήσετε περιεχόμενο από οποιονδήποτε χώρο εργασίας στον οποίο είστε μέλος ή διαχειριστής.You can use content from any workspace that you're a member or an admin of. Απαιτεί άδεια χρήσης Power BI Pro ή Premium ανά χρήστη (PPU).Requires a Power BI Pro or Premium Per User (PPU) license.

Βήμα 2 - Καταχωρήστε μια εφαρμογή Azure ADStep 2 - Register an Azure AD application

Η καταχώρηση της εφαρμογής σας με το Azure AD σάς επιτρέπει να κάνετε τα εξής:Registering your application with Azure AD allows you to:

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

Σημείωση

Προτού καταχωρήσετε την εφαρμογή σας, θα πρέπει να αποφασίσετε ποια μέθοδο ελέγχου ταυτότητας θα χρησιμοποιήσετε, την κύρια υπηρεσία ή τον κύριο χρήστη.Before registering your application, you'll need to decide which authentication method to use, service principal or master user.

Βήμα 3 - Δημιουργήστε έναν χώρο εργασίας Power BIStep 3 - 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.

Βήμα 4 - Δημιουργήστε και δημοσιεύστε μια αναφορά Power BIStep 4 - 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.

Βήμα 5 - Λάβετε τις τιμές παραμέτρων ενσωμάτωσηςStep 5 - Get the embedding parameter values

Για να ενσωματώσετε το περιεχόμενό σας, θα πρέπει να αποκτήσετε ορισμένες τιμές παραμέτρων.To embed your content, you'll need to obtain certain parameter values. Ο παρακάτω πίνακας εμφανίζει τις απαιτούμενες τιμές και υποδεικνύει εάν ισχύουν για τη μέθοδο ελέγχου ταυτότητας κύριας υπηρεσίας , τη μέθοδο ελέγχου ταυτότητας Master user ή και τα δύο.The table below shows the required values, and indicates if they're applicable to the service principal authentication method, the master user authentication method, or both.

Προτού ενσωματώσετε το περιεχόμενό σας, βεβαιωθείτε ότι έχετε όλες τις τιμές που παρατίθενται παρακάτω.Before you embed your content, make sure you have all the values listed below. Ορισμένες από τις τιμές θα διαφέρουν, ανάλογα με τη μέθοδο ελέγχου ταυτότητας που χρησιμοποιείτε.Some of the values will differ, depending on the authentication method you're using.

ΠαράμετροςParameter Κύρια υπηρεσίαService principal Κύριος χρήστηςMaster user
Αναγνωριστικό υπολογιστή-πελάτηClient ID Ισχύει για. Ισχύει για.
Αναγνωριστικό χώρου εργασίαςWorkspace ID Ισχύει για. Ισχύει για.
Αναγνωριστικό αναφοράςReport ID Ισχύει για. Ισχύει για.
Μυστικός κωδικός προγράμματος-πελάτηClient secret Ισχύει για. Δεν ισχύει για.
Αναγνωριστικό μισθωτήTenant ID Ισχύει για. Δεν ισχύει για.
Όνομα χρήστη Power BIPower BI username Δεν ισχύει για. Ισχύει για.
Κωδικό πρόσβασης Power BIPower BI password Δεν ισχύει για. Ισχύει για.

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

Συμβουλή

Ισχύει για τα προγράμματα: Ισχύει για.Κύρια υπηρεσία Ισχύει για.Κύριος χρήστηςApplies to: Applies to.Service principal Applies to.Master user

Για να λάβετε το αναγνωριστικό 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.

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

Συμβουλή

Ισχύει για τα προγράμματα: Ισχύει για.Κύρια υπηρεσία Ισχύει για.Κύριος χρήστηςApplies to: Applies to.Service principal Applies to.Master user

Για να λάβετε το αναγνωριστικό 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

Συμβουλή

Ισχύει για τα προγράμματα: Ισχύει για.Κύρια υπηρεσία Ισχύει για.Κύριος χρήστηςApplies to: Applies to.Service principal Applies to.Master user

Για να λάβετε το αναγνωριστικό 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

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

Συμβουλή

Ισχύει για τα προγράμματα: Ισχύει για.Κύρια υπηρεσία Δεν ισχύει για.Κύριος χρήστηςApplies to: Applies to.Service principal Does not apply to.Master user

Για να λάβετε τον μυστικό κωδικό προγράμματος-πελάτη, ακολουθήστε τα εξής βήματα: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.

Σημείωση

Βεβαιωθείτε ότι έχετε αντιγράψει την κρυφή τιμή του προγράμματος-πελάτη όταν εμφανίζεται για πρώτη φορά.Make sure you copy the client secret value when it first appears. Αφού απομακρυνθείτε από αυτήν τη σελίδα, το μυστικό του πελάτη θα είναι κρυφό και δεν θα μπορείτε να ανακτήσετε την τιμή του.After navigating away from this page, the client secret will be hidden and you'll not be able to retrieve its value.

Αναγνωριστικό μισθωτήTenant ID

Συμβουλή

Ισχύει για τα προγράμματα: Ισχύει για.Κύρια υπηρεσία Δεν ισχύει για.Κύριος χρήστηςApplies to: Applies to.Service principal Does not apply to.Master user

Για να λάβετε το αναγνωριστικό GUID μισθωτή, ακολουθήστε τα εξής βήματα:To get the tenant ID GUID, 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 you're using for embedding your Power BI content.

  4. Από την ενότητα Επισκόπηση, αντιγράψτε το GUID Αναγνωριστικό καταλόγου (μισθωτή) .From the Overview section, copy the Directory (tenant) ID GUID.

Όνομα χρήστη και κωδικός πρόσβασης Power BIPower BI username and password

Συμβουλή

Ισχύει για τα προγράμματα: Δεν Ισχύει για.Κύρια υπηρεσία Ισχύει για.Κύριος χρήστηςApplies to: Does not apply to.Service principal Applies to.Master user

Αποκτήστε το όνομα χρήστη και τον κωδικό πρόσβασης του χρήστη Power BI που χρησιμοποιείτε ως κύριο χρήστη.Obtain the username and password of the Power BI user you're using as your master user. Αυτός είναι ο ίδιος χρήστης που χρησιμοποιήσατε για να δημιουργήσετε ένα χώρο εργασίας και να αποστείλετε μια αναφορά στην Υπηρεσία Power BI.This is the same user you used to create a workspace and upload a report to, in Power BI service.

Βήμα 6 - Πρόσβαση στο API κύριας υπηρεσίαςStep 6 - Service principal API access

Συμβουλή

Ισχύει για τα προγράμματα: Ισχύει για.Κύρια υπηρεσία Δεν ισχύει για.Κύριος χρήστηςApplies to: Applies to.Service principal Does not apply to.Master user

Αυτό το βήμα ισχύει μόνο εάν χρησιμοποιείτε τη μέθοδο ελέγχου ταυτότητας κύρια υπηρεσία.This step is only relevant if you're using the service principal authentication method. Εάν χρησιμοποιείτε έναν κύριο χρήστη, παραλείψτε αυτό το βήμα και συνεχίστε με το Βήμα 7 - Ενεργοποίηση πρόσβασης σε χώρο εργασίας.If you're using a master user, skip this step and continue with Step 7 - Enable workspace access.

Για να μπορεί μια εφαρμογή Azure AD να έχει πρόσβαση στο περιεχόμενο Power BI και τα API, ένας διαχειριστής Power BI χρειάζεται να επιτρέψει την πρόσβαση κύριας υπηρεσίας στην πύλη διαχειριστή Power BI.For an Azure AD app to be able to access the Power BI content and APIs, a Power BI admin needs to enable service principal access in the Power BI admin portal. Εάν δεν είστε ο διαχειριστής του μισθωτή σας, λάβετε τον διαχειριστή του μισθωτή για να ενεργοποιήσετε τις Ρυθμίσεις μισθωτή για εσάς.If you're not the admin of your tenant, get the tenant's admin to enable the Tenant settings for you.

  1. Στην Υπηρεσία Power BI, επιλέξτε Ρυθμίσεις > Ρυθμίσεις > Πύλη διαχείρισης.In Power BI service, select Settings > Settings > Admin portal.

    Ένα στιγμιότυπο οθόνης που εμφανίζει την επιλογή μενού ρυθμίσεων διαχειριστή στο μενού ρυθμίσεων της υπηρεσίας Power BI

  2. Επιλέξτε Ρυθμίσεις μισθωτή και, στη συνέχεια, κάντε κύλιση προς τα κάτω στην ενότητα Ρυθμίσεις προγραμματιστή.Select Tenant settings and then scroll down to the Developer settings section.

  3. Αναπτύξτε την επιλογή Να επιτρέπεται στις κύριες υπηρεσίες η χρήση των API του Power BI και ενεργοποιήστε αυτή την επιλογή.Expand Allow service principals to use Power BI APIs, and enable this option.

    Ένα στιγμιότυπο οθόνης που δείχνει πώς μπορείτε να ενεργοποιήσετε την επιλογή "Ρυθμίσεις προγραμματιστή", στην επιλογή μενού "Ρυθμίσεις μισθωτή", στην υπηρεσία Power BI

Σημείωση

Κατά τη χρήση μιας κύριας υπηρεσίας, συνιστάται να περιορίσετε την πρόσβασή της στις ρυθμίσεις μισθωτή, χρησιμοποιώντας μια ομάδα ασφαλείας.When using a service principal, it's recommended to limit its access to the tenant settings using a security group. Για να μάθετε περισσότερα σχετικά με αυτήν τη δυνατότητα, ανατρέξτε σε αυτές τις ενότητες στο άρθρο κύρια υπηρεσία:To learn more about this feature, see these sections in the service principal article:

Βήμα 7 - Ενεργοποίηση πρόσβασης στον χώρο εργασίαςStep 7 - Enable workspace access

Για να επιτρέψετε στην εφαρμογή σας Azure AD πρόσβαση σε τεχνουργήματα όπως αναφορές, πίνακες εργαλείων και σύνολα δεδομένων στην υπηρεσία Power BI, προσθέστε την κύρια υπηρεσία ή τον κύριο χρήστη ως μέλος ή διαχειριστή στον χώρο εργασίας σας.To enable your Azure AD app access artifacts such as reports, dashboards and datasets in the Power BI service, add the service principal or master user, as a member or admin to your workspace.

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

  2. Μεταβείτε στον χώρο εργασίας για τον οποίο θέλετε να επιτρέψετε την πρόσβαση και από το μενού Περισσότερα, επιλέξτε Πρόσβαση σε χώρο εργασίας.Scroll to the workspace you want to enable access for, and from the More menu, select Workspace access.

    Στιγμιότυπο οθόνης που εμφανίζει το κουμπί πρόσβασης χώρου εργασίας στο μενού "Περισσότερα" ενός χώρου εργασίας Power BI.

  3. Στο τμήμα παραθύρου Πρόσβαση, ανάλογα με τη μέθοδο ελέγχου ταυτότητας που χρησιμοποιείτε, αντιγράψτε την κύρια υπηρεσία ή τον κύριο χρήστη στο πλαίσιο κειμένου Εισαγωγή διεύθυνσης ηλεκτρονικού ταχυδρομείου.In the Access pane, depending on which authentication method you're using, copy the service principal or master user to the Enter email address text box.

    Σημείωση

    Εάν χρησιμοποιείτε μια κύρια υπηρεσία, το όνομά της είναι το όνομα που δώσατε στην εφαρμογή σας Azure AD.If you're using a service principal, its name is the name you gave your Azure AD app.

  4. Επιλέξτε Προσθήκη.Select Add.

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

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

Ακολουθήστε τα παρακάτω βήματα για να τροποποιήσετε το δείγμα εφαρμογής ενσωμάτωση για τους πελάτες σας, για να ενσωματώσετε την αναφορά Power BI.Follow these steps to modify the embed for your customers 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
    • JavaJava
    • Node JSNode JS
    • PythonPython

    Σημείωση

    Το στοιχείο ενσωμάτωση για τους πελάτες σας δείγματα εφαρμογών υποστηρίζουν μόνο τα πλαίσια που αναφέρονται παραπάνω.The embed for your customers sample applications only support the frameworks listed above. Το δείγμα εφαρμογής αντιδρούν υποστηρίζει μόνο τη λύση ενσωμάτωση για τον οργανισμό σας .The React sample application only supports the embed for your organization solution.

  2. Ανοίξτε τον φάκελο Ενσωμάτωση για τους πελάτες σας.Open the Embed for your customers folder.

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

  2. Ανοίξτε το appsettings.json.Open appsettings.json.

  3. Ανάλογα με τη μέθοδο ελέγχου ταυτότητας, συμπληρώστε τις ακόλουθες τιμές παραμέτρων:Depending on your authentication method, fill in the following parameter values:

    ΠαράμετροςParameter Κύρια υπηρεσίαService principal Κύριος χρήστηςMaster user
    AuthenticationMode ServicePrincipalServicePrincipal MasterUserMasterUser
    ClientId Το δικό σας αναγνωριστικό προγράμματος-πελάτη της εφαρμογής σας Azure ADYour Azure AD app client ID Το δικό σας αναγνωριστικό προγράμματος-πελάτη της εφαρμογής σας Azure ADYour Azure AD app client ID
    TenantId Το δικό σας αναγνωριστικό μισθωτή του Azure ADYour Azure AD tenant ID Δ/ΥN/A
    PbiUsername Δ/ΥN/A Το όνομα χρήστη κύριου χρήστη, ανατρέξτε στην ενότητα Όνομα χρήστη και κωδικός πρόσβασης Power BIYour master user username, see Power BI username and password
    PbiPassword Δ/ΥN/A Ο κωδικός πρόσβασης κύριου χρήστη, ανατρέξτε στην ενότητα Όνομα χρήστη και κωδικός πρόσβασης Power BIYour master user password, see Power BI username and password
    ClientSecret Ο μυστικός κωδικός προγράμματος-πελάτη του Azure ADYour Azure AD client secret Δ/ΥN/A
    WorkspaceId Το αναγνωριστικό του χώρου εργασίας με την ενσωματωμένη αναφορά σας, ανατρέξτε στο Αναγνωριστικό χώρου εργασίαςThe ID of the workspace with your embedded report, see Workspace ID Το αναγνωριστικό του χώρου εργασίας με την ενσωματωμένη αναφορά σας, ανατρέξτε στο Αναγνωριστικό χώρου εργασίαςThe ID of the workspace with your embedded report, see Workspace ID
    ReportId Το αναγνωριστικό της αναφοράς που ενσωματώνετε, ανατρέξτε στο Αναγνωριστικό αναφοράςThe ID of the report you're embedding, see Report ID Το αναγνωριστικό της αναφοράς που ενσωματώνετε, ανατρέξτε στο Αναγνωριστικό αναφοράςThe ID of the report you're embedding, see Report ID
  4. Εκτελέσετε το έργο, επιλέγοντας την κατάλληλη επιλογή: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.

Ανάπτυξη της εφαρμογής σας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