<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.1b1//EN" "../../../dtd/website.dtd">

<webpage id="configuration_index"> 

  <head>
	 <title>Configuration of an SDX-2 application</title>
	 <titleabbrev>Configuration</titleabbrev>
	 <author>
		<firstname>Martin</firstname>
		<surname>Sévigny</surname>
		<affiliation>
		  <orgname>AJLSM</orgname> 
		</affiliation>
	 </author>
	 <revhistory>
		<revision>
		  <revnumber>1.0</revnumber> 
		  <date>2003-06-03</date> 
		</revision>
	 </revhistory>
  </head>

  <para>All information on configuration of an SDX-2 application are recorded in a single XML document. This document mst absolutely bve named and located as follows: <filename>{chemin-sdx}/{dossier-application}/conf/application.xconf</filename>. The folder <filename>{folder-application}</filename> must be located in the SDX installation folder (usually the <filename>sdx</filename> folder located in the <filename>webapps</filename> folder of the servlet engine).</para>
  <para>Many configuration informationare necessary in this file, the easiest way is to get an example and to modify it according to your needs. The <emphasis>human</emphasis> documentation of configuartion options has not been written yet, but two resources provide technical documentation:</para>
  <itemizedlist>
	 <listitem>
		<para>The XML schema which the document must comply with <filename>application.xconf</filename>: if the document does not comply with this schema, your application cannot be loaded by SDX. To use this schema in an XML editorwhen creating the <filename>application.xconf</filename> file, allows to view possible options.</para>
	 </listitem>
	 <listitem>
		<para>A demonstration file 
		  <ulink url="../../samples/documented_application_xconf.xml"><filename>application.xconf</filename></ulink>, which is as complete as possible, with various explanations.</para>
	 </listitem>
  </itemizedlist>
  <para>It is important to record that SDX-2 is released with a show case application, named <emphasis>sdxworld</emphasis>, which has a <filename>application.xconf</filename> file, which you can use as a basis for your own application.</para>
  <para>We also would like t underline that for the migration of an SDX-1 application, particular instructions are available to transform the <filename>db_info.xml</filename> file (SDX-1) into a <filename>application.xconf</filename> file (SDX-2).</para>

</webpage> 
