# Installing the ENLYZE Power BI Integration

## Prerequisites

* **Power BI Desktop** – You can download the latest version [here](https://www.microsoft.com/en-us/download/details.aspx?id=58494). Power BI Desktop is required to use the ENLYZE Power BI Integration; the Power BI Web App is not supported. Please note that Power BI Desktop requires a Windows computer.
* **ENLYZE Power BI Integration** – You can download the latest version [here](https://github.com/enlyze/enlyze-powerbi/releases/latest/download/enlyze-powerbi.mez). More information can be found [here](https://github.com/enlyze/enlyze-powerbi).
* **ENLYZE API Key** – If you do not have an ENLYZE API Key yet, contact your ENLYZE representative to request one.

{% hint style="info" %}
The Power BI integration is currently in **beta testing**. Changes may occur and might not be immediately reflected in the documentation.

During the **beta phase**, the integration is available **free of charge** to all interested users. After the beta phase ends, usage of the integration will require payment.
{% endhint %}

## 1. Power BI Desktop Installieren

If Power BI Desktop is not yet installed on your computer, download it [here](https://www.microsoft.com/en-us/download/details.aspx?id=58494) and install it on your Windows machine.

{% hint style="info" %}
Power BI Desktop must be used! The Power BI Web App is not supported.
{% endhint %}

## **2. Install the ENLYZE Power BI Integration**

#### **2.1 Create the Custom Connectors Directory**

To use third-party integrations (Custom Connectors) in Power BI, they must be placed in the following directory:\
`Documents\Microsoft Power BI Desktop\Custom Connectors`\
Ensure that this directory exists on your computer.

#### **2.2 Download the ENLYZE Power BI Integration**

If the ENLYZE Power BI Integration is not yet installed, download the latest version [here](https://github.com/enlyze/enlyze-powerbi/releases/latest/download/enlyze-powerbi.mez).

#### **2.3 Move the ENLYZE Power BI Integration to the Custom Connectors Folder**

Move the file **enlyze-powerbi.mez** from your **Downloads** folder to the following directory:\
`Documents\Microsoft Power BI Desktop\Custom Connectors`

#### **2.4 Allow Loading of Third-Party Data Extensions**

To allow Power BI to load the ENLYZE Power BI Integration, third-party data extensions must be enabled:

1. Open **Microsoft Power BI** and navigate to the security settings:\
   **File > Options and Settings > Options > Security**
2. Under **Data Extensions**, select **Allow any extension to load without validation or warning** and click **OK**.

For more details on Custom Connectors and their installation, see [here](https://learn.microsoft.com/en-us/power-bi/connect-data/desktop-connector-extensibility#custom-connectors).

#### **2.5 Restart the Power BI Application**

To apply the changes, restart Power BI.

#### **2.6 Connect Power BI to the ENLYZE Manufacturing Data Platform**

1. Click **Get Data > More...**, search for `"enlyze"`, select **ENLYZE (Beta) (Custom)**, and click **Connect**.
2. You will be prompted to enter your **ENLYZE API Key**. Enter your key and click **Connect** again.

{% hint style="success" %}
You have successfully connected Power BI to the **ENLYZE Manufacturing Data Platform** and now have access to your production data in Power BI.
{% endhint %}