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

  • Άρθρο

Μάθετε πώς μπορείτε να ενσωματώσετε περιεχόμενο ανάλυσης στις εφαρμογές επιχειρηματικών διαδικασιών σας για εθνικά /τοπικά cloud. Χρησιμοποιήστε το Power BI .NET SDK με το Power BI JavaScript API για να ενσωματώσετε μια αναφορά, έναν πίνακα εργαλείων ή ένα πλακίδιο στις εφαρμογές σας Web.

Το Power BI υποστηρίζει τα ακόλουθα εθνικά/περιφερειακά cloud:

  • Cloud κοινότητας δημόσιων οργανισμών των Η.Π.Α. (GCC)

  • Υψηλό cloud κοινότητας δημόσιων οργανισμών των Η.Π.Α. (GCC High)

  • Προμηθευτές των στρατιωτικών των Η.Π.Α. (DoDCON)

  • Στρατός των Η.Π.Α. (DoD)

  • Power BI για cloud Κίνας

Screenshot showing the Embed a dashboard feature.

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

Σημείωμα

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

Για να ενσωματώσετε έναν πίνακα εργαλείων σε μια εφαρμογή web, χρησιμοποιήστε το Power BI API και ένα διακριτικό πρόσβασης εξουσιοδότησης του Microsoft Entra για να λάβετε έναν πίνακα εργαλείων. Φορτώστε τον πίνακα εργαλείων χρησιμοποιώντας ένα διακριτικό ενσωμάτωσης. Το Power BI API παρέχει πρόσβαση μέσω προγραμματισμού σε συγκεκριμένους πόρους του Power BI . Για περισσότερες πληροφορίες, ανατρέξτε στα θέματα Power BI REST API, Power BI .NET SDK και Power BI JavaScript API.

Λήψη του δείγματος

Αυτό το άρθρο εμφανίζει τον κώδικα για το δείγμα App Owns Data στο GitHub. Για να ακολουθήσετε τις οδηγίες αυτής της αναλυτικής παρουσίασης, κάντε λήψη του δείγματος. Χρησιμοποιούμε τον .NET Framework/Embed for your customers κατάλογο.

Σημαντικό

Μπορείτε να ενσωματώσετε περιεχόμενο Power BI μόνο από ένα cloud κοινότητας δημόσιων οργανισμών (GCC) με ένα SKU του Microsoft 365. Άλλοι πελάτες του εθνικού/τοπικού cloud μπορούν να χρησιμοποιήσουν SKU Microsoft 365 ή Azure.

A screenshot that shows downloading the App Owns Data sample.

A screenshot that shows the App Owns Data directory.

  • Cloud κοινότητας δημόσιων οργανισμών (GCC):

    1. Στο αρχείο Web.config, ενημερώστε applicationId (Εγγενής εφαρμογή applicationId), workspaceId, το όνομα χρήστη (ο κύριος χρήστης σας) και τον κωδικό πρόσβασης.

    2. Στη συνέχεια, προσθέστε τις παραμέτρους GCC ως εξής.

      <add key="authorityUrl" value="https://login.microsoftonline.com/organizations/" />
<add key="scopeBase" value="https://analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.powerbigov.us/" />

  • Προμηθευτές των στρατού (DoDCON):

    1. Στο αρχείο Web.config, ενημερώστε applicationId (Εγγενής εφαρμογή applicationId), workspaceId, το όνομα χρήστη (ο κύριος χρήστης σας) και τον κωδικό πρόσβασης.

    2. Στη συνέχεια, προσθέστε τις παραμέτρους DoDCON ως εξής.

      <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
<add key="scopeBase" value="https://high.analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.high.powerbigov.us/" />

  • Ένοπλες δυνάμεις (DoD):

    1. Στο αρχείο Web.config, ενημερώστε applicationId (Εγγενής εφαρμογή applicationId), workspaceId, το όνομα χρήστη (ο κύριος χρήστης σας) και τον κωδικό πρόσβασης.

    2. Στη συνέχεια, προσθέστε τις παραμέτρους DoDCON ως εξής.

      <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
