Client Mapping for Custom Datasets

Client Mapping for Custom Datasets

If you’re building custom datasets that will be used with client facing reports, make sure to map the appropriate field to use with the filtering. Please make sure to use a field that will be the same across the datasource. Ensure that the field you're selecting is of the same field type across the datasource.

Note: If you're selecting numbers in one dataset and text in another, this will break the client mapping and could possibly lead to data leakage in client reports.


Pulling in the Correct Client Field in Your Dataset (Specific for Your Datasource)

If you’re creating a custom dataset from a featured integration, here are the specific fields and their table that we’re pulling so that you can add it into your own as well:



field: company_name

table: company



field: AccountName

table:  tvw_SOListView



field: Name

table: clients



field: orgname




field: CustomerName

table: dim_customer



field: name

table: customer


When you create a custom dataset, you’ll be prompted to select the field name in your dataset that you want to use for the client mapping.


Selecting a Client Column for Mapping on a New Dataset

Step 1 - Create the dataset

You will need to create your SQL dataset and make sure it follows the requirements set forth in the document here. Test your query, make sure there are no errors, and then click on the save button (the save button will only appear once all errors are removed).


Step 2 - Choose the Client Column

When you click save, a modal will pop up asking you to select a client column or skip & save dataset. If you’re in this document, you’ll want to select a column, however you can skip & save and select the client column later if you desire (see section below).

Make sure the client column you select is the appropriate column otherwise the mapping will not work or could potentially cause gauges to show the wrong data.


Step 3 - Save the dataset

After selecting the client column, click on the save button and you’re all done!

Selecting a Client Column for Mapping on an Existing Dataset

Step 1 - Find the custom dataset you created

Go to your datasets page, find the custom dataset you created, and then click on its name to go to the dataset editor page.


Step 2 - Select the client name field

Once in the dataset editor, look below the dataset settings fields, but just above the SQL editor and you’ll see a Client Column dropdown box. This box is pulling the column names from your dataset.  Click on the dropdown and select your field.


Step 3 - Test and save your dataset

Once you’ve selected your column, test the query and re-save your dataset. Make sure to address any errors that may popup.  Once you click save, you’re all done!


Was this article helpful?
2 out of 2 found this helpful