Create New External Report Profile (External Report Type) (v7.2.0+)
Each External Report Profile is based on the Plugin connection used as its Data Source.
When any new External Report is created, its Report profile is assigned to it by the user. Report Profile determines generic settings of the External Report; i.e., source of images, download ability, drill down authentication. A new Report Profile should be created for each plugin you plan to use as a Data Source for External Reports.
The list of Plugins supported by Metric Insights can be found here.
In this article:
- Create New External Report Profile
- Provide Information Essential for Creating External Report Profile
- Plugin-Specific Settings
- Change Log
1. Create New External Report Profile
Access Admin > Plugins > External Report Profiles
Click [+New External Report Profile] to open Add External Report Profile popup.
In this article, Tableau is used as an example. The Add External Report Profile popup includes a core set of configurations and can also feature a few options that are Plugin-specific.
External Report Profile Editor includes an expanded list of settings that are described below.
Plugin-specific settings are briefly outlined in the end of this article.
2. Provide Information Essential for Creating External Report Profile
- Name: Provide a descriptive title for External Report Profile. It is recommended to include the name of the Plugin to be used as a Data Source into the name.
- Profile of External Report was intended to be a dropdown list of settings that are usually common for customer or a specific plugin so as not to overload External Report Editor. There are no constraints as to the text used to Name the Profile. Upon adding new Plugin, usually a default Report Profile is assigned for that Plugin with recommended settings.
- Plugin Data Source: Define which of the source Plugins supported by Metric Insights should be used to fetch images for Reports of this profile.
- Display Drill-through Link: Define if you want the BI tool URL appear in External Report Editor.
- Override Drill-through Link Text and Drill-Through Link Text: Define if you want to and provide the label for the BI tool URL.
- [Tableau only] Intermediate Page: Select "Tableau JWT" in case you want to use JSON Web Token Authentication for Tableau Plugin.
- Drill-Down Authentication: Specify whether drill-down authentication is to be enabled for the Plugin. If the user is authenticated on the server of the corresponding plugin, credentials will not be required to preview the report in MI Viewer.
- NOTE: This option is currently supported for Tableau, Power BI, and MI Portal Pages. To request it for other Plugins, contact Metric Insights support team at [email protected].
- Auto generate URL: Available for specific Plugins.
- If enabled, a link to the source of External Report in External Report Editor is going to be automatically generated based on the selections in the fields above.
- If disabled, a full URL must be provided manually.
- Allow iframe Embedding: If disabled, restricts the ability to view External Report in iframe by hiding it in External Report Editor.
- Size Shall Respect Report's Aspect Ratio: Specify if the system should auto-adjust the iframe height depending on the size of the collected image.
- Display on Mobile App: Defines if External Report can be viewed in native apps on mobile devices.
- Enable Deep Link to BI Tool's Native Mobile App: Enables links that send users directly to a mobile app on tap. A limited number of tools are supported.
- Allow Report Notification Subscriptions: If disabled, the Notifications icon (envelope icon) will not be displayed in Report Viewer.
- [Tableau only] Enable Workbook Download Link: Enabling this setting will allow for downloading the source Tableau Workbook from Viewer.
- Allow PDF Download: If disabled, restricts downloading the External Report image as PDF by hiding this option from Viewer.
- Allow PowerPoint Download: If disabled, restricts downloading External Report as PPT by hiding this option from Viewer.
- Enable "Share" Link: If disabled, the Share icon will be hidden from Viewer.
- Crop Tall Images to Default Size: Specify if you want to crop images collected for Elements to default size (1200 х 600 px) if they are too tall to be properly displayed in Homepage tiles.
- [Tableau only] Pre-verify User Access through Tableau API: Enabling this setting allow Metric Insights to verify authorization to Plugin Element before trying to display it.
- NOTE: This option requires the Plugin to be configured correctly. See Setting Element Discoverability.
- Dimension usage pattern: Follow your BI tool's standards to embed Dimension Values into External URL.
- NOTE: This mechanism is used in rare cases when a BI tool does not support External Filter functionality, and must instead use Dimensions.
3. Plugin-Specific Settings
Tableau:
- Intermediate Page: Select "Tableau JWT" in case you want to use JSON Web Token Authentication for Tableau Plugin.
- Enable Workbook Download Link: Enabling this setting will allow for downloading the source Tableau Workbook from Viewer.
- Download File Label: Provide an alternative label for the file download link, if needed.
- Pre-verify User Access through Tableau API: Enabling this setting will allow Metric Insights to verify authorization to Plugin Element before trying to display it.
- NOTE: This option requires the Plugin be configured correctly. See Setting Element Discoverability.
Power BI:
- Display Tabs in Viewer: Specify if Power BI's tabs should be available on the left side of Viewer.
- NOTE: These tabs function in place of the Power BI tabs. If this setting is turned off, global/sticky filters will not work.
- Display Filter Pane: Specify if Power BI's Filter Pane should be available in Viewer.
- Display Action Bar: Specify if Power BI's Action Bar should be available in Viewer.
- Display Personal Bookmarks: Specify if Power BI's Personal Bookmarks should be available in Viewer.
Qlik Sense:
- Append dimension filter to External URL formatted for: Defines how Metric Insights will pass parameters (filters) to Qlik Sense in the URL – as a standard GET parameter (standard embedding) or by incorporating them into the URL (alternative).
- NOTE: To properly pass the parameters to Qlik Sense, select "alternative: pass as URL parameter to Qlik Sense UI".

