将 IBM OpenPages with Watson 与 IBM App Connect Enterprise 配合使用

IBM® OpenPages with Watson 是一个集成的监管，风险和合规性 (GRC) 平台，支持公司管理整个企业中的风险和监管挑战。 IBM App Connect Enterprise 提供了 IBM OpenPages with Watson Input 和 IBM OpenPages with Watson Request 节点，可用于与 IBM OpenPages with Watson进行交互。

以下步骤说明如何使用连接器发现来连接到 IBM OpenPages with Watson 帐户并配置 IBM OpenPages with Watson Request 节点。 您可以遵循类似的过程来配置 IBM OpenPages with Watson 输入 节点，以通过创建包含 IBM OpenPages with Watson 输入 节点的流并通过连接器发现对其进行配置，从而监视 IBM OpenPages with Watson 以获取新的或更新的对象。

1. 在 IBM App Connect Enterprise Toolkit中，创建包含 IBM OpenPages with Watson Request 节点的流。
2. 选择流中的 IBM OpenPages with Watson Request 节点以在编辑器中显示节点属性。
3. 在 基本 选项卡上，单击 启动连接器发现。
   此时会显示一个面板，您可以在其中指定要在连接器发现期间使用的策略项目名称和保险库文件详细信息。
4. 指定要在连接器发现期间使用的策略项目和保险库文件的详细信息：
   1. 在 策略项目 字段中，指定用于存储连接器发现期间创建的策略的策略项目。
      也可以通过单击新建并指定新策略项目的名称来创建新的策略项目。 然后单击完成。
   2. 指定要在连接器发现期间使用的保险库文件。 缺省情况下，连接器发现期间使用的凭证存储在 外部目录保险库中，这是可供任何集成服务器使用的 App Connect Enterprise 保险库文件。 或者，您可以将凭证存储在集成服务器保险库文件中，该保险库文件是在集成服务器的工作目录中创建的，并且只能由该特定集成服务器使用。
      要指定用于存储凭证的保险库文件，请完成下列其中一个主题的 使用连接器发现向导 部分中的步骤:

      • 配置外部目录保险库
      • 配置集成服务器保险库
   3. 在 保险库密钥 字段中，输入用于访问保险库中存储的凭证的保险库密钥。 保险库密钥的长度必须至少为 8 个字符。
   4. 可选: 缺省情况下，指定的保险库文件位置和保险库文件密钥将另存为 Toolkit 中的首选项，以便在您启动 "连接器发现" 时预设这些值。 如果您不希望保存这些首选项，请取消选中保存在保险库文件首选项中。
