在 UI 中,您可以一次从单个类别导出一种类型的工件。 您可以使用 IBM Knowledge Catalog API 来导出某一类型的所有治理工件。 该信息将导出到写入缺省下载文件夹的 CSV 文件。 缺省文件名为 <category_name>-<artifact_type>-csv-export.csv
。 您可在目录之外修改此文件,稍后再将其导入。
有关导出类别的信息,请参阅导入或导出类别。
从类别导出监管工件
您一次可以从类别或从类别及其子类别导出一种类型的监管工件。 只有与该类别或其子类别具有主关系的工件才会导出。
- 所需许可权
- 您必须是在要导出它的类别中至少具有 查看者 角色的合作者,或者具有有权导出工件类型的定制角色的合作者。
要从类别导出一种类型的监管工件,请执行以下操作:
选择 监管> 类别。
单击类别名称以将其打开。
单击导出。
选择要导出的监管工件类型。
每个类型最多可导出 400 个监管工件。
可选。 选择从当前类别的子类别导出工件。
选择导出子类别时,还可以选择同时导出当前类别。 在缺省情况下,不会包括当前类别。 要导出完整类别层次结构 (类别和树中的所有子类别) ,请同时选中这两个复选框。 要一次性导出所有根类别,请参阅 导入或导出类别。
单击导出。
这会将 CSV 文件下载到计算机。 导出文件具有与导入文件相同的结构。 请参阅导入 CSV 文件的格式。 如果导出系统缺省类别 [uncategorized],那么已导出的 CSV 文件不包含所选类型的监管工件的类别名称。
同时导出某一类型的所有监管工件
通过使用 REST API,最多可导出 400 个所选类型的监管工件。 提交 GET /v3/governance_artifact_types/{artifact_type}/export
请求。 请将 {artifact_type}
替换为所要导出的工件类型。 要从所有类别导出所选类型的工件,请将 category_id
字段留空。 有关详细信息,请参阅 API 文档。
- 所需许可权
- 您必须是对所有类别至少具有 查看者 角色的合作者,或者具有导出工件类型的许可权的定制角色的合作者。
将所有监管工件导出到 ZIP 文件
您可以使用 REST API 将所有监管工件导出到单个 ZIP 文件。 使用这种导出将所有治理工件从一个IBM Knowledge Catalog服务实例移动到另一个。 ZIP 文件包含每个工件类型的文件夹,每个文件夹都包含一个具有工件的 CSV 文件。 您可以导出所有工件类型或仅导出所选工件类型。 可导出的最大监管工件数为 400。 此方法还允许导出和导入具有其类别角色的类别合作者。
提交 GET /v3/governance_artifact_types/export
请求。 在 artifact_id_mode
字段中,保留缺省值 always
,因为导入所需的工件标识值。 有关详细信息,请参阅 API 文档。
- 所需许可权
- 您必须具有管理者服务角色。
安全性注意事项
导出到 CSV 文件的监管数据将针对已知的 CSV 注入攻击进行清理,以确保自动解释 CSV 数据的电子表格程序安全。 因此,任何以下列其中一个字符开头的文本值:
- 等于 (=)
- 加号 (+)
- 减 (-)
- at (@)
以单引号字符 (') 作为前缀。 为了使功能一致,还会对导入的 CSV 文件进行额外解析,以自动除去单引号字符 (')。 在导入监管工件并将其导出到 ZIP 文件时,清理也适用,因为这些工件包含 CSV 文件。
要禁用此功能:
编辑IBM Knowledge Catalog词汇表 服务部署:
oc edit deployment wkc-glossary-service
将环境变量
ESCAPE_FORMULAS_IN_CSV_FILES
设置为值false
。
有关更多信息,请参阅 CSV 注入。
了解更多信息
父主题: 管理监管工件