BizTalk开发系列(十五) Schema设计之Qualified 与Unqualified

更多内容请查看：BizTalk动手实验系列目录

                      BizTalk 开发系列

      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:Root  DATE ="DATE_0"  xmlns:ns0 ="http://schemasample.test" >  
< ns0:Record >  
< ns0:SubRecord  NUM ="NUM_0" >  
< ns0:TestField > TestField_0 </ ns0:TestField >  
</ ns0:SubRecord >  
</ ns0:Record >  
</ ns0:Root >  

   

     经过测试发现Schema的设置不能应用到子记录或元素的原因是记录的类型为引用类型，并且引用了全局的元素。

<? xml version="1.0" encoding="utf-16" ?>  
< 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数据如下：

< ns0:Root  xmlns:ns0 ="http://OrchTest.Schema1" >  
< 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如下：

<? xml version="1.0" encoding="utf-16" ?>  
< 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。生成实例如下：

 

< ns0:Root  xmlns:ns0 ="http://OrchTest.Schema1" >  
< 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的设置不能作用于该元素。