Training by Example: Use Case — Catalog

This article contains a sample of an end-to-end Metric Insights system Use Case. If you are new to the system, completing all the steps introduces you to several features within the system and explains how they work together.  In addition, the Use Case familiarizes you with MI's vocabulary.

In this example, the Admin has a request from a business unit that oversees company Wine Sales.  They request that the Metric Insights Catalog display content from a dashboard pre-filtered for specific users; e.g., the manager who works only with the online purchases needs to see the data filtered by the "website" channel of sales on the first place. Use the example workflow outline below to:

  • Understand how users connect to BI platforms, retrieve and display an existing dashboard from Tableau – Wine Sales Dashboard
  • Learn how to create elements that display content
  • Organize the tile into a Folder where each user will see their expected filter defaults

Though the example uses Tableau, the workflow is general enough that it can be applied to different BI platforms that use filtered visualizations.

A similar workflow is outlined in this training video.

Data Collection

In this section, you connect to the Tableau Data Source that establishes a pipeline between the Metric Insights and Tableau data visualization software. Metric Insights can interface with a wide variety of different business intelligence tools.

Make sure to register on the Tableau website and create an account and some data files. For this Use Case you will need the username and password of your Tableau account.

Detailed information about the types of Data Sources and general approach to them can be found in Understanding Data Sources article.

Access Admin > Collection & Storage > Data Sources

  1. [+ New Data Source]
  2. Select Other
  3. Choose "Tableau"
  4. [Next Step]

Complete the fields:

  1. Data Source Name: Give the Data Source a descriptive name
  2. Auth Type: Choose "Password"
  3. Tableau Server: Insert the address of the Tableau server
  4. Site ID: Type the ID of the site you are using
  5. Username: Use the username of the account you registered on the Tableau website
  6. Password: Insert the password of the account you registered on the Tableau website
  7. [Save]
  8. [Test Connection]

If your entries are correct, the "Connection validated successfully" notification appears.

As you can see, the Tableau Objects tab is empty. To see the objects that are stored in Tableau, you need to refresh the list.

Access Tableau Objects tab and [Refresh List].

Data Collection Triggers are used to control when content should be updated within Metric Insights. You can define at what time and how often the data will be collected from Tableau. For more details about Data Collection Triggers, check this article.

Access Admin > Collection & Storage > Data Collection Triggers

  1. [+ New Data Collection Trigger]
  2. Name: Give the Trigger a descriptive name
  3. [Save]
  1. Run data collection: Set to "After Specified Time"
  2. Collect data after: Choose the time
  3. [Save]

If you would like to understand what other options on the Configuration tab are responsible for, check Create a Data Collection Trigger article.

Content Creation

In this section you will create a Category for the content, an External Report to which that Category will be applied and a User Map that will define what part of the data will be visible to Users.

For more details, refer to Create a Category article.

Access Content > Categories

  1. [+ New Category]
  2. Category Name: Give the Category a descriptive name
  3. [Save]

External Report is a piece of content that allows to automatically gather and show data, stored in an external source, apply filters to that data and flexibly customize its display. For a detailed description of External Report features, refer to the External Report Overview article.

Access New > External Report > Tableau

  1. Name: Give the Report a descriptive name
  2. Category: select previously created Category
  3. Report Image Trigger: Choose previously added Trigger
  4. Plugin Connection Profile: Select your Tableau Data Source
  5. Tableau Worksheet: Click on the field and in the displayed window choose the file
  6. [Next: Define Details]
  1. Show Report in: Select "Viewer"
  2. Report Image Trigger: Choose the Trigger you created

If you created filters for the data in Tableau account or any BI tool you use and want to use them in Metric Insights, you first need to retrieve their names. Afterward, you will be able to match those filters with the User Map.

  1. [Manage Filters]
  2. Activate Retrieve Filter Names from Tableau toggle switch
  3. [Done]

See Filtering in External Reports for more details.

When you are finished with the settings, publish the Report. After that, it will appear on the Homepage as a tile.

  1. [Save and Collect Image]. After that an image appears in the Preview and Thumbnail windows
  2. [Enable & Publish]

