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

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

Σε αυτό το εκπαιδευτικό βοήθημα, θα μάθετε πώς μπορείτε να κάνετε τα εξής:

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

Για να χρησιμοποιήσουν την εφαρμογή σας, οι χρήστες σας θα πρέπει να εισέλθουν στο Power BI.

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

Σημαντικό

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

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

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

• .NET Framework
• .NET Core
• React TypeScript

Σημείωμα

Τα δείγματα .NET Core και .NET Framework επιτρέπουν στον τελικό χρήστη να προβάλει οποιονδήποτε πίνακα εργαλείων, αναφορά ή πλακίδιο Power BI στο οποίο έχει πρόσβαση στην υπηρεσία Power BI. Το δείγμα React TypeScript σάς επιτρέπει να ενσωματώσετε μόνο μία αναφορά στην οποία έχει ήδη πρόσβαση ο τελικός χρήστης σας στην υπηρεσία Power BI.

Τα δείγματα κώδικα υποστηρίζουν τα ακόλουθα προγράμματα περιήγησης:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

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

Προτού ξεκινήσετε αυτή την εκμάθηση, βεβαιωθείτε ότι έχετε και τις δύο ακόλουθες εξαρτήσεις Power BI και κώδικα:

• Εξαρτήσεις Power BI

  • Ο δικός σας μισθωτής Microsoft Entra.

    • Μία από τις παρακάτω άδειες χρήσης:

      • Power BI Pro

      • Premium ανά χρήστη (PPU)

    Σημείωμα

    Για να μετακινηθείτε στην παραγωγή θα χρειαστείτε μία από τις ακόλουθες ρυθμίσεις παραμέτρων:

    • Όλοι οι χρήστες με άδειες χρήσης Pro.
    • Όλοι οι χρήστες με άδειες χρήσης PPU.
    • Μια SKU που ισοδυναμεί ή μεγαλύτερη από μια SKU F64. Αυτή η ρύθμιση παραμέτρων επιτρέπει σε όλους τους χρήστες να έχουν δωρεάν άδειες χρήσης.

• Εξαρτήσεις κώδικα

  .NET Core

  • .NET Core 3.1 SDK (ή νεότερη έκδοση)

  • Ένα ενσωματωμένο περιβάλλον ανάπτυξης (IDE). Συνιστούμε τη χρήση ενός από τα παρακάτω ΙDEs:

    • Visual Studio

    • Κώδικας Visual Studio

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • Πρόγραμμα επεξεργασίας κειμένου

  • Τερματικό γραμμής εντολών (ή PowerShell)

---

Μέθοδος

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

1. Καταχωρήστε μια εφαρμογή Microsoft Entra.

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

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

4. Λάβετε τις τιμές παραμέτρων ενσωμάτωσης.

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

Βήμα 1 - Καταχωρήστε μια εφαρμογή Microsoft Entra

Η καταχώρηση της εφαρμογής σας στο Αναγνωριστικό Microsoft Entra σάς επιτρέπει να δημιουργήσετε μια ταυτότητα για την εφαρμογή σας.

Για να καταχωρήσετε την εφαρμογή σας στο Microsoft Entra ID, ακολουθήστε τις οδηγίες στην ενότητα Καταχώρηση της εφαρμογής σας.

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

Το Microsoft Fabric διατηρεί τις αναφορές, τους πίνακες εργαλείων και τα πλακίδια σας σε έναν χώρο εργασίας. Για να ενσωματώσετε αυτά τα στοιχεία, πρέπει να τα δημιουργήσετε και να τα αποστείλετε σε έναν χώρο εργασίας.

Φιλοδώρημα

Εάν έχετε ήδη έναν χώρο εργασίας, μπορείτε να παραλείψετε αυτό το βήμα.

Για να δημιουργήσετε έναν χώρο εργασίας, κάντε τα εξής:

1. Εισέλθετε στο Fabric.

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

3. Επιλέξτε + Νέος χώρος εργασίας.

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

Βήμα 3 - Δημιουργία και δημοσίευση μιας αναφοράς Power BI

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

Φιλοδώρημα

