限制

CSV 导入文件的最大建议大小为 50 MB。

某些 IBM Knowledge Catalog计划对您可以创建的特定类型的治理工件的数量有限制。 系统不会对第一个导入的草稿单独计数，但会对您后续导入的任何草稿计数。 例如，如果已发布的术语 A 具有一个更新草稿，那么已发布的术语和草稿将计为一个术语。 但是，如果已发布的术语 A 有两个草稿更新，那么已发布的术语和草稿将计为两个术语。 可以通过在重新导入之前发布导入的工件来避免重复计数。

标题行

CSV 文件的标题行表示要为工件导入哪些属性。

请遵循标题行的以下准则:

• 标题行必须是文件中的第一行，并且不得重复。
• 用逗号分隔列名。 如果在电子表格编辑器中创建文件，那么以 CSV 格式保存文件时将自动添加逗号。
• 标题行必须包含工件类型的必需列。
• 可以省略任何可选列。
• 使用标题行中的精确列名 (定制属性和定制关系列除外)。 某些列具有备用名称。 列名区分大小写。
• 确保列名不包含额外的空格字符。 空格字符可以由电子表格或文本编辑器添加，但不可见。 如果接收到列名称不正确的导入错误 (即使列拼写和大写正确) ，请检查是否存在空格。 有关更多信息，请参阅 解决监管工件导入问题。

列定界符

要对不同列的值进行定界，请使用逗号。 如果在电子表格编辑器中创建文件，那么以 CSV 格式保存文件时将自动添加逗号。

要省略列的值，请在前面的逗号后面直接使用逗号，而不使用任何其他字符。 例如，两个连续的逗号表示第二列为空。

要在值中包含逗号，请将该值括在双引号中。 例如，要导入 test的值，请使用以下格式:

"test,"

类别路径

必须指定类别的完整类别路径以及与工件的关系。 如果未指定类别，那么缺省类别为 [uncategory]。

要对类别路径进行定界，请在类别层次结构的每个级别之间以及类别路径与工件名称之间使用两个大于 (>>) 符号。

myCategory1 >> myCategory2 >> myCategory3

myCategory1 >> myCategory2 >> myCategory3 >> artifactName

>> artifactName
artifactName

工件属性值

导入的监管工件属性的值区分大小写。 例如，标记 number 和 NUMBER 被视为两个不同的标签，而不是一个。

Name,Artifact Type,Category,Tags,Related Terms
businessterm1,glossary_term,myCategory1,tag1,myCategory1 >> rel_term1
,,,tag2,myCategory1 >> rel-term2
businessterm2,glossary_term,myCategory1,tag3,myCategory2 >> rel-term3
,,,tag4,myCategory2 >> rel-term4

GIM00015E: Artifact Average balance in column Related Terms is not found in the specified hierarchy.

字符编码

http 请求中的内容类型必须为 multipart/form-data ，文件类型必须为 text/csv。 缺省情况下，对于 CSV 文件使用 UTF-8 字符编码。 如果 CSV 文件不使用 UTF-8，那么必须使用 API 调用导入该文件，并将编码类型包含在内容类型规范中。 请参阅 导入编码不同于 UTF-8的 CSV 文件。

名称 (必填)

备用列名

名称

工件类型

类别，业务术语，分类，数据类，参考数据集，策略，监管规则

描述

此工件的名称。

监管工件的名称与其主类别相关联，您必须将其包含在 类别 字段中。 例如，这就是为什么业务术语列表可能会显示名称相同但主类别不同的业务术语。

FORMAT

工件的名称对于其主类别中的工件类型必须是唯一的。 名称区分大小写。 例如，名称 "机密" 和 "机密" 被视为不同的名称。

名称必须包含 1-255 个字符。 名称不能包含 Unicode 控制字符，以空格开头或结尾，也不能包含任何大于 (>) 符号。

缺省值

无。 必须为工件名称提供值。

示例

要添加名为 Blue的业务术语，请指定:

 Name,Artifact Type,Category
 Blue,glossary_term,Colors

工件类型 (必需)

备用列名

artifact_type

工件类型

类别，业务术语，分类，数据类，参考数据集，策略，监管规则

描述

一种类型的监管工件的名称。

FORMAT

一次只能导入一种监管工件类型的数据。 请使用下列值来指定工件类型：

缺省值

无。 必须提供工件类型。

示例

要添加业务术语工件，请指定:

 Name,Artifact Type,Category
 Blue,glossary_term,Colors

类别 (必填)

备用列名

类别

工件类型

