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 > 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>
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