Manage context specifications (in preview)

Keep your context specifications accurate as your operating model and your target platforms evolve. You can edit the details of a context specification or edit its YAML directly. You can also duplicate a context specification to try a different configuration without risk to a working one, or delete it.

Prerequisites

  • You have the Product rights > Guided Stewardship global permission.
  • To edit Context Specification asset, including the mapping and YAML, you have the Asset > Update resource permission. Without this permission, you can view the mapping, but you cannot edit it.

Steps

Edit the details of a context specification

  1. On the main menu, click Stewardship.
  2. In the Semantic Layer section, click Context specifications.
  3. In the row of the context specification, click More icon, and then click Edit.
    The Edit Context dialog box appears.
  4. Edit the Context name, the Description, or the Target asset type.
    You cannot edit the Target schema type. To use a different target schema, create a new context specification.
  5. Click Save

Duplicate a context specification

Duplicate a context specification when you want to try an alternative configuration. The duplicate is independent, so your edits don't affect the original.

  1. On the main menu, click Stewardship.
  2. In the Semantic Layer section, click Context specifications.
  3. In the row of the context specification, click More icon, and then click Duplicate.
    A copy appears in the list, with the same YAML, target schema, and target asset type. Collibra adds (copy) to the name.

Edit the YAML of a context specification

  1. On the main menu, click Stewardship.
  2. In the Semantic Layer section, click Context specifications.
  3. Click the name of the context specification.
    The asset page of the Context Specification asset opens.
  4. On the Specification tab, click YAML.
  5. Click Edit icon.
  6. Edit the YAML.
    The editor highlights the syntax and marks errors. If the YAML has errors, a list of errors appears below the editor. To go to the line of an error, click Go to error.
  7. Click Save.
    The schema tree and the mapping builder show the new configuration.

For the YAML keys and values, go to Context specification YAML reference (in preview).

Delete a context specification

  1. On the main menu, click Stewardship.
  2. In the Semantic Layer section, click Context specifications.
  3. In the row of the context specification, click More icon, and then click Delete.
    The Delete context dialog box appears.
  4. Click Delete.
    Collibra deletes the context specification.

Helpful resources