Différences

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

--- serveurscrutari:config:uricodes [2016/07/06 17:43]
vincent ↷ Liens modifiés en raison d'un déplacement.
+++ serveurscrutari:config:uricodes [2016/07/18 11:24] (Version actuelle)
vincent
@@ Ligne 1: / Ligne 1: @@
 ====== Fichier uri-codes.xml : préétablir le code des URI ======
-Les différents contenus du format ScrutariData sont identifiés de façon certaine à l'aide d'un URI (pour plus de précision, voir [[scrutaridata:uri|UUID et URI]]). Comme cet URI est assez long, le serveur ne l'utilise pas en interne : il attribute un code (un entier strictement positif) à chaque URI et c'est ce code qu'il manipule à la place. Ce code se retrouve d'ailleurs toujours dans les résultats des requêtes JSON. L'attribution d'un code à une URI n'est pas pérenne, elle peut changer à chaque mise à jour du serveur car elle se fait dans l'ordre de lecture des fichiers ScrutariData. C'est pourquoi il faut utiliser les URI dès qu'il faut conserver les informations.
+Les différents contenus du format ScrutariData sont identifiés de façon certaine à l'aide d'un URI (pour plus de précision, voir [[scrutaridata:uri|URI]]). Comme cet URI peut être assez long, le serveur ne l'utilise pas en interne : il attribute un code (un entier strictement positif) à chaque URI et c'est ce code qu'il manipule à la place. Ce code se retrouve d'ailleurs toujours dans les résultats des requêtes JSON. D'une mise à jour à l'autre, le serveur essaie d'attribuer le même code à une URI mais cette opération n'est pas garantie : un déplacement du serveur, une réinitialisation en profondeur peuvent supprimer cette association. C'est pourquoi la conservation des informations doit se faire via les URI.
 Cependant, pour certains contenus comme la définition des bases, des corpus et des thésaurus, il peut être avantageux d'être sûr de la pérennité de l'attribution des codes : cela permet de manipuler de simples entiers plutôt que de longues chaines (par exemple, dans les paramétrages). Les requêtes JSON peuvent recevoir aussi bien des codes que des URI quand il s'agit de lister du contenu (par exemple, les mots-clés lorsqu'il s'agit d'un filtre sur l'indexation).
 C'est l'objectif du fichier de configuration //uri-codes.xml// de proposer cette pérennité. Ce fichier n'est pas obligatoire. Il se présente très simplement sous forme d'une liste d'URI avec le code qu'il lui est attribué. Les doublons (code attribué deux fois ou URI avec des codes différents) ne déclenchent pas d'erreurs et sont signalés sous forme d'avertissement.
+La numérotation automatique des URI commençant à partir de 1001, les codes de 1 à 1 000 peuvent donc être attribué librement sans risque de conflit.
 Note : toute modification des codes ne sera pris en compte qu'après la relance du moteur (ou après la mise à jour quotidienne).
 ===== Structure du format XML =====