本主题包含以下部分:
TimeoutControl 节点接收包含超时请求的输入消息。请参阅超时请求消息,获取超时请求消息的描述。该节点验证请求、存储消息,并将消息(不加更改)传播到消息流中的下一个节点。
TimeoutControl 节点在工作台中由以下图标表示:
对于要求事件在特定时间或固定时间间隔发生的应用情况,在消息流中同时使用 TimeoutControl 节点和 TimeoutNotification 节点。
多个 TimeoutControl 节点可与一个 TimeoutNotification 节点配对。这些 TimeoutControl 节点处理的所有超时请求均由同一个 TimeoutNotification 节点处理。如果 TimeoutNotification 节点和每个 TimeoutControl 节点使用同一唯一标识,则会发生这种情况。
有关如何使用超时处理节点的更多详细信息,请查看超时处理样本。
将 TimeoutControl 节点的实例放入消息流中后,可以对它进行配置。
右键单击编辑器视图中的节点,然后单击属性。将显示节点的基本属性。
唯一标识是唯一的必要属性。它没有缺省值。
通过执行以下操作,配置节点的基本属性:
现在配置该节点的“消息”属性:
对于 XML、XMLNS、XMLNSC、JMS、MIME 和 BLOB 解析器,将消息集保留为空白。
对于 XML、XMLNS、XMLNSC、JMS、IDOC、MIME 和 BLOB 解析器,将消息类型保留为空白。
对于 XML、XMLNS、XMLNSC、JMS、MIME 和 BLOB 解析器,将消息格式保留为空白。
完成配置时,单击应用。这在不关闭属性对话框的情况下就可以对 TimeoutControl 节点进行更改。单击确定以应用更改,并关闭属性对话框。单击取消以关闭对话框,并废弃对属性所作的所有更改。
下表中描述了 TimeoutControl 节点终端。
终端 | 描述 |
---|---|
In | 接受消息树用于进行处理(包括验证在消息树的请求位置中指定的超时请求)并将它添加到控制队列的输入终端。 |
Failure | 如果在此节点中进行处理期间检测到故障,则将输入消息传播到的输出终端。如果此终端未连接到其他节点,则错误信息将传递回消息流中的前一个节点。 |
Out | 在成功处理超时请求后,向其传播未经更改的入局消息的输出终端。如果此终端未连接到其他节点,则不会进行传播。如果消息传播失败,则消息将传播到 Failure 终端。 |
下表描述该节点的属性;标题为 M 的列表示属性是否是必需的(如果在未定义缺省值时必须输入值,则在属性对话框上以星号作标记),标题为 C 的列表示属性是否是可配置的(将消息流添加到 BAR 文件以部署此文件时可以更改该值)。
下表中描述了 TimeoutControl 节点的基本属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
唯一标识 | 是 | 是 | 无 | 这是该节点的唯一必要属性。它的值在代理中必须是唯一的。与此节点成对的 TimeoutNotification 节点的等价属性必须具有相同的值。此标识的最大长度为 12 个字符。 |
请求位置 | 否 | 否 | 无 | 此属性描述在何处查找超时请求信息。这必须是消息树中的有效位置。运行时将验证此值。如果没有指定任何请求位置,将假定为 LocalEnvironment.TimeoutRequest。请参阅超时请求消息,获取超时请求消息的描述。 |
请求持久性 | 否 | 否 | 自动 | 此属性确定当代理或消息流重新启动后,入局超时请求是否继续存在。此属性的值可以是自动、是或否。如果该值为自动,则使用入局消息“属性”文件夹中的“持久性”设置。 |
下表中描述了 TimeoutControl 节点的消息属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
存储的消息位置 | 否 | 否 | 无 | 要存储用于传播的部分请求消息的位置,与此节点成对的 TimeoutNotification 节点将传播该部分请求消息。 |
消息域 | 否 | 否 | 无 | TimeoutNotification 节点将用来解析存储的超时请求消息的域。 |
消息集 | 否 | 否 | 无 | 消息集的名称或标识,其中定义了存储的超时请求消息。 |
消息类型 | 否 | 否 | 无 | 存储的超时请求消息的名称。 |
消息格式 | 否 | 否 | 无 | 存储的超时请求消息的物理格式的名称。 |
下表中描述了 TimeoutControl 节点的描述属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
简短描述 | 否 | 否 | 节点的简要描述。 | |
详细描述 | 否 | 否 | 描述消息流中节点用途的文本。 |