XSD中fullName唯一性约束失效问题排查及解决方法咨询

尝试为Salesforce CustomLabels格式的XML生成XSD，用于自动化流程中的文件生成与验证。已在XSD中为fullName字段添加唯一性校验，但该约束未生效。

示例XML #

<?xml version="1.0" encoding="UTF-8"?>
<CustomLabels
    xmlns="http://soap.sforce.com/2006/04/metadata">
    <labels>
        <fullName>Label1</fullName>
        <categories>L1</categories>
        <language>en_US</language>
        <protected>false</protected>
        <shortDescription>This is label 1</shortDescription>
        <value>1</value>
    </labels>
    <labels>
        <fullName>Label2</fullName>
        <categories>L2</categories>
        <language>en_US</language>
        <protected>false</protected>
        <shortDescription>Label 2 </shortDescription>
        <value>2</value>
    </labels>
    <labels>
        <fullName>Label2</fullName>
        <categories>L2</categories>
        <language>en_US</language>
        <protected>false</protected>
        <shortDescription>New label</shortDescription>
        <value>New value</value>
    </labels>
</CustomLabels>

现有XSD #

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           xmlns="http://soap.sforce.com/2006/04/metadata"
           targetNamespace="http://soap.sforce.com/2006/04/metadata"
           elementFormDefault="qualified"
           attributeFormDefault="unqualified">

  <xs:element name="CustomLabels">
    <xs:complexType>
      <xs:sequence>
        <xs:element maxOccurs="unbounded" name="labels">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="fullName" type="xs:string"/>
              <xs:element name="categories" type="xs:string" minOccurs="0"/>
              <xs:element name="language" type="xs:string"/>
              <xs:element name="protected" type="xs:boolean" minOccurs="0"/>
              <xs:element name="shortDescription" type="xs:string" minOccurs="0"/>
              <xs:element name="value" type="xs:string"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
    <xs:unique name="fullname_unique">
            <xs:selector xpath="labels/fullName"/>
            <xs:field xpath="."/>
    </xs:unique>
  </xs:element>
</xs:schema>

XML中的所有元素都属于命名空间http://soap.sforce.com/2006/04/metadata，且XSD设置了elementFormDefault="qualified"，意味着所有子元素都默认归属目标命名空间。但现有XSD中的xs:unique约束使用的XPath没有指定命名空间前缀，导致解析器无法匹配到对应的labels和fullName元素，唯一性校验自然不生效。

1. 添加命名空间前缀：在xs:schema标签中定义一个前缀（比如md）绑定到目标命名空间
2. 修改XPath表达式：在xs:selector和xs:field的XPath中使用该前缀，确保解析器能正确定位到命名空间下的元素

修改后的完整XSD如下：

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           xmlns:md="http://soap.sforce.com/2006/04/metadata"
           targetNamespace="http://soap.sforce.com/2006/04/metadata"
           elementFormDefault="qualified"
           attributeFormDefault="unqualified">

  <xs:element name="CustomLabels">
    <xs:complexType>
      <xs:sequence>
        <xs:element maxOccurs="unbounded" name="labels">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="fullName" type="xs:string"/>
              <xs:element name="categories" type="xs:string" minOccurs="0"/>
              <xs:element name="language" type="xs:string"/>
              <xs:element name="protected" type="xs:boolean" minOccurs="0"/>
              <xs:element name="shortDescription" type="xs:string" minOccurs="0"/>
              <xs:element name="value" type="xs:string"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
    <xs:unique name="fullname_unique">
      <xs:selector xpath="md:labels"/>
      <xs:field xpath="md:fullName"/>
    </xs:unique>
  </xs:element>
</xs:schema>

关键修改说明 #

• 新增xmlns:md="http://soap.sforce.com/2006/04/metadata"，给目标命名空间分配前缀md
• 将xs:selector的XPath从labels/fullName改为md:labels，定位所有labels元素
• 将xs:field的XPath从.改为md:fullName，指定每个labels下的fullName字段作为唯一性校验的依据

修改后，解析器就能正确识别命名空间下的元素，唯一性约束会正常生效，示例XML中重复的Label2会被校验出错误。

内容的提问来源于stack exchange，提问作者Manu Murukesan