Xml Inclusion

Format Xml Inclusion utilisé par Up ! eXtended Markup Language

Xml Inclusion permet de référencer des ressources externes qui seront chargées à la demande de l'application par le processeur Xml. L'espace de noms de Xml Inclusion est xmlns:xinclude=http://www.w3.org/2001/xinclude".

L'élément représentant une inclusion est xinclude:include. Il possède les attributs suivants :

Attribut.	Sémantique.
`accept`	En mode texte, encodages à demander par le processeur Xml au service Http pour la ressource à inclure. Par défaut, pas d'encodage.
`accept-language`	En mode texte, choix de la langue à demander par le processeur Xml au service Http pour la ressource à inclure. Par défaut, pas de choix.
`href`	URI de la ressource à inclure. Un fragment n'est pas possible.
`encoding`	En mode texte, encodage de la ressource à inclure utilisé par le service Http. Par défaut, pas d'encodage et la page de codes est UTF-8.
`parse`	`text` pour ne pas faire analyser le contenu et `xml` pour le faire.
`xpointeur`	En mode Xml, portion de la ressource à inclure décrite en Xml Pointeur. Par défaut, toute la ressource est incluse.

Si la ressource à inclure n'est pas disponible, il est possible de spécifier un contenu de substitution défini dans l'élément xinclude:fallback.

Exemple d'un flux Xml utilisant Xml Inclusion

Boici la ressource locale :


<?xml version="1.0"?>

<Document xmlns:xinclude="http://www.w3.org/2001/xinclude">

	Ceci est la partie 2 du contenu de la ressource externe incluse :

   <xinclude:include href="http://www.up-comp.com/application/parties.xml" parse="xml" xpointeur="p2">
	
		<xinclude:fallback>Désolé, le contenu n'est pas disponible.</xinclude:fallback>
	
	</xinclude:include>

</Document>

Voici la ressource externe :
<?xml version="1.0"?> <Partie id="p1">


	Partie 1.


</Partie>

<Partie id="p2">

	Partie 2.

</Partie>

<Partie id="p2">

	Partie 3.

</Partie>

Et voici l'équivalent de l'inclusion :
<?xml version="1.0"?> <Document xmlns:xinclude="http://www.w3.org/2001/xinclude">


	Ceci est la partie 2 du contenu de la ressource externe incluse :

	<Partie id=2 xml:base="http://www.up-comp.com/application/parties.xml">
	
		Partie 2.
	
	</Partie>


</Document>