Make External Reports Discoverable - Obsolete
This article is obsolete - please see: Set Discoverability & Custom Access Request Messages for External Reports
In version 5.6, the Access Request function for External Reports has been enhanced to support Client sites with either Distributed or Centralized Access Request responsibilities, as well as customized Deny Access messages, and support for BI Tool security access.
You may specify tailored messages, control where Requests for Access are routed, and are now able to support both centralized Access Request processing (via a tool like SAP's GRC) and distributed Access Request responsibilities via a Metric Insights-only work flow.
The system will first check the Element Editor to verify Access settings and the default No Access tile format. If the Report settings do not include a Custom Access Message, then the Category Editor will be accessed to locate a Custom Message. The first Message encountered will be used. The system will default to standard error messaging if no customization has been set up.
This article will explain how to apply Customized Access Request processing for two common process flows:
- Set Discoverability for a single External Report
- Set Discoverability for all External Reports within one Category
You may want to use either or both of these procedures independently based on your needs.
How are Access Requests handled by your company?
Set Variables for Discoverability handled by Metric Insights
Access Admin / System / System Config
Access Admin / System / System Config
Set the 6 required Access-request variables in the Config file:
- Type 'access' in the Search field to narrow your options
- Set 'SHOW_ITEMS_WITHOUT_ACCESS' to 'Y'
- Set 'SEND_ACCESS_REQUEST_DIGEST' to 'Y' (optional)
- Set 'ACCESS_REQUEST_VIA_WEBPAGE' to 'N'
- Set 'ACCESS_REQUEST_URL_PASSWORD' to a valid password for the URL_USERNAME
- Set 'ACCESS_REQUEST_URL' to the end-point of your Access Request API
- Set 'ACCESS_REQUEST_URL_USERNAME' to a valid User for API authentication
- Commit your changes
Do you want to work with single reports or multiple reports (via Category)
Set Custom Access Request fields on External Report Editor
Create a New Tableau Report (New > External Report), Select the Tableau Report Type, and follow instructions in How to create an External Report from Tableau.
Access the Advanced tab of the External Report Editor
Do you want to display custom image for Discoverable element?
- Select 'Upload Public Image File' to open a standard Upload Image popup.
- The Upload Image pop-up will appear to allow you to select an alternative image.
Do you want to format a custom Access Deny message
Note: if you do not specify a Access message at the External Report level, the system will check the associated Category for a message. If neither is specified, the Standard Message will display.
- Toggle the 'Use Custom Access Denied Message' to 'ON' to display additional fields
- You can control the Message display using the standard formatting options
- You can insert the following variables using the dropdown:
- [Element name] causes the system to substitute the External Report name in the display
- [More Info] provides a link to show list of Support Admins that can assist you
- (Optional) Provide an Access Request email address to be informed of this Access Request. This field will over-ride the default option that sends the email to your Support Admins.
Use Metric Insights default message
Use the Bulk update for elements to set Discoverable option for Reports
Note that you can limit the element display using the Filter options on the top of screen.
- Select Category and apply additional Filters as needed
- Select Individual Reports or just select everything in the Category; only External Reports will be affected
- Select Bulk change
- Open Choose Field drop-down and select Discoverability
- Next: Preview
Do you want to customize the Access Request message
Access corresponding Category Editor
- One the Info tab, toggle the 'Use Custom Access Denied message' to ON to open additional fields
- You can control the Message display using the standard formatting options
- You can insert the following variables using the dropdown:
- [Element name] causes the system to substitute the External Report name in the display
- [More Info] provides a link to show list of Support Admins that can assist you
- (Optional) Provide an Access Request email address to be informed of this Access Denial. This field will over-ride the Default option that sends email to your Support Admin(s) for Access.
Do you want to check authorization for access to your BI tool?
Is the Report from Tableau
Set Report Type
Sorry but other BI tools not currently supported
Do you want to see example of how Metric Insights handles Access Requests?
- User clicks Report title
- Access Denied Message is displayed (default message used here)
- User may Request access
- Access may be granted to the single Report or to the entire Category containing the Report.