XML 有线格式消息集属性

下面的表定义了消息集的 XML 有线格式的属性。

名称空间设置

属性 类型 含义
名称空间 URI String 输入将标识您将哪个名称空间用于关联的前缀的名称空间名称。
前缀 String 输入您要与名称空间名称一起使用的与元素和属性名称相关联的前缀。

名称空间模式位置

属性 类型 含义
名称空间 URI String 输入将用于标识您使用的名称空间的名称空间名称。
模式位置 String 输入将用于验证名称空间中的对象的关联的名称空间名称的模型的位置。

XML 声明

属性 类型 含义
抑制 XML 说明 复选框 选择此复选框以抑制 XML 声明。如果已选中,则禁止声明(例如,<?xml version='1.0'>)。
XML 版本 枚举类型 这控制生成的 XML 声明中版本的值。

缺省值 1.0

如果您设置抑制 XML 说明 Yes,则忽略此属性。

XML 编码 枚举类型 这控制是否在生成的 XML 声明中写代码属性。

如果选择了,则在输出的 XML文档的 XMl 声明中不写代码属性。

如果选中了作为文档主体,将生成与 XML 文档的主体一致的代码属性。

缺省值是

如果您设置抑制 XML 说明 Yes,则忽略此属性。

独立文档 枚举类型 从下拉列表中选择。如果选择了,则在 XMl 声明不出现独立的声明。If 如果您选择,当写输出消息时,声明 standalone = "yes"standalone = "no" 将添加到 XML 声明。

此属性的设置不确定是否装入外部 DTD 子集:外部 DTD 子集从不在该发行版中装入。

如果您设置抑制 XML 说明 Yes,则忽略此属性。

输出名称空间声明 枚举类型 输出名称空间声明属性控制名称空间声明将放置在输出 XML 文档中的哪里。在下列各项中选择:
  • 文档开始处。 上面的名称空间模式位置表中的所有条目的声明将作为消息的属性在输出 XML 文档中输出。此选项的缺点是在某些情况下,可能会输出不必要的声明。
  • 根据需要。仅当此名称空间中的元素或属性需要时,才输出声明。该选项的缺点是相同的名称空间声明可能需要在输出 XML 文档中输出多次。

缺省选项为在文档开始处

仅当为此消息集启用了名称空间时,此属性才是活动的。

XML 文档类型设置

属性 类型 含义
抑制 DOCTYPE 复选框 如果您选择此复选框,将抑制 DOCTYPE(DTD)声明。

缺省为选中。

DOCTYPE 系统标识 String 指定 DOCTYPE 外部 DTD 子集(如果 DOCTYPE 存在)的系统标识。它通常设置为消息集生成(或导入)的 DTD 名称。

如果已设置禁止 DOCTYPE,则将忽略该属性,且无法对其进行更改(该字段已禁用)。缺省值是后跟消息集标识的www.mrmnames.net/

DOCTYPE 公用标识 String 指定 DOCTYPE 外部 DTD 子集(如果 DOCTYPE 存在,且指定系统标识)的公用标识。

如果已设置禁止 DOCTYPE,则将忽略该属性,且无法对其进行更改(该字段已禁用)。缺省值是消息集标识。

DOCTYPE 文本 String 使用此属性添加附加的 DTD 说明。 XML 解析器不对它进行解析,所以它可能不是有效的 XML。您可以包含 ENTITY 定义或内部 DTD 说明。它是一个字符串(最多 32KB),其中的新行和制表符分别由 \n\t 替换。

对内容进行解析,该内容在输出消息中出现。如果有内联 DTD,则此属性的内容具有优先权。

如果您设置禁止 DOCTYPE,则忽略此属性并且不能更改它(此字段是被禁用的)。

有关更多信息,请参阅内联 DTD 和 DOCTYPE 文本属性

缺省值为空的(未设置)。

根标记名

属性 类型 含义
根标记名 String 指定消息集根标记的名称。您可以将此属性保留为空白,在此情况下,无包装标记用于消息(即,消息标记是文档的根)。此名称后跟一个空格以及将与根标记一起出现的属性/值对的附加文本。

缺省值为空白。

抑制时间戳记注释

属性 类型 含义
抑制时间戳记注释 复选框 如果是选择的,将抑制 XML 输出中的时间戳记注释字符串。

如果未选择,将禁止注释,且 <!--MRM Generated XML Output on: Tue Apr 23 09:34:42 2002--> 格式的注释将包含在输出消息中。

此复选框缺省是选中的。

启用版本控制支持

属性 类型 含义
启用版本控制支持 复选框 如果这是选择的,则将启用版本控制支持。此属性指定是否为消息中的根标记编码 XML 名空间定义以及为不属于缺省名称空间的任何元素编码名称空间限定符。这些名称空间定义用于表示消息集相关信息,这些信息用于支持基于相同消息集的不同定制的应用程序间的消息交换。

