“HTTP 发布请求”活动

HTTP 发布请求活动可以向指定位置(即 HTTP 端点)发送 HTTP 请求并接收从该位置返回的 HTTP 响应。

下图显示了 HTTP 发布请求活动,该活动可以向指定位置(即 HTTP 端点)发送 HTTP 请求并接收返回的 HTTP 响应:

图 1.

向编排添加“HTTP 发布请求”活动

  1. 创建或打开编排。这样会以图形形式显示编排。
  2. 选择活动选项卡,并展开 HTTP 文件夹。
  3. 发布请求活动拖到编排中。
  4. 选择该活动。这样会显示核对表

创建、选择或编辑 HTTP 端点

  1. 单击核对表中的选取端点任务,然后选择下列操作之一:
    • 选择现有端点:
      1. 选择浏览。这样会显示 Project Explorer。
      2. 选择现有端点并单击确定。跳至“配置活动”过程。
    • 选择现有端点并编辑该端点:
      1. 选择浏览。这样会显示 Project Explorer。
      2. 选择现有端点并单击确定
      3. 单击编辑。这样会显示“编辑端点”窗格。
    • 创建新端点:选择新建。这样会显示“创建端点”窗格。
  2. 创建或编辑 HTTP 端点(请参阅创建或编辑 HTTP 端点)。

配置活动

  1. 核对表中选择配置任务。这样会显示“配置”窗格。
  2. 配置此窗格中的所有字段和复选框,如下表所述:
    表 1.
    字段或复选框 描述
    URL(主机名后的路径) 指定发布请求活动要将请求发布到的资源路径,例如:/mypath。 您在此字段中指定的字符串必须排除字符串 http:// 以及 Integration Appliance 的主机名和端口号。完整的 URL 将由 Integration Appliance 的主机名、HTTP 端点所指定的端口号以及此字段所指定的路径自动构造而成。例如,如果发布请求活动要将请求发布到的完整 URL 为 http://myAR:myPort/myPath,那么您只需在此字段中指定字符串:/myPath。对于在同一时间使用同一端口在同一 Integration Appliance 上部署的发布请求活动,所指定的路径必须是唯一的。 
    请求消息的类型 指定 HTTP 请求的期望消息类型 - 文本二进制。 
    答复消息的类型 指定 HTTP 答复的消息类型 - 文本二进制
    停止处理编排作业

    或者

    继续处理并返回 HTTP 错误代码

    指定活动在 HTTP 服务器返回错误响应时应执行的运行时行为:
    • 停止处理编排作业 - 如果编排作业应在运行时期间从 HTTP 服务器收到错误响应后停止处理,那么请选择此选项。编排将停止处理 HTTP 发布请求活动、不会处理编排中位于 HTTP 发布请求活动之后的活动并会抛出失败异常。
    • 继续处理并返回 HTTP 错误代码 - 如果编排活动应在运行时期间从 HTTP 服务器收到错误响应后继续处理,那么请选择此选项。编排作业应继续处理编排中位于 HTTP 发布请求活动之后的活动,并会通过 responsecoderesponsemessage 输出参数分别返回错误响应代码和错误响应消息。
    使用压缩/解压缩 指定是否在活动级别打开或关闭压缩/解压。缺省情况下,将清除使用压缩/解压复选框并为此活动禁用压缩/解压。 选中使用压缩/解压复选框可为此活动启用压缩/解压。有关更多信息,请参阅通过“HTTP 发布请求”活动进行压缩/解压

指定重试选项

  1. 核对表中选择重试任务。这样会显示“重试”窗格。
  2. 配置用于连接 HTTP 服务器的重试选项。下表定义了用于连接 HTTP 服务器的重试选项:
    表 2.
    字段 描述
    重试  
    1) 前后两次重试之间的等待时间(以秒为单位)。 Integration Appliance 在尝试与 HTTP 服务器建立连接之前要等待的秒数。
    2) 失败之前的连接尝试次数。 指定重试计数,即 Integration Appliance 在发出错误并停止处理当前编排作业之前尝试与 HTTP 服务器建立连接的最大次数。

    如果部署了包含“HTTP 发布请求”活动的编排,而且 Integration Appliance 无法连接指定的 HTTP 服务器,那么 Integration Appliance 会将连接错误以警告的形式记录在系统和编排日志中,直至达到重试计数值为止。在达到重试计数之后,Integration Appliance 会在系统和编排日志中记录错误,并停止处理当前编排作业。

    例如,将重试计数设置为 3。第一、第二和第三个连接错误将以警告的形式出现在系统日志中。Integration Appliance 将以错误形式记录第四个连接错误,并停止处理当前编排作业。

    活动超时  
    3) 超时时间(以秒为单位,从端点不响应请求时开始算起)。 指定在活动发出端点请求和端点进行响应之间发生超时情况前的时间量(以秒为单位)。对于 HTTP 发布请求活动,活动超时是指 Integration Appliance 在发送 HTTP 请求之后、发出超时错误之前用于等待 HTTP 服务器响应所花费的时间量。活动超时不同于连接超时,因为活动超时是在与端点建立连接之后发生的。 连接超时指定在 Integration Appliance 尝试与端点建立连接和端点响应连接请求之间发生超时情况前的时间量(以秒为单位)。您可以在“HTTP 端点”选项卡中进行连接超时设置。有关连接超时的更多信息,请参阅创建或编辑 HTTP 端点

