Delen via

Systeemintegratie van Power BI-visuals

  • Artikel

In het artikel wordt de Visual-API beschreven en hoe Power BI de interacties tussen u, de visual en de host verwerkt.

Acties en volgende updates in Power BI kunnen handmatig of automatisch worden gestart. Updatetypen:

In de volgende afbeelding ziet u hoe veelvoorkomende visuele acties, zoals het selecteren van een bladwijzer, worden verwerkt in Power BI.

Diagram van het Power BI-visualproces.

Interactie met een visual via Power BI

U kunt een visual als volgt bijwerken met Power BI:

  • Open het eigenschappenvenster van de visual.

    Wanneer u het eigenschappenvenster van de visual opent, haalt Power BI ondersteunde objecten en eigenschappen op uit het capabilities.json-bestand van de visual. Als u werkelijke waarden van eigenschappen wilt ontvangen, roept Power BI in plaats daarvan de getFormattingModel methode van de visual aan (API's ouder dan versie 5.0 enumerateObjectInstances ). De API retourneert onderdelen, eigenschappen en de werkelijke waarden van het moderne indelingsdeelvenstermodel.

    Zie Mogelijkheden en eigenschappen van Power BI-visuals voor meer informatie.

  • Visualisatietitels, achtergronden, labels en legenda's aanpassen.

    Wanneer u de waarde van een eigenschap in het deelvenster Opmaak wijzigt, roept Power BI de update methode aan. Power BI geeft het nieuwe options object door aan de update methode en de objecten bevatten de nieuwe waarden.

    Zie Objecten en eigenschappen van Power BI-visuals voor meer informatie.

  • Pas het formaat van de visual aan.

    Wanneer u de grootte van een visual wijzigt, roept Power BI de update methode aan en geeft het nieuwe options object door. De options objecten hebben ingebedde viewport objecten die de nieuwe breedte en hoogte van de visual bevatten.

  • Pas een filter toe op rapport-, pagina- of visualniveau.

    Power BI filtert gegevens op basis van filtervoorwaarden. Power BI roept de update methode van de visual aan om de visual bij te werken met nieuwe gegevens.

    De visual krijgt een nieuwe update van de options objecten wanneer er nieuwe gegevens in een van de geneste objecten staan. Hoe de update plaatsvindt, hangt af van de configuratie van de gegevensweergavetoewijzing van de visual.

    Voor meer informatie, zie Inzicht in toewijzing van gegevensweergaven in Power BI-visuals.

  • Selecteer een gegevenspunt in een andere visual in het rapport.

    Wanneer u een gegevenspunt in een andere visual in het rapport selecteert, filtert of markeert Power BI de geselecteerde gegevenspunten en roept de methode van update de visual aan. De visual haalt nieuwe gefilterde gegevens op of haalt dezelfde gegevens op met een matrix met markeringen.

    Zie Gegevenspunten markeren in Power BI-visuals voor meer informatie.

  • Selecteer een bladwijzer in het deelvenster Bladwijzers van het rapport.

    Wanneer u een bladwijzer selecteert in het deelvenster Bladwijzers, gebeurt er een van de volgende dingen:

    • Power BI roept een functie aan die wordt doorgegeven en geregistreerd door de registerOnSelectionCallback methode. De callback-functie krijgt arrays van selecties voor de bijbehorende bladwijzer.

    • Power BI roept de update methode aan met een bijbehorend filter object in het options object.

      In beide gevallen wordt de status van de visual gewijzigd op basis van de ontvangen selecties of filter objecten.

      Zie visualfilters-API in Power BI-visuals voor meer informatie over bladwijzers en filters.

Rechtstreeks communiceren met de visual

U kunt ook rechtstreeks met de visual communiceren om deze bij te werken:

  • Beweeg de muisaanwijzer over een gegevenselement.

    Een visual kan meer informatie over een gegevenspunt weergeven via de Power BI Tooltips-API. Wanneer u de muisaanwijzer over een visueel element beweegt, kan de visual de gebeurtenis afhandelen en gegevens weergeven over het bijbehorende uitleg-element. De visual kan een standaardtooltip of een rapportpagina-tooltip weergeven.

    Zie Knopinfo toevoegen aan uw Power BI-visuals voor meer informatie.

  • Wijzig visuele eigenschappen (bijvoorbeeld door een boomstructuur uit te vouwen) en de weergave slaat de nieuwe status op in de eigenschappen van de weergave.

    Een visual kan eigenschappenwaarden opslaan via de API van Power BI. Wanneer u bijvoorbeeld interactie hebt met de visual en de visual eigenschappenwaarden moet opslaan of bijwerken, kan de visual de persistProperties methode aanroepen.

  • Selecteer een URL.

    Standaard kan een visual een URL niet rechtstreeks openen. Als u een URL op een nieuw tabblad wilt openen, kan de visual de launchUrl methode aanroepen en de URL doorgeven als parameter.

    Zie Een start-URL maken voor meer informatie.

  • Pas een filter toe via de visual.

    Een visual kan de applyJsonFilter methode aanroepen en voorwaarden doorgeven om te filteren op gegevens in andere visuals. Er zijn verschillende typen filters beschikbaar, waaronder Basic-, Geavanceerde en Tuple-filters.

    Zie visualfilters-API in Power BI-visuals voor meer informatie.

  • Selecteer elementen in de visualisatie.

    Zie voor meer informatie over selecties in een Power BI-visual Interactiviteit toevoegen aan visuals via selecties van Power BI-visuals.

Visual communiceert met Power BI

Soms initieert de visual communicatie met de Power BI-host zonder enige invoer van u:

  • Een visual vraagt om meer gegevens van Power BI.

    Een visual verwerkt gegevens gedeeltelijk. De fetchMoreData API-methode vraagt het volgende gegevensfragment in het semantische model aan.

    Zie Meer gegevens ophalen uit Power BI voor meer informatie.

  • De gebeurtenisservice wordt geactiveerd.

    Power BI kan een rapport exporteren naar PDF of een rapport per e-mail verzenden (alleen van toepassing op gecertificeerde visuals). Als u Power BI wilt informeren dat de rendering is voltooid en dat de visual gereed is om te worden opgeslagen als PDF of e-mail, moet de visual de Rendering Events API aanroepen.

    Zie Rapporten exporteren van Power BI naar PDF voor meer informatie.

    Zie Gebeurtenissen weergeven in Power BI-visuals voor meer informatie over de gebeurtenisservice.

Gerelateerde inhoud

Wilt u visualisaties maken en toevoegen aan Microsoft AppSource? Zie de volgende artikelen: