Zelfstudie: Inhoud Power BI met behulp van een voorbeeld van insluiten voor uw organisatietoepassing
Power BI ingesloten analyse kunt u Power BI inhoud, zoals rapporten, dashboards en tegels, insluiten in uw toepassing.
In deze zelfstudie leert u het volgende:
- Uw embedded omgeving instellen.
- Configureer een voorbeeldtoepassing voor insluiten voor uw organisatie (ook wel bekend als gebruiker is eigenaar van gegevens).
Als u uw toepassing wilt gebruiken, moeten uw gebruikers zich aanmelden bij Power BI.
De oplossing Insluiten voor uw organisatie wordt doorgaans gebruikt door ondernemingen en grote organisaties en is bedoeld voor interne gebruikers.
Specificaties voor codevoorbeeld
Deze zelfstudie bevat instructies voor het configureren van een voorbeeldtoepassing voor insluiten voor uw organisatie in een van de volgende frameworks:
- .NET Framework
- .NET Core
- React TypeScript
Notitie
Met de .NET Core- en de .NET Framework-voorbeelden kan de eindgebruiker elk Power BI-dashboard, -rapport of -tegel weergeven waar ze toegang tot hebben in Power BI service. Met React TypeScript-voorbeeld kunt u slechts één rapport insluiten waar uw eindgebruiker al toegang toe heeft in Power BI service.
De codevoorbeelden ondersteunen de volgende browsers:
- Microsoft Edge
- Google Chrome
- Mozilla Firefox
Vereisten
Voordat u met deze zelfstudie begint, controleert u of u over de Power BI- en codeafhankelijkheden beschikt die hieronder worden vermeld:
Power BI-afhankelijkheden
Uw eigen Azure Active Directory-tenant.
Een van de volgende licenties:
Notitie
Als u wilt over stappen naar productie, hebt u een van de volgende configuraties nodig:
Codeafhankelijkheden
.NET Core 3.1 SDK (of hoger)
Een geïntegreerde ontwikkelomgeving (IDE of Integrated Development Environment). Het is raadzaam een van de volgende opties te gebruiken:
Methode
Volg deze stappen om een insluiting te maken voor de voorbeeld-app van uw organisatie:
Stap 1: Een Azure AD-toepassing registreren
Als u uw toepassing registreert bij Azure AD, kunt u een identiteit voor uw app tot stand brengen.
Als u de app wilt registreren bij Microsoft Azure Active Directory, volgt u de instructies in Uw app registreren.
Stap 2: een Power BI maken
Power BI bewaart uw rapporten, dashboards en tegels in een werkruimte. Als u deze items wilt insluiten, moet u ze maken en naar een werkruimte uploaden.
Tip
Als u al een werkruimte hebt, kunt u deze stap overslaan.
Als u een werkruimte wilt maken, doet u het volgende:
Meld u aan bij Power BI.
Selecteer Werkruimten.
Selecteer Een werkruimte maken.
Geef uw werkruimte een naam en selecteer Opslaan.
Stap 3: een nieuw rapport Power BI publiceren
In de volgende stap maakt u een rapport en uploadt u dit naar uw werkruimte. U kunt uw eigen rapport maken met behulp van Power BI Desktop en het vervolgens publiceren naar uw werkruimte. U kunt ook een voorbeeldrapport uploaden naar uw werkruimte.
Tip
Als u al een werkruimte met een rapport hebt, kunt u deze stap overslaan.
Als u een voorbeeldrapport wilt downloaden en wilt publiceren naar uw werkruimte, voert u de volgende stappen uit:
Open de GitHub-map Power BI Desktop-voorbeelden.
Selecteer Code en vervolgens ZIP-bestand downloaden.
Pak het gedownloade ZIP-bestand uit en ga naar de map Voorbeeldrapporten.
Selecteer een rapport dat u wilt insluiten en publiceer het naar uw werkruimte.
Stap 4: de parameterwaarden voor insluiten op halen
Als u uw inhoud wilt insluiten, moet u enkele parameterwaarden verkrijgen. De parameterwaarden die u nodig hebt, zijn afhankelijk van de taal van de voorbeeldtoepassing die u wilt gebruiken. In de onderstaande tabel wordt vermeld welke parameterwaarden vereist zijn voor elk voorbeeld.
| Parameter | .NET Core | .NET Framework | React TypeScript |
|---|---|---|---|
| Client ID |  |
|
|
| Clientgeheim | |
|
 |