将输入映射到活动

  1. 核对表中选择映射输入任务。body 输入参数会显示在映射输入任务的“目标活动”窗格中。 必须至少将一个变量映射到 body 输入参数 - 该参数是强制参数。body 输入参数包含发送到 HTTP 服务器的 HTTP 请求消息的主体。
  2. 要在“映射输入”窗格的“目标活动”窗格中查看可选输入参数,请从工具栏菜单中选择映射 > 显示可选参数,或在“目标活动”窗格中右键单击并选择显示可选参数选项。如果无法在工具栏菜单中选择映射 > 显示可选参数选项,那么请单击“映射输入”窗格中的节点以激活此选项。这样会显示 httpheadershttpConnParameter 输入参数。
    下表定义了可选 httpheaders 输入参数的节点:
    表 3.
    httpheaders 输入参数的节点 描述
    httpheaders/uri 指定资源路径,例如:/myPath
    httpheaders/method 指定 HTTP 请求的类型。
    httpheaders/otherHeaders/headerItem 指定包含了一组 HTTP 头参数作为名称/值对的元素。可以在 HTTP 请求中指定多个 HTTP 头参数,因此,它是一个重现节点。
    ttpheaders/otherHeaders/headerItem/name 指定 HTTP 头参数名称。
    httpheaders/otherHeaders/headerItem/value 指定 HTTP 头参数值。
    注: 如果使用 httpheaders/otherHeaders/headerItem/namehttpheaders/otherHeaders/headerItem/value 显式设置了“内容长度”头,那么在运行时期间会忽略该值。此活动会自动将“内容长度”头设置为主体的大小。
    下表定义了可选 httpConnParameter 输入参数的节点。您可以选择将变量值传递到下表所指定的节点中,以覆盖您在运行时期间在核对表选取端点任务中动态指定的设置。例如,在运行时期间,您可以通过将变量映射到 httpConnParameter 输入参数的 host 节点来覆盖端点所指定的主机名。在运行时期间,该变量的值是用于连接 HTTP 服务器的主机名。
    表 4.
    httpConnParameter 输入参数的节点 描述 覆盖 HTTP 端点中的哪些设置?
    timeout    
    host 指定远程 HTTP 服务器的主机名或 IP 地址。  httpConnParameter 输入参数的 host 节点会覆盖 HTTP 端点的主机名字段。
    port 指定远程 HTTP 服务器的端口号。  httpConnParameter 输入参数的 port 节点会覆盖 HTTP 端点的端口字段。
    isSecure 将此布尔值设置为 true 可启用 HTTPS(即,安全的基于 SSL 的 HTTP)。将此布尔值设置为 false 可禁用安全性。 httpConnParameter 输入参数的 isSecure 节点会覆盖 HTTP 端点中的安全性选项。
    username 指定用于连接 HTTP 服务器的帐户的用户名。 httpConnParameter 输入参数的 username 节点会覆盖 HTTP 端点中的用户名字段。
    password 指定用于连接 HTTP 服务器的帐户的密码。 httpConnParameter 输入参数的 password 节点会覆盖 HTTP 端点中的密码字段。
  3. 在编排变量和输入参数之间创建映射。请参阅创建映射,以获取有关映射的常规指示信息。

映射活动的输出

  1. 核对表中选择映射输出任务。活动的输出参数会显示在映射输出任务的“源活动”窗格中,如下表所述:
    表 5.
    输出参数 描述
    httpheaders 指定 HTTP 响应的头。
    body 指定 HTTP 响应消息的主体。
    responsecode 指定在运行时期间从 HTTP 服务器返回的 HTTP 响应代码。 
    responsemessage 指定与 HTTP 响应代码关联的消息。
    下表定义了 httpheaders 输出参数的节点:
    表 6.
    httpheaders 输出参数的节点 描述
    httpheaders/uri 指定资源路径,例如:/myPath
    httpheaders/method 指定 HTTP 响应的类型。
    httpheaders/otherHeaders/headerItem 指定包含 HTTP 响应的 HTTP 参数的名称/值对集。可以在 HTTP 响应中指定多个 HTTP 参数,以使 headerItem 成为重现节点。
    httpheaders/otherHeaders/headerItem/name 指定 HTTP 参数的名称。
    httpheaders/otherHeaders/headerItem/value 指定 HTTP 参数的值。
  2. 在活动的输出参数和编排变量之间创建映射。请参阅创建映射,以获取有关映射的常规指示信息。

将证书用于 Microsoft Internet Explorer

如果在 HTTP 端点中选择了 HTTPS 安全选项,那么请注意:Microsoft® Internet Explorer 无法识别已修改的证书并高速缓存 SSL 状态。如果要修改证书,那么必须清除 SSL 状态。要在 Microsoft Internet Explorer 中清除 SSL 状态:
  1. 从 Microsoft Internet Explorer 工具栏菜单中,选择工具 > Internet 选项...。这样会显示“Internet 选项”窗格。
  2. 单击内容选项卡。
  3. 证书部分中,单击清除 SSL 状态。这样会显示“SSL 缓存成功清除”对话框。
  4. 单击确定,然后再单击确定