Knowledge Accelerators 入门

将 Knowledge Accelerators 组件到 IBM Knowledge Catalog 中，然后自定义组件。

准备工作

  1. 确保您拥有以下计划和 用户权限：
    产品套餐
    企业计划 IBM Cloud Pak for Data 企业计划。 更多信息，请参阅 IBM Knowledge Catalog 服务计划。
    必需的许可权
    • 访问目录
    • 管理资产发现
    • 访问监管工件
    • 管理词汇表
    • 管理监管类别
    • 管理项目

添加 Knowledge Accelerators 与用户界面

用户界面无法导入行业对齐词汇表。 相反，您必须使用 API 方法。 要导入业务范围或业务核心词汇和业务绩效指标，请使用用户界面导入方法。
  1. 转到管理工具 > 配置和设置 ，然后单击 Add Knowledge Accelerator 磁贴。
  2. 选择一个行业来添加词汇。
  3. 选择要添加的行业业务范围。
    所有项目 - 导入所有特定 Knowledge Accelerators 词汇表

    您可以选择导入包含完整业务词汇和所有业务范围的每个特定 Knowledge Accelerators 词汇表。 如果您需要导入大量的商业术语，以应对一个行业的广泛性，例如 5,000 到 20,000 个术语，那么请选择此选项。

    您可以使用 API 单独导入行业对齐词汇表。

    选定项目 - 导入业务范围

    您可以单独导入选定的 Knowledge Accelerators 业务范围，例如 Data Privacy 和其他特定行业范围。 如果您感兴趣的领域存在一个或多个此类业务范围，而且如果您希望从相对较少的业务术语（例如 200 到 500 个术语）开始，请安装一个或多个此类独立范围。 每个业务范围单独导入。

    有关每个行业的所有可用项 (包括定义，标识和更多信息) 的详细列表，请参阅以下链接。
  4. 设置导入的合并选项。

    更多信息，请参阅合并导入和现有工件的方法。

  5. 单击 Add 开始导入。
    注：
    • 如果导入多个 KA 业务范围，从共享工件（如策略和规则）到词汇术语的某些关系可能会被随后的业务范围导入覆盖。
    • 如果为多个行业导入 Knowledge Accelerators ，那么对于后续导入，可能不会合并共享工件 (例如，从策略和规则到词汇表术语) 中的关系-将保留最初导入的 KA 工件中的映射。 您可以忽略导入日志中与策略和监管规则相关的消息 (GIM00010E 或 GIM00015E)。

    看到导入开始的通知信息后，就可以关闭窗口了。

    不能同时启动多个导入任务。

  6. 请注意通知中的 process_id 值，因为导入完成后不会通知您。

    使用 process_id 查看导入任务的状态。 根据进口物品的数量和大小，进口可能需要一些时间。

    导入完成后，就可以开始添加协作者了。

添加 Knowledge Accelerators API

