OData Integration for Power BI and Tableau
Export Fact Sheet data to Power BI and Tableau through the OData protocol.
Overview
Note
The OData integration is only supported for PowerBI and Tableau.
The integration with Power BI and Tableau enhances your ad-hoc reporting capabilities, allowing you to take advantage of the extensive features that these Business Intelligence (BI) tools offer.
The OData integration provides a read-only connector to export Fact Sheet data in the form of saved searches (also referred to as bookmarks) to Power BI and Tableau. Because this is only a one-way integration, importing data back into your LeanIX workspace is not possible.
The current integration supports OData version 4.
Prerequisites
Before you start, ensure that you have administrator access to:
- Your LeanIX workspace
- Your BI tool: Power BI or Tableau
Procedure
Follow these steps:
- In LeanIX:
- In the Integrations section of the administration area, enable the OData integration.
- In the Inventory, create and save searches with the required fields within the Table View. OData sharing is only available for saved searches created within the Table View.
- In the configuration of saved searches, enable OData sharing and set the permission to Unrestricted or Write Restricted. To learn more, see Enabling OData Sharing for a Saved Search.
- In Power BI or Tableau:
- Access the OData endpoint of your workspace with an API token. For more information, see
Authentication to OData Endpoints. - Import saved searches into your BI tool by connecting to the OData data source.
- Access the OData endpoint of your workspace with an API token. For more information, see
Note
If you disable the OData integration in the administration area, the imported data remains shared with the BI tool as long as OData sharing is enabled for individual saved searches.
Video Tutorial
In the following video tutorial, you can learn how to enable the OData integration for Power BI and Tableau.
Enabling OData Sharing for a Saved Search
You can enable sharing through the OData protocol for a saved search to export Fact Sheet data to external systems.
Note the following:
- You can enable OData sharing only for saved searches created within the Table View. Only the columns that you selected when creating a saved search are exported through OData.
- Avoid using the dot (.) and the @ symbol in the column names because this interferes with the annotations in OData.
- When the saved search permission is set to Read & Write Restricted, OData sharing is disabled for this saved search.
To enable OData sharing for a saved search, follow these steps:
-
In the Inventory, navigate to the Searches tab in the left sidebar, then click Manage Searches at the bottom of the sidebar.
-
On the Manage Saved Searches page, hover over the saved search that you want to update, then click Edit.
-
On the saved search configuration page, select OData sharing enabled, then click Save.
The link icon in the OData column on the Manage Saved Searches page indicates that OData sharing is enabled for a saved search.
Authentication to OData Endpoints
LeanIX provides REST API endpoints that allow you to import your saved searches (referred to as bookmarks within APIs) into Power BI or Tableau. OData endpoints employ the Basic authentication scheme, which is widely supported by many BI tools.
Two endpoints are available:
-
Standard endpoint that supports common attribute names, also referred to as labels (for example, "Display Name"):
https://{SUBDOMAIN}.leanix.net/services/import-export/v1/odata/BookmarkService.svc/
-
Alternative endpoint that supports technical attribute names, also referred to as keys (for example, "Application_displayName"):
https://{SUBDOMAIN}.leanix.net/services/import-export/v1/odata/BookmarkDataService.svc/
Note
Single and Multi-Select values of any given field are always displayed with their internal technical key (for example, “application_category_1” as opposed to “Application Category 1”).
The following credentials are required to authenticate to these endpoints:
Username | Password |
---|---|
apitoken | Your API token. You can obtain an API token by creating a Technical User. For more information, see Technical Users. |
Connecting to an OData Data Source in Power BI
Power BI provides the OData Feed connector that allows you to import your saved searches into the tool. To learn more about the connector, refer to the Power BI documentation.
To connect to an OData data source in Power BI, follow these steps:
-
In the Get Data overlay, search for the OData Feed connector, then click Connect.
-
In the overlay that appears, select Basic, enter the URL of the OData endpoint, then click OK. To view available OData endpoints, see Authentication to OData Endpoints.
-
If this is your first time connecting to the OData Feed, you need to select an authentication method. In the sidebar, select Basic, then enter your authentication details:
- User name:
apitoken
- Password: Your API token. You can obtain an API token by creating a Technical User. For more information, see Technical Users.
- User name:
The connection should be established. You should see a list of exposed saved searches.
Note
Due to OData limitations, the names of your saved searches are normalized.
You can load or transform the imported data as needed.
Changing Authentication Credentials for an OData Feed
If you replace the API token of your Technical User or delete the Technical User, you need to update credentials in all your integrations where the token is used.
To change credentials in Power BI, follow these steps:
-
On the menu bar, select File, then select Options and settings.
-
Select Data source settings.
-
Select your domain, then click Edit Permissions.
-
In the overlay that appears, click Edit, then click OK.
-
In the overlay that appears, navigate to the Basic tab, enter your new API token, then click Save.
Connecting to an OData Data Source in Tableau
To import your saved searches into Tableau, connect Tableau to an OData data source. For instructions, refer to the Tableau documentation.
In Tableau, enter the following credentials for the OData endpoint:
- Server: The URL of the OData endpoint. To view available endpoints, see Authentication to OData Endpoints.
- Authentication: Select Username and Password.
- Username:
apitoken
- Password: Your API token. You can obtain an API token by creating a Technical User. For more information, see Technical Users.
The connection should be established. You should see a list of your saved searches.
You can drag and drop the exported fields of your searches within Sheets.
Viewing External Content in Dashboards
To allow users to view content from Power BI or Tableau in their dashboards, do the following:
- In LeanIX, enable the Do not restrict external content option for your Workspace. Alternatively, restrict external content to specific URLs. For more information, see External Content.
- In Power BI or Tableau, configure appropriate permissions to publish content to external systems without making it public to everyone.
Related Resources
Updated 7 days ago