Delen via

Power BI-rapporten maken om Dynamics 365 Business Central-gegevens weer te geven

  • Artikel

U kunt uw Dynamics 365 Business Central-gegevens als gegevensbron beschikbaar maken in Power BI Desktop en krachtige rapporten maken over de status van uw bedrijf.

In dit artikel wordt beschreven hoe u aan de slag kunt met Power BI Desktop om rapporten te maken waarin Dynamics 365 Business Central-gegevens worden weergegeven. Nadat u rapporten hebt gemaakt, kunt u deze publiceren via uw Power BI-service of delen met alle gebruikers in uw organisatie. Zodra deze rapporten zich in de Power BI-service bevinden, kunnen gebruikers die ervoor zijn ingesteld, vervolgens de rapporten bekijken in Dynamics 365 Business Central.

Bereid u voor

Notitie

U kunt de gegevens van verschillende bedrijven in één rapport te krijgen met OData-webservices. Echter, beginnend met Business Central 2021 releasewave 2, wordt alleen ODataV4 ondersteund. ODataV4 exporteert geen gegevens van meerdere bedrijven. De functie $expand in Power BI waarvan u zou denken dat het een alternatieve manier is om een rapport voor meerdere bedrijven te maken, kan ook niet worden gebruikt. Het maakt een kolom met de bedrijfsnaam, maar deze wordt na een vernieuwing niet gevuld met de bedrijfsgegevens.

Business Central toevoegen als een gegevensbron in Power BI Desktop

De eerste taak bij het maken van rapporten is het toevoegen van Business Central als een gegevensbron in Power BI Desktop. Als de verbinding tot stand is gebracht, kunt u beginnen met het maken van het rapport.

  1. Start Power BI Desktop.

  2. Selecteer Gegevens ophalen.

    Als u de optie Gegevens ophalen niet ziet, selecteert u het menu Bestand en vervolgens de optie Gegevens ophalen.

  3. Selecteer op de pagina Gegevens ophalen de optie Onlineservices.

  4. Voer in het deelvenster Onlineservices een van de volgende stappen uit:

    • Als u verbinding wilt maken met Business Central online, selecteert u Dynamics 365 Business Central en vervolgens Verbinden.

  5. Meld u aan bij Business Central online (eenmalig).

    Als u zich niet eerder hebt aangemeld bij Business Central vanuit Power BI Desktop, wordt u gevraagd zich aan te melden.

    • Voor Business Central online selecteert u Aanmelden en kiest u het relevante account. Gebruik hetzelfde account dat u gebruikt om u aan te melden bij Business Central. Wanneer u klaar bent, selecteert u Verbinden.

    Notitie

    Nadat u verbinding hebt gemaakt met Business Central, wordt u niet opnieuw gevraagd om in te loggen. Hoe wijzig of wis ik het account dat ik momenteel gebruik om verbinding te maken met Business Central vanuit Power BI Desktop?

  6. Eenmaal verbonden neemt Power BI contact op met de Business Central-service. Het navigatievenster verschijnt en toont de beschikbare gegevensbronnen voor het maken van rapporten. Selecteer een map om deze uit te vouwen en de beschikbare gegevensbronnen te bekijken.

    Deze gegevensbronnen vertegenwoordigen alle API´s en webservices die zijn gepubliceerd voor Business Central, gegroepeerd op omgevingen en bedrijven. Met Business Central online heeft Navigator de volgende opbouw:

    • Omgevingsnaam
      • Bedrijfsnaam

        • Geavanceerde API's

          Deze map bevat geavanceerde API's die zijn gepubliceerd door Microsoft, zoals de automatiserings-API's van Business Central en API's die zijn gepubliceerd door andere organisaties (deze API's worden aangepaste API's genoemd). Aangepaste API's zijn verder gegroepeerd in mappen volgens de eigenschappen APIPublisher/APIGroup van de API-broncode.

        • Standaard API's v2.0

          Deze map bevat de gegevens-API's die worden weergegeven in de Business Central API V2.0. U gebruikt deze API's om gegevens uit de Business Central-database te lezen, zoals hoofdgegevens (klant, leverancier, artikel, enzovoort), transacties (grootboekposten, klantenposten, enzovoort) of instellingsgegevens (dimensies, betalingsmethoden, eenheid, enzovoort).

        • Webservices (oud)

          Deze map bevat pagina's, codeunits en query's die zijn gepubliceerd als webservices in Business Central. Het wordt afgeraden om deze verouderde methode te gebruiken voor het lezen van gegevens uit Business Central. We raden u aan om in plaats daarvan API´s te gebruiken.

  7. Selecteer de gegevensbron of -bronnen die u aan uw gegevensmodel wilt toevoegen en selecteer vervolgens de knop Laden.

  8. Als u later meer Business Central-gegevens wilt toevoegen, kunt u de vorige stappen herhalen.

