3. XSD - structure du fichier et espaces de nom

3.1 Structure et espace de nom d’un fichier XSD

Comme tout fichier XML, XSD doit commencer par une déclaration XML
Racine d’un XSD : < schema> ... </schema>
L’élément schema possède des attributs (voir plus loin)
XSD utilise des espaces de noms pour distinguer éléments appartenant à XSD (le langage) et les éléments et attributs définis par un schéma donné (même principe que XSLT).

Espaces de noms (namespaces) et préfixes

On peut soit définir un préfixe pour les éléments XSD soit pour vos éléments

Voir solution 1 et 2 ci-dessous

Vous pouvez aussi choisir si vos éléments XML auront un namespace

A. Solution 1: Donner un namespace au code XSD

Souvent on utilise le préfixe xs: pour le code XSD

Parfois xsd: cela n’a pas d’importance

elementFormDefault="qualified" veut dire que vos balises n’auront pas de namespace

Exemple 3-1: XSD définition pour une simple recette de cuisine

<?xml version="1.0" encoding="UTF-8"?>

<!-- Simple recipe Schema -->

<xs:
schema
 xmlns:xs="http://www.w3.org/2001/XMLSchema"
           elementFormDefault="qualified
">

  <xs
:element name="list">

    <xs:complexType>

      <xs:sequence>

        <xs:element maxOccurs="unbounded" ref="recipe
"/>

      </xs:sequence>

    </xs:complexType>

  </xs:element>

Cette solution est préférable en règle générale (mais voir plus loin comment associer une XSD à un fichier XML: il faut encore ajouter des attributs)

B. Solution 2: Donner un namespace au code du schéma

Les éléments définis pour votre schéma ont un préfixe dans la définition.

vous devez donc définir votre namespace (substituer "yourdomain.org/namespace")

On déclare que XML Schema a le namespace par défaut, c.a.d. les éléments XSD ne seront pas préfixés.

Exemple 3-2: XSD définition pour une simple recette

<schema

  xmlns='http://www.w3.org/2000/10/XMLSchema'
  targetNamespace='http://yourdomain.org/namespace/
'  xmlns:t='http://yourdomain.org/namespace/
'>

 <element name='t:list'>

  <complexType>

   <sequence>

    <element ref='t:recipe
' maxOccurs='unbounded'/>

   </sequence>

  </complexType>

 </element>

3.2 Validation

Un document XML décrit par un XSD est appelé instance document .

A. Association d’un XSD avec un fichier XML, Solution 1

Il faut déclarer le namespace xsi: (XMLSchema-instance)
L’attribut xsi:noNamespaceSchemaLocation définit l’URL de votre XSD
Attention: il faut utiliser cela tel quel !!!
Je déconseille cette solution (voir la solution 2)

XML file (recipe-no-ns.xml)

<?xml version="1.0" encoding="ISO-8859-1" ?>

<list

  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:noNamespaceSchemaLocation="
recipe-no-ns.xsd
">

  <recipe> ....

</list>

XSD file (recipe-no-ns.xsd)

<?xml version="1.0" encoding="UTF-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

           elementFormDefault="qualified">

  <xs:element name="list">

B. Association d’un XSD avec XML, Solution 2

Solution à retenir: L’idée est que chaque fragment XML fait tjrs partie d’un namespace:

Les fichiers XML et XSD doivent inclure une namespace declaration pour un domaine

Le fichier XML doit inclure en plus:

une déclaration pour le XMLSchema-instance namespace
un attribut xsi:schemaLocation qui dit ou trouver XSD

Cet attribut peut contenir plusieurs pairs "namespace-URL"

Exemple 3-3: XML pour une recette avec une XSD associée (file recipe.xml)

XML file (recipe.xml)

<?xml version="1.0" encoding="ISO-8859-1" ?>

<list

  xmlns="http://myrecipes.org/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="
http://myrecipes.org/
 
recipe.xsd
" 
>

  <recipe>

    <meta> .....</meta>

    ......

  </recipe>

</list>

En gros: Il faut substituer qc. pour le rose et le rouge ci-dessus. Faites attention à la syntaxe de l’attribut schemaLocation: "Namespace_url XSD_URL NameSpace_URL XSD_URL ..."

XSD file (recipe.xsd)

<?xml version="1.0" encoding="UTF-8"?>

<!-- Simple recipe Schema -->

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema
"	       targetNamespace="http://myrecipes.org/"
	       xmlns="http://myrecipes.org/"
	       elementFormDefault="qualified">

   ....

</xs:schema>

La XSD définit un namespace pour vos balises.
Il faut substituer http://myrecipes.org/" par un URL de votre choix, mais de préférence un URL sur lequel vous avez le contrôle (par exemple votre home page).

Exemple 3-4: IMS Content Packaging 1.1.4 et IMS/LOM Metadata

C.f. http://tecfa.unige.ch/guides/tie/html/pedago-normes/pedago-normes.html

Le fichier XML

<manifest

  xmlns
="http://www.imsglobal.org/xsd/imscp_v1p1"  xmlns:imsmd
="http://www.imsglobal.org/xsd/imsmd_v1p2"

  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

  identifier="MANIFEST-1"

  xsi:schemaLocation=

   "http://www.imsglobal.org/xsd/imscp_v1p    imscp_v1p1.xsd     http://www.imsglobal.org/xsd/imsmd_v1p2    imsmd_v1p2p2.xsd">

 <metadata>

    <imsmd:lom> ......

   </imsmd:lom>

 </metadata>

 <organizations default="learning_sequence_1">

.....

Cet exemple montre comment utiliser deux espaces de nom pour deux XSD
imscp_v1p1 est le namespace par défaut (sans préfixe)
imsmd_v1p1 est le namespace pour les métadonnées.

Extrait du fichier ims_cp_rootv1p1.xsd

<xsd:schema

	xmlns
 = "http://www.imsglobal.org/xsd/imscp_v1p1"

	targetNamespace = "http://www.imsglobal.org/xsd/imscp_v1p1"

	xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"

	xmlns:xsd = "http://www.w3.org/2001/XMLSchema"

	version = "IMS CP 1.1.4"

	elementFormDefault = "qualified">

3.3 Définition d’éléments

Une structure XML est hiérarchique ...

<xs:element>

Définit un élément

Exemple d’un simple élément sans enfant et sans attributs:

<xs:element
 name="author" type="xs:string"/>

Définition d’éléments enfants

On peut les définir de deux façons:

soit avec un élément enfant complexType
soit avec un attribut "type" qui se réfère à une définition complexType

<xs:complexType> (1)

enfant de xs:element

<xs:element
 name="recipe">

    <xs:complexType>

      <xs:sequence>

        <xs:element ref="meta"/>

        <xs:element minOccurs="0" ref="recipe_author"/>

        <xs:element ref="recipe_name"/>

        <xs:element ref="ingredients"/>

        <xs:element ref="directions"/>

      </xs:sequence>

    </xs:complexType>

  </xs:element>

<xs:complexType> (2)

Alternativement, on déclare un complex type seul et ensuite on l’utilise dans des déclarations d’éléments.

 <xs:element
 name="recipe" type="recipe_contents
" />

 <xs:complexType name="recipe_contents
">

      <xs:sequence>

        <xs:element ref="meta"/>

        <xs:element minOccurs="0" ref="recipe_author"/>

        <xs:element ref="recipe_name"/>

        <xs:element ref="meal"/>

        <xs:element ref="ingredients"/>

        <xs:element ref="directions"/>

      </xs:sequence>

  </xs:complexType>