XSD annotation et la documentation des éléments, et comment les utiliser

Nous sommes en créant des fichiers xml que nous voulons être en conformité avec la suite xsd: http://www.topografix.com/gpx/1/1/gpx.xsd Ce xsd prend en charge " ...l'extension par l'ajout de vos propres éléments ici...", voir la extensionsType, que j'ai copié ci-dessous pour plus de commodité.

1) je ne comprends pas si l'annotation et la documentation littérale des noms d'éléments qui apparaissent dans xml conforme. Je crois qu'ils ne sont pas, mais besoin d'une confirmation. Je suppose alors qu'un document conforme serait tout simplement avoir un nombre quelconque de nos propres éléments n'importe où à l'intérieur de tout [extensions] élément, correct?

2) Pourquoi il n'y deux paires de l'annotation et de la documentation les éléments ci-dessous, avec un dans une séquence?

 <xsd:complexType name="extensionsType">
       <xsd:annotation>
        <xsd:documentation>
         You can add extend GPX by adding your own elements from another schema here.
        </xsd:documentation>
       </xsd:annotation>
        <xsd:sequence>
         <xsd:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded">
           <xsd:annotation>
            <xsd:documentation>
             You can add extend GPX by adding your own elements from another schema here.
            </xsd:documentation>
           </xsd:annotation>
         </xsd:any>
        </xsd:sequence>
      </xsd:complexType>

OriginalL'auteur bethesdaboys | 2011-11-18

  1. 8

    1) à Partir du Schéma XML spécification: "Annotations fournir pour l'homme et la machine ciblée annotations des éléments du schéma." Schéma auteurs utilisent xsd:documentation, comme Java ou .NET, les développeurs à utiliser les commentaires.

    Les Annotations sont de Schéma XML des artefacts; elles ne doivent pas apparaître dans un document XML. Et oui, vos extensions éléments devraient passer sous <extensions/>; vous pouvez utiliser tout l'espace de noms, autres que http://www.topografix.com/GPX/1/1

    XSD annotation et la documentation des éléments, et comment les utiliser

    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
<!-- Sample XML generated by QTAssistant (http://www.paschidev.com) -->
<gpx xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.1" creator="creator1" xmlns="http://www.topografix.com/GPX/1/1">
    <extensions>
        <my:element xmlns:my="urn:tempuri-org:some">Hello!</my:element>     
    </extensions>
</gpx>

    2) Difficile de dire pourquoi il y a deux avec le même commentaire; la différence est cependant que l'un des documents de type complexe, tandis que l'autre le xsd:n'importe quel élément. Je n'ai personnellement utilisé différents commentaires, d'abord d'expliquer ce que le type complexe est pour, la deuxième, juste comme illustré.

    Je comprends maintenant. RTFM ne fonctionnait pas pour moi 🙂 Merci!

    OriginalL'auteur Petru Gardea