Zodra de gegevens zijn geladen, ziet u deze in de rechternavigatie op de pagina. Nu hebt u met succes een verbinding gemaakt met uw Business Central-gegevens en kunt u uw Power BI-rapport gaan maken.

Fooi

Zie Aan de slag met Power BI Desktop voor meer informatie over het gebruik van Power BI Desktop.

Toegankelijke rapporten maken

Het is belangrijk om uw rapporten bruikbaar te maken voor zoveel mogelijk mensen. Probeer rapporten zo te ontwerpen dat ze geen speciale aanpassingen nodig hebben om aan specifieke behoeften van verschillende gebruikers te voldoen. Zorg ervoor dat gebruikers dankzij het ontwerp kunnen profiteren van ondersteunende technologieën, zoals schermlezers. Power BI bevat verschillende toegankelijkheidsfuncties, tools en richtlijnen om hierbij te helpen. Ga voor meer informatie naar Power BI-rapporten voor toegankelijkheid ontwerpen in de Power BI-documentatie.

Rapporten maken om gegevens weer te geven die aan een lijst in Business Central zijn gekoppeld

U kunt rapporten maken die worden weergegeven in een feitenblok op een Business Central-lijstpagina en die veranderen wanneer verschillende rijen in de lijst worden geselecteerd. U kunt deze rapporten op ongeveer dezelfde manier maken als andere rapporten, maar u moet wel een paar dingen doen om ervoor te zorgen dat de rapporten worden weergegeven zoals verwacht. Ga voor meer informatie naar Power BI-rapporten maken voor het weergeven van lijstgegevens in Business Central.

Het Business Central-rapportthema gebruiken (optioneel)

U wordt aangeraden om voordat u uw rapport maakt het Business Central-themabestand te downloaden en importeren. Het themabestand maakt een kleurenpalet, zodat u rapporten kunt maken met dezelfde kleurstijl als de Business Central-apps zonder dat u aangepaste kleuren hoeft te definiëren voor elk visueel element.

Opmerking

Deze taak is optioneel. U kunt altijd uw rapporten maken en later alsnog de stijlsjabloon downloaden en toepassen.

Het thema downloaden

Het themabestand is beschikbaar als JSON-bestand in de themagalerij van de Microsoft Power BI-community. Voer de volgende stappen uit om het themabestand te downloaden:

  1. Ga naar de themagalerij van de Microsoft Power BI-community voor Microsoft Dynamics 365 Business Central.
  2. Selecteer de downloadbijlage Microsoft Dynamics Business Central.json.

Het thema in een rapport importeren

Nadat u het Business Central-rapportthema hebt gedownload, kunt u het in uw rapporten importeren. Als u het thema wilt importeren, selecteert u Weergave>Thema's>Thema's zoeken. Meer informatie vindt u op Power BI Desktop - Aangepaste rapportthema's importeren.

Rapporten publiceren

Nadat u een rapport hebt gemaakt of gewijzigd, kunt u het rapport publiceren naar uw Power BI-service en delen met anderen in uw organisatie. Nadat u een rapport hebt gepubliceerd, is het beschikbaar in Business Central. Het rapport kan ook worden geselecteerd in Business Central.

Als u een rapport wilt publiceren, selecteert u Publiceren op het tabblad Start of in het menu Bestand. Als u bent aangemeld bij de Power BI-service, wordt het rapport naar deze service gepubliceerd. Als dat niet het geval is, wordt u gevraagd u aan te melden.

Een rapport distribueren of delen

Er zijn enkele manieren om rapporten te delen:

  • Een rapport delen vanuit uw Power BI-service (aanbevolen)

    Als u een Power BI PRO-licentie hebt of Power BI Premium-capaciteit gebruikt, kunt u het rapport rechtstreeks vanuit uw Power BI-service delen. Ga voor meer informatie naar Power BI - een dashboard of rapport delen.

  • U kunt rapporten distribueren als PBIX-bestanden.

    Rapporten worden op uw computer opgeslagen als PBIX-bestanden. U kunt het .pbix-bestand net als elk ander bestand onder gebruikers distribueren. Vervolgens kunnen de mensen met wie u het bestand hebt gedeeld, het uploaden naar hun Power BI-service. Ga voor meer informatie naar Rapporten uploaden vanuit bestanden.

    Notitie

    Als u een rapport op deze manier distribueert, houdt dat in dat iedere gebruiker afzonderlijk de gegevens van dat rapport moet vernieuwen. Deze situatie kan van invloed zijn op de prestaties van Business Central.

