添加映射消息作为有效负载
除 ASCII 分隔符消息、XML 和自由格式文本有效负载以外,基于 JMS 的传输还支持映射消息格式。
映射消息由名称 - 数值对组成,这些名称 - 数值对具有与之相关联的类型。如果您的企业应用程序使用映射消息,则需要将映射消息格式添加至传输映射中。与 XML 格式(始终为字符串)不同,将映射指定为该格式将允许您指定变量的数据类型,例如整数、字符串、浮点型等。
请按照以下步骤操作:
- 在 Transport Map(传输映射)窗口上,单击 Transport(传输)向下箭头,然后选择适当的传输。映射消息格式仅适用于基于 JMS 的传输。
- 使用 Input(输入)选项卡创建映射变量。已完成的 Input(输入)选项卡可能如下所示:
下一步是创建有效负载。将属性名称与输入变量或宏关联。数组:不得将数组与映射消息一起使用。输入映射变量的计数必须为 1。当格式为 Map(映射)时,事务服务器将不允许输入映射变量的计数大于 1 的传输映射定义。
- 转到 To Enterprise(至企业)部分,单击 Format(格式)向下箭头,然后选择 Map(映射)。
- 单击 Add(添加)。
表中的第一行变为可用。
这些列中的值将显示在映射消息中:
Field(字段)— 此列提供 Input(输入)选项卡中的映射变量的列表。当指定传输映射由触发器使用时,映射变量将与 PLC 设备变量或常量值相关联。
Details(详细信息)- 想要与 Field(字段)列中显示的映射变量相关联的支持的主机启动的数据类型的列表。
PropertyName(属性名称)- 指定作为显示在映射消息中的标识符的名称。Map(映射)格式需要 Property Name(属性名称),以名称 - 数值对中的 JMS 映射消息格式将信息发送至 JMS 服务器。 - 单击 Field(字段)列下的行。
显示一个列表。 - 选择您在第 2 步中创建的映射变量(Input(输入)选项卡)。此例中为 VIN。
- 对于 Details(详细信息)列,接受字符串的默认值。
- 双击 Property Name(属性名称)下的行,然后键入想要与 VIN 相关联的名称。此例中为 VehicleNumber。
- 单击 Add(添加)。
在第一行下方插入一行。 - 对于其余映射变量,重复步骤 6 至 8。此例中为 colorCode。将数据类型设置为整数,并将 Property Name(属性名称)设置为 ColorCode。
下一步是添加时间戳宏。 - 单击 Add(添加)。
在第二行下面插入一行。 - 在新行中,单击 Field(字段)列,然后选择 $TRANSPORT_MAP_TS。
使用 $TRANSPORT_MAP_TS 宏时,用字符串表示时间。
已完成的 To Enterprise(至企业)部分可能如下所示: - 单击 Validate(验证)。
随即显示一个窗口,其中包含映射消息输出的示例。 - 单击 Save(保存)。
传输映射的名称已添加到 Transport Maps(传输映射)窗口。