首页 > 代码库 > BizTalk开发系列(十五) Schema设计之Qualified 与Unqualified
BizTalk开发系列(十五) Schema设计之Qualified 与Unqualified
XML Schema中的命名空间前缀限定包括对元素(Element)或属性(Attribute)的限定,即常见的如 “<ns0:root>...</ns0:root>”之类的格式。一般情况下在BizTalk Schema编辑器中设置架构的属性
elementFormDefault /AttributeFormDefault
在该 schema 的目标命名空间中声明的元素的形式。该值必须是下列字符串之一: "qualified" 或 "unqualified"。 默认值为 "unqualified"。
"unqualified" 指示无须通过命名空间前缀限定目标命名空间的元素/属性。
"qualified" 指示必须通过命名空间前缀限定目标命名空间的元素属性。
另外可以直接在记录、元素、属性的属性窗口设置Form的值.
Form
如果该值是 “unqualified”,则无须通过命名空间前缀限定该元素。
如果该值是 “qualified”,则必须通过命名空间前缀限定该元素。
Schema中对于声明是可以继承的,但也是可以重写声明的。即如果在架构中声明了ElementFormDefault属性(全局声明)而子元素没有声明Form(局部声明)的话则该元素则继承ElemnetFormDefault属性。如果子元素重新声明了Form属性则该声明在该元素上优先于全局的声明。
通过以上的设置通常就可以实现对架构,元素或属性的命名空间前缀限定。但在有些情况下虽然设置了Element FromDefault(Attribute一般为属性部声明)的值为UnQualified。但是使用生成实例生成的XML元素或记录还是会带命名空间前缀(如下XML),这种情况一般发生在使用Schema生成向导生成的Schema,从XDR(BizTalk 2002以前使用的Schema格式)转到XSD(BizTalk 2004以后使用的Schema 格式)。
<ns0:Record>
<ns0:SubRecord NUM="NUM_0">
<ns0:TestField>TestField_0</ns0:TestField>
</ns0:SubRecord>
</ns0:Record>
</ns0:Root>
经过测试发现Schema的设置不能应用到子记录或元素的原因是记录的类型为引用类型,并且引用了全局的元素。
<xs:schema xmlns:b="http://schemas.microsoft.com/BizTalk/2003" xmlns="http://orchtest.schema1/" elementFormDefault="unqualified" targetNamespace="http://orchtest.schema1/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:appinfo>
<b:schemaInfo standard="XML" xmlns:b="http://schemas.microsoft.com/BizTalk/2003" root_reference="Root" displayroot_reference="Root" />
</xs:appinfo>
</xs:annotation>
<xs:element name="Root">
<xs:complexType>
<xs:sequence>
<xs:element name="Record1">
<xs:complexType />
</xs:element>
<xs:element name="Field1" type="xs:string" />
<xs:element name="Field2" type="xs:string" />
<xs:element name="Record2" type="Record2" />
<xs:element minOccurs="1" maxOccurs="1" ref="ExtRecord" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="ExtRecord">
<xs:complexType>
<xs:choice minOccurs="0">
<xs:element name="TestField">
<xs:simpleType>
<xs:restriction base="xs:string" />
</xs:simpleType>
</xs:element>
</xs:choice>
<xs:attribute name="NUM" type="xs:string" />
</xs:complexType>
</xs:element>
<xs:complexType name="Record2">
<xs:annotation> <xs:appinfo> <b:fieldInfo xmlns:b="http://schemas.microsoft.com/BizTalk/2003" /></xs:appinfo> </xs:annotation> <xs:attribute name="Field" type="xs:string" /> </xs:complexType>
请注意上图的几个背景部分:
绿色部分 为在架构中声明全局属性即元素不需要命名空间前缀限定
灰色部分 为在Schema编辑器中自定义的Complex Type.
黄色部分 为转换向导生成的类型
粉色部分 为在Root节点引用ExtRecord元素的类型。
特别注意红色部分,如果没有加上红色部分的声明的话在BizTalk编辑器会显示所有元素。即会出现两个ExtRecord节点。
使用Schema生成实例生成的XML数据如下:
<Record1 />
<Field1>Field1_0</Field1>
<Field2>Field2_0</Field2>
<Record2 Field="Field_0" />
<ns0:ExtRecord NUM="NUM_0">
<TestField>TestField_0</TestField>
</ns0:ExtRecord>
</ns0:Root>
我们再来改变一下Schema(注意,此修改是在XML编辑器进行,而不是在BizTalk的Schema编辑器。右击Schema文件,选择打开方式,在对话框中选择XML编辑器)
更改之后的XML如下:
<xs:schema xmlns:b="http://schemas.microsoft.com/BizTalk/2003" xmlns="http://orchtest.schema1/" elementFormDefault="unqualified" targetNamespace="http://orchtest.schema1/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:appinfo>
<b:schemaInfo standard="XML" xmlns:b="http://schemas.microsoft.com/BizTalk/2003" root_reference="Root" />
</xs:appinfo>
</xs:annotation>
<xs:element name="Root">
<xs:complexType>
<xs:sequence>
<xs:element name="Record1">
<xs:complexType />
</xs:element>
<xs:element name="Field1" type="xs:string" />
<xs:element name="Field2" type="xs:string" />
<xs:element name="Record2" type="Record2" />
<xs:element name="ExtRecord">
<xs:complexType>
<xs:choice minOccurs="0">
<xs:element name="TestField">
<xs:simpleType>
<xs:restriction base="xs:string" />
</xs:simpleType>
</xs:element>
</xs:choice>
<xs:attribute name="NUM" type="xs:string" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:complexType name="Record2">
<xs:annotation>
<xs:appinfo>
<b:fieldInfo xmlns:b="http://schemas.microsoft.com/BizTalk/2003" />
</xs:appinfo> </xs:annotation> <xs:attribute name="Field" type="xs:string" /> </xs:complexType> </xs:schema>
保存Schema。生成实例如下:
<Record1 />
<Field1>Field1_0</Field1>
<Field2>Field2_0</Field2>
<Record2 Field="Field_0" />
<ExtRecord NUM="NUM_0">
<TestField>TestField_0</TestField>
</ExtRecord>
</ns0:Root>
经查证。XML Schema中的全局声明必须是唯一的,而全局模式中的每一个声明都自动进入目标名称空间。因此ElementFormDefault的设置不能作用于该元素。
BizTalk开发系列(十五) Schema设计之Qualified 与Unqualified