Εάν έχετε ήδη έναν χώρο εργασίας με μια αναφορά, μπορείτε να παραλείψετε αυτό το βήμα.

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

1. Ανοίξτε τον φάκελο GitHub Δείγματα Power BI Desktop.

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

   

3. Εξαγάγετε το ZIP που έχετε κατεβάσει και μεταβείτε στον φάκελο Δείγματα αναφορών .

4. Επιλέξτε μια αναφορά για ενσωμάτωση και δημοσιεύστε τη στον χώρο εργασίας σας.

Βήμα 4 - Λήψη των τιμών παραμέτρων ενσωμάτωσης

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

Παράμετρος	.NET Core	.NET Framework	React TypeScript
Αναγνωριστικό προγράμματος-πελάτη
Μυστικός κωδικός προγράμματος-πελάτη
Αναγνωριστικό χώρου εργασίας
Αναγνωριστικό αναφοράς

Αναγνωριστικό πελάτη

Φιλοδώρημα

Ισχύει για: .NET Core .NET Framework React TypeScript

Για να λάβετε το αναγνωριστικό GUID προγράμματος-πελάτη (επίσης γνωστό ως αναγνωριστικό εφαρμογής), ακολουθήστε τα εξής βήματα:

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

2. Κάντε αναζήτηση για Καταχωρήσεις εφαρμογών και επιλέξτε τη σύνδεση Καταχωρήσεις εφαρμογών .

3. Επιλέξτε την εφαρμογή Microsoft Entra που χρησιμοποιείτε για την ενσωμάτωση του περιεχομένου σας Power BI.

4. Από την ενότητα Επισκόπηση , αντιγράψτε το ΑΝΑΓΝΩΡΙΣΤΙΚΌ GUID εφαρμογής (πρόγραμμα-πελάτης).

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

Φιλοδώρημα

Ισχύει για: .NET Core .NET Framework React TypeScript

Για να λάβετε τον μυστικό κωδικό προγράμματος-πελάτη, ακολουθήστε τα εξής βήματα:

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

2. Κάντε αναζήτηση για Καταχωρήσεις εφαρμογών και επιλέξτε τη σύνδεση Καταχωρήσεις εφαρμογών .

3. Επιλέξτε την εφαρμογή Microsoft Entra που χρησιμοποιείτε για την ενσωμάτωση του περιεχομένου σας Power BI.

4. Στην περιοχή Διαχείριση, επιλέξτε Πιστοποιητικά και μυστικά.

5. Στην περιοχή Μυστικά προγράμματος-πελάτη, επιλέξτε Νέος μυστικός κωδικός προγράμματος-πελάτη.

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

7. Από την ενότητα Μυστικοί κωδικό προγράμματος-πελάτη, αντιγράψτε τη συμβολοσειρά στη στήλη Τιμή του μυστικού κωδικού της εφαρμογής που μόλις δημιουργήσατε. Η τιμή του μυστικού κωδικού προγράμματος-πελάτη είναι το αναγνωριστικό προγράμματος-πελάτη.

Σημείωμα

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

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

Φιλοδώρημα

Ισχύει για: .NET Core .NET Framework React TypeScript

Για να λάβετε το αναγνωριστικό GUID χώρου εργασίας, ακολουθήστε τα εξής βήματα:

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

2. Ανοίξτε την αναφορά που θέλετε να ενσωματώσετε.

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

   

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

Φιλοδώρημα

Ισχύει για: .NET Core .NET Framework ReactTypeScript

Για να λάβετε το αναγνωριστικό GUID αναφοράς, ακολουθήστε τα εξής βήματα:

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

2. Ανοίξτε την αναφορά που θέλετε να ενσωματώσετε.

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

   

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

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

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

1. Ανοίξτε τον φάκελο Δείγματα για προγραμματιστές του Power BI.

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

   

3. Εξαγάγετε το ZIP που έχετε κατεβάσει και μεταβείτε στον φάκελο PowerBI-Προγραμματιστής-Δείγματα-κύριος .

