“MQ 轮询队列”活动

在运行时期间,“MQ 轮询队列”活动会根据指定的重试时间间隔对 MQ 队列进行定期消息检查。

注: 在配置该活动之前,您必须已经为 MQ 活动创建端点
配置任务包含三个部分:

完成配置任务后,针对活动进行映射输出

注: 最大消息大小为 100 MB。

队列和消息详细信息

使用下表中的字段指定队列和消息详细信息。 必填字段以星号标记。
字段 描述
队列名称 * 指定用于轮询消息的队列的名称。
有效内容数据类型 指定消息有效内容的数据类型:二进制字符串
MQRFH2 头的模式片段 指定 MQRFH2 头是否包含在消息中。 如果消息是 XML 消息并且包含 MQRFH2 头,那么请选中此复选框并单击 [...]。在浏览至模式类型元素对话框中,找到用于定义头的 XML 模式,在该 XML 模式中选择 NameValueData 元素,然后单击确定。模式片段为 NameValueData 元素及其所有子元素。
注: 必须首先创建用于定义头的 XML 模式,并将其装入到项目中,然后才能选择该 XML 模式。有关更多信息,请参阅为 MQRFH2 头定义和装入 XML 模式

交付规则

字段 描述
轮询更改 指定 Integration Appliance 应轮询队列中的更改的频率。有关更多信息,请参阅轮询时间间隔行为
其中消息具有唯一标识 指定队列中的消息是否具有唯一标识。
交付消息 此处可用的选项取决于是否选中了唯一标识复选框。如果已选中,那么所有这三个选项均可用。如果未选中,那么只会显示至少一次
  • 至少一次 - 指定至少交付消息一次,但是可能会多次交付。连接或 Integration Appliance 故障可能会导致多次检索和处理消息。此交付选项通常在接收系统可以检测到或允许重复消息时使用。
  • 至多一次 - 指定仅交付消息一次或根本不交付消息。连接或 Integration Appliance 故障可能会导致丢失消息。此交付选项通常在接收系统不允许重复消息但是允许丢失消息时使用。
  • 仅一次 - 指定交付消息一次且仅一次。连接或 Integration Appliance 故障不会影响通过此选项进行的交付。Integration Appliance 使用 MQ 消息标识来确保消息仅检索和处理一次。
    注: 如果选择“仅一次”选项,那么必须启用持久性。有关更多信息,请参阅启用持久性

重试选项

配置“MQ 轮询队列”活动的重试选项,如下表中所定义:

重试选项 描述
1) 在前后两次重试之间等待 __ 秒。 Integration Appliance 在再次尝试从 MQ 服务器中检索消息之前要等待的秒数。
2) 尝试连接 __ 次后失败。 指定 Integration Appliance 在失败之前尝试从 MQ 服务器中检索消息的最大次数。

如果部署了以 MQ 轮询队列活动开始的编排,而且 Integration Appliance 无法连接指定的 MQ 服务器或无法从队列中检索消息,那么 Integration Appliance 会将错误以警告的形式记录在系统日志中,直至达到重试计数值。在达到重试计数后,Integration Appliance 会在系统日志中记录错误,将当前重试计数重置为零,并继续尝试与 MQ 服务器建立连接。

例如,将重试计数设置为 3。第一个、第二个和第三个连接错误在系统日志中显示为“警告”。Integration Appliance 将以错误形式记录第四个错误,并将当前重试计数重置为零。因此,第五个连接错误会在系统日志中生成警告。Integration Appliance 将继续尝试从队列中检索消息。

映射输出

您不需要为此活动映射输出参数。但是,如果您映射了其中的任意参数,那么请注意以下几点:
参数:
  • payloadmqmdheader 参数是从接收自队列的消息中获取的。
  • 如果在配置任务中指定了 RFH2 头的模式,那么将获取 rfh2header