类别，业务术语，分类，数据类，参考数据集，策略，监管规则

描述

要创建的工件或类别的主类别。

FORMAT

指定以顶级类别开头的完整层次结构路径，例如: myCategory1 >> myCategory2 >> myCategory3。 请参阅 类别路径 (Category path)。

除非要导入类别，否则指定的类别必须存在。 如果要导入子类别，那么必须存在更高级别的类别，除非您在同一文件中定义这些类别。

缺省值

在以下情况下，请将此字段留空:

• 导入顶级类别。
• 将导入的工件添加到 [uncategory] 类别。

示例

要将业务术语添加到 颜色 顶级类别，请指定:

 Name,Artifact Type,Category
 Blue,glossary_term,Colors

要导入名为 myCategory1的新顶级类别，请指定:

Name,Artifact Type,Category
myCategory1,category,

要将名为 myCategory2的类别作为子类别添加到名为 myCategory1的现有类别，请指定:

Name,Artifact Type,Category
myCategory2,category,myCategory1

要在 myCategory1 >> myCategory2的现有类别层次结构中添加名为 myCategory3的类别，请指定:

Name,Artifact Type,Category
myCategory3,category,myCategory1 >> myCategory2

描述

备用列名

描述

工件类型

类别，业务术语，分类，数据类，参考数据集，策略，监管规则

描述

工件的描述。

FORMAT

描述最多可包含 15000 个字符。

辅助类别

备用列名

secondary_categories

工件类型

业务术语，分类，数据类，参考数据集，策略，监管规则

描述

工件的辅助类别。

FORMAT

该类别必须存在。 不能将 [uncategory] 类别指定为辅助类别。 指定从顶级类别开始的完整层次结构路径。 请参阅 类别路径 (Category path)。

要导入工件的多个辅助类别，请为该工件添加多行，每行中包含不同的辅助类别值。

元数据管理员

备用列名

管理者

工件类型

类别，业务术语，分类，数据类，参考数据集，策略，监管规则

对于类别，元数据管理员不会显示在 UI 中。 要检查值，您可使用以下 REST API 调用：GET /v3/categories/{guid}。 更多信息，请参阅API 文档。

描述

负责工件的人员的用户标识。

FORMAT

由字母数字值组成的 IBMid 。 作为 IBM Cloud 帐户所有者，您可以查看帐户中的所有用户。 要查找用户的 IBMid，请转至 管理> 访问权 (IAM)> 用户。 打开该用户对应的条目，然后单击详细信息。

元数据管理员值的格式在 Cloud Pak for Data as a Service 与 Cloud Pak for Data 3.5 或 4.x之间不兼容。

管理者组

工件类型

类别，业务术语，分类，数据类，参考数据集，策略，监管规则

描述

负责工件的元数据管理员用户组。

标记

备用列名

标记

工件类型

类别，业务术语，分类，数据类，参考数据集，策略，监管规则

对于类别，不会在 UI 中显示标记。 要检查值，您可使用以下 REST API 调用：GET /v3/categories/{guid}。 更多信息，请参阅API 文档。

描述

可简化工件可检索性的字符串。

FORMAT

最多 255 个字符的字符串。 它可以包含空格、字母、数字、下划线、短划线以及符号 # 和 @。

如果该标记尚不存在，那么会创建新标记。 要导入工件的多个标记，请为该工件添加多行，其中每一行中的标记具有不同的值。

分类

备用列名

分类

工件类型

类别，业务术语，数据类，参考数据集，策略，监管规则

对于类别，分类不会显示在 UI 中。 要检查值，您可使用以下 REST API 调用：GET /v3/categories/{guid}。 更多信息，请参阅API 文档。

描述

分配给工件的分类。

FORMAT

该分类必须存在。 指定分类及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

要为一个工件导入多个分类，请为该工件添加多行，并在每一行指定不同的分类值。 请注意，在类别导入中支持 分类 列，但不会将其导出。

示例

Name,Artifact Type,Category,Classifications
Account,glossary_term,Insurance >> Business Area >> All Accounts,Insurance >> concept

业务开始

备用列名

business_start

工件类型

业务术语，分类，数据类，参考数据集，策略，监管规则

描述

已发布工件变为活动状态的生效日期。 您可以导入具有过去的业务开始日期的工件。

生效开始日期设置如下:

