web
You’re offline. This is a read only version of the page.
close
Skip to main content

Notifications

Announcements

No record found.

Community site session details

Community site session details

Session Id :
Finance | Project Operations, Human Resources, ...
Answered

How to initialise an embedded Power BI report

(0) ShareShare
ReportReport
Posted on by

I'm attempting to develop an embedded Power BI report and have faced a number of issues. My starting point was to follow the Microsoft guidance as laid out here:

https://docs.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/analytics/add-analytics-tab-workspaces?toc=%2Ffin-and-ops%2Ftoc.json

Whilst attempting to debug the issues I was having I made some surprising discoveries:

  1. Microsoft's stated method to use - PBIReportHelper::initializeReportControl - is deprecated, and we should be using a new version - PBIReportHelper::initializeReportControlv2.
  2. PBIReportHelper::initializeReportControlv2 is never used in Microsoft's code.
  3. PBIReportHelper::initializeReportControl is only used three times in Microsoft's code, and not for any of the main examples I looked at.

Based on the above, my question is as follows:

How should we initialise an embedded Power BI report? Should we be using the method as recommended, or should we be using a totally different approach? If so, what?

I have the same question (0)
  • Verified answer
    Madhuri Ailavarapu Profile Picture
    on at

    Hello Stuart,

    Please use PBIReportHelper::initializeReportControlV2 to intialize report control  instead of PBIReportHelper::initializeReportControl  and it should work as expected.

    Let me know if you are seeing any errors using the new method.

  • Verified answer
    Mea_ Profile Picture
    60,284 on at

    You should use initializeReportControlV2 because initializeReportControl will be deleted one day. However, as of today initializeReportControl  just calls initializeReportControlV2  inside of it, So there is no difference. 

  • Community Member Profile Picture
    on at

    Thanks for the replies. My concern was that I was wasting my time trying to debug something that had been abandoned - good to know that it's still the correct and supported method.

  • Mea_ Profile Picture
    60,284 on at

    I would still recommend you to use initializeReportControlV2, check how initializeReportControl calls it and do the same, this way you will save you from a trouble if MS delete it one day.

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Responsible AI policies

As AI tools become more common, we’re introducing a Responsible AI Use…

Neeraj Kumar – Community Spotlight

We are honored to recognize Neeraj Kumar as our Community Spotlight honoree for…

Leaderboard > Finance | Project Operations, Human Resources, AX, GP, SL

#1
Martin Dráb Profile Picture

Martin Dráb 551 Most Valuable Professional

#2
André Arnaud de Calavon Profile Picture

André Arnaud de Cal... 450 Super User 2025 Season 2

#3
BillurSamdancioglu Profile Picture

BillurSamdancioglu 278 Most Valuable Professional

Last 30 days Overall leaderboard

Product updates

Dynamics 365 release plans