Skip to main content
cancel
Showing results for 
Search instead for 
Did you mean: 

July 7 - July 17 | Round 2 of the Power BI Dataviz World Championships. Don't miss your chance! Learn more

Reply
Husain
Advocate I
Advocate I

SampleMatrix Custom Visual doen't work

I am trying to run the the SampleMatrix Custom Visual frm Microsoft to learn about the Subtotals API availiable starting with the API 2.6.

 

However it doesn't work

 

https://github.com/microsoft/Powerbi-Visuals-SampleMatrix

 

When I run pbiviz start I get following

matrix error.png

 

@dm-p  
@jppp 

 

Could you help please?

 

 

 

 

1 ACCEPTED SOLUTION

Hi @Husain - yes, the SDK is a global install so any other projects may be impacted.

In these cases you'd need to reinstall the SDK you want to work with. It's a pain and a large reason why I can't assist on this issue more directly (as I have a huge v3 project that I'm working on at present that I can't deviate from).

This is a problem working with any visual prior to v3 of the SDK, as the API and SDK were bundled together.

For visuals developed on v3 or later the API and SDK are decoupled so it's easier to work across projects on different versions of the API, as you only need to install the necessary version of powerbi-visuals-api local to the project.

If you want to use the same SDK globally for all your projects and work with the sample, you would need to migrate the sample matrix project to support v3 SDK, (or ask MS to do it).

Regarding your follow-on error from the downgrade, if you've re-run npm i from the root of your project to ensure that all packages are correct following the downgrade, then this might need to be rasied as an issue on the repo, or you can try contacting [email protected] to see if the team can assist.

Regards,

Daniel





Did I answer your question? Mark my post as a solution!

Proud to be a Super User!


On how to ask a technical question, if you really want an answer (courtesy of SQLBI)




View solution in original post

4 REPLIES 4
dm-p
Super User
Super User

Hi @Husain,

Did you follow the instructions in the repo about installing the correct version of powerbi-visuals-tools? From the error message in your screenshot, I would assume that you're attempting this on 3.1 or higher?

If so, you will need to install version 2.5 as per the linked instructions:

npm install -g [email protected]

Note that you will need to re-generate your certificate as this is matched to the version of the tools that you have installed. In versions prior to 3.1, this process is a 2-step process:

pbiviz --create-cert
pbiviz --install-cert

Good luck!

Daniel





Did I answer your question? Mark my post as a solution!

Proud to be a Super User!


On how to ask a technical question, if you really want an answer (courtesy of SQLBI)




Hi @dm-p 

 

I tried these steps. I get following error now

 

errorPBI.png

HI @dm-p 

 

When I downgrade and install cert

npm install -g [email protected]

 

My other custom visuals stop working and I get this message

$ pbiviz start
 info   Building visual...
 error  VALIDATION   Invalid API Version v3.5.0

 

Hi @Husain - yes, the SDK is a global install so any other projects may be impacted.

In these cases you'd need to reinstall the SDK you want to work with. It's a pain and a large reason why I can't assist on this issue more directly (as I have a huge v3 project that I'm working on at present that I can't deviate from).

This is a problem working with any visual prior to v3 of the SDK, as the API and SDK were bundled together.

For visuals developed on v3 or later the API and SDK are decoupled so it's easier to work across projects on different versions of the API, as you only need to install the necessary version of powerbi-visuals-api local to the project.

If you want to use the same SDK globally for all your projects and work with the sample, you would need to migrate the sample matrix project to support v3 SDK, (or ask MS to do it).

Regarding your follow-on error from the downgrade, if you've re-run npm i from the root of your project to ensure that all packages are correct following the downgrade, then this might need to be rasied as an issue on the repo, or you can try contacting [email protected] to see if the team can assist.

Regards,

Daniel





Did I answer your question? Mark my post as a solution!

Proud to be a Super User!


On how to ask a technical question, if you really want an answer (courtesy of SQLBI)




Helpful resources

Announcements
FabCon and SQLCon Barcelona 2026

FabCon & SQLCon – Barcelona 2026

Join us in Barcelona for FabCon and SQLCon, the Fabric, Power BI, SQL, and AI community event. Save €200 with code FABCMTY200.

60 days of Data Days Carousel

Data Days 2026

Join Data Days 2026: 60 days of free live/on-demand sessions, challenges, study groups, and certification opportunities.

Power BI DataViz World Championships carousel

Power BI DataViz World Championships - June 2026

A new Power BI DataViz World Championship is coming this June! Don't miss out on submitting your entry.