Een ontwikkelingsmethodologie gebruiken om Power BI-inhoud in te sluiten
In de volgende stappen worden de algemene methodologie beschreven die ontwikkelaars moeten volgen om Power BI-inhoud programmatisch in te sluiten in een nieuwe of bestaande app.
- Power BI-inhoud voorbereiden voor insluiten.
- Maak een Microsoft Entra ID app-registratie.
- Ontwikkel de app-insluitingscode.
- Verbeter de gebruikerservaring met behulp van client-API-mogelijkheden.
Eerst moet u Power BI-inhoud gereed hebben om in te sluiten. Het voorbereiden van inhoud omvat het maken van Power BI-werkruimten en het publiceren van inhoud naar deze werkruimten. U kunt inhoud op conventionele manieren maken en beheren met behulp van Power BI Desktop en de Power BI-service. Het proces voor het voorbereiden van Power BI-inhoud voor insluiten wordt beschreven in de volgende les.
Ten tweede moet u een app-registratie maken in Microsoft Entra. Met de app-registratie weet Microsoft Entra hoe u tokens kunt uitgeven, waardoor toegang wordt verleend tot services en resources. Andere Microsoft Entra installatie is mogelijk vereist, afhankelijk van de insluitidentiteit van uw app.
Notitie
Als u meer wilt weten over het insluiten van identiteiten en het instellen van app-beveiliging, gaat u naar de module Machtigingen voor het insluiten van Power BI-inhoud instellen .
Vervolgens gaat u uw app-oplossing ontwikkelen of uitbreiden met het insluiten van code. Dit proces omvat het importeren van specifieke NuGet-pakketten. De NuGet-pakketten helpen bij vereisten aan de serverzijde voor verificatie met Microsoft Entra ID, het genereren van tokens en het detecteren van Power BI-inhoud. Het daadwerkelijke insluiten van Power BI-inhoud vindt plaats aan de clientzijde. Een client-API-bewerking sluit een specifiek Power BI-inhoudsitem in een div
element in.
Notitie
Als u meer wilt weten over het ontwikkelen van insluitlogica, gebruikt u de module Power BI-inhoud insluiten .
De client-API's doen veel meer dan power BI-inhoud insluiten. Ze ondersteunen veel bewerkingen om u te helpen bij het naadloos integreren en verbeteren van inhoud. Mogelijkheden zijn onder andere:
- Programmatische interactie : uw app kan bijvoorbeeld nieuwe filters toepassen op een ingesloten rapport.
- Subscribable gebeurtenissen : grafiekelementen, zoals een kolom van een kolomdiagramvisual, menu-extensies en knoppen, kunnen gebeurtenissen activeren waarop uw app kan reageren. Wanneer de app-gebruiker bijvoorbeeld een knop in een Power BI-rapport selecteert, kan uw app een dialoogvenster openen om gegevens in te voeren en terug te schrijven naar de app-database.
- Dynamische rapportindelingen : uw app-gebruiker kan bijvoorbeeld lichte of donkere rapporten kiezen.
- Interactie met bladwijzers : uw app kan bestaande rapportbladwijzers toepassen of persoonlijke bladwijzers maken (en behouden).
- Rapportvisuals maken : met uw app kunnen gebruikers rapportvisuals maken of bestaande rapportvisuals aanpassen.
Notitie
Als u meer wilt weten over de Power BI-client-API's, bekijkt u de module Inhoud integreren met de Power BI-client-API's .