<?xml version="1.0"?>
<!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.1b1//EN" "../../../dtd/website.dtd" [
<!ENTITY config SYSTEM "configuration.xml" NDATA XML>
<!ENTITY sitemap SYSTEM "sitemap.xml" NDATA XML>
<!ENTITY url SYSTEM "api-url.xml" NDATA XML>
<!ENTITY xsp SYSTEM "api-xsp.xml" NDATA XML>
]>
<webpage id="migration_intro">
	<head>
		<title>La migration de SDX-1 à SDX-2</title>
		<titleabbrev>Migration</titleabbrev>
		<author>
			<firstname>Martin</firstname>
			<surname>Sévigny</surname>
			<affiliation>
				<orgname>AJLSM</orgname>
			</affiliation>
		</author>
		<author>
			<firstname>Frédéric</firstname>
			<surname> Glorieux</surname>
			<affiliation>
				<orgname>AJLSM</orgname>
			</affiliation>
		</author>
		<revhistory>
			<revision>
				<revnumber>1.0</revnumber>
				<date>2002/11/07</date>
			</revision>
		</revhistory>
	</head>
	<para>Les applications développées sous la version 1.x de SDX devront généralement être modifiées pour utiliser la version 2. Le développement de SDX-2 a été orienté pour rendre cette migration aussi simple que possible, mais en même temps, les changements importants de l'architecture sous-jacente rendent illusoire toute compatibilité parfaite avec SDX-1. Dans cette partie de la documentation, nous allons expliquer les principales différences entre les deux versions et quelles sont les principales actions à entreprendre pour réaliser une migration.</para>
	<variablelist>
		<title>La version 1 de SDX offrait ses services par trois API&#xA0;: l'API-Java, l'API-XSP et l'API-URL.</title>
		<varlistentry>
			<term>API-Java</term>
			<listitem>
				<para>Pour des opérations rares et très spécifiques, par exemple une alimentation directe des bases, on peut accéder à SDX directement en code Java. Pour la pérennité d'un développement, ce n'est pas conseillé.  Suite à l'intégration à Cocoon-2, l'API-Java a dû être complètement refondue, mais bien documentée. Les développeurs concernés y trouveront leur nécessaire, et un peu plus.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>API-XSP</term>
			<listitem>
				<para>Ces cas mis à part, la plupart des applications SDX-1 reposent essentiellement sur l'API-XSP. La recette était bonne, et s'il y a des différences, c'est surtout pour améliorer la cohérence du  vocabulaire et de la syntaxe (ainsi que bien sûr, donner accès aux  nouveautés apportées).</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>API-URL</term>
			<listitem>
				<para role="bold"> L'API-URL a été entièrement réécrite, <emphasis>mais</emphasis>, à l'exception des fonctions qui ont été supprimées, les anciens noms fonctionnent. Toutefois, il est largement conseillé de vérifier les URLs formées, afin d'adopter les nouvelles dénominations. </para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term>API-SDX</term>
			<listitem>
				<para>Le but poursuivi consiste à n'entretenir qu'un seul et même vocabulaire qui sera désormais nommé <emphasis role="bold">API-SDX</emphasis>
				</para>
			</listitem>
		</varlistentry>
	</variablelist>
	<orderedlist>
		<title>La migration devrait s'effectuer avec un effort minimal selon l'ordre suivant</title>
		<listitem>
			<para>écrire la configuration de l'application selon le schéma <filename>application-xconf.xsd</filename>, voir <olink targetdocent="config">configuration d'une application SDX 2</olink>.</para>
		</listitem>
		<listitem>
			<para>écrire un  <filename>sitemap.xmap</filename> afin d'organiser la  génération XSP, les  transformations XSL, la sérialisation HTML, voir les <olink targetdocent="sitemap">
					<emphasis>sitemap</emphasis>
				</olink> Cocoon.</para>
		</listitem>
		<listitem>
			<para>valider les pages XSP contre le schéma <filename>api-sdx.xsd</filename>, voir les changements de l'<olink targetdocent="xsp">API XSP</olink>.</para>
		</listitem>
		<listitem>
			<para>revoir les feuilles XSL employant l'API-URL, voir les changements de l'<olink targetdocent="url">API URL</olink>.</para>
		</listitem>
	</orderedlist>
	<para>Cette section est structurée selon ces quatre aspects. A la fin, la migration devrait être réussie, c'est l'occasion d'optimiser votre application avec  ce que SDX-2 peut lui apporter.</para>
</webpage>
