XML模式设计 - <xs:documentation>源属性值</xs:documentation>

时间:2012-10-02 00:01:40

标签: xml xsd schema-design

我被要求记录XML Schema文件。我需要包含每个架构元素的业务和技术描述。看看我们的指南和W3C XML Schema建议,我发现自己想知道最佳实践究竟是什么。

我们的指南规定注释标记应具有以下格式:

<xs:annotation>
    <xs:documentation source="BusinessDescription">This is the business description</xs:documentation>
    <xs:documentation source="TechnicalDescription">This is the business description</xs:documentation>
</xs:annotation>

XML建议声明source属性应为“xs:anyURI”类型。显然,“BuinessDescription”和“TechnicalDescription”不是URI,并且将在整个架构中重复多次。因此,将source属性用作语义属性是否真的正确?

在XML Schema中http://shop.oreilly.com/product/9780596002527.do Eric van der Vlist建议这是可以接受的,但也反驳了这种观点,指出它可能导致互操作性问题。

1 个答案:

答案 0 :(得分:3)

您可以在其中放置格式良好的xml而不仅仅是文本,因此不要将已知的标准属性混淆。只有<Business>This is the business...</Business><Technical>This is the technical....</Tecnhical>个节点。