Power BI-rapporten voor meerdere bedrijven of omgevingen maken

De Business Central API-eindpunten hebben allemaal het voorvoegsel https://api.businesscentral.dynamics.com/v2.0/<environment_name>/api/v2.0, gevolgd door /companies({company_id})/accounts({id}) (hier gebruiken we de accounts API als illustratie). U kunt deze structuur gebruiken om PowerQuery-query's te maken die gegevens laden voor meerdere bedrijven of meerdere omgevingen als de gebruiker die gegevens leest, er toegang toe heeft.

Volg deze stappen om een query in te stellen om gegevens voor meerdere bedrijven te laden:

  1. Neem de PowerQuery-query waarmee gegevens voor één bedrijf worden geladen. Converteer het naar een aangepaste Power Query-functie die de bedrijfs-id (of misschien de omgevingsnaam) als parameters gebruikt. Ga voor meer informatie naar Aangepaste Power Query-functies gebruiken.
  2. Gebruik nu de nieuwe aangepaste functie in een PowerQuery-query, waarbij u de functie toewijst aan een lijst met bedrijven en vervolgens de gegevenssets samenvoegt met behulp van de functie Table.Combine Power Query.

Geavanceerd: de taal, time-out, databasereplica of paginagrootte aanpassen voor uw Business Central-gegevensbron

De Power BI-connector voor Business Central ondersteunt verschillende geavanceerde eigenschappen voor het maken van verbinding met een Business Central-gegevensbron die u in uw Power Query-query's kunt instellen. De volgende tabel geeft een beschrijving van de parameters.

Parameter Omschrijving Standaard Meer informatie op
AcceptLanguage Met deze parameter kunt u voorkeurstalen voor reacties opgeven, zodat gebruikers berichten en vertaalbare tekenreeksen in de door hen gewenste taal ontvangen. Hiermee wordt de taal ingesteld waarin de Business Central API-sessie wordt uitgevoerd. Hiermee wordt de taal beïnvloed van foutmeldingen, opgemaakte waarden in AL en andere waarden die afhankelijk zijn van taal of cultuur.

Door deze parameter in te stellen verbetert u de gebruikerstevredenheid en worden de gegevens toegankelijker en relevanter.		 niet opgegeven Lokale waarden gebruiken in meertalige Power BI-rapporten.
ODataMaxPageSize Met deze parameter wordt het aantal entiteiten per resultatenpagina beperkt, wat zorgt voor meer flexibiliteit bij het verbinden met grote gegevenssets of het gebruiken van complexe query's. Hiermee wordt het maximale aantal records ingesteld dat voor elke pagina moet worden geretourneerd bij het aanroepen van een API. Als uw tabel Klanten bijvoorbeeld 13.000 records heeft en ODataMaxPageSize is ingesteld op 5000, voert Power BI 3 API-aanroepen uit om uw klanten op te halen. Met de eerste aanroep worden 5.000 records opgehaald, met de volgende nog eens 5000 en met de laatste aanroep de resterende 3000. Deze optie kan niet hoger zijn dan de maximale paginagrootte die wordt afgedwongen door Business Central, namelijk 20000.

Het instellen van deze parameter zorgt voor efficiënt en responsief ophalen van gegevens, wat leidt tot snellere inzichten en besluitvorming. U mag de maximale paginagrootte die op de service is gedefinieerd, niet overschrijden.		 5000 Eigenschap ODataPreferenceHeader.MaxPageSize
Time-out met deze parameter wordt de maximale duur van een aanvraag gedefinieerd voordat deze wordt geannuleerd. Hiermee wordt de time-out ingesteld voor elke afzonderlijke API-aanroep naar Business Central. De waarde ervan mag niet hoger zijn dan de time-out die is afgedwongen in de Business Central-service, die momenteel 10 minuten (00:10:00) is.