4. Ανοίξτε έναν από τους ακόλουθους φακέλους ανάλογα με τη γλώσσα που θέλετε να χρησιμοποιεί η εφαρμογή σας:

   • .NET Core
   • .NET Framework
   • React-TS

   Σημείωμα

   Τα δείγματα εφαρμογών ενσωμάτωσης για τον οργανισμό σας υποστηρίζουν μόνο τα πλαίσια που αναφέρθηκαν προηγουμένως. Τα δείγματα Java, Node JS και Python , υποστηρίζουν μόνο τη λύση ενσωμάτωση για τους πελάτες σας.

.NET Core

Ρύθμιση παραμέτρων της εφαρμογής Σας Microsoft Entra

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

2. Επιλέξτε Καταχωρήσεις εφαρμογών. Εάν δεν μπορείτε να δείτε αυτή την επιλογή, αναζητήστε την.

3. Ανοίξτε την εφαρμογή Microsoft Entra που δημιουργήσατε στο Βήμα 1 - Καταχώρηση μιας εφαρμογής Microsoft Entra.

4. Από το μενού Διαχείριση , επιλέξτε Έλεγχος ταυτότητας.

5. Στις Ρυθμίσεις παραμέτρων πλατφόρμας, ανοίξτε την πλατφόρμα Web και στην ενότητα URIs ανακατεύθυνσης, προσθέστε https://localhost:5000/signin-oidc.

   Σημείωμα

   Εάν δεν έχετε μια πλατφόρμα Web , επιλέξτε Προσθήκη πλατφόρμας και στο παράθυρο Ρύθμιση παραμέτρων πλατφορμών , επιλέξτε Web.

6. Αποθηκεύστε τις αλλαγές σας.

Ρύθμιση παραμέτρων του δείγματος εφαρμογής ενσωμάτωσης

1. Ανοίξτε τον φάκελο Ενσωμάτωση για τον οργανισμό σας.

2. Ανοίξτε το δείγμα εφαρμογής ενσωμάτωση για τον οργανισμό σας χρησιμοποιώντας μία από αυτές τις μεθόδους:

   • Εάν χρησιμοποιείτε Visual Studio, ανοίξτε το αρχείο UserOwnsData.sln .

   • Εάν χρησιμοποιείτε Visual Studio Code, ανοίξτε τον φάκελο UserOwnsData .

3. Ανοίξτε appsettings.json και συμπληρώστε τις παρακάτω τιμές παραμέτρων:

   • ClientId- Χρήση του αναγνωριστικού GUID προγράμματος-πελάτη

   • ClientSecret- Χρήση του μυστικού κωδικού προγράμματος-πελάτη

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

1. Εκτελέστε το έργο, επιλέγοντας την κατάλληλη επιλογή:

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

   • Εάν χρησιμοποιείτε Κώδικα Visual Studio, επιλέξτε Εκτέλεση > Έναρξη εντοπισμού σφαλμάτων.

2. Πραγματοποιήστε είσοδο στο δείγμα εφαρμογής ενσωμάτωσης.

   Σημείωμα

   Κατά την πρώτη σας είσοδο, θα σας ζητηθεί να επιτρέψετε δικαιώματα microsoft Entra για την εφαρμογή.

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

   

.NET Framework

Ρύθμιση παραμέτρων της εφαρμογής Σας Microsoft Entra

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

2. Επιλέξτε Καταχωρήσεις εφαρμογών. Εάν δεν μπορείτε να δείτε αυτή την επιλογή, αναζητήστε την.

3. Ανοίξτε την εφαρμογή Microsoft Entra που δημιουργήσατε στο Βήμα 1 - Καταχώρηση μιας εφαρμογής Microsoft Entra.

4. Από το μενού Διαχείριση , επιλέξτε Έλεγχος ταυτότητας.

5. Στις ρυθμίσεις παραμέτρων πλατφόρμας, ρυθμίστε τις παραμέτρους των παρακάτω επιλογών:

   1. Στην πλατφόρμα Web, στην ενότητα URIs ανακατεύθυνσης, προσθέστε https://localhost:44300/.

      Σημείωμα

      Εάν δεν έχετε μια πλατφόρμα Web , επιλέξτε Προσθήκη πλατφόρμας και στο παράθυρο Ρύθμιση παραμέτρων πλατφορμών , επιλέξτε Web.

   2. Στην επιλογή Έμμεση εκχώρηση και υβριδικές ροές, ενεργοποιήστε την επιλογή Διακριτικά αναγνωριστικού .

