# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enlyze.com/en/integrations/power-bi/installing-the-enlyze-power-bi-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.