Het instellen van deze parameter helpt systeemresources effectief te beheren en voorkomt dat langdurige query's de algehele systeemprestaties beïnvloeden. Gebruikers ervaren minimale vertragingen en onderbrekingen, waardoor hun werkstroom soepeler verloopt.		 00:08:00 OData.Feed
UseReadOnlyReplica Met deze parameter wordt bepaald of aanvragen gericht zijn op de primaire database of op een alleen-lezen replica. Het verplaatsen van leesbewerkingen van de primaire database kan de prestaties aanzienlijk verbeteren.

Als u deze eigenschap instelt, worden gegevens sneller opgehaald en verbetert de stabiliteit van het systeem, vooral tijdens piekmomenten.		 waar

De geavanceerde parameters configureren

  1. Start Power BI Desktop.

  2. Voer de stap uit die bij uw scenario past:

    1. Selecteer Bestand>Openen.
    2. Blader naar het rapport en selecteer het (.pbix).
    3. Selecteer op het lint Gegevens transformeren om de Power Query-editor te openen.

  1. Selecteer in de Power Query-editor Geavanceerde editor vanaf het lint.

  2. Zoek in de Geavanceerde editor de regel die begint met Source =:

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, null),

  3. Vervang in de regel de vierde parameter van Dynamics365BusinessCentral.ApiContentsWithOptions door een door komma's gescheiden lijst van eigenschappen en waarden die u wilt instellen, bijvoorbeeld:

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, [UseReadOnlyReplica = true, Timeout = Duration.From("00:07:00"), ODataMaxPageSize = 10000, AcceptLanguage = "it-it"])

  4. Selecteer Gereed om Geavanceerde editor te sluiten.

  5. Selecteer Sluiten en toepassen om de wijzigingen op te slaan en de Power Query-editor te sluiten.

Problemen oplossen

"Expression.Error: de omgeving 'Productie' bestaat niet." Fout bij het opgeven van een Business Central-omgeving

VAN TOEPASSING OP: Business Central online

Wanneer u verbinding maakt met Business Central online via Power BI of wanneer u een Power BI Desktop-app installeert via Microsoft AppSource die gebruikmaakt van Business Central-gegevens, wordt u mogelijk gevraagd de Business Central-omgeving in te voeren waarmee u verbinding wilt maken.

Als u een foutmelding krijgt die lijkt op "Expression.Error: de omgeving 'Productie' bestaat niet.", voert u deze stappen uit om het probleem op te lossen:

  1. Zorg ervoor dat u de juiste referenties gebruikt om toegang te krijgen tot Business Central. Deze referenties zijn mogelijk niet dezelfde referenties als die u gebruikt om toegang te krijgen tot Power BI. Hoe wijzig of wis ik het account dat ik momenteel gebruik om verbinding te maken met Business Central vanuit Power BI Desktop?
  2. Als uw omgeving een ingesloten ISV-omgeving is, moet u de ingesloten ISV-naam tussen haakjes opgeven als onderdeel van de omgevingsnaam. Als u bijvoorbeeld verbinding wilt maken met een omgeving met de naam Productie vanuit de ingesloten ISV met de naam Fabrikam, moet u "PRODUCTIE (fabrikam)" opgeven als omgevingsnaam.

"Kan geen record invoegen. Huidige verbindingsintentie is alleen-lezen." Fout bij het maken van verbinding met aangepaste API-pagina

GELDT VOOR: Business Central online

Rapporten die gebruikmaken van Business Central-gegevens, maken standaard verbinding met een alleen-lezen replica van de Business Central-database. In zeldzame gevallen, afhankelijk van het API-ontwerp, kunt u een foutmelding krijgen wanneer u verbinding probeert te maken en gegevens van de API probeert op te halen. De fout ziet er als volgt uit:

Dynamics365BusinessCentral: Request failed: The remote server returned an error: (400) Bad Request. (Can't insert a record. Current connection intent is Read-Only. CorrelationId: [...])".

Als u een aangepaste API gebruikt, raden we u aan de AL-code na te bewerken om ervoor te zorgen dat deze geen databasewijzigingen aanbrengt wanneer alleen gegevens worden gelezen. Maar als uw scenario dit vereist, kunt u de connector configureren om in plaats daarvan een lees-schrijfverbinding te gebruiken.

Uw bedrijfsgegevens inschakelen voor Power BI
Bedrijfsinformatie
Voorbereid zijn om zaken te doen
Bedrijfsgegevens importeren uit andere financiële systemen
Business Central instellen
Financiën
Snelle start: verbinding maken met uw gegevens in Power BI Desktop

U vindt hier gratis e-learningmodules voor Business Central