“HTTP 删除请求”活动

HTTP 删除请求活动向指定位置(HTTP 端点)发送删除请求并从该位置接收 HTTP 响应。

向编排添加“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 上部署的删除请求活动,所指定的路径必须唯一。

    要使用路径参数和查询参数,请按下列格式输入 URL:“url/{path}?name1=value1&name2=value2”。 这使您能够将字符串值映射到“{path}”参数并指定查询参数名:该示例中的 name1name2。如果您选择声明多个“{path}”参数,那么每个参数都应具有唯一名称。具有相同名称的参数在映射中只会表示为一个节点。 路径参数显示在“映射输入”中的 /httpheaders/pathParameters 下。查询参数显示在“映射输入”中的 /httpheaders/queryParameters 下。

    注: 在 URL 中,分配给查询参数的任何值都不会传递到映射器。要为查询参数分配值,可在映射器中将值显式映射到该查询参数,也可以定义缺省值。
    请求消息的类型 指定 HTTP 响应的消息类型 - 文本二进制
    答复消息的类型 指定 HTTP 答复的消息类型 - 文本二进制
    停止处理编排作业

    或者

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

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

指定请求头

  1. 从“核对表”中选择请求头任务。这样会显示请求头窗格。顶部显示定制头表,中间部分显示包含预定义的标准头复选框,底部显示标准头表。
  2. 单击添加按钮以向定制头表添加头。 单击新条目以输入头名称或从下拉列表中选择头名称。如果头名称是预定义的头名称,那么将在描述列中显示描述,否则,请为这些头输入描述。
  3. 要使用预定义的标准头,请选中包含预定义的标准头复选框。请注意,不允许重复的头名称(忽略大小写差异),将提示您除去定制头表中的任何重复头。 所选 HTTP 头显示在“映射输入”中的 /httpheaders 下。

指定响应头

  1. 从“核对表”中选择响应头任务。这样会显示响应头窗格。顶部显示“定制头”表,中间部分显示包含预定义的标准头复选框,底部显示标准头表。
  2. 单击添加按钮以向定制头表添加头。 单击新条目以输入头名称或从下拉列表中选择头名称。如果头名称是预定义的头名称,那么将在描述列中显示描述,否则,请为这些头输入描述。
  3. 要使用预定义的标准头,请选中包含预定义的标准头复选框。请注意,不允许重复的头名称(忽略大小写差异),将提示您除去定制头表中的任何重复头。 所选 HTTP 头显示在“映射输出”中的 /httpheaders 下。

指定重试选项

  1. 核对表中选择重试任务。这样会显示“重试”窗格。
  2. 配置用于连接到 HTTP 服务器的重试选项。下表定义了用于连接到 HTTP 服务器的重试选项:
    字段 描述
    重试  
    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 端点”选项卡中进行连接超时设置。有关连接超时的更多信息,请参阅创建或编辑 Web Service 端点

将输入映射到活动

  1. 核对表中选择映射输入任务。body 输入参数会显示在映射输入任务的“至活动”窗格中。 body 输入参数是可选参数。body 输入参数包含发送回 HTTP 服务器的 HTTP 响应消息的主体。
  2. 要在“映射输入”窗格的“至活动”窗格中查看可选输入参数,请从工具栏菜单中选择映射 > 显示可选参数,或者在“至活动”窗格中右键单击,并选择显示可选参数选项。如果映射 > 显示可选参数选项在工具栏菜单中不可选,请单击“映射输入”窗格中的节点以激活此选项。 这样会显示 httpheadershttpConnParameter 输入参数。
    下表定义了可选 httpheaders 输入参数的节点:
    表 2.
    httpheaders 输入参数的节点 描述
    httpheaders/uri 指定资源路径,例如:/myPath
    httpheaders/<configured_header_name> 如果在“请求头”步骤中配置了至少一个请求头,那么此处会显示所有请求头。<configured_header_name> 将替换为您选择或输入的实际头名称。
    httpheaders/pathParameters 如果在“配置”步骤中配置了 URL 中的路径参数,那么此处会显示所有路径参数。如果未指定路径参数,该节点将不显示。
    httpheaders/query Parameters 如果在“配置”步骤中配置了 URL 中的查询参数,那么此处会显示所有查询参数。如果未指定查询参数,该节点将不显示。
    httpheaders/otherHeaders/headerItem 指定包含一组 HTTP 头参数以作为 HTTP 响应的名称/值对的元素。可以在 HTTP 响应中指定多个 HTTP 参数,以使该节点成为重现节点。
    httpheaders/otherHeaders/headerItem/name 指定 HTTP 参数的名称。
    httpheaders/otherHeaders/headerItem/value 指定 HTTP 参数的值。
    注: 如果使用 httpheaders/otherHeaders/headerItem/namehttpheaders/otherHeaders/headerItem/value 显式设置了内容长度头,那么运行时期间将忽略此值。此活动会自动将内容长度头设置为主体的大小。
    下表定义了可选 httpConnParameter 输入参数的节点。您可以选择将变量值传递到下表所指定的节点中,以覆盖您在运行时期间在“核对表”的“选取端点”任务中动态指定的设置。例如,在运行时期间,您可以通过将变量映射到 httpConnParameter 输入参数的 host 节点来覆盖端点所指定的主机名。在运行时期间,该变量的值是用于连接 HTTP 服务器的主机名。
    表 3.
    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. 核对表中选择映射输出任务。活动的输出参数会显示在映射输出任务的“自活动”窗格中,如下表所述:
    表 4.
    输出参数 描述
    httpheaders 指定 HTTP 请求的头。
    body 指定 HTTP 请求消息的主体。
    responsecode 指定在运行时期间从 HTTP 服务器返回的 HTTP 响应代码。
    responsemessage 指定与 HTTP 响应代码关联的消息。
    下表定义了可选 httpheaders 输出参数的节点。
    表 5.
    httpheaders 输出参数的节点 描述
    httpheaders/uri 指定传入请求的资源路径,例如:/myPath
    httpheaders/<configured_header_name> 如果在“响应头”步骤中配置了至少一个响应头,那么此处会显示所有响应头。<configured_header_name> 将替换为您选择或输入的实际头名称。
    httpheaders/otherHeaders/headerItem 指定包含了一组 HTTP 头参数作为名称/值对的元素。可以在 HTTP 请求中指定多个 HTTP 头参数,因此,它是一个重现节点。
    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. 单击确定,然后再单击确定