In simple words, User Map works like an additional filter. It grants the User access to the filter values, created in a BI tool. User Map is a table, made on your PC or in any BI tool, that defines what kind of data a specific user sees in Viewer.  In this workflow, the User Map connects a Metric Insights User name to a filter value as defined in the Tableau filter section of the External Report.  Because we know in advance the values that belong to each User, we can map those usernames to specific filter values as a convenient, intelligent default. See the detailed explanation of what the User Map is in this article.

The User Map can use any Data Source but in this use case it will be a CSV file. So, you will need a test CSV file. You can download it or create it manually.

In Excel or similar tool, create a table that contains "username" column. The table should have columns with the names that match the names of columns in the External Report table. Fill them with data, mapping the usernames with the types of information they see by default. When the designated user enters the Homepage, in this External Report he will, by default, see the data you listed in the User Map. Here is an example of such a table:

Give it a descriptive name and save the table as a CSV file.

Access Content > User Maps

[+ New User Map] at the bottom of the User Maps list.

  1. Name: Give the User Map a descriptive name
  2. Category: Select the Category you created
  1. In the Data Source field choose "CSV or Excel File"
  2. [Save Changes And load data]
  3. Click on the Data field and choose any date in the past
  4. [Select]
  5. [Browse] and choose the CSV file you downloaded or created previously on your PC
  6. [Load]

Afterward, [Enable & View].

  1. Access Content > Elements
  2. Click on the name of the Report you created
  1. Select Apply Based on User Map radio button
  2. User map: Choose the User Map you created
  3. Filter: Select the name of the filter, retrieved from the BI tool
  4. User Map Column: Choose the name of the column in the User Map to match the BI tool filter
  5. [Save]

You applied User Map to External Report. Now, when a User contained in the User Map enters the Homepage, this External Report will contain data for the filter value assigned to that person. 

Folder is a section that is used to organize the content on the Homepage. Learn more about Folders from the Understanding Folders article.

A Folder can be created and associated with this External Report for the purposes of convenient workspace organization.

  1. Access Content > Folders
  2. [+ New Folder]
  1. Name: Give the Folder a descriptive name
  2. [Add Content]
  3. Select the Report you created
  4. [Add Content]
  5. [Save]

The new Folder will appear in the left sidebar of the Homepage, and the External Report you created will be visible in that Folder.

Control Access

In this section you will create a User Group to control the access to the content you've just created by allowing the Users in the User Group to see that content. It is easier and faster than granting Permissions to each of those Users individually.

Users that are not added to the User Group and weren't granted an individual Permission won't be able to see the content.

  1. Access Admin > Users & Groups
  2. Open Groups tab
  3. [+ New Group]
  4. Name: Give the Group a descriptive name
  5. [Save]
  1. Open Members tab
  2. [+ User To Group]
  3. Activate check boxes near the users that appear in the User Map
  4. [+ Add Selected]
  1. Access Content > Folders
  2. Click on the name of the Folder you created
  1. Open Sharing tab
  2. [Add Group]
  3. Group: Choose the Group you created
  4. Folder on Homepage: Select "Yes"
  5. Can Add/Remove Content: Choose "No"
  6. [Save]
  1. Access Admin > Users & Groups
  2. Open Groups tab
  3. Click on on the name of the Group you created
  1. Open Elements tab
  2. [+ Category to Group]
  3. Category: Choose the Group you created
  4. Grant conditional edit permission to Power User members: Select "No"
  5. [Save]

As an Admin, you can log into the accounts of created Users. Try to log in as a User to confirm that your settings work.

  1. Open Members tab
    • If you are a Power User, than access Admin > Groups, click on the title of the created Group and open the Members tab
  2. Choose one of the Users added to the Group and click a "Log in as this user" icon in its row
  1. On the Homepage find the created Folder with the External Report in it
  2. Click on the Report's tile to open the preview
  3. Check if the filters, mentioned in the User Map are set to the values defined in it

Congratulations! You finished the workflow!

You are done. Great job!