您可以使用 CSV 文件导入监管工件和类别。 您可以包含监管工件的所有属性的值,包括与其他工件的关系。 对于每种类型的监管工件和类别,您必须具有单独的 CSV 文件。
先决条件
在使用 CSV 文件导入监管工件之前,请创建格式正确的文件,并确保您具有必需的许可权。
CSV 文件
CSV 文件的格式必须正确。 请参阅 用于导入监管工件的 CSV 文件格式。
您可以通过多种方式创建 CSV 文件,例如:
- 您可以在另一个软件应用程序 (例如电子表格程序) 中创建 CSV 文件。
- 您可以从IBM Knowledge Catalog同一实例中导出治理工件,然后修改导出的文件。
- 您可以从不同的IBM Knowledge Catalog实例中导出治理工件。
- 您可以从 IBM InfoSphere Information Governance Catalog导出工件,然后更新 CSV 导出文件以符合 CSV 导入文件所需的格式。
根据文件的编码方式,您可能需要使用其他方法来导入该文件。 如果该文件使用 UTF-8进行编码,那么您可以通过 UI 或通过 API 请求来导入该文件。 如果该文件使用不同的编码,那么必须使用 API 请求来导入该文件。 请参阅 导入编码不同于 UTF-8的 CSV 文件。
必需的许可权
您需要的许可权取决于您计划导入的内容。
用于导入顶级类别的许可权
要导入顶级类别,您必须具有 管理监管类别 用户许可权。
用于导入子类别的许可权
要导入子类别,您必须在父类别中具有下列其中一个类别合作者角色:
- 管理员
- 所有者
- 具有创建子类别的许可权的定制角色。
用于导入监管工件的许可权
您必须有权管理 CSV 文件中列出的每个类别中的工件,无论该类别是在 类别 字段, 辅助类别 字段中列出,还是作为相关工件路径的一部分列出。 如果您具有下列其中一个类别合作者角色,那么可以管理类别中的工件:
- 管理员
- 所有者
- 编辑者
- 具有导入工件类型的许可权的定制角色。
要导入监管工件,您必须有权管理该文件中列出的每个监管工件的主类别中的工件。
要导入两个监管工件之间的关系,您必须有权管理这两个监管工件的主类别中的工件。
要包含监管工件的辅助类别关系,您必须有权管理辅助类别中的工件。
准备导入监管工件
在可以导入监管工件之前,这些工件的导入文件中列出的所有类别和子类别都必须存在。 否则,将不会导入具有未定义类别的工件。 有关更多信息,请参阅 解决监管工件导入问题。
除非在文件中定义更高级别的类别,否则必须先存在这些类别,然后才能导入具有类别定义的 CSV 文件。
要创建所需类别,可以使用以下任一方法:
导入文件可以包含与尚未导入的其他类型的监管工件的关系。 将创建文件中定义的工件。 但是,不会创建与不存在的工件的关系,并且您会收到错误消息。 您可以通过在导入和发布其他类型的监管工件之后再次导入接收到错误的文件来添加关系。
通过 UI 导入 CSV 文件
要通过 UI 导入 CSV 文件:
使用 API 请求导入 CSV 文件
在 API 请求中,可以指定运行并行导入进程,或者 将内容类型规范 设置为与 UTF-8不同的编码。
要使用 REST API 导入 CSV 文件:
- 如果需要,请创建类别。 请参阅 准备导入监管工件。
- 提交
POST /v3/governance_artifact_types/{artifact_type}/import
请求。 设置查询参数:- 设置 merge option 参数以解决与现有工件的冲突:
- 可选。 如果要并行运行多个导入过程,请将 async_mode 参数设置为
true
。 - 如果需要,请在 API 请求中包含编码信息。 请参阅 导入编码不同于 UTF-8的 CSV 文件。 请参见API 文档:从指定的 CSV 文件导入值。 提交该请求后,响应中提供了进程标识(process_id 参数)。
- 可选。 您可以使用响应中提供的进程标识来检查导入的状态。 提交
GET /v3/governance_artifact_types/import/status/{process_id}
请求以返回导入过程的状态。 请参见API 文档:导入状态。 - 导入过程完成后, 完成工件和类别。
导入使用 UTF-8 以外的编码的 CSV 文件
http 请求中的内容类型必须为 multipart/form-data
,文件类型必须为 text/csv
。 缺省情况下,对于 CSV 文件使用 UTF-8 字符编码。 如果该文件未使用 UTF-8,那么必须使用 API 调用来导入该文件。 请参见API 文档:从指定的 CSV 文件导入值。
您可以在内容类型规范中输入编码类型。
例如,如果文件具有 windows-1250 编码,那么 CURL 命令可能如下所示:
curl -X POST "https://{server}:{port}/v3/governance_artifact_types/{artifact_type}/import?merge_option={merge_option}" -H "accept: application/json" -H "Authorization: $AUTHORIZATION_HEADER" -H "content-type: multipart/form-data" -F "file=@\"./import_glossary.csv\";type=text/csv;charset=windows-1250" -k
完成工件和类别
CSV 文件中的监管工件将作为草稿导入,并遵循工作流程。 草稿工件必须遵循该类型监管工件的工作流程。 您可以在 草稿 选项卡上查看相应工件类型 (例如,业务术语) 的草稿监管工件。
要完成导入的工件:
- 导入所有类型的工件之后,请发布所有草稿工件。 转至 任务收件箱 并启动发布过程。 您必须具有发布工件的许可权。 请参阅 监管工件的工作流程。
- 如果需要,请使用 替换所有值 合并方法对接收到关系错误的文件重新运行导入。 然后,发布更新后的工件。
您导入的任何类别都将立即发布,因为类别不受工作流程约束。 导入的类别具有以下合作者:
- 您是导入的所有类别中的合作者,具有 所有者 角色。
- 如果导入新的顶级类别,那么您是唯一的合作者。
- 如果将子类别导入到现有类别,那么新子类别将从其更高级别的类别继承所有合作者。
有关更多信息,请参阅 解决监管工件导入问题。
要完成导入的类别,请将其他合作者添加到新类别。 如果将 公共访问权 组添加到导入的类别,那么缺省情况下会分配 编辑者 类别角色,而不是 查看者 角色,当您手动创建类别时,会将此角色分配给此组。
请参阅 管理类别合作者。
了解更多信息
父主题: 管理工件的导入方法