5. 单击 启动发现 以启动 IBM OpenPages with Watson 连接器的 "连接器发现" 向导。
   此时将显示 " 连接器发现 " 窗口。 如果现有 IBM OpenPages with Watson 连接 (帐户) 可用，那么将显示这些连接的列表。 如果没有现有连接，那么 IBM OpenPages with Watson 连接器的状态显示为 Not connected。
   • 如果一个或多个 IBM OpenPages with Watson 连接 (帐户) 可用，请完成以下步骤:
     1. 通过单击连接（帐户）来选择要使用的连接（帐户）。
     2. 单击所需的对象类型，然后选择要对该对象执行的操作。 例如，要从 IBM OpenPages with Watson检索操作项，请单击 操作项 ，然后单击 检索操作项。
   • 如果没有现有连接（帐户），请完成以下步骤：
     1. 单击所需的对象类型，然后选择要对该对象执行的操作。 例如，要从 IBM OpenPages with Watson检索操作项，请单击 操作项 ，然后单击 检索操作项。
     2. 单击连接。
     3. 选择所选应用程序类型:
        • 单击 OpenPages on IBM Cloud Pak for Data，然后单击 继续。
        • 单击 OpenPages (云托管或本地)，然后通过从下拉列表中单击下列其中一个选项，选择要用于连接到 IBM OpenPages with Watson的授权方法:
          1. 提供凭证以供 App Connect 使用 (BASIC)
          2. 提供凭证以供 App Connect 使用 (SSL)

          请单击继续。

     4. 指定将用于连接到 IBM OpenPages with Watson的凭证。 所需凭证根据您选择的应用程序类型和授权方法而有所不同:

        表 1. 所选授权方法或应用程序类型的连接字段

        提供凭证以供 App Connect 使用 (BASIC)	提供凭证以供 App Connect 使用 (SSL)	OpenPages 关于 IBM Cloud Pak for Data
        端点 URL	端点 URL	端点 URL
        用户名	证书	用户名
        密码	Key	密码
        		实例名称
        		网络名 (可选)

        下表提供了连接字段的描述:

        表 2. IBM OpenPages with Watson 的连接详细信息

        连接字段	描述
        端点 URL	IBM OpenPages with Watson 实例的 URL ，格式为 https://<hostname> 。 如果端点 URL 不是可以从全球网络访问的公共 URL ，则可以使用 IBM Secure Gateway 在公共网络上进行访问。 有关 IBM Secure Gateway 的更多信息，请参阅 IBM Cloud文档中的 Secure Gateway 入门。
        用户名	用于登录到 IBM OpenPages with Watson 帐户的用户名。
        密码	指定用户名的密码。
        实例名称	IBM OpenPages with Watson 实例的唯一名称。 有关实例名称的更多信息，请参阅 OpenPages API 文档中的 OpenPages GRC REST API 参考指南 的 可寻址空间 /URI 设计 部分。
        证书	Base64-encoded (PEM) 格式的客户机证书内容。 证书和密钥是根据在 IBM OpenPages with Watson 帐户创建期间获取的个人证书生成的。 有关客户机证书的更多信息，请参阅 OpenPages API 文档中 OpenPages GRC REST API Reference Guide 的 Security 部分。
        Key	Base64-encoded (PEM) 格式的客户机证书密钥。 证书和密钥是根据在 IBM OpenPages with Watson 帐户创建期间获取的个人证书生成的。 有关客户机证书密钥的更多信息，请参阅 OpenPages API 文档中 OpenPages GRC REST API Reference Guide 的 Security 部分。
        网络名 (可选)	指定 IBM App Connect Enterprise 将用于访问系统的网络的名称。 仅当连接到专用网络中的系统时，才需要此属性。 如果已在 IBM App Connect Enterprise 中配置了可访问专用网络的网络，那么可以选择该网络。 否则，您需要配置网络 (通过下载和配置 Secure Gateway) 以用于专用网络。 有关更多信息，请参阅 IBM App Connect 文档中的 为 IBM App Connect 。 重要信息: 确保 Secure Gateway 客户机已启动。 如果需要，可以启动 Secure Gateway 客户机，如 IBM App Connect 文档中的 为 IBM App Connect 中所述。

     5. 单击连接。

        有关获取这些连接详细信息的更多信息，请参阅 IBM App Connect Enterprise as a Service 文档 中的 如何使用 IBM App Connect 和 IBM OpenPages with Watson。

6. 在向导中设置必需的连接器属性。
   您可以通过单击 添加条件 ，然后选择要过滤的属性来添加用于检索数据的条件。 例如，您可以检索具有指定资源标识的操作项。 您还可以设置一些属性，这些属性指定要检索的最大记录数以及在超过该限制时要执行的操作。
7. 在 "连接器发现" 向导中指定完属性后，单击 保存。
   用于连接到 IBM OpenPages with Watson 的凭证存储在保险库文件中，其他连接详细信息保存在 IBM OpenPages with Watson 策略中。 您在向导中设置的属性值将返回到 IBM App Connect Enterprise Toolkit中的 IBM OpenPages with Watson Request 节点。
