解决使用IBM Knowledge Catalog导入治理工件时可能遇到的问题。
列名不正确
问题描述
导入失败,发生以下错误: 列名对于此工件类型无效,或者缺少必需列,但实际上文件中的所有列都已正确命名,并且未缺少任何必需列。
变通方法
标题可能包含一些在电子表格中或甚至在文本编辑器中不可见的空格字符。 空格字符会阻止识别列名。
- 使用显示空格字符的编辑器来编辑文件。
- 请尝试从头开始手动删除头并输入其名称。
- 检查文件编码是否为 UTF-8,例如,是否为 UTF-8 BOM。
跳过与不存在的工件的关系
问题描述
当您定义两个工件之间的任何类型的关系时,导入过程将成功,但将跳过与不存在的工件的关系。 跳过的关系会导致类似如下的错误:
GIM00015E: Artifact Average balance in column Related Terms is not found in the specified hierarchy.
变通方法
如果计划导入彼此之间具有关系的多种类型的工件,请首先导入所有工件,发布已导入的工件,然后使用 替换所有值 合并方法再次导入相同的 CSV 文件。 第二个导入过程将关系添加到现有工件。
类别不存在
问题描述
如果未在 CVS 文件中定义工件的父类别,那么缺省情况下会将工件导入到 [未分类] 类别。 如果在 CSV 文件中定义了工件的父类别,但该工件在环境中不存在,那么导入将失败。 导入过程每次导入时始终只创建一种类型的工件。 导入除类别以外的工件时,无法创建父类别。
变通方法
在从 CSV 文件导入工件之前,请确保要将其导入的类别存在于环境中。 在开始导入过程之前创建这些文件。
CSV 导入后找不到工件
问题描述
CSV 文件导入的工件在 "已发布" 页面上不可见。
变通方法
您必须先发布工件,然后这些工件才会显示为 "已发布" 并且可供使用。 如果工件位于导入的类别中,那么您可能需要将用户作为合作者添加到这些类别。
在 ZIP 导入后找不到工件
问题描述
ZIP 文件导入的工件在 UI 上不可见,但它们在 API 调用中可用。
变通方法
在 ZIP 导入期间, wkc-search
服务可能未处于 ready
状态。 要解决此问题,请使用以下命令再同步:
curl -X GET "$CPD_URL/v3/glossary_terms/admin/resync?artifact_type=all" -k -H "accept: application/json" -H "Authorization: Bearer $TOKEN"
ZIP 导入过程将创建重复工件
问题描述
导出的 ZIP 文件中的工件通过 Artifact ID
列中的工件标识进行标识,而不是通过工件名称和类别路径进行标识。 但是,每个IBM Knowledge Catalog实例的预定义业务术语、数据类和分类的工件标识符是不同的。 因此,导入的预定义工件无法识别为与现有预定义工件相同。 因此,导入过程将创建重复的工件。
变通方法
在导入工件之前,从目标IBM Knowledge Catalog实例中删除现有的预定义工件。 请参阅 删除相同类型的已发布工件。
对于预定义的数据类和分类:
- 通过导出工件创建 ZIP 文件时,排除 [uncategory] 类别。
- 编辑数据类和分类的 CSV 文件,并将 父分类 和 父数据类 列中预定义数据类和分类的工件标识替换为等效的预定义工件名称和类别路径。
- 编辑其他工件的 CSV 文件,并将预定义数据类和分类的工件标识替换为与预定义工件具有关系的任何工件的 分类 和 数据类 列中的等效预定义工件名称和类别路径。
导入工件时,将创建与现有目标预定义工件的关系。
对于预定义的业务术语:
- 通过导出工件创建 ZIP 文件时,排除 Knowledge Accelerator 样本个人数据 类别。
- 编辑 Business termsa 和其他工件的 CSV 文件,并将预定义业务术语的工件标识替换为 相关术语 列和定义业务术语关系的任何其他列中的等效预定义工件名称和类别路径。
导入工件时,将创建与现有目标预定义工件的关系。
在所有IBM Knowledge Catalog实例中,"地点"类别中的预定义参考数据集具有相同的工件 ID 值,因此无需采取变通方法。
缺少与从 ZIP 导入的预定义数据类和分类的关系
问题描述
不会导入定制属性和关系值。
变通方法
编辑 CSV 文件,编辑从工件标识到工件名称和类别路径的相关预定义数据类和分类的值,然后重新导入。