<add key="scopeBase" value="https://mil.analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.mil.powerbigov.us/" />

  • Παράμετροι του Power BI για cloud Κίνας

    1. Στο αρχείο Web.config, ενημερώστε applicationId (Εγγενής εφαρμογή applicationId), workspaceId, το όνομα χρήστη (ο κύριος χρήστης σας) και τον κωδικό πρόσβασης.

    2. Στη συνέχεια, προσθέστε τις παραμέτρους του Power BI για cloud Κίνας ως εξής.

      <add key="authorityUrl" value="https://login.chinacloudapi.cn/organizations/" />
<add key="scopeBase" value="https://analysis.chinacloudapi.cn/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.powerbi.cn/" />

Βήμα 1 - Καταχώρηση μιας εφαρμογής στο Αναγνωριστικό Microsoft Entra

Καταχωρήστε την εφαρμογή σας στο Microsoft Entra ID για να κάνετε κλήσεις REST API. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Καταχώρηση εφαρμογής Microsoft Entra για ενσωμάτωση περιεχομένου Power BI. Δεδομένου ότι υπάρχουν διαφορετικές συσχετίσεις εθνικών/περιφερειακών cloud, υπάρχουν ξεχωριστές διευθύνσεις URL για να καταχωρήσετε την εφαρμογή σας.

  • Cloud κοινότητας δημόσιων οργανισμών (GCC) - https://app.powerbigov.us/apps

  • Προμηθευτές των κεφαλαίων (DoDCON) - https://app.high.powerbigov.us/apps

  • Ένοπλες δυνάμεις (DoD) - https://app.mil.powerbigov.us/apps

  • Power BI για cloud Κίνας - https://app.powerbi.cn/apps

Εάν κάνατε λήψη του δείγματος ενσωμάτωσης για τον πελάτη σας, θα χρησιμοποιούσατε το applicationId δείγμα που λάβατε, έτσι ώστε το δείγμα να μπορεί να πραγματοποιήσει έλεγχο ταυτότητας στο Microsoft Entra ID. Για να ρυθμίσετε τις παραμέτρους του δείγματος, αλλάξτε το applicationIdστο αρχείο web.config .

Βήμα 2 - Λήψη διακριτικού πρόσβασης από το αναγνωριστικό Microsoft Entra

Μέσα από την εφαρμογή σας, πρέπει να λάβετε ένα διακριτικό πρόσβασης, από το Αναγνωριστικό Microsoft Entra, για να μπορείτε να κάνετε κλήσεις στο Power BI REST API. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Έλεγχος ταυτότητας χρηστών και λήψη διακριτικού πρόσβασης του Microsoft Entra για την εφαρμογή σας Power BI. Δεδομένου ότι υπάρχουν διαφορετικές συσχετίσεις εθνικών/περιφερειακών cloud, υπάρχουν ξεχωριστές διευθύνσεις URL για να λάβετε ένα διακριτικό πρόσβασης για την εφαρμογή σας.

  • Cloud κοινότητας δημόσιων οργανισμών (GCC) - https://login.microsoftonline.com

  • Προμηθευτές των κεφαλαίων (DoDCON) - https://login.microsoftonline.us

  • Ένοπλες δυνάμεις (DoD) - https://login.microsoftonline.us

  • Power BI για cloud Κίνας - https://login.chinacloudapi.cn

Μπορείτε να δείτε παραδείγματα αυτών των διακριτικών πρόσβασης μέσα σε κάθε εργασία στοιχείου περιεχομένου στο αρχείο Controllers\HomeController.cs .

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

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

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

Δείγμα ενσωμάτωσης για τους πελάτες σας

Power BI JavaScript API

Περισσότερες ερωτήσεις; Ρωτήστε τον Κοινότητα Power BI