XML 侦听器命令

事务服务器将定义 XML 命令和响应格式，外部企业应用可使用该命令和响应格式来发送和接收消息。这些命令可与侦听器功能结合使用。
企业应用可使用这些命令来发送将转发至侦听器触发器的参数，也可接收在侦听器触发器完成后发送回企业的参数。
每个命令必须以下方过程指令作为开头：

XML 侦听器请求的有效负载

侦听器请求的有效负载将采用预定义的 XML 格式。请求必须指定侦听器映射标识符，以便侦听器查找相应的侦听器映射定义。此定义会将请求的有效负载中指定的项目映射到内部请求，该内部请求将触发侦听器触发器。

有关更多信息，请参见下面的侦听器请求。

以下内容适用于熟悉消息队列软件并希望交付可通过这些侦听器命令与节点进行交互的企业应用的程序员。

侦听器请求

<?xml version="1.0" encoding="iso-8859-1" ?>
<ListenerRequest seq="100" >
<ListenerMap id="GetBinInformation" version="1" />
<Item name="PlantBinLocationId">
<Data>1254</Data>
</Item>
<Item name="PlantBinLevel" >
<Data>10 </Data>
</Item>
<Item name="PlantPriorBinLevel" >
<Data> 5</Data>
</Item></ListenerRequest>

本例中的 <ListenerRequest> 标签具有以下静态属性和嵌套标签：

• seq= 一种静态属性，指定将在此请求的回复中返回的唯一字符串。企业应用可使用该字符串区分回复与回复队列中的多个回复。
• <ListenerMap> 一个嵌套标签，其 id XML attributeid= 静态属性指定侦听器映射定义的名称，该名称将用于映射此请求。

例如：
<ListenerMap id="LEVT1" />

• <Item> 一个嵌套标签，其 name= 静态属性指定项目元素的名称。此名称应与 Listener Map Definition（侦听器映射定义）窗口的 FromEnterprise（从企业）部分中条目的 PropertyName（项目名称）列匹配，以便将 <Data> 元素中的数据发送到侦听器触发器。
• <Data> 一个嵌套标签，其值确定发送到侦听器触发器的内容。

侦听器回复

<?xml version="1.0" encoding="ISO-8859-1"?><ListenerReply seq="100" ><ListenerMap id="GetBinInformation" /><Format encoded="no" delimiter="," /> <Item name="PlantBinLevel"> <Data>100</Data> </Item> <Item name="PlantBinLocation"> <Data>25</Data> </Item></ListenerReply>

本例中的 <ListenerReply> 标签具有以下静态属性和嵌套标签：

• seq= 一种静态属性，指定侦听器请求中指定的唯一字符串。该值在回复中返回，企业应用可使用该值区分回复与回复队列中的多个回复。
• <ListenerMap> 一个嵌套标签，其 id= 静态属性指定侦听器映射定义的名称，该名称将用于映射此响应。

例如： 

<ListenerMap id="GetBinInformation"

• <Item> 一个嵌套标签，其 name= 静态属性指定项目元素的名称。此名称可在 Listener Map Definition（侦听器映射定义）窗口的 Output（输出）选项卡的 To Enterprise（至企业）部分中条目的 PropertyName 列中指定。

• <Data> 一个嵌套标签，其值将从侦听器触发器返回到企业。