Skip to main content
Version: Next

Create a DataHub Compliance Form

Feature Availability
Self-Hosted DataHub
DataHub Cloud

Creating and Assigning Compliance Forms​

The following steps will walk you through creating and assigning Compliance Forms, including:

  1. Prerequisites
  2. Defining your Compliance Form
  3. Creating Questions to be completed by assignees
  4. Selecting the in-scope Assets for the Compliance Form
  5. Assigning Forms to specific Users
  6. Publish your Form
note

Creating and managing Compliance Forms via the UI is only available in DataHub Cloud. If you are deployed with DataHub Core, please see the Compliance Forms API Guide.

Step 0: Prerequisites​

In order to create or edit a Compliance Form, your DataHub User must have the Manage Compliance Forms permission.

Step 1: Define your Complinace Form​

From the navigation bar, head to Govern > Compliance Forms. Click + Create to start building your Form.

View of all Compliance Forms

First up, provide the following details:

  1. Name: Give your Compliance Form a unique name.
  2. Description: Describe the purpose of the Form to help your users understand the reason of the exercise.
  3. Type: Determine the collection type of the Form:
    • Verification: Collect required information and require final verification to complete the Form.
    • Completion: Collect required information; final verification is not required.
  4. Click Add Question to begin setting the requirements for your Form.

Create a new Compliance Form

Step 2: Add Questions to your Form​

Next, create Questions you want your users to complete to capture the desired metadata with this Compliance Form. There are five types of Questions that can be created, each of which can be set to be require response:

  • Ownership: Assign one or more Owners to the Asset, with the option to pre-define the set of allowed Owners and/or Ownership Types.
    • E.g. Who is responsible for ensuring the accuracy of this Dataset?
  • Domain: Assign a Domain to the Asset, with the option to pre-define the set of allowed Domains.
    • E.g. Which Domain does this Dashboard belong to? Sales, Marketing, Finance.
  • Documentation: Provide Documentation about the Asset and/or Column.
    • E.g. What is the primary use case of this Dataset? What caveats should others be aware of?
  • Glossary Terms: Assign one or more Glossary Term to the Asset and/or Column, with the option to pre-define the set of allowed Glossary Terms.
    • E.g. What types of personally identifiable information (PII) are included in this Asset? Email, Address, SSN, etc.
  • Structured Properties: Apply custom properties to an Asset and/or Column.
    • E.g. What date will this Dataset be deprecated and deleted?

When creating a Question, be sure to give it an easy-to-understand Title, and provide additional context or direction in the Description.

Create a new Compliance Form prompt

Step 3: Assign your Form to relevant Assets​

Now that you have defined the Questions you want Users to complete, it's now time to select the in-scope Assets for this exercise.

In the Assign Assets section, you can easily target the specific set of Assets that are relevant for this Form with the following steps:

  1. Add a Condition or Group of Conditions
  2. Choose the appropriate filter type, such as:
    • Asset Type (Dataset, Chart, etc.)
    • Platform (Snowflake, dbt, etc.)
    • Domain (Sales, Marketing, Finance, etc.)
    • Assigned Owners
    • Assigned Glossary Terms
  3. Decide between All, Any, or None of the filters should apply
  4. Preview the relevant Assets to confirm you have applied the appropriate filters

Assign assets to a Compliance Form

Step 4: Add Recipients to your Form​

Now that you have defined the set of Questions to be answered for a set of Assets, it's now time to delegate out to your Users.

In the Add Recipients section, decide who is responsible for completing the Form:

  • Asset Owners: Any User that is assigned to one of the in-scope Assets will be able to complete the Form. This is useful for larger initiatives when you may not know the full set of Users.
  • Specific Users and/or Groups: Select a specific set of Users and/or Groups within DataHub. This is useful when Ownership of the Assets may be poorly-defined.

Assign recipients to a Compliance Form

Step 5: Publish your Form​

Once you have defined the set of Questions to be completed, the in-scope Assets, and the relevant Recipients, it's now time to publish your Form!

caution

Once you have published a Form, you cannot change or add Questions.

Publish a Compliance Form

FAQ and Troubleshooting​

How does a Compliance Form interact with existing metadata?

If an asset already has existing metadata that is also referenced in a Form Question, users assigned to the Form will have the option to confirm the value and make no changes, overwrite the value, or append additional details.

What is the difference between Completion and Verification Forms?

Both form types are a way to configure a set of optional and/or required questions for DataHub users to complete. When using Verification Forms, users will be presented with a final verification step once all required questions have been completed; you can think of this as a final acknowledgement of the accuracy of information submitted.

Can I assign multiple Forms to a single asset?

You sure can! Please keep in mind that an Asset will only be considered Documented or Verified if all required questions are completed on all assigned Forms.

API Tutorials​

Next Steps​

Now that you have created a DataHub Compliance Form, you're ready to Complete a Compliance Form.