在 IBM App Connect Enterprise 中使用 ClickSend

ClickSend是一款基于云计算的商务通信软件，允许公司在全球范围内收发短信、电子邮件、语音、传真和邮件。

以下步骤将向您展示如何使用连接器发现功能连接到ClickSend账户并配置ClickSend请求节点。 您可以按照类似的步骤，通过创建包含 "ClickSend输入节点的流程并通过连接器发现进行配置，来配置 "ClickSend输入节点以监控 "ClickSend的输入。

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

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

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

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

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

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

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

   • 操作 - RETRIEVEALL
   • 对象 - getSmsCampaigns_model

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

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

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

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

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

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

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

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

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