8. 完成发现并保存属性值后，通过单击窗口右上角的 X 或按 Alt+F4来退出 "连接器发现" 向导。
9. 返回以编辑 IBM App Connect Enterprise Toolkit中的 IBM OpenPages with Watson Request 节点。
   现在，在 "连接器发现" 向导 (在步骤 6中) 中设置的连接器属性在属性编辑器中的 IBM OpenPages with Watson Request 节点上可见。 基本 选项卡以只读格式显示您在向导中设置的 操作 和 对象 属性的值。 如果要更改这些值，您可以通过再次单击启动连接器发现并在“连接器发现”向导中设置新值来执行此操作。

   模式基本名称 属性指定模式文件的基本名称，这些文件描述从 IBM OpenPages with Watson 连接器发送和接收的请求和响应消息的格式。 第一次对节点运行发现时，将自动设置模式基本名称，该名称基于当前流名称和节点名。 如果在首次运行发现之前手动设置此属性，那么将使用您设置的值。 如果在发现后重命名模式，那么必须编辑此属性，以使其与项目中重命名的模式所使用的模式基本名称相匹配。 如果在发现后更改此属性，那么必须重命名模式名称以匹配或再次运行发现。

   根据发现期间选择的操作， "连接器发现" 向导将生成请求模式和响应模式，或者仅生成响应模式。 仅当所选操作和对象需要请求消息时，才会生成请求模式。 生成的请求模式用于验证请求消息。 如果操作为 RETRIEVE 或 DELETE，那么连接器仅返回响应模式。

   生成的模式文件将添加到项目中，并且可供 映射 节点用于变换输入或输出数据。 模式的完整文件名派生自模式基本名称 (例如 gen/MyMessageFlow.IBM_OpenPages_with_Watson_Request) ，后缀为 response.schema.json 或 request.schema.json。 您可以通过单击 打开请求模式 或 打开响应模式来打开模式。

10. 检查 IBM OpenPages with Watson Request 节点上的属性设置是否正确，然后保存消息流。
11. 在 IBM OpenPages with Watson Request 节点的 连接 选项卡上， 策略 属性显示策略的名称，该策略包含要用于连接的安全身份的详细信息。 策略的类型为 IBM OpenPages with Watson。 有关更多信息，请参阅 IBM OpenPages with Watson 策略。
12. 可选: 在 连接 选项卡上设置 超时 属性，以指定节点等待 IBM OpenPages with Watson 处理操作的时间 (以秒计)。
13. IBM OpenPages with Watson Request 节点的 过滤器 选项卡包含用于控制消息流选择数据的方式的属性。 这些属性的初始值取自在 "连接器发现" 向导中为 IBM OpenPages with Watson 连接器设置的属性值，包括过滤器选项属性和指定的任何条件 (如步骤 6中所述)。 如果您随后返回到 "连接器发现" 向导并更改任何属性的值 (例如，通过添加新条件) ，那么这些更新将反映在节点上设置的属性中。

    过滤器选项 属性控制执行 IBM OpenPages with Watson Request 节点时要对哪些对象进行操作。 过滤器限制 属性控制要检索的最大项数以及超出限制时要执行的操作。

    您可以通过单击要在 " 过滤器选项 " 部分中修改的值旁边的 编辑 ，并通过更改在 过滤器限制 部分中设置的属性值来修改值。

    属性值可以是文本值，也可以是 ESQL 或 XPATH 表达式，这些表达式在执行时根据传递到 IBM OpenPages with Watson Request 节点的消息内容进行解析。

14. 在 请求 选项卡上，设置 数据位置 属性以指定入局消息树中包含要在 IBM OpenPages with Watson中创建的对象数据的位置。 此数据构成从 IBM OpenPages with Watson Request 节点发送到 IBM OpenPages with Watson 系统的请求。
15. 在 结果 选项卡上，设置 输出数据位置 属性以指定输出消息树中将包含在 IBM OpenPages with Watson中创建的记录数据的位置。
16. 缺省情况下，将根据连接器发现期间生成的请求模式验证请求消息。 您可以通过使用 IBM OpenPages with Watson Request 节点的 验证 属性来关闭请求验证或更改验证设置。
17. 保存 消息流。