此复选框缺省是选中的,以与较早发行版的 MRM XML 消息兼容。如果您没有使用较早发行版的 MRM XML 消息,您应确保此复选框是未选择的。

XML 布尔值表示

属性 类型 含义
布尔真值 String 指定用于编码和识别布尔 true 值的字符串。当解析 XML 文档时,字符串 1 对于 BOOLEAN 元素始终接受为 true。输入一个最多为 254 个字符的字符串。

缺省是 true1 也有效。

布尔 False 值 String 指定用于编码和识别布尔 false 值的字符串。当解析 XML 文档时,字符串 0 对于 BOOLEAN 元素始终接受为 false。输入一个最多为 254 个字符的字符串。

缺省是 false0 也有效。

XML 空值表示

属性 类型 含义
编码数值空 枚举类型 指定数值 XML 元素的空编码。这提供了将逻辑空含义指定给该类元素的方法。您必须从下拉列表中选择下列值其中之一:
  • NULLEmpty。如果元素值为空字符串,那么元素为空。这是缺省值。
  • NULLValue。如果元素值与关联属性代码数值空值所提供的值匹配,那么元素为空。
  • NULLXMLSchema。如果元素包含结果为真的 xsi:nil 属性,那么元素为空。
  • NULLValueAttribute。此选项仅对 XML 有线格式属性呈现设置为 XMLElementAttrValXMLElementAttrIDVal的元素有效。请参阅XML 空处理选项 以获取详细信息。
  • NULLAttribute(不推荐)。 如果元素包含名称与关联属性编码数值空值所提供的名称匹配的属性,而且属性值为真,那么元素为空。
  • NULLElement(不推荐)。 如果元素包含名称与关联属性代码数值空值所提供的名称匹配的子元素,那么元素为空。
请参阅 XML 空处理选项以获取详细信息。
编码数值空值 String 如果已将该值设置为 NULLAttributeNULLValueNULLElement,则指定该值以限定编码数值空属性的值。 请参阅XML 空处理选项以获取更多信息。
编码非数值空 枚举类型 指定非数值 XML 元素的空编码。这提供了将逻辑空含义指定给该类元素的方法。这些选项等同于那些可用于属性为编码数值空的选项。
编码非数值空值 String 指定该值以限定编码非数值空属性。 请参阅XML 空处理选项以获取更多信息。

日期时间设置

属性 类型 含义
来自逻辑类型的缺省日期时间格式 Button 如果要让元素或属性的逻辑类型来确定缺省日期时间格式,请选择此选项。缺省为:
dateTime
yyyy-MM-dd'T'HH:mm:ssZZZ
date
yyyy-MM-dd
time
HH:mm:ssZZZ
gYear
yyyy
gYearMonth
yyyy-MM
gMonth
--MM--
gMonthDay
--MM-dd
gDay
---dd

您可以覆盖复杂类型中元素或属性的该属性。

使用缺省日期时间格式 Button 和 dateTime 如果要为逻辑类型 dateTime、date、time、gYear、gYearMonth、gMonth、gMonthDay 和 gDay 的所有元素或属性指定固定的缺省日期时间格式,请选择此选项。

此属性的初始值是 yyyy-MM-dd'T'HH:mm:ssZZZ,可通过重新输入更改它。

您可以覆盖复杂类型中元素或属性的该属性。

有关日期时间格式的更多信息,请参阅日期时间格式

2 位数年的世纪的开始 整数 此属性确定如何解释两位数的年份。指定两位数字,将启动一个包含当前年份的 100 年的窗口。例如,如果您指定 89,当前年份是 2002,则所有两位数的日期都解释为范围在 1989 到 2088 之间。

初始值是 53,可通过重新输入对它进行更改。

一年的第一个星期中的日期 枚举类型 指定新年中必须归入第一周的天数。

一年的开始通常是在一周的某天。如果这一周中的天数小于在此处定义的值,就认为这一周是上一年的最后一周;因此第一周是从新年中的某天开始的。否则认为该周是新年的第一周;因而第 1 周在元旦之前几天开始。

选择使用代理语言环境,它使代理从基础平台中获得信息,或者从下拉列表中选择一个数。 初始值为 4

一周的第一天 枚举类型 指定每个新的一周开始的那天。

选择使用代理语言环境,它会使代理从基础平台中获得信息,或者从下拉列表中选择一天。 初始值为星期一

