Create a context specification (in preview)

Create a context specification to define how Collibra reads an asset type and shapes the output for a target schema. When you finish, you and your colleagues can generate governed context for any asset of that type, in the same structure every time.

Prerequisites

  • The Governed Context Compiler is switched on in your environment.
  • You have the Product rights > Guided Stewardship global permission.
  • You have the Asset > Add resource permission on the New Context Specifications domain where Collibra saves Context Specification assets.

Steps

  1. On the main menu, click Stewardship.
  2. In the Semantic Layer section, click Context specifications.
  3. Click Create context specification.
  4. Enter the required information.
    5. Field Description
    Context name A unique name for the context specification, up to 255 characters.
    Description Optional. A short description that appears in the list of context specifications.
    Target schema type The structure of the output: a predefined schema or Custom Schema. You cannot edit the target schema type after you create the context specification.
    Target asset type The asset type that the context specification reads from. You can edit the target asset type later.
  5. Click Create.
    The asset page of the new Context Specification asset opens on the Specification tab. The schema tree is on the left. For a predefined schema, the schema tree shows all fields of that schema.
  6. If you selected Custom Schema, build the output structure in the schema tree:
    1. Click Add field in the schema tree.
    2. Enter the name of the field.
    3. To add a child item to an existing field, hover your cursor over the field and click More icon, then click Add child item.
    4. To change the order of the schema, click and drag fields in the schema tree, or click More icon, then Move up or Move down.
  7. In the schema tree, select a field.
  8. In the Mapping type section, select how the field gets its value. For more information, go to Context specification mapping types (in preview).
  9. Enter the settings for the mapping type.
  10. Repeat steps 7 to 9 for each field.
    A green check mark appears next to each field that has a valid mapping. Collibra saves your edits automatically.
  11. Optionally, test the context specification on a real asset. For more information, go to Test a context specification (in preview).

Helpful resources