Governance Toolkit: DataSet Tagging

Accessing the Toolkit

The Governance Toolkit can be found in the Admin section of Domo, under Governance then Toolkit.

If you are unable to find the Toolkit, ensure your user role has the required grants. 

Required Grants

To access the Governance Toolkit, a user will need 1 of 2 grants enabled for a user. Grants can be added to a custom user role. The Administer Custom Pipeline Process grant is enabled for Admin users by default. 

•  Create Custom Pipeline Processes
  • This grant will allow a user to create, update, share and delete jobs.
  • This grant will only allow a user to see jobs that they created or jobs that have been shared with them.
• Administer Custom Pipeline Processes
  • This Grant will allow a user to create, update, share and delete jobs.
  • this grant will allow a user to see all jobs

To learn more about custom roles and grants see Managing Custom Roles.

Types of Jobs 

There are two different job types to choose from: Tag Settings or Configuration DataSet.

A Tag Settings job allows users to create a job with prebuilt Domo tags. Users are be able to filter to a subset of datasets or dataflows and then apply Domo generated tags to those datasets or dataflows.

A Configuration DataSet job uses your input dataset to determine which datasets or dataflows will have custom tags.

Creating a Tag Settings Job

1. In the navigation header, go to Admin.

2. Under Governance, select Toolkit

2. Select Tag Management.

3. Select + New Job

4. Enter the following information: 

• Job name (required)
• Job description (optional)
• Select DataSets (optional)
  • You can add filtering to narrow down which DataSets you would like to include in the backup job.
  • Each filter category will work as an AND statement.
  • Each value in a filter category will work as an OR statement.

The screenshot below represents the following filters: 

Owner Name = 'Nolan Landefeld'
AND
(Tag = 'Child Cards: 4022' OR Tag= 'Downstream Datasets: 288')

AND
(Type = 'Federated Data' OR Type = MySQL Federated')

5. Tag the Selected policies you wish to add to your filtered DataSets. 

Tagging Policies Reference Guide

6. Apply tags to (required)

Apply tags created by the job to DataSets, DataFlows, or both.

7. Run Logs (required)

Each job will keep track of executions and information surrounding the job at hand. 

• New DataSet: Creates a new DataSet in your Domo instance and all runs of the job will write logging to the new DataSet.
• Existing DataSet: Combines multiple DataSet Tagging jobs into a single logging DataSet.

8. Email(s) to receive notifications (optional)

• You can add user emails to this field.
• Users will receive an email notification from Domo each time the job runs.
• The notification will outline what the job did during the run and any failures that occurred.
  
  
  
  
  • •  

Creating a Configuration Dataset Job

1. In the navigation header, go to Admin.

2. Under Governance, select Toolkit

2. Select Tag Management.

3. Select + New Job

4. Enter the following information: 

• Job name (required)
• Job description (optional)
• Select your Configuration DataSet

5. Handle existing Tags (required)

Users can Append existing tags on the datasets or dataflows from your input configuration dataset, or Replace them. 

6. Run Logs (required)

Each job will keep track of executions and information surrounding the job at hand. 

• New DataSet: Creates a new dataset in your Domo domain. All runs of the job will writ logging to the new dataset.
• Existing DataSet: Allows you to combine multiple DataSet Tagging jobs into a single logging dataset.

7. Email(s) to receive notifications (optional)

• You can add user emails to this field.
• Users will receive an email notification from Domo each time the job runs.
• The notification will outline what the job did during the run and any failures that occurred.
  
  

Running a Job

Each job has an Enabled Toggle. This will control how a job is run.

• Disabled
  • The job will only execute when the job is manually run.
• Active
  • The job will execute every 12 hours.
  • A Configuration DataSet job will run when the configuration dataset updates.