Power BI Data extension

<< Click to Display Table of Contents >>

Navigation:  Automation Server > Reports and Process Analytics > Extending reporting options >

Power BI Data extension


Power BI is a platform that let you analyze your business information, specialized in the visual representation of your data.  It provides insight into how your company is working, helping you in the decision-making process. Power BI can interact with your data stored in Bizagi using a Data extension. This article explains how to connect Power BI to your Bizagi Projects.


Bizagi Configuration

This Data extension interacts with Bizagi using the OData layer. The access to this layer is linked to a user, letting you control which information is available for your reports. The selected user must have permissions to see the information you want to use in Power BI. Before launching the connector, you need to create an OAuth Application in Bizagi. Follow these steps to generate it.


1.Go to your Work Portal and in the Administration menu, click the OAuth2 Applications option.




1.Click the plus sign at the bottom of the module to create a new OAuth2 Application.




2.Give the Application a name and select Client Credentials as its Grant type.




3.Select the API and ODATA QUERY checkboxes.




4.Select the user associated with the token and a lifetime. You can give your token a description (Optional).




5.Click Save




7. You now can see this token's Client Secret and Client ID from the OAuth2 Applications module.




With this, you have finished the needed set up process in Bizagi, and you can go to Power BI and configure the Data extension.


Installing the Bizagi Data extension

To send data from Bizagi to Power BI, you need to install the Bizagi Data extension. You can find the Data extension at https://resources.bizagi.com/docs/BizagiBI.mez as a .mez file.


Follow these steps to install your Bizagi Data extension in Power BI:

1.Download the .mez file from https://resources.bizagi.com/docs/BizagiBI.mez and save it in the folder C:\Users\YOUR_USER\Documents\Power BI Desktop\Custom Connectors. If any of the folders don't exist, create the full path manually.




2.Open Power BI go to File>Options and then to settings>Options




3.On the Security tab, under the Data extension section check the (Not Recommended) Allow any extension to load without validation or warning option.




With this, you can now use the Bizagi Data extension to retrieve information of your process.


Using the Data extension

To use the Bizagi data extension follow these steps:

1.Go to Get Data>More.




2.In the Other section find Bizagi, select it and click connect




3.In the next window, type your environment URL.




4.Now power BI will ask for the client Id and client Secret generated in Bizagi. Once you've copied them click connect.




5.Wait for some seconds. A new window appears where you can select the entity you want to obtain, along with the desired XPaths to retrieve. You need to specify at least one XPath of the entity.




If you select a Process entity, you can select some particular attributes related to the process execution.

@ProcessId: Unique ID of the process.

@CaseNumber: Number of the case.

@CreationDate: Creation date of the case.

@EstimatedSolutionDate: Estimated solution date of the case.

@SolutionDate: Actual solution date of the case.

@Closed: Whether the case is closed.


If you use one of these parameters, a new window will ask you to select the process from which you want to retrieve the information.




6.After you click Invoke a preview of your data appears.




7.Click the Close & Apply button to bring your Data into Power BI.





You can only access up to two layers of XPaths.

You can't retrieve information of your collections.