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:syndication [2013/11/22 12:52]
vincent
serveurscrutari:syndication [2022/07/01 17:12]
vincent
Ligne 1: Ligne 1:
-====== ​Fils de syndication ======+====== ​Flux de syndication ======
  
-Le serveur ​Scrutari propose trois types de fil de syndication différents pour être tenu informé des nouvelles entrées dans le serveur. Ces trois fils sont au format Atom. Ils sont accessibles via une adresse décomposée comme suit :+Un moteur ​Scrutari propose trois types de flux de syndication différents pour être tenu informé des nouvelles entrées dans le moteur plus un flux pour les erreurs. Ces quatre flux sont au format Atom. Ils sont accessibles via une adresse décomposée comme suit :
  
-///​feed/​{nom du fil}(-{options du flux})_{langue d'​interface}.atom//​+//{adresse du moteur}/feed/{nom du flux}(-{options du flux})_{langue d'​interface}.atom//​
  
 Les options sont exprimées sous la forme d'une série de lettres accolées, à chaque lettre correspond une option (sur le même principe que les arguments d'une ligne de commande). La langue de l'​interface est le code ISO classique de la langue qui doit être utilisé de préférence pour les intitulés. Les options sont exprimées sous la forme d'une série de lettres accolées, à chaque lettre correspond une option (sur le même principe que les arguments d'une ligne de commande). La langue de l'​interface est le code ISO classique de la langue qui doit être utilisé de préférence pour les intitulés.
  
-===== Type de fil =====+L'​interface d'​administration propose à l'​onglet « syndication » un outil pour construire l'URL du flux en fonction des options.
  
-Les trois fils diffèrent par le format et le nombre des entrées fournies par le fil. Ces fils sont les suivants :+===== Type de flux =====
  
-  * //tree// : le fil comprend une entrée unique par mise à jour avec comme contenu les fiches ​et les mots-clés organisés suivant les bases, corpus et thésaurus d'​origine ; ce fil est adapté pour un suivi interne de l'​évolution du contenu d'un moteur Scrutari ; le fil contient l'​entrée de la dernière mise à jour ainsi que les entrées ​de la dizaine de mises à jour précédentes +Les trois flux diffèrent par le format ​et le nombre des entrées ​fournies ​par le flux. Ces flux sont les suivants :
-  * //classes// : équivalent au fil //tree// (une seule entrée ​par mise à jour) mais les fiches sont regroupées par classe de corpus ; ce fil n'a évidemment d'​intérêt que si des classes de corpus sont définies dans le moteur Scrutari +
-  * //fiches// : le fil propose une entrée par fiche ajoutée dans le moteur ; seules les nouvelles fiches de la dernière mise à jour sont indiquées ; le contenu d'une entrée reprend ​les données d'une fiche (titre, sous-titre, champs complémentaires,​ attributs, mot-clé) et le lien de l'​entrée pointe sur l'​adresse de la fiche ; ce fil est le plus « lisible », c'est probablement celui qu'il faut privilégier à destination du public+
  
-==== Les options ====+  * //tree// : le flux comprend une entrée unique par mise à jour avec comme contenu les fiches et les mots-clés organisés suivant les bases, corpus et thésaurus d'​origine ; ce flux est adapté pour un suivi interne de l'​évolution du contenu d'un moteur Scrutari ; le flux contient l'​entrée de la dernière mise à jour ainsi que les entrées de la dizaine de mises à jour précédentes 
 +  * //​categories//​ : équivalent au flux //tree// (une seule entrée par mise à jour) mais les fiches sont regroupées par catégorie ; ce flux n'a évidemment d'​intérêt que si des catégories de corpus sont définies dans le moteur Scrutari 
 +  * //fiches// : le flux propose une entrée par fiche ajoutée dans le moteur ; seules les nouvelles fiches de la dernière mise à jour sont indiquées ; le contenu d'une entrée reprend les données d'une fiche (titre, sous-titre, champs complémentaires,​ attributs, mot-clé) et le lien de l'​entrée pointe sur l'​adresse de la fiche ; ce flux est le plus « lisible », c'est probablement celui qu'il faut privilégier à destination du public 
 +  * //errors// : flux des erreurs rencontrées au moment de la mise à jour du moteur
  
-Les options ​sont indiquées à l'aide d'une série de lettre à la suite du type de fil. Les options ne s'​appliquent pas forcément à tous les types. Les options sont les suivantes :+===== Les options ​=====
  
-  * //f// : n'​indiquer que les fiches dans les nouveautés (les nouveaux mots-clés ​sont ignorés) (//tree//, //​classes//​) +Les options ​sont indiquées à l'aide d'une série de lettre ​à la suite du type de flux. Les options ne s'appliquent pas forcément à tous les types. Les options sont les suivantes :
-  * //s// : ajouter le sous-titre (//tree//, //​classes//​) +
-  * //c// : ajouter les champs complémentaires (//tree//, //​classes//​) +
-  * //m// : ajouter les mots-clés (//tree//, //​classes//​) +
-  * //i// : ajouter ​l'icone de la fiche (//tree//, //​classes//​) +
-  * //h// : le texte XML est indenté, utile à des fins de débogage (tous les fils) +
-  * //v// : demande que le titre de chaque entrée soit sous la forme d'une série de variables, ​à utiliser ​s'il fait l'​objet d'un post-traitement (//tree//, //​classes//​)+
  
 +  * //f// : n'​indiquer que les fiches dans les nouveautés (les nouveaux mots-clés sont ignorés) (//tree//, //​categories//​)
 +  * //s// : ajouter le sous-titre (//tree//, //​categories//​)
 +  * //i// : ajouter l'​icone de la fiche (//tree//, //​categories//​)
 +  * //h// : le texte XML est indenté, utile à des fins de débogage (tous les flux)
 +  * //v// : demande que le titre de chaque entrée soit sous la forme d'une série de variables, à utiliser s'il fait l'​objet d'un post-traitement (//tree//, //​categories//​)
  
-==== Le filtre de recherche ==== 
  
-Le fil //fiches// a ceci de particulier qu'il accepte les mêmes paramètres ​ 
  
-=== Exemples ===+==== Exemples ​====
  
 Pour la Coredem : Pour la Coredem :
  
- * http://​sct1.scrutari.net/​sct/​coredem/​feed/​classes-fiv_fr.atom : fil avec une entrée par mise à jour, les fiches sont regroupées par classe ​de corpus, les mots-clés ne sont pas ajoutés (option //f//), les icones des fiches sont indiquées (option //i//), le titre de l'​entrée indique le nombre de fiches de l'​entrée (option //v//), les intitulés sont en français +  ​* http://​sct1.scrutari.net/​sct/​coredem/​feed/​categories-fiv_fr.atom : flux avec une entrée par mise à jour, les fiches sont regroupées par catégories ​de corpus, les mots-clés ne sont pas ajoutés (option //f//), les icones des fiches sont indiquées (option //i//), le titre de l'​entrée indique le nombre de fiches de l'​entrée (option //v//), les intitulés sont en français 
- * http://​sct1.scrutari.net/​sct/​coredem/​feed/​fiches_en.atom : fil des nouveautés avec une fiche par entrée, intitulés en anglais  +  * http://​sct1.scrutari.net/​sct/​coredem/​feed/​fiches_en.atom : flux des nouveautés avec une fiche par entrée, intitulés en anglais  
- *+ 
 +===== Filtrer les fiches par une recherche ===== 
 + 
 +Le flux //fiches// a ceci de particulier qu'il accepte les mêmes paramètres de recherche que la requête JSON [[serveurscrutari:​json:​type_qfiche|q-fiche]]. Lorsqu'​une recherche est ainsi définie, un filtre est appliqué aux entrées du flux de syndication : seules les fiches répondant au critère de recherche sont insérées dans le flux (ce qui peut conduire à un flux vide). 
 + 
 +==== Exemple ==== 
 + 
 +  ​http://​sct1.scrutari.net/​sct/​coredem/​feed/​fiches_fr.atom?​q=economie : flux des nouveautés qui traite de l'​économie 
 + 
 + 
 +===== Filtrer les fiches par l'​identifiant d'une recherche ​ ===== 
 + 
 +Un flux peut également être filtré en se basant sur les paramètres d'une recherche existante (paramètre //qid//). Cela permet d'​éviter une URL complexe si les critères de recherche sont multiples. En outre, le flux admet le paramètre //all// qui indique que **toutes** les fiches de la recherche doivent être incluses dans le flux. Cela permet à un internaute de retrouver l'​intégralité de sa recherche dans son agrégateur tout en bénéficiant par la suite des nouveautés. Le paramètre //all// peut avoir les valeurs suivantes : 
 +  * //always// : toutes les fiches sont toujours rajoutée 
 +  * une date au format ISO (Année-Mois-Jour) : toutes les fiches sont incluses lors de l'​appel à cette date et au jour suivant, ensuite, seules les nouveautés sont incluses. 
 + 
 +==== Exemple ==== 
 + 
 +  * Voir l'URL du lien « flux de syndication ATOM » après voir effectué une recherche sur http://​scrutarijs.coredem.info/​coredem 
 + 
 +===== Filtrer les fiches par les filtres ​ ===== 
 + 
 +Qu'il soit ou non filtré préalablement par une recherche, le flux //fiches// peut être filtré par les filtres définis dans [[serveurscrutari:​json:​filtersyntax|Syntaxe des filtres]] ainsi que les paramètres //​langlist//​ (liste de langue) et //​corpuslist//​ (liste de corpus). 
 + 
 +==== Exemple ==== 
 + 
 +  * http://​sct1.scrutari.net/​sct/​coredem/​feed/​fiches_fr.atom?​langlist=fr : flux des nouveautés en français uniquement
serveurscrutari/syndication.txt · Dernière modification: 2022/07/01 17:12 par vincent
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0