在 IBM App Connect Enterprise 中使用 Hunter

Hunter是一个通过电子邮件寻找、验证和丰富专业联系人的平台。 该平台提供电子邮件查找器、电子邮件验证器和个性化电子邮件活动等工具。

以下步骤将向您展示如何使用连接器发现功能连接Hunter账户并配置Hunter 请求节点。

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

      • 配置外部目录库
      • 配置集成服务器保险库
   3. 在 "保险库钥匙字段中，输入用于访问存储在保管库中的凭据的保管库密钥。 保险库密钥的长度必须至少为 8 个字符。
   4. 可选项："默认情况下，指定的保险库位置和保险库密钥会作为首选项保存在工具包中，这样在启动 Connector Discovery 时就会预设这些值。 如果您不希望保存这些首选项，请取消选中保存在保险库文件首选项中。
5. 单击 "启动发现"，为Hunter连接器启动连接器发现向导。
   显示 "发现连接器"窗口。 如果有现有的猎人连接（账户），则会显示这些连接的列表。 如果没有现有连接，亨特连接器的状态将显示为 "Not connected。
   • 如果有一个或多个猎人连接（账户），请完成以下步骤：
     1. 点击要使用的连接（账户）。
     2. 单击所需的对象类型，然后选择要对该对象执行的操作。 例如，要从Hunter 检索线索，请单击 "线索"，然后检索所有线索。
   • 如果没有现有连接（帐户），请完成以下步骤：
     1. 单击所需的对象类型，然后选择要对该对象执行的操作。 例如，要从Hunter 检索线索，请单击 "线索"，然后检索所有线索。
     2. 单击连接。
        系统将显示一个窗口，您可在其中输入猎人账户的连接详情。 在连接器向导中输入以下信息：

        • 服务器 URL ：指定用于运行时调用的API服务器的 URL。
        • API 密钥：在调用 API 时用于验证账户的 API 密钥。
        • 允许自签名证书：从下拉菜单中选择 "真 "或"假"。
        • 覆盖服务器 URL ：如果您想使用专用网络客户端连接专用网络中的终端，或者想覆盖服务器 URL ，则需要填写。 以 "<http or https>://<host_name>:<port>格式指定连接器主机和端口的覆盖值。 如果不使用专用网络客户端或不需要覆盖，请将此字段留空。
     3. 单击连接。

     有关识别这些连接详细信息的更多信息，请参阅《 IBM App Connect in containers 》中“如何在 Hunter 中使用 IBM App Connect ”一节的持续交付 (CD) 文档。

6. 在向导中设置必需的连接器属性。

   对于创建操作，可以选择使用高级模式。 在操作的默认编辑视图中，有些应用程序的字段是隐藏的，因为一般用例不需要它们。 对于更高级的使用情况，您可以切换到高级模式编辑，它为编辑流程提供了额外的功能。 要使用高级模式，请单击关闭按钮 (X) 退出连接器发现向导，然后完成使用高级模式中的说明。

   如果为检索或更新操作添加了条件，则可以选择使用条件筛选来细化应用的条件。 要使用条件筛选，请单击关闭按钮 (X) 退出连接器发现向导，然后完成使用条件筛选中的说明。

   您还可以设置属性，指定要检索的记录的最大数量，以及超过该限制时要采取的操作。
7. 完成连接器发现向导中的属性指定后，单击保存。
   用于连接Hunter的凭证保存在保险库中，其他连接细节保存在Hunter 策略中。 您在向导中设置的属性值将返回至 IBM App Connect Enterprise 工具包中的 Hunter Request 节点。
8. 完成发现并保存属性值后，单击窗口右上角的 X 或按Alt+F4 退出连接器发现向导。
9. 返回 IBM App Connect Enterprise 工具包中的 “猎人请求 ”节点进行编辑。
   在连接器发现向导（第6 步）中设置的连接器属性现在可以在属性编辑器的猎人请求节点上看到。 基本选项卡显示在向导中设置的动作和对象属性值。 例如，如果在向导中选择了线索 > 检索所有线索，节点的基本选项卡上就会显示以下属性：

   • 操作 - RETRIEVEALL
   • 对象 - getV2Leads_model

   操作和对象属性的值将以只读格式显示。 如果要更改这些值，您可以通过再次单击启动连接器发现并在“连接器发现”向导中设置新值来执行此操作。

   模式基名属性指定描述从Hunter连接器发送和接收的请求和响应信息格式的模式文件的基名。 模式基础名称会在首次为节点运行发现时自动设置，它基于当前流程名称和节点名称。 如果在首次运行发现之前手动设置此属性，则会使用您设置的值。 如果在发现模式后重新命名模式，则必须编辑此属性，使其与项目中重新命名的模式所使用的模式基础名称相匹配。 如果在发现后更改此属性，则必须重新命名模式名称以匹配，或重新运行发现。

   根据发现过程中选择的操作，连接器发现向导会生成一个请求模式和一个响应模式，或者只生成一个响应模式。 只有当所选操作和对象需要请求信息时，才会生成请求模式。 生成的请求模式用于验证请求信息。 如果操作是 "RETRIEVE或 "DELETE，连接器只返回响应模式。

   生成的模式文件会添加到项目中，可由制图节点用于转换输入或输出数据。 模式的完整文件名来自模式的基本名称（如 "gen/hunter.Hunter_Request），后缀为 "response.schema.json或 "request.schema.json。 单击 "打开请求模式 "或"打开响应模式"即可打开模式。

10. 检查猎人请求节点上的属性设置是否正确，然后保存报文流程。
11. 在 "猎人请求节点的 "连接选项卡上，"政策属性显示了包含连接所用安全标识详细信息的策略名称。 政策类型为 "Hunter.
    更多信息，请参见猎人政策。
12. 可选：设置连接选项卡上的超时属性，指定节点等待Hunter处理操作的时间（秒）。
13. 猎人请求节点的 "过滤器"选项卡包含控制报文流如何选择数据的属性。 这些属性的初始值取自 "连接器发现 "向导中为Hunter连接器设置的属性值，包括过滤选项属性和指定的任何条件（如步骤6 所述）。 然后，如果您返回 "连接器发现 "向导并更改任何属性的值（例如，通过添加新条件），这些更新将反映在节点上设置的属性中。

    筛选器选项属性控制执行猎人请求节点时要对哪些对象进行操作。 筛选限制属性控制要检索的项目的最大数量，以及超过限制时要采取的操作。

    单击 "筛选器选项"部分中要修改的值旁边的 "编辑"，以及更改 "筛选器限制"部分中已 设置的属性值，即可修改这些值。

    属性值可以是文本值，也可以是 ESQL 或 XPATH 表达式，这些表达式是在执行时从传递给猎人请求节点的信息内容中解析出来的。

14. 在 请求"选项卡上，设置数据位置属性，以指定传入信息树中包含要在Hunter 中创建的对象数据的位置。 这些数据构成了从Hunter 请求节点发送到Hunter系统的请求。
15. 在 "结果"选项卡上，设置 "输出数据位置"属性，以指定输出消息树中包含在Hunter 中创建的记录数据的位置。
16. 默认情况下，请求信息是根据连接器发现过程中生成的请求模式进行验证的。 您可以使用猎人请求节点的验证属性关闭请求验证或更改验证设置。
17. 保存信息流程。