严格的日期时间检查 复选框 如果您要将日期时间限制为有效日期时间格式,请选择此选项。这将不允许把 3 月 35 日处理为 4 月 4 日,且把 10:79 处理为 11:19。如果设置了严格日期时间检查,则接收到错误的日期时间将导致出现错误。缺省情况下,限制日期时间。
严格日期时间检查
严格日期时间检查的示例:
  • 将日期时间仅限制为有效日期时间。这将不允许把 3 月 35 日处理为 4 月 4 日,且把 10:79 处理为 11:19。接收到像此示例中的无效日期时间将导致出现错误。
  • 数值 dateTime 组件的字符数必须在相应的格式化符号限制范围内。重复符号以指定所需的最小位数。允许的最大位数将是特定符号的上限。 例如,月份中日期的上限是 31,因此格式字符串 d 将允许解析值 2 或 21,但不允许解析值 32 或 210。在输出时,用零将数字填充到特定长度。年是特殊情况,请参阅 2 位数年的世纪的开始的消息集属性。对于分秒,长度必须与输入中格式符号数目隐式匹配。将输出舍入至指定的长度。
  • 将不会跳过空格。输入字符串中的空格必须对应于格式字符串中空格的相同数目和位置。
  • 如果当格式字符串中的所有符号都已匹配后,输入字符串中还有要解析的数据,将出现错误。
不严格的日期时间检查
不严格日期时间检查的示例:
  • 解析器将频带外 dateTime 值转换为相应的频带内值。 例如,日期 2005-05-32 将转换为 2005-06-01。
  • dateTimes 的输出始终遵循符号计数。例如,格式字符串 yyyy-MM-dd(其中“-”是字段分隔符)允许对 MM 和 dd 解析一个或多个字符。这将允许输入无效日期(例如 2005-1-123 和 2005-011-12)。2005-1-123 的第一个值将输出为日期 2005-05-03,2005-011-12 的第二个值将输出为日期 2005-11-12。
  • 格式化符号 Z 的时区数目将仅应用于输出日期时间格式。
  • 空格将会被跳过。
时区 枚举类型 如果您为缺省日期时间格式属性指定的值不包含时区信息,则使用为此属性设置的值。

初始值为使用代理语言环境,这使代理从基础平台获取信息。

您可以使用下拉框来更改它。

夏令时 复选框 如果时区属性中的区域实行夏令时,选择此选项。如果它不实行夏令时,则不应该选择该选项。

例如,如果在时区中选择了一个区域,而没有选择此选项,则传递的值将表示没有夏令时的时区。

缺省为不实行夏令时。

在输出上使用输入 URC 格式 复选框 该属性应用于逻辑类型 xsd:dateTime 或 xsd:time (具有日期时间格式 I、IU、T 或 TU,或包含 ZZZ 或 ZZZU )的元素和属性。

这类元素和属性可以使用值中的字符 Z 或时区 +00:00 指定世界标准时间(UTC)。在输入时,MRM 解析器会记住指定 UTC 的方式。

如果选中该属性,则元素或属性将复制到输出消息,然后 UTC 格式将保留到输出消息中,并将覆盖 dateTime 格式属性隐含的格式。

如果未选中该属性,或者未从输入消息复制元素和属性,则输出消息中的 UTC 格式将由 dateTime 格式属性单独控制。

缺省情况下,该属性未选中。

xsi:类型输出策略

属性 类型 含义
xsi:类型属性的输出策略 枚举类型

在写 XML 文档时,此属性允许您指定将输出元素的 xsi:type 属性的情况。

从不
即使 xsi:type 属性在消息树中出现,也不输出元素的 xsi:type 属性。
出现时
只有当 xsi:type 属性在消息树中出现时才输出 xsi:type 属性。
始终(仅简单元素)
确保所有输出的简单元素都带有 xsi:type 属性。 如果消息树中的简单元素已经具有 xsi:type 属性则将会使用,否则将使用下表的规则来生成 xsi:type 属性。
始终(所有元素)
如果可能,确保所有输出的元素都带有 xsi:type 属性。如果消息树中的元素已经具有 xsi:type 属性则将会使用,否则将使用下表的规则来生成 xsi:type 属性。
按照 SOAP 编码规则
与始终(仅简单元素)的行为相同。此外,在所有消息的跟标记中输出 SOAP 编码风格属性。

如果需要输出 xsi:type 属性,但是不出现在消息树中,它的值将按照以下方式生成:

元素类型 在类型中定义元素时生成的值 元素自定义时生成的值
简单类型

如果类型为全局或内建类型则使用。

如果类型为本地,则使用从其派生的全局或内建类型。

使用与消息树中的元素数据类型最佳匹配的内建类型。
具有简单内容的复杂类型

如果类型为全局,则使用该类型。

如果类型为本地,则使用从其派生的全局或内建类型。

使用与消息树中的元素数据类型最佳匹配的内建类型。
具有复杂内容的复杂类型

如果类型为全局,则使用该类型。

如果类型是本地,则不输出 xsi:type 属性。

不输出 xsi:type 属性。
相关概念
MRM 域中的物理格式
XML 有线格式
XML 有线格式:处理 xsi:type 属性
XML 有线格式:与逻辑模型的关系
相关任务
使用物理属性
相关参考
消息集属性
定制有线格式消息集
内联 DTD 和 DOCTYPE 文本属性
TDS 格式消息集属性
所有消息集对象的文档属性
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ad09260_