xs:annotation

(Auszug aus "XML Schema" von Eric van der Vlist)

Informative Angaben für menschliche oder elektronische Agenten.

<xs:annotation
    id = xs:ID
    {beliebige Attribute mit einem Nicht-Schema-Namensraum}
    >
    Content: (xs:appinfo | xs:documentation)*
</xs:annotation>

Kann auftreten innerhalb von: xs:all (außerhalb einer Gruppe), xs:all (innerhalb einer Gruppe), xs:any, xs:anyAttribute, xs:attribute (Verweis oder lokale Definition), xs:attribute (globale Definition), xs:attributeGroup (Verweis), xs:attributeGroup (global Definition), xs:choice (außerhalb einer Gruppe), xs:choice (innerhalb einer Gruppe), xs:complexContent, xs:complexType (lokale Definition), xs:complexType (globale Definition), xs:element (innerhalb von xs:all), xs:element (Verweis oder lokale Definition), xs:element (globale Definition), xs:enumeration, xs:extension (komplexer Inhalt), xs:extension (einfacher Inhalt), xs:field, xs:fractionDigits, xs:group (Verweis), xs:group (Definition), xs:import, xs:include, xs:key, xs:keyref, xs:length, xs:list, xs:maxExclusive, xs:maxInclusive, xs:maxLength, xs:minExclusive, xs:minInclusive, xs:minLength, xs:notation, xs:pattern, xs:redefine, xs:restriction (komplexer Inhalt), xs:restriction (einfacher Typ), xs:restriction (einfacher Inhalt), xs:schema, xs:selector, xs:sequence (innerhalb einer Gruppe), xs:sequence (außerhalb einer Gruppe), xs:simpleContent, xs:simpleType (lokale Definition), xs:simpleType (globale Definition), xs:totalDigits, xs:union, xs:unique, xs:whitespace

Beschreibung

xs:annotation ist ein Container, in den zusätzliche Informationen eingebettet werden können, sei es für die Nutzung durch Menschen (mit xs:documentation), sei es für Programme (xs:appinfo). xs:annotation kann fast jedem Element von W3C XML als erstes Kindelement hinzugefügt werden. Dieser Container kann auch überall als Element auf oberster Ebene (unmittelbar unterhalb von xs:schema) angegeben werden.

Einschränkungen

xs:annotation kann nicht innerhalb von sich selbst auftreten.

Beispiel

<xs:element name="author" type="author">
    <xs:annotation>
        <xs:documentation xml:lang="en">The author of a book.</xs:documentation>
        <xs:documentation xml:lang="de">Der Autor eines Buches.</xs:documentation>
        <xs:appinfo xmlns:sch="http://www.ascc.net/xml/schematron">
            <sch:pattern name="Born before dead">
                <sch:rule context="author">
                    <sch:assert test="not(dead) oder (dead &gt; born)" xs:any diagnostics="bornAfterDead">Ein Autor sollte erst nach seiner Geburt sterben.</sch:assert>
                    <sch:diagnostics>
                        <sch:diagnostic id="bornAfterDead">Fehler, dieser Autor wurde erst nach seinem Tod geboren! Autor = <sch:value-of select="name"/> Geburt = <sch:value-of select="born"/> Tod = <sch:value-of select="dead"/></sch:diagnostic>
                    </sch:diagnostics>
                </sch:rule>
            </sch:pattern>
        </xs:appinfo>
    </xs:annotation>
</xs:element>

Attribute

id
Element-ID laut W3C XML Schema.

   

<< zurück vor >>

 

 

 

Tipp der data2type-Redaktion:
Zum Thema XML Schema bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © 2003 O'Reilly Verlag GmbH & Co. KG
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "XML Schema" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

O’Reilly Verlag GmbH & Co. KG, Balthasarstraße 81, 50670 Köln, kommentar(at)oreilly.de