Legenda van de schemadocumentatie
De schemadocumentatie gebruikt interactieve diagrammen om de XML-structuur te visualiseren en aan te geven hoe de informatie gestructureerd is. Onderstaande diagrammen illustreren de meestgebruikte symbolen en andere onderdelen van zo'n diagram. In de documentatie zijn de diagrammen klikbaar: de benoemde onderdelen linken naar hun eigen definitie.
De uitleg hieronder gebruikt de prefix xs: voor elementen uit namespace van XML Schema Documents xmlns:xs="http://www.w3.org/2001/XMLSchema".
Elementen
Elementen worden in de diagrammen getekend als een een rechthoek met afgeronde hoeken.
Het onderstaande diagram toont een element waarvan de kindelementen een vaste volgorde
hebben (middels een xs:sequence). De namen van de kinderen in dit voorbeeld geven de verschillende kardinaliteiten
(optioneel, verplicht, meervoudig). De lijnen naar en om verplichte kinderen zijn in de diagrammen dikker dan de lijnen naar en om optionele kinderen.
Het element in dit voorbeeld heeft tevens een attribuutgroep.
Globale en lokale definities
In bovenstaand diagram verwijst (middels xs:element/@ref) het content model naar vier globaal gedeclareerde elementen ( verplicht-element, optioneel-element, verplicht-meervoudig-element en optioneel-meervoudig-element). De verwijzing is getoond middels het pijltje rechts onderin de rechthoek. Globaal
gedeclareerde elementen hebben in de gehele XSD dezelfde definitie.
Het laatste element element-lokaal-in-dit-content-model is een lokale declaratie (middels xs:element/@name) die alleen geldt binnen de context van het ouder-element element-met-vaste-volgorde.
De lokale elementdeclaraties staan in de documentatie op dezelfde pagina als het ouderelement. Dat is immers de enige context waarin dat element gebruikt mag worden.
Element met keuze
Onderstaand diagram toont een element waar het content model een keuze biedt (middels een xs:choice) tussen een verplichte-eerste-element enerzijds of een verplichte-tweede-keuze gevolgd door een optionele-derde-keuze anderzijds.
Element met onbepaalde volgorde
Onderstaande diagram toont een element waarin de volgorde van de kindelementen onbepaald
is (middels een xs:all)
Attribuutgroep
Attributen worden getekend als een rechthoek met links rechte en rechts afgeronde hoeken.
xs:complexType
Een element waarvan het type gedefinieerd is middels een benoemd xs:complexType toont de naam van zijn type onderin de afgeronde rechthoek en toont tevens het model
van dat complexType:
Het xs:complexType zelf wordt getekend als een rechthoek met scherpe hoeken met daarbinnen links een
vierkant:
Lokale elementen binnen een xs:complexType
Binnen een xs:complexType worden vaak alleen lokale elementdeclaraties gebruikt. Net zoals lokale elementdeclaraties binnen een element worden de lokale
elementen van een xs:complexType op dezelfde pagina als het xs:complexType zelf gedocmenteerd.
xs:simpleType
Een element waarvan het type is gedefinieerd middels een zogenaamd xs:simpleType ofwel "datatype" toont ook de naam van dat type onderin de afgeronde rechthoek
Het xs:simpleType zelf is een langwerpige achthoek met daarbinnen links een driehoek. Het diagram toont
het basistype van de XML Schema datatypes waarop het xs:simpleType is gebaseerd.
