Fichier sources.xml : définir les sources de données

Le fichier de configuration sources.xml est un fichier essentiel puisque c'est lui qui liste les sources de données du moteur Scrutari. L'absence de ce fichier n'entrainera d'erreur, simplement le moteur tournera à vide !

Chaque source de données est identifiée par un nom qui doit être unique, ne contenir que des minuscules (sans acccent), des chiffres ou le tiret bas _. Pour chaque source, il faut indiquer une URL qui peut être de deux types :

Soit il s'agit directement de l'URL d'un fichier au format ScrutariData et dans ce cas il faut également indiquer la fréquence (en nombre de jours de mise à jour)
Soit il s'agit de l'URL d'un fichier qui suit le format des fichiers d'information

Pointer directement vers un fichier au format ScrutariData est plus simple. En revanche, un fichier d'information donne plus de possibilités, en particulier celles de tronçonner les données en plusieurs fichiers.

Structure du format XML

L'élément racine est l'élément <sources> qui contient un seul type d'élément : l'élément <source> qui a un attribut obligatoire @name et qui peut contenir soit un et un seul élément <info-url>, soit un et un seul élément <scrutaridata-url> ; ces deux éléments doivent avoir comme valeur une URL valide et l'élément <scrutaridata-url> peut posséder un attribut @freq qui indique la fréquence de mise à jour en nombre de jours (la valeur par défaut est « 1 » ce qui signifie que le fichier sera vérifié tous les jours.

Exemple

L'exemple suivant est le fichier de configuration de la Coredem en mars 2014

<?xml version="1.0" encoding="UTF-8"?>
<sources>
    <source name="irenees">
        <info-url>http://bases.basedefiches.net/irenees/pub/scrutari/coredem.scrutari-info.xml</info-url>
	</source>
    <source name="dph">
        <info-url>http://bases.basedefiches.net/dph/pub/scrutari/coredem.scrutari-info.xml</info-url>
	</source>
    <source name="irg">
        <info-url>http://bases.basedefiches.net/irg/pub/scrutari/coredem.scrutari-info.xml</info-url>
	</source>
    <source name="eclm">
        <info-url>http://bases.basedefiches.net/fph/pub/scrutari/eclm_coredem.scrutari-info.xml</info-url>
	</source>
    <source name="chinaeuropa">
        <info-url>http://base.china-europa-forum.net/xml/scrutari/coredem.scrutari-info.xml</info-url>
    </source>
    <source name="terrecitoyenne">
        <info-url>http://terre-citoyenne.org/fileadmin/scrutari/AITC/scrutari-entete.xml</info-url>
	</source>
    <source name="sitecoredem">
        <info-url>http://scrutari.coredem.info/infos/xml/sitecoredem.scrutari-info.xml</info-url>
	</source>
    <source name="fngm">
        <info-url>http://scrutari.coredem.info/infos/php/info.php?base=fngm</info-url>
	</source>
    <source name="lexicommon">
        <info-url>http://lexicommon.coredem.info/spip.php?page=scrutari_entete&amp;id_exportscrutari=1</info-url>
	</source>
    <source name="arga">
        <info-url>http://bases.basedefiches.net/gouvafrique/pub/scrutari/coredem.scrutari-info.xml</info-url>
	</source>
    <source name="cafolis">
        <info-url>http://www.cafolis.org/cgi-bin/scrutari/HEAD</info-url>
	</source>
    <source name="rsp">
        <info-url>http://bases.basedefiches.net/rsp/pub/scrutari/coredem.scrutari-info.xml</info-url>
	</source>
    <source name="premiermai">
        <info-url>http://bases.basedefiches.net/premiermai/pub/scrutari/coredem.scrutari-info.xml</info-url>
    </source>
    <source name="ire">
        <info-url>http://scrutari.i-r-e.org/bdf/sitecoredem.scrutari-info.xml</info-url>
	</source>
    <source name="edd">
        <info-url>http://scrutari.coredem.info/infos/php/info.php?base=edd</info-url>
	</source>
    <source name="aei">
        <info-url>http://scrutari.coredem.info/infos/xml/aei.scrutari-info.xml</info-url>
	</source>
    <source name="culturemedia">
        <info-url>http://scrutari.coredem.info/infos/xml/culturemedia.scrutari-info.xml</info-url>
    </source>
    <source name="vecam">
        <info-url>http://vecam.org/spip.php?page=scrutari-entete</info-url>
    </source>
    <source name="partagedeseaux">
        <info-url>http://www.partagedeseaux.info/spip.php?page=scrutari-entete</info-url>
    </source>
    <source name="modop">
        <info-url>http://bases.basedefiches.net/modop/pub/scrutari/coredem.scrutari-info.xml</info-url>
    </source>
    <source name="cetim">
        <info-url>http://scrutari.coredem.info/infos/php/info.php?base=cetim</info-url>
    </source>
    <source name="agter_bdf">
        <info-url>http://bases.basedefiches.net/agter/pub/scrutari/coredem.scrutari-info.xml</info-url>
    </source>
    <source name="bienscommuns">
        <info-url>http://scrutari.coredem.info/infos/php/info.php?base=bienscommuns</info-url>
    </source>
    <source name="socioeco">
        <info-url>http://bases.basedefiches.net/ess/pub/scrutari/coredem.scrutari-info.xml</info-url>
    </source>
    <source name="aitec">
        <info-url>http://aitec.reseau-ipam.org/spip.php?page=scrutari_entete&amp;id_exportscrutari=1</info-url>
    </source>
    <source name="soletcivilisation">
        <info-url>http://bases.basedefiches.net/soletcivilisation/pub/scrutari/coredem.scrutari-info.xml</info-url>
    </source>
    <source name="coredem_passerelles">
        <info-url>http://www.coredem.info/scrutari-info_passerelles.xml</info-url>
    </source>
    <source name="veblen">
        <info-url>http://www.veblen-institute.org/spip.php?page=scrutari_entete&amp;id_exportscrutari=1</info-url>
    </source>
    <source name="ritimo">
        <info-url>http://www.ritimo.org/spip.php?page=scrutari_entete&amp;id_exportscrutari=1</info-url>
    </source>
    <source name="alimenterre">
        <info-url>http://scrutari.coredem.info/csvconversion/alimenterre/ressources.scrutari-info.xml</info-url>
    </source>
    <source name="alliancesud">
        <info-url>http://www.alliancesud.ch/multimedia/spip.php?page=scrutari_entete&amp;id_exportscrutari=1</info-url>
    </source>
    <source name="agter_spip">
        <info-url>http://www.agter.asso.fr/spip.php?page=scrutari_entete&amp;id_exportscrutari=2</info-url>
    </source>
    <source name="globalchance">
        <info-url>http://www.global-chance.org/spip.php?page=scrutari_info</info-url>
    </source>
    <source name="infogm">
        <info-url>http://scrutari.coredem.info/infos/php/info.php?base=infogm</info-url>
    </source>
</sources>

DTD

<!ELEMENT sources (source*)>
 
<!ELEMENT source (info-url?|scrutaridata-url?)>
   <!ATTLIST source name NMTOKEN #REQUIRED>
 
<!ELEMENT info-url (#PCDATA)>
 
<!ELEMENT scrutaridata-url (#PCDATA)>
   <!ATTLIST source name NMTOKEN '1'>