• 导入具有过去生效开始日期的新工件: 当您发布草稿时，生效开始日期将设置为发布日期和时间。
• 导入具有将来生效日期的新工件: 发布草稿时，将使用导入中指定的生效开始日期。
• 导入对过去具有生效开始日期的现有工件的更新: 发布草稿时，如果使用 替换空值 合并方法导入，那么将保留原始开始日期。 否则，开始日期将更改为发布日期。
• 导入对将来具有生效开始日期的现有工件的更新: 发布草稿时，将使用导入中指定的生效开始日期，除非该日期是过去的日期。 在这种情况下，它设置为发布的日期和时间。

FORMAT

指定开始日期，时间和全球标准时间时间偏移量，格式为 yyyy-mm-dd hh:mm±hh:mm，例如 2020-10-07 16:00+00:00。 指定时间偏移量是可选的。 如果省略该部分，那么将采用全球标准时间。

业务结束

备用列名

business_end

工件类型

业务术语，分类，数据类，参考数据集，策略，监管规则

描述

已发布工件变为不活动状态的生效日期。

FORMAT

以格式 yyyy-mm-dd hh:mm±hh:mm指定开始日期，时间和全球标准时间偏移量，例如 2021-10-07 17:00+00:00。 指定时间偏移量是可选的。 如果省略该部分，那么将采用全球标准时间。

相关术语

备用列名

相关术语

工件类型

业务术语，分类，数据类，参考数据集，策略，监管规则

描述

与工件相关的业务术语。

FORMAT

业务术语必须存在。 指定相关术语及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

要为一个工件导入多个术语，请为该工件添加多行，并在每一行指定不同的术语值。

示例

Name,Artifact Type,Category,Classifications,Related Terms
Account claim tracking,glossary_term,Insurance >> Business Area >> Claim,Insurance >> property,Insurance >> Business Area >> Account >> Account

定制属性值

列名

custom_属性-名称

此类值的列名是以 custom_为前缀的定制属性的名称。

工件类型

类别，业务术语，数据类，策略，监管规则

描述

任何类型的定制属性的值，类型为 "关系" 的定制属性除外。

FORMAT

定制属性必须存在。
对于 USER_GROUP 类型的自定义属性，支持的格式是

• "user_id:user" ，例如 "1000330999:user"
• "group_id:group" ，例如 "10000:group"

可以为类型为 USER_GROUP 的一个 CP 定义用户和用户组 (如果它支持多个值)。

定制关系

列名

custom_directed_关系名称

关系的列名是以 custom_directed_作为前缀的定制关系的名称。 例如， custom_directed_Is Analyze By。

工件类型

类别，业务术语，数据类，分类，策略，监管规则

描述

类型为 "关系" 的定制属性。

FORMAT

定制关系和目标工件必须存在。 必须指定定向关系。 将自动创建反向关系。 指定定制关系及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

按以下格式指定信息： contextPath:Type

部分条款

备用列名

part_of_terms

工件类型

业务术语

描述

在两个业务术语之间添加部件关系:

• 是以下项的一部分: 指定一个关系，在该关系中，一个项是另一个项的组件，一部分，属性或成员。
• 具有部分: 指定另一个术语是第一个术语的组件，部分，属性或成员的关系。

FORMAT

目标业务术语必须存在或必须在同一 CSV 文件中定义。 在具有 是 关系的一部分的业务术语的行中，列出目标业务术语。 将自动添加 具有部分 关系的一半。