您可以在 API 文档中找到 Knowledge Accelerators 的 API 端点的描述。

  1. 可选：通过调用 Knowledge Accelerators 已 导入到词汇表 API 端点。
  2. 可选：选中可以导入的项目：
  3. 如果使用 API 添加 Knowledge Accelerators 组件，则必须通过生成 Cloud Pak for Data 生成 IBM Cloud IAM 令牌：
    1. 按照在控制台中创建 API 密钥中的说明获取 API 密钥。
    2. 按照使用 API 密钥生成 IBM Cloud IAM 令牌中的说明，使用 API 密钥生成 IAM 令牌。
  4. 调用 " 将指定的知识加速器项目导入词汇表 API 端点"。
  5. 选择要安装的项。
    注：
    • 如果导入多个 KA 业务范围，从共享工件（如策略和规则）到词汇术语的某些关系可能会被随后的业务范围导入覆盖。
    • 如果为多个行业导入 Knowledge Accelerators ，那么对于后续导入，可能不会合并共享工件 (例如，从策略和规则到词汇表术语) 中的关系-将保留最初导入的 KA 工件中的映射。 您可以忽略导入日志中与策略和监管规则相关的消息 (GIM00010E 或 GIM00015E)。
    所有项
    Knowledge Accelerators 词汇表适用于四个特定行业中的每个行业，并包含完整的 "业务词汇表" ， "行业对齐词汇表" 和所有 "业务作用域"。 您可以选择导入所有词汇表或选择这些词汇表。 如果需要导入一组广泛的业务术语 (例如， 5,000 到 20,000 个术语) ，请选择此选项。
    选定项目 - 导入业务范围
    可选择单独导入知识加速器业务范围，例如 Data Privacy 和其他特定行业范围。 如果对于您感兴趣的区域存在一个或多个这些业务作用域，并且如果您希望从相对较少的业务术语 (例如 200 到 500 个术语) 开始，那么可以安装一个或多个这些单独的作用域。
    有关每个行业的所有可用项 (包括定义，标识和更多信息) 的详细列表，请参阅以下链接。
  6. 输入以下参数的值。
    例如：
    参数 描述 示例
    ka_id 行业的标识 kafs20
    标识 要导入的一个或多个 Knowledge Accelerator 项的标识，以逗号分隔。 请注意，一次只能导入一个作用域。 core-bpi,ccpa,fhir, gdpr
    合并选项 导入到 IBM Knowledge Catalog时要使用的合并选项。 all
    dependencies 指示还应导入所指定项标识的哪些依赖关系。 necessary
    do_import
    • 选择 false 以检查参数并确定将导入的内容。
    • 选择要导入的 true 。
    		 false
  7. 请注意通知中的 process_id 值，因为导入完成后不会通知您。

    使用 process_id 查看导入任务的状态。 根据进口物品的数量和大小，进口可能需要一些时间。

    导入完成后，就可以开始添加协作者了。

检查导入状态

通过调用资产导入状态 API 端点来检查导入状态，其中 {process_id} 是使用 API 添加 Knowledge Accelerators 的第 4 步的值。

导入状态保持为 "IN_PROGRESS" ，直到导入所有工件为止。

在资源中心中查找 Knowledge Accelerators

  • 登录 Cloud Pak for Data as a Service 资源中心 https://dataplatform.cloud.ibm.com/gallery.
  • 选择筛选器 > 标签 > Knowledge Accelerators。
  • 点击磁贴查看特定行业的详细信息。 Knowledge Accelerators 行业。

添加合作者

您需要将合作者添加到 Knowledge Accelerators 类别，否则只有导入加速器的人员才能使用这些工件。 请参阅 管理对类别的访问权 ，以获取有关如何执行此操作的详细信息。

为逻辑数据模型资产分配术语

该 Knowledge Accelerators 功能可自动将业务术语 Knowledge Accelerators 该功能可自动为导入目录的逻辑数据模型资产分配业务术语。 IBM Cloud Pak for Data 目录。

先决条件
您需要将逻辑数据模型导入目录。 IBM Cloud Pak for Data 目录中。 您可以通过以下步骤导入模型：
先决条件 步骤以及从何处获取更多信息
1.安装 MANTA 自动数据线。  
2.启用血统导入。  
3.对于以下 IBM 行业模型的用户，您需要为导入模型做好准备。
  1. 打开逻辑数据模型的 erwin Data Modeler 文件。
  2. 删除模型上的所有图表。 有关更多信息，请参阅此支持页面 https://www.ibm.com/support/pages/node/7070054
  3. 将模型保存为标准 XML。
  4. 压缩或压缩标准 XML 文件。

如需了解更多信息，请联系 IBM 支持部门。
4.导入逻辑数据模型  
调用端点

