Table of contents

Importing or exporting categories (Watson Knowledge Catalog)

You can import categories and governance artifacts from a file that is in CSV format. You can also export one type of artifact at a time from a category to a file that is in CSV format. You can modify this file outside of the catalog and later import it.

Importing categories

Whether you can import a category depends on the level of the category, your user permissions, and in some cases, on your role within the parent category.

Required permissions
You must have this user permission to import top-level categories:
  • Manage governance categories

You must have one of these category roles on the parent category to import subcategories:

  • Admin
  • Owner

To import categories, see Importing governance artifacts.

Exporting artifacts from a category

You can export one type of governance artifact at a time from a category or from a category and its subcategories. Only artifacts with a primary relationship to the category or its subcategories are exported.

Required permissions
You must be a collaborator in a category to export it.

To export one type of governance artifact from a category:

  1. Choose Governance > Categories.
  2. Click a category name to open it.
  3. Click Export.
  4. Select the type of governance artifact to export. When you select to export subcategories, you also have the option to include the current category into the export. By default, the current category is not included.
  5. Optional. Select to export artifacts from subcategories of the current category.
  6. Click Export.

A CSV file is downloaded to your computer. The export file has the same structure as an import file. See The Header row of a CSV file. If you export the system default category [uncategorized], the exported CSV file does not contain a category name for the selected type of governance artifact.

Exporting all governance artifacts of a type at once

You can export all governance artifacts of a selected type at once by using the REST API. Submit a GET /v3/governance_artifact_types/{artifact_type}/export request. Replace {artifact_type} with the artifact type that you want to export. To export all artifacts of the selected type from all categories, leave the category_id field empty. For details, see the API documentation.

Required permissions
You must be a collaborator with at least Viewer role on all categories.