指定与其完整类别层次结构路径 ` 的部件关系。 请参阅 类别路径 (Category path)。 必须始终将部件关系定义为 是 关系的一部分。

要为一个术语导入多种关系，请为该术语添加多行。

示例

例如，“固定利率”、“混合利率”和“可变利率”是术语“利率”的属性，“利率”则是术语“房屋贷款”的属性。 在本例中，术语“固定利率”、“混合利率”和“可变利率”中的每一项都与术语“利率”有隶属于关系。 术语“利率”与这些术语有包括关系，但还与术语“房屋贷款”有隶属于关系。

这些术语的行类似于以下样本：

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Part of Terms,Abbreviations
Interest Rate,glossary_term,myCategory1,,,,,,myCategory1 >> Home Loan,,
Fixed Rate,glossary_term,myCategory1,,,,,myCategory1 >> Interest Rate,,
Hybrid Rate,glossary_term,myCategory1,,,,,myCategory1 >> Interest Rate,,
Variable Rate,glossary_term,myCategory1,,,,,myCategory1 >> Interest Rate,,

术语类型

备用列名

type_of_terms

工件类型

业务术语

描述

显示类型关系:

• 是一种类型: 指定一个关系，在该关系中，一个术语是由另一个通常范围更广的术语表示的概念的实例。
• 具有类型: 指定一个关系，在该关系中，由术语表示的概念具有一个或多个由其他术语表示的子类型。 例如，术语“贷款”可以指定为与术语“房屋贷款”、“汽车贷款”和“学生贷款”具有包括关系。

FORMAT

目标业务术语必须存在或必须在同一 CSV 文件中定义。 在具有 是 关系类型的业务术语的行中，列出目标业务术语。 将自动添加 具有类型为 的一半关系。

指定与其完整类别层次结构路径的类型关系。 请参阅 类别路径 (Category path)。 类型关系必须始终定义为 是 关系的类型。

要为一个术语导入多种关系，请为该术语添加多行。

示例

例如，“房屋贷款”、“汽车贷款”和“学生贷款”都是不同类型的贷款。 在此情况下，术语“房屋贷款”、“汽车贷款”和“学生贷款”与术语“贷款”之间都存在隶属于关系。 术语“贷款”与这些术语之间存在包括关系。

这些术语的行类似于以下样本：

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Part of Terms,Type of Terms
Home Loan,glossary_term,myCategory1,,,,,,,myCategory1 >> Loan,
Car Loan,glossary_term,myCategory1,,,,,,,myCategory1 >> Loan,
Student Loan,glossary_term,myCategory1,,,,,,,myCategory1 >> Loan,

同义词

备用列名

同义词

工件类型

业务术语

描述

与另一个具有相同含义的业务术语的关系。

FORMAT

目标业务术语必须存在或在同一 CSV 文件中定义。 指定同义词及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

要为一个术语导入多个同义词，请为该术语添加多行，并在每一行指定不同的同义词。

数据类

备用列名

数据类

工件类型

业务术语

描述

任何分配给术语的数据类。

FORMAT

数据类必须存在。 指定数据类及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

要为一个术语导入多个数据类，请为该术语添加多行，并在每一行指定不同的数据类。

缩写

备用列名

缩写

工件类型

业务术语

描述

业务术语名称的缩写形式。

FORMAT

术语的缩写。

要导入一个术语的多个缩写，请为该术语添加多行，并在每行中为一个缩写添加不同的值。

父分类

备用列名

父分类

工件类型

分类

描述

该分类所属的主分类。

FORMAT

父分类必须存在或在同一 CSV 文件中定义。 指定父分类及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

示例 :

Name,Artifact Type,Category,Parent Classification,Related Terms
financial,classification,Insurance >> Business Area >> Claim,Insurance >> property

父数据类

备用列名

parent_data_class

工件类型

数据类

描述

指定数据类层次结构中的关系。

FORMAT

父数据类必须存在或必须在同一 CSV 文件中定义。 每个数据类都只能有一个父数据类。 父数据类和子数据类必须位于同一类别中。 指定父数据类及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

示例 :

Name,Artifact Type,Category,Description,Classifications,Related Terms,Parent Data Class
Georgia State Driver's License,data_class,Driver's License >> US License,A string representing a driver license of US state Georgia.,,,Driver's License >> US License >> Southeastern Driver's License

已启用

备用列名

已启用

工件类型

数据类

描述

指示是否启用数据类进行数据匹配。

FORMAT

可能的值是 TRUE 或 FALSE。 此列是可选的，但如果添加该列，那么它必须包含 CSV 文件中每个数据类的值。

已授权报告

备用列名

报告

定义

备用列名

定义

工件类型

数据类

描述

数据类定义。

FORMAT

以双引号括起的 XML 代码。 通过导出现有数据类来创建此 XML 代码。

此列是可选的，但如果添加该列，那么它必须包含 CSV 文件中每个数据类的值。

示例 :

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><DataClasses xmlns="http://www.ibm.com/infosphere/ia/classification/DataclassesDefinition"><DataClass id="AddressLine1" name="Address Line 1" description="Address Line 1 of a multi-line address." priority="12" active="true" provider="IBM"><JavaClassifier scope="column" className="com.ibm.infosphere.classification.impl.AddressLineClassifier"/><DataTypeFilter><LogicalDataType>string</LogicalDataType></DataTypeFilter><DataLengthFilter minLength="4" maxLength="100"/><ColumnNameFilter><ColumnNameRegularExpression>addr.{0,15}(1|one)$</ColumnNameRegularExpression></ColumnNameFilter></DataClass></DataClasses>

数据集类型 (对于参考数据集是必需的)

备用列名

类型

工件类型

参考数据集

描述

参考数据集的数据类型。 在导入参考数据集时，此属性为必需。

FORMAT

支持的值是 text、date 和 number。

父参考数据集

备用列名

父 rds

工件类型

参考数据集

描述

指定参考数据集层次结构中的关系。

FORMAT

父参考数据集必须存在或必须在同一 CSV 文件中定义。 一个参考数据集可以有任意数量的父参考数据集。 指定父参考数据集及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

要导入多个父参考数据集，请为每个父参考数据集分别添加一行。

示例 :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Business Start,Business End,Data Set Type,Parent Reference Data Sets,Secondary Categories,Custom Columns
RDS1,reference_data,cat1,Test RDS,tag1,Confidential,1000330999,cat1 >> term1,6/15/2021 13:08,7/31/2021 21:59,TEXT,cat1 >> RDS2,Information Governance,TEXT||CUSTOM COLUMN1||test
,,,,,,,,,,,,Business Information,NUMBER||CUSTOM COLUMN2||test2
RDS2,reference_data,cat1,,,,,,6/15/2021 13:13,,TEXT,,,

定制列

备用列名

custom_columns

工件类型

参考数据集

描述

将参考数据集中的列映射到现有定制列。 导入新的参考数据集时，可以定义新的定制列。 请参阅 定制列。

FORMAT

按以下格式指定信息：

type (TEXT/NUMBER/DATE)||name||description (optional)||composite-key/normal-column (optional, default: normal-column)||mandatory/optional (optional, default: optional)||max characters number (optional, default: 2000 for normal-column, 200 for CK column)||validator as path>>name (optional)

• 如果将该列定义为组合键，那么它必须是必需的。
• 只有类型为 TEXT 的已发布引用数据集才能作为验证器。
• 只有类型为 TEXT 的定制列才能具有验证器。
• 每个集合的最大组合键列数为 5。

示例 :

NUMBER||Digit Count||Number of digits of the prime
TEXT||Additional information

父策略

备用列名

父策略

工件类型

策略

描述

指定策略的父策略。

FORMAT

父策略必须存在。 指定父策略及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

一个策略只能有一个父策略。

示例 :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Secondary Categories,Rules,Parent Policy
policy7,policy,PolicyDef,test policy7,Tag1,,,,,PolicyDef >> policy1

父策略

备用列名

父策略

工件类型

监管规则

描述

指定监管规则的父策略。

FORMAT

父策略必须存在。 指定父策略及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

示例 :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Business Start,Business End,Type,Secondary Categories,Rules,Reference Data Sets,Parent Policies,custom_Rule_text_0
rule2,rule,cat1,,,,,,6/15/2021 13:17,,Governance,,cat1 >> rule1,,cat1 >> pol1,
rule1,rule,cat1,test description,tag1,Confidential,1000330999,cat1 >> term1,6/15/2021 13:16,8/31/2021 21:59,Governance,Business Information,cat1 >> rule3,cat1 >> RDS2,cat1 >> pol2,example CA value
,,,,,,,,,,,,cat1 >> rule2,cat1 >> RDS1,cat1 >> pol1,
rule3,rule,cat1,,,,,,6/15/2021 13:20,,Governance,,cat1 >> rule1,,cat1 >> pol1,

规则

备用列名

规则

工件类型

策略，监管规则

描述

对于策略，这是受此策略管理的监管规则。

对于规则，以某种方式与此规则相关的监管规则。 此关系是对称的。 如果指定规则 A 与规则 B 相关，那么规则 B 与规则 A 相关。

FORMAT

监管规则必须存在。 指定监管规则及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。

要导入具有多个规则的关系，请为每个规则添加单独的行。

示例 :

Name,Artifact Type,Category,Description,Tags,Classifications,Stewards,Related Terms,Business Start,Business End,Secondary Categories,Rules,Parent Policy,custom_policy_text_0
pol3,policy,cat1,,,,,,6/15/2021 13:16,,,,,
pol2,policy,cat1,,,,,,6/15/2021 13:14,,,cat1 >> rule1,cat1 >> pol1,
pol1,policy,cat1,test descritpion,tag1,Confidential,1000330999,cat1 >> term1,6/15/2021 13:11,7/31/2021 21:59,Information Governance,cat1 >> rule3,cat1 >> pol3,example CA value
,,,,,,,,,,,cat1 >> rule1,,
,,,,,,,,,,,cat1 >> rule2,,

参考数据集

备用列名

rds

工件类型

监管规则

描述

与监管规则相关的参考数据集。

FORMAT

参考数据集必须存在。 指定参考数据集及其完整类别层次结构路径。 请参阅 类别路径 (Category path)。