| Werkruimte-id | |
|
|
| Rapport-id | |
|
|
Client-id
Tip
Van toepassing op: . NET Core React TypeScript
Als u de GUID van de client-id (ook wel de app-id genoemd) wilt ophalen, voert u de volgende stappen uit:
Meld u aan bij Microsoft Azure.
Ga naar App-registraties en selecteer de koppeling App-registraties.
Selecteer de Azure AD-app die u gebruikt voor het insluiten van uw Power BI-inhoud.
Kopieer in de sectie Overzicht de GUID van de app-id (client) .
Clientgeheim
Tip
Van toepassing op: . NET Core React TypeScript
Als u het clientgeheim wilt ophalen, voert u de volgende stappen uit:
Meld u aan bij Microsoft Azure.
Ga naar App-registraties en selecteer de koppeling App-registraties.
Selecteer de Azure AD-app die u gebruikt voor het insluiten van uw Power BI-inhoud.
Selecteer onder Beheren de optie Certificaten en geheimen.
Selecteer onder Clientgeheimen de optie Nieuw clientgeheim.
Geef in het pop-upvenster Een clientgeheim toevoegen een beschrijving op voor uw app-geheim, selecteer wanneer het app-geheim verloopt en selecteer Toevoegen.
Kopieer in de sectie Clientgeheimen de tekenreeks in de kolom Waarde van het zojuist gemaakte app-geheim. De waarde van het clientgeheim is uw client-id.
Notitie
Zorg ervoor dat u de waarde van het clientgeheim kopieert wanneer deze voor het eerst wordt weergegeven. Na het navigeren van deze pagina wordt het clientgeheim verborgen en kunt u de waarde ervan niet meer ophalen.
Werkruimte-id
Tip
Van toepassing op: op. . NET Core React TypeScript
Als u de GUID van de werkruimte-id wilt ophalen, voert u de volgende stappen uit:
Meld u aan bij de Power BI-service.
Open het rapport dat u wilt insluiten.
Kopieer de GUID van de URL. De GUID is de tekenreeks tussen /groups/ en /reports/ .
Rapport-id
Tip
Van toepassing op: op. . NET Core ReactTypeScript
Volg deze stappen om de rapport-id-GUID op te halen:
Meld u aan bij de Power BI-service.
Open het rapport dat u wilt insluiten.
Kopieer de GUID van de URL. De GUID is de tekenreeks tussen /reports/ en /ReportSection.
Stap 5: uw inhoud insluiten
Met Power BI ingesloten voorbeeldtoepassing kunt u een insluittoepassing maken voor uw organisatie Power BI app.
Volg deze stappen om de voorbeeldtoepassing voor insluiten voor uw organisatie te wijzigen om uw Power BI in te sluit.
Open de map Voorbeelden voor Power BI-ontwikkelaars.
Selecteer Code en vervolgens ZIP-bestand downloaden.
Pak het gedownloade ZIP-bestand uit en ga naar de map PowerBI-Developer-Samples-master.
Afhankelijk van de taal die u voor de app wilt gebruiken, opent u een van de volgende mappen:
- .NET Core
- .NET Framework
- React-TS
Notitie
De insluiten voor voorbeeldtoepassingen van uw organisatie ondersteunen alleen de hierboven vermelde frameworks. De java-, Node JS- en Python-voorbeeldtoepassingen bieden alleen ondersteuning voor het insluiten voor uw klanten.
Uw Azure AD-app configureren
Meld u aan bij de Azure Portal.
Selecteer App-registraties. Als deze optie niet wordt weergegeven, zoekt u deze op.
Open de Azure AD-toepassing die u hebt gemaakt in Stap 1: Een Azure AD-toepassing registreren.
Selecteer verificatie in het menu Beheren.
Open in Platformconfiguraties uw webplatform en voeg in de sectie Omleidings-URI's
https://localhost:5000/signin-oidctoe.Notitie
Als u geen webplatform hebt, selecteert u Een platform toevoegen en selecteert u in het venster Platforms configureren de optie Web.
Sla uw wijzigingen op.
De voorbeeld-app voor insluiten configureren
Open de map Insluiten voor uw organisatie.
Open de voorbeeld-app voor insluiten voor uw organisatie met een van de volgende methoden:
Als u de Visual Studio,opent u het bestand UserOwnsData.sln.
Als u code voor Visual Studio gebruikt,opent u de map UserOwnsData.
Open appsettings.json en vul de volgende parameterwaarden in:
ClientId- De client-id-GUID gebruikenClientSecret- Het clientgeheim gebruiken
De voorbeeld-app uitvoeren
Voer het project uit door de juiste optie te selecteren:
Als u Visual Studio gebruikt, selecteert u IIS Express (afspelen).
Als u Visual Studio Code gebruikt, selecteert u Uitvoeren > Foutopsporing starten.
Meld u aan bij de voorbeeldtoepassing voor insluiten.
Notitie
Tijdens de eerste aanmelding wordt u gevraagd om Azure AD-machtigingen voor de app toe te staan.
Wanneer de voorbeeldtoepassing voor insluiten wordt geladen, selecteert Power BI inhoud die u wilt insluiten en selecteert u vervolgens Insluiten.
Uw toepassing ontwikkelen
Na het configureren en uitvoeren van de voorbeeld-app voor het insluiten voor uw klanten, kunt u beginnen met het ontwikkelen van uw eigen app.