要将现有的 Knowledge Accelerators 术语分配给您的逻辑数据模型资产， 请使用指定的策略调用将术语分配给资产，例如 \ industrymodels_ldm API 端点。

  1. 参见 https://cloud.ibm.com/apidocs/watson-data-api-cpd#post-add-assignment.
  2. 在用户界面中查找目录、资产和类别的 ID。 IBM Knowledge Catalog 用户界面中查找目录、资产和类别的 id。
    查找目录 ID：
    1. 从主 IBM Cloud Pak for Data 展开目录并选择所有目录。
    2. 转到您正在使用的目录。
    3. 在浏览器 URL 中，您可以在 "/catalogs/"和 "?context=icp4data"字符串之间找到目录 ID。 例如，在下面的 URL 中，id 是 67ea9e1f-b2d9-423c-ab9e-c234945f9c0b ： https://api.dataplatform.cloud.ibm.com/67ea9e1f-b2d9-423c-ab9e-c234945f9c0b/?context=icp4data
    查找资产 ID：
    1. 从目录中单击过滤器图标，选择 " 逻辑模型 "作为 Asset Type ，然后单击应用。
    2. 单击结果集中列出的 "Logical Model"，例如原子仓库模型。
    3. 在浏览器 URL 中，您可以在 "/asset/" 和 "?context=icp4data" 字符串之间找到资产 ID。 例如，在下面的 URL 中，id 是 7948818c-d3b5-4844-bf1b-5cc22f6fe6e1 ： https://api.dataplatform.cloud.ibm.com/67ea9e1f-b2d9-423c-ab9e-c234945f9c0b/7948818c-d3b5-4844-bf1b-5cc22f6fe6e1/?context=icp4data
    查找类别 ID：
    1. 从主 IBM Cloud Pak for Data 从主菜单中，展开 " 管理 " 并选择 " 类别 "。
    2. 转到您正在使用的类别。
    3. 在浏览器 URL 中，您可以在 "/categories/"字符串后找到目录 ID。 例如，在下面的 URL 中，id 是 dc559b02-a39a-4132-8832-d42cd51af994 ： https://api.dataplatform.cloud.ibm.com/gov/categories/dc559b02-a39a-4132-8832-d42cd51af994
  3. 在请求正文中输入值。
    例如：
    值 规范 缺省值 描述 示例
    策略 可选 industrymodel_ldm 对资产采用的任期分配策略。 industrymodel_ldm
    资产标识 可选 目录中的逻辑数据模型。 目录中资产的 ID，用于分配商业条款。 7948818c-d3b5-4844-bf1b-5cc22f6fe6e1
    类别 可选 安装知识加速器的商业核心词汇。 类别的 ID，从中获取业务术语以将资产映射到该类别。 这将自动包括所提供类别的子类别，并延伸出其条款。 dc559b02-a39a-4132-8832-d42cd51af994
    ldm_type 可选 用于进行实体和列名到术语赋值的行业模型逻辑模型存储赋值类型。 用于进行实体/列名到术语赋值的行业模型逻辑模型存储赋值类型。 bfmdw_awm
    术语匹配方法 可选 仅支持术语匹配方法 artifact_id（id）。 仅支持术语匹配方法 artifact_id（id）。 id
    catalog_id 必需 包含要为其分配业务术语的资产的目录 id。 包含要为其分配业务术语的资产的目录 id。 提供目录 ID 或项目 ID，但不能多于一个。 67ea9e1f-b2d9-423c-ab9e-c234945f9c0b
  4. 在回复中，请注意"process_id"，因为您可以在下一节 " 检查学期分配进程的状态 "中用它来检查导入作业的状态。 由于分配过程可能需要一些时间，这取决于导入的逻辑数据模型资产和词汇表术语的数量和大小，因此可能有必要或应该进行此检查。

检查学期分配进程的状态

要监控将业务术语分配给逻辑数据模型资产的进度，请调用获取将术语分配给资产 API 端点的状态 ，其中 {process_id} 是将术语分配给逻辑数据模型资产的值。

参见 https://cloud.ibm.com/apidocs/watson-data-api-cpd#get-mappings-added

复制到项目中

您还可以使用将知识加速器项目复制到项目 API 端点，将 Knowledge Accelerators 工件作为 CSV 文件添加到 Cloud Pak for Data 项目中。

参见 https://cloud.ibm.com/apidocs/watson-data-api-cpd#copy-ka-into-ikc.

提示： 您可以在本地下载 CSV 文件，然后使用用户界面导入内容。 更多信息，请参见 https://cloud.ibm.com/apidocs/knowledge-catalog#copy-ka-into-ikc.