Integrate BI Gateway with AIM-A for Reporting
- Last UpdatedDec 09, 2025
- 4 minute read
This section describes the configuration needed to run Power BI reports on the data loaded into AIM Advanced. Data loaded through the AVEVA Data Pipeline is loaded into an AIM database and a Reporting database. The Business Intelligence Gateway cloud service uses the Reporting database to generate Microsoft Power BI reports.
Note: You must first whitelist the customer's domain with AVEVA CDO before providing them with access rights to BI Gateway.
Creating a Tenant
-
Sign into CONNECT and choose an account.
-
Select the hamburger icon (
), then select Folder Management.
-
Select Add Folder, then fill in the required details. A new tenant is created.
-
To enable the tenant service, select the toggle button to switch it On.
Wait for about 10 minutes as the database gets created.

Assigning Groups and roles
-
Once the database is created, select the vertical ellipsis icon (
) , and select Manage roles.
-
Under the Groups tab, select Assign group.
-
Create the required groups. You require at least an Admin group and a Reporting Database group.
-
For each group, add the following:
-
Group name
-
Group description
-
Users
Note: The only special character allowed is an underscore ‘_’.
If you are being added to the Active Directory for AVEVA Intelligence in the cloud, for the first time, accept the invite you receive via email. However, if you are already registered in the Active Directory, you may not receive an email. Follow the instructions:
-
Visit https://portal.azure.com/d9bde4ea-8859-4e11-9efa-491b97c4db44 in an incognito mode tab.
-
Log in with your credentials.
-
Accept the invite.
-
-
Under the Roles tab, select Assign role. It is compulsory to add the following roles:
-
Administrator role – Only users/groups with the Administrator role can view the tenant model builder.
-
Reporting - Analytics User role – Only users/groups with the Reporting - Analytics User role can view the reporting database information and later configure a database.
-
Important: 1:1 mapping is only allowed within the same account. A BI Gateway role can be assigned to only one group and one tenant. The tables below demonstrate the 1:1 mapping within two accounts:
|
Account |
Tenant |
Role |
Group |
|
|---|---|---|---|---|
|
Account1 |
Tenant1 |
Administrator |
Grp1 |
Allowed |
|
Account1 |
Tenant1 |
Administrator |
Grp2 |
Not allowed |
|
Account1 |
Tenant1 |
Reporting - Analytics User |
Grp1 |
Not allowed |
|
Account1 |
Tenant1 |
Reporting - Analytics User |
Grp2 |
Allowed |
|
Account1 |
Tenant2 |
Reporting - Analytics User |
Grp2 |
Not allowed |
|
Account1 |
Tenant2 |
Administrator |
Grp1 |
Not allowed |
|
Account1 |
Tenant2 |
Administrator |
Grp3 |
Allowed |
|
Account1 |
Tenant2 |
Reporting - Analytics User |
Grp4 |
Allowed |
Configuring the Database
-
Return to the Home page (
) from the task list and go to the tenant.
Note: Only the user(s) with the Admin role can access the tenant model builder.
-
For Power BI users to access the reporting database, under the profile icon, select Whitelist Client IP.

-
Add a new Firewall rule by pressing the + icon.
You can add your own IP address for Start IP and End IP.

-
Under the profile icon, select View Datastore Information. You can copy the reporting database name and the reporting database service name from here.

-
Go to the program you use to configure databases. For example: Power BI, SQL Server Management Studio, etc.
-
Fill in the required information to connect to the server.
Further Reading
For general information on the BI Gateway, refer to the AVEVA BI Gateway Documentation.
For information on how to configure a private endpoint for your data and integrate it with the AVEVA BI Gateway, refer to Private Endpoint Configuration.