使用连接

本页内容针对 Controlled Release (CR) 的产品或特性。如果您不是 CR 组的成员，如需了解更多信息，请联系您的 CXone 客户代表。

在 Integration Hub 中，连接定义身份验证详细信息和 API 请求。创建并配置连接后，您可以在 CXone 中使用它。

执行来自 Integration Hub 的请求

您可以从定义它所在的 Integration Hub 连接执行请求。只可从 Integration Hub 执行手动请求。

    在 CXone 中单击应用程序选择器 并选择自动化与 AI > Integration Hub。

  1. 从页面左侧的“我的连接”中，单击您要使用的连接。

  2. 在“请求”选项卡上，单击要执行的请求旁边的测试。将弹出一个页面，其显示来自已连接 Web 服务的响应。

  3. 如果您想保留该页面中的响应内容，请选择并复制这些内容。

  4. 查看完该响应后，单击取消。

在脚本中使用身份验证

连接可存储身份验证详细信息。您可以在脚本中任何需要它们的地方使用它们。它们可单独使用，也可与请求一起使用。

  1. 打开 Studio 和 ，登录 。

  2. 打开您想要将请求添加到的脚本。

  3. 将 ConnectAuth 操作添加到脚本。

  4. 在 ConnectAuth 的 connectName 属性中，输入您要使用的连接的名称。如果您不知道连接名称：

    1. 双击 ConnectAuth，打开 Integration Hub。
    2. 在“我的连接”下，单击您要使用的连接旁边的复选标记 复选标记的图标。。
    3. 单击是，将其分配给此操作。

    您可以使用变量替换，而不是在 connectName 属性中使用特定连接的名称。创建一个变量来保存连接名称，然后使用脚本逻辑将该名称传递给 ConnectAuth。

在脚本中使用手动请求

您可以在脚本中任何需要进行 API 调用的地方使用手动请求。必须在 Integration Hub 连接中定义该请求。

该脚本可能需要更多编辑来处理从该请求连接到的资源返回的响应。此外，ConnectRequest 操作可能需要额外配置。

  1. 打开 Studio 和 ，登录 。

  2. 打开您想要在其中使用请求的脚本。

  3. 将 ConnectRequest 操作添加到脚本。

  4. 在 connectName 和 requestName 属性中，输入您要使用的连接和请求的名称。如果您不知道这些名称：

    1. 双击 ConnectRequest，打开 Integration Hub。

    2. 在“我的连接”下，单击您要使用的连接旁边的复选标记 复选标记的图标。。

    3. 单击是，将其分配给此操作。

    4. 选择您刚刚分配到 ConnectRequest 的连接。

    5. 在“请求”选项卡上，单击您要分配到此操作的请求对应的框，然后单击确定。

    您可以使用变量替换，而不是在 connectName 和 requestName 属性中使用特定连接和请求的名称。创建变量来保存这些名称，然后使用脚本逻辑将这些名称传递给 ConnectRequest。

  5. 要在脚本中使用来自关联的连接的变量，请将该变量的名称括在双括号 ([[ ]]) 中。

在脚本中使用 Studio 请求

首先将 Studio 请求添加到 Integration Hub 连接，然后通过 ConnectRequest 操作将其添加到脚本。来自 Studio 的输入可能会更改请求的详细信息，因此这些详细信息通常是在 SNIPPET 操作中构建的，以便能够将它们传递到 ConnectRequest 操作。

该脚本可能需要更多编辑来处理从该请求连接到的资源返回的响应。此外，ConnectRequest 操作或 Snippet 操作可能需要额外配置。

  1. 在 Integration Hub 中创建 Studio 请求，然后在脚本中构建请求对象（如果尚未这样做）。

  2. 在 Studio 中，打开包含您要使用的请求的脚本。
  3. 将 ConnectRequest 操作添加到保存该请求对象的 Snippet 操作之后的脚本中，然后连接它们。

  4. 在 ConnectRequest 的 connectName 属性中，输入您要使用的连接的名称。如果您不知道该名称：

    1. 双击 ConnectRequest，打开 Integration Hub。

    2. 在“我的连接”下，单击您要使用的连接旁边的复选标记 复选标记的图标。。

    3. 单击是，将其分配给此操作。

    4. 选择您刚刚分配到 ConnectRequest 的连接。

    5. 在“请求”选项卡上，单击您要分配到此操作的请求对应的框，然后单击确定。

    您可以使用变量替换，而不是在 connectName 属性中使用特定连接和请求的名称。创建变量来保存该名称，然后使用脚本逻辑将该名称传递给 ConnectRequest。

  5. 选择 ConnectRequest 操作，然后使用保存 JSON 请求的变量的名称配置 RequestPayload 字段。您在 Snippet 中定义了该变量

  6. 要在脚本中使用来自关联的连接的变量，请将该变量的名称括在双括号 ([[ ]]) 中。

  7. 如果您的连接需要授权，请在脚本中添加并配置 ConnectAuth 操作。