6. Αποθηκεύστε τις αλλαγές σας.

Ρύθμιση παραμέτρων του δείγματος εφαρμογής ενσωμάτωσης

1. Ανοίξτε τον φάκελο Ενσωμάτωση για τον οργανισμό σας.

2. Χρησιμοποιώντας το Visual Studio, ανοίξτε το αρχείο UserOwnsData.sln .

3. Ανοίξτε το Web.config και συμπληρώστε τις παρακάτω τιμές παραμέτρων:

   • clientId- Χρήση του αναγνωριστικού GUID προγράμματος-πελάτη

   • clientSecret- Χρήση του μυστικού κωδικού προγράμματος-πελάτη

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

1. Εκτελέστε το έργο επιλέγοντας IIS Express (αναπαραγωγή).

2. Πραγματοποιήστε είσοδο στο δείγμα εφαρμογής ενσωμάτωσης.

   Σημείωμα

   Κατά την πρώτη σας είσοδο, θα σας ζητηθεί να επιτρέψετε δικαιώματα microsoft Entra για την εφαρμογή.

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

   

React TypeScript

Ρύθμιση παραμέτρων της εφαρμογής Σας Microsoft Entra

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

2. Επιλέξτε Καταχωρήσεις εφαρμογών. Εάν δεν μπορείτε να δείτε αυτή την επιλογή, αναζητήστε την.

3. Ανοίξτε την εφαρμογή Microsoft Entra που δημιουργήσατε στο Βήμα 1 - Καταχώρηση μιας εφαρμογής Microsoft Entra.

4. Από το μενού Διαχείριση , επιλέξτε Έλεγχος ταυτότητας.

5. Στις ρυθμίσεις παραμέτρων πλατφόρμας, ρυθμίστε τις παραμέτρους της πλατφόρμας Web ως εξής:

   1. Στα URIs ανακατεύθυνσης, προσθέστε https://localhost:3000 και επιλέξτε Ρύθμιση παραμέτρων.

      Σημείωμα

      Εάν δεν έχετε μια πλατφόρμα Web , επιλέξτε Προσθήκη πλατφόρμας και στο παράθυρο Ρύθμιση παραμέτρων πλατφορμών , επιλέξτε Web.

   2. Στην ενότητα Έμμεση εκχώρηση και υβριδικές ροές, ενεργοποιήστε και τις δύο επιλογές:

      • Διακριτικά πρόσβασης
      • Διακριτικά αναγνωριστικού

6. Αποθηκεύστε τις αλλαγές σας.

Ρύθμιση παραμέτρων του δείγματος εφαρμογής ενσωμάτωσης

1. Ανοίξτε τον φάκελο Ενσωμάτωση για τον οργανισμό>σας UserOwnsData>src.

2. Χρησιμοποιώντας ένα πρόγραμμα επεξεργασίας κειμένου, ανοίξτε το αρχείο Config.ts και συμπληρώστε τις παρακάτω τιμές παραμέτρων:

   • clientId- Χρήση του αναγνωριστικού GUID προγράμματος-πελάτη

   • workspaceId - Χρήση του αναγνωριστικού χώρου εργασίας

   • reportId- Χρήση του αναγνωριστικού αναφοράς

3. Αποθηκεύστε το αρχείο.

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

1. Ανοίξτε ένα τερματικό και μεταβείτε στην ενότητα Ενσωμάτωση για τον οργανισμό>σας UserOwnsData.

2. Εγκαταστήστε τις απαιτούμενες εξαρτήσεις καταχωρώντας την ακόλουθη εντολή:

   npm install

3. Εκτελέστε την εφαρμογή πληκτρολογώντας την ακόλουθη εντολή:

   npm run start

   Σημείωμα

   Κατά την πρώτη σας είσοδο, θα σας ζητηθεί να επιτρέψετε δικαιώματα microsoft Entra για την εφαρμογή.

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

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

Ενημέρωση δικαιωμάτων χρήστη

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

Σχετικό περιεχόμενο

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

Ρωτήστε την κοινότητα του Power BI