Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
serveurscrutari:config:sources [2017/08/02 13:23]
vincent
serveurscrutari:config:sources [2022/09/11 11:53] (Version actuelle)
vincent
Ligne 6: Ligne 6:
  
   * soit en indiquant directement l'URL de téléchargement (voir ci-dessous l'​élément !!<​scrutaridata-url>​!!)   * soit en indiquant directement l'URL de téléchargement (voir ci-dessous l'​élément !!<​scrutaridata-url>​!!)
-  * soit en indiquant l'URL d'un fichier appelé « fiche d'​information » qui sert d'​intermédiaire,​ notamment en indiquant le ou les URLs nécessaires pour construire les données au format ScrutariData (voir son [[serveurscrutari:​config:​scrutariinfo|format exact] et ci dessous l'​élément !!<​info-url>​!!)+  * soit en indiquant l'URL d'un fichier appelé « fiche d'​information » qui sert d'​intermédiaire,​ notamment en indiquant le ou les URLs nécessaires pour construire les données au format ScrutariData (voir son [[serveurscrutari:​config:​scrutariinfo|format exact]] et ci dessous l'​élément !!<​info-url>​!!)
  
 Le choix entre ces deux manières dépend de la source. Un fichier d'​information est particulièrement utile quand les données sont importantes et que leur génération peut prendre du temps. Le choix entre ces deux manières dépend de la source. Un fichier d'​information est particulièrement utile quand les données sont importantes et que leur génération peut prendre du temps.
Ligne 12: Ligne 12:
 Au niveau du fichier de configuration //​sources.xml//,​ une source de données est identifiée par un nom unique et peut combiner plusieurs URLs (fichiers au format ScrutariData ou fichiers d'​information) comme le montre l'​exemple ci-dessous : Au niveau du fichier de configuration //​sources.xml//,​ une source de données est identifiée par un nom unique et peut combiner plusieurs URLs (fichiers au format ScrutariData ou fichiers d'​information) comme le montre l'​exemple ci-dessous :
  
-<code xml> +
-<source name="​coredem">​ +
- <​scrutaridata-url freq="​1">​http://​www.coredem.info/​spip.php?​page=scrutaridata_passerelles</​scrutaridata-url>​ +
- <​info-url>​http://​docs.fichotheque.net/​coredem/​scrutari/​sitecoredem.scrutari-info.xml</​info-url>​ +
-</​source>​ +
-</​code>​+
  
  
 ===== Structure du format XML ===== ===== 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 des éléments !!<​info-url>​!!, soit des éléments !!<​scrutaridata-url>​!! ; ces deux éléments doivent avoir comme valeur une URL valide et un é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.+L'​élément racine est l'​élément !!<​sources>​!! qui contient un seul type d'​élément : l'​élément !!<​source>​!!. Celui-ci ​a un attribut obligatoire!!@name!!qui est le nom identifiant la source (il doit être unique et n'​être composé que des minuscules (sans accent), des chiffres ou le tiret bas //_//). 
 + 
 +L'​élément //<​source>//​ contient ​des éléments !!<​info-url>​!! ​et des éléments !!<​scrutaridata-url>​!! ; ces deux éléments doivent avoir comme valeur une URL valide et un é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).
  
-L'​élément //<​source>//​ peut également posséder un élément !!<​uri>​!! (indiquant l'URI de la base à utiliser en lieu et place de l'URI indiqué par le fichier au format ScrutariData) ou plusieurs éléments !!<​alias>​!! (permettant d'​indiquer des anciens URI équivalents à l'URI actuel). Voir ci-dessous.+L'​élément //<​source>//​ peut également posséder un élément !!<​uri>​!! (indiquant l'URI de la base à utiliser en lieu et place de l'URI indiqué par le fichier au format ScrutariData) ou plusieurs éléments !!<​alias>​!! (permettant d'​indiquer des anciens URI équivalents à l'URI actuel). Voir les exemples et ci-dessous.
  
  
Ligne 32: Ligne 29:
  
 <code xml> <code xml>
-<?xml version="​1.0"​ encoding="​UTF-8"?>​ 
 <?xml version="​1.0"​ encoding="​UTF-8"?>​ <?xml version="​1.0"​ encoding="​UTF-8"?>​
 <​sources>​ <​sources>​
     <source name="​irenees">​     <source name="​irenees">​
         <​info-url>​http://​bases.basedefiches.net/​irenees/​pub/​scrutari/​coredem.scrutari-info.xml</​info-url>​         <​info-url>​http://​bases.basedefiches.net/​irenees/​pub/​scrutari/​coredem.scrutari-info.xml</​info-url>​
- </​source>​+    ​</​source>​
     <source name="​rsp">​     <source name="​rsp">​
         <​info-url>​http://​bases.basedefiches.net/​rsp/​pub/​scrutari/​coredem.scrutari-info.xml</​info-url>​         <​info-url>​http://​bases.basedefiches.net/​rsp/​pub/​scrutari/​coredem.scrutari-info.xml</​info-url>​
- <​alias>​base:/​e17a05b0-c45e-11d8-9669-0800200c9a66/​rsp</​alias>​ + <​alias>​base:/​e17a05b0-c45e-11d8-9669-0800200c9a66/​rsp</​alias>​ 
- </​source>​+    </​source>​
     <source name="​agter">​     <source name="​agter">​
         <​info-url>​http://​bases.basedefiches.net/​agter/​pub/​scrutari/​coredem.scrutari-info.xml</​info-url>​         <​info-url>​http://​bases.basedefiches.net/​agter/​pub/​scrutari/​coredem.scrutari-info.xml</​info-url>​
Ligne 47: Ligne 43:
     </​source>​     </​source>​
     <source name="​coredem">​     <source name="​coredem">​
- <​uri>​base:/​coredem.info/​core</​uri>​ + <​uri>​base:/​coredem.info/​core</​uri>​ 
- <​alias>​base:/​7121aba0-5232-11e1-b86c-0800200c9a66/​passerelles</​alias>​ + <​alias>​base:/​7121aba0-5232-11e1-b86c-0800200c9a66/​passerelles</​alias>​ 
- <​alias>​base:/​e17a05b0-c45e-11d8-9669-0800200c9a66/​sitecoredem</​alias>​ + <​alias>​base:/​e17a05b0-c45e-11d8-9669-0800200c9a66/​sitecoredem</​alias>​ 
- <​scrutaridata-url freq="​1">​http://​www.coredem.info/​spip.php?​page=scrutaridata_passerelles</​scrutaridata-url>​ + <​scrutaridata-url freq="​1">​http://​www.coredem.info/​spip.php?​page=scrutaridata_passerelles</​scrutaridata-url>​ 
- <​info-url>​http://​docs.fichotheque.net/​coredem/​scrutari/​sitecoredem.scrutari-info.xml</​info-url>​ + <​info-url>​http://​docs.fichotheque.net/​coredem/​scrutari/​sitecoredem.scrutari-info.xml</​info-url>​ 
- </​source>​+    </​source>​
     <source name="​comedie">​     <source name="​comedie">​
         <​scrutaridata-url freq="​1">​http://​www.comedie.org/​scrutari/​comedie.scrutari-data.php</​scrutaridata-url>​         <​scrutaridata-url freq="​1">​http://​www.comedie.org/​scrutari/​comedie.scrutari-data.php</​scrutaridata-url>​
     </​source>​     </​source>​
- <source name="​multinationales">​ 
- <​info-url>​http://​sct1.scrutari.net/​data/​multinationales/​multinationales.scrutari-info.xml</​info-url>​ 
- </​source>​ 
 </​sources>​ </​sources>​
- 
 </​code>​ </​code>​
  
Ligne 77: Ligne 69:
         <​info-url>​http://​www.agter.asso.fr/​spip.php?​page=scrutari_entete&​amp;​id_exportscrutari=2</​info-url>​         <​info-url>​http://​www.agter.asso.fr/​spip.php?​page=scrutari_entete&​amp;​id_exportscrutari=2</​info-url>​
   </​source>​   </​source>​
 +</​code>​
 +
 +et l'​exemple de la Coredem avec l'​utilisation des deux éléments à la fois :
 +
 +<code xml>
 +<source name="​coredem">​
 + <​scrutaridata-url freq="​1">​http://​www.coredem.info/​spip.php?​page=scrutaridata_passerelles</​scrutaridata-url>​
 + <​info-url>​http://​docs.fichotheque.net/​coredem/​scrutari/​sitecoredem.scrutari-info.xml</​info-url>​
 +</​source>​
 </​code>​ </​code>​
  
Ligne 87: Ligne 88:
  
 //<​uri>//​ et //<​alias>//​ ont la même syntaxe : leur texte doit être un URI de base valide (l'​indication du protocole base: n'est pas obligatoire). //<​uri>//​ et //<​alias>//​ ont la même syntaxe : leur texte doit être un URI de base valide (l'​indication du protocole base: n'est pas obligatoire).
 +
 +Voici ci-dessous l'​exemple de la source Coredem qui fusionne les listes des revues Passerelles et la liste des sites membres de la Coredem. Initialement,​ ces deux données étaient gérées comme deux sources différentes avec des URI de bases distinctes. Le nouvel URI est //​base:/​coredem.info/​core//​.
 +
 +<code xml>
 +<source name="​coredem">​
 +    <​uri>​base:/​coredem.info/​core</​uri>​
 +    <​alias>​base:/​7121aba0-5232-11e1-b86c-0800200c9a66/​passerelles</​alias>​
 +    <​alias>​base:/​e17a05b0-c45e-11d8-9669-0800200c9a66/​sitecoredem</​alias>​
 +    <​scrutaridata-url freq="​1">​http://​www.coredem.info/​spip.php?​page=scrutaridata_passerelles</​scrutaridata-url>​
 +    <​info-url>​http://​docs.fichotheque.net/​coredem/​scrutari/​sitecoredem.scrutari-info.xml</​info-url>​
 +</​source>​
 +</​code>​
    
  
serveurscrutari/config/sources.1501673015.txt.gz · Dernière modification: 2017/08/02 13:23 par vincent
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0