Utilisation des valves, génération du site web de l'ULB - format xml
sommairesommaireindexindexdébutdébutpage précédentepage précédentepage suivantepage suivanteimprimerimprimerenvoyerenvoyermarquermarquer

Sélection des informations

Par défaut, toutes les informations de la source seront affichées. Il est possible d'effectuer une sélection sur base des critères suivants:


Sélection par catégories

Chaque source peut définir une ou plusieurs familles de catégories, et chaque information peut être classée dans une ou plusieurs catégories, et ce dans chacune des familles en question.

Parmi ces familles, une joue le rôle principal. La famille principale s'utilise sans identificateur, tandis que les autres familles s'utilisent avec un identificateur.

Le nombre de familles ainsi que leur identificateur dépendent de la source. Dans Babelbox, par exemple, il existe deux familles publics et classements à coté de la famille principale.

Pour sélectionner des informations classées dans une catégorie, on utilise l'attribut catégories contenant le nom de la catégorie recherchée (si elle fait partie de la famille principale) ou le nom de la catégorie précédé de l'identificateur de la famille et d'un ':' (si elle fait partie d'une famille autre que la famille principale).

Cet attribut est à placer sur les éléments <source-rss>, <source-babelbox>, <source-xml> et <source-difusion>.

Exemples:

  • catégories="Enseignement": on recherche les informations dans la catégorie Enseignement de la famille principale;

  • catégories="publics:chercheur": on recherche les informations dans la catégorie chercheur de la famille publics;

Pour sélectionner des informations classées dans plusieurs catégories, on mentionne les noms de ces catégories séparés par le caractère | (barre verticale).

Si on sélectionne plusieurs catégories dans la même famille (par exemple Recherche|Enseignement) on prendra toutes les informations présentes dans l'une ou l'autre de ces catégories (toutes les actualités de la catégorie Recherche OU de la catégorie Enseignement).

Par contre, si on sélectionne des informations dans des catégories de familles différentes (exemple catégories="Recherche|public:chercheur"), on prendre toutes les informations présentes dans chacune de ces catégories (toutes les actualités présentes à la fois dans la catégorie Recherche ET dans la catégorie publics:chercheur).

Comment les sources gèrent les catégories:


Dans cet exemple, on prendra les actualités uniquement dans la catégorie "Recherche" de la famille principale.

Remarque: Si vous faites afficher les catégories, seules les catégories recherchées seront affichées.

Dans cet exemple, la première actualité se trouve dans deux catégories: "Recherche" et "Enseignement". Comme cette dernière n'est pas recherchée, elle n'est pas affichée.

Exemple
<valves maximum="3" style="class1">
   <affichage>
      <catégories préfixe="Catégories: "/><titre/><aperçu/>
   </affichage>
   <source-babelbox box="1" type="actualité" catégories="Recherche"/>
</valves>
loading...ajax1

Dans cet exemple, on prendra les actualités dans les catégories "Recherche" et "Enseignement" de la famille principale.

Comme ces deux catégories appartiennent à la même famille, c'est un OU qui s'applique (la catégorie "Recherche" OU la catégorie "Enseignement").

Remarquez que, contrairement à l'exemple précédent, les deux catégories sont maintenant affichées car elles sont toutes les deux recherchées.

Exemple
<valves maximum="3" style="class1">
   <affichage>
      <catégories préfixe="Catégories: "/><titre/><aperçu/>
   </affichage>
   <source-babelbox box="1" type="actualité" catégories="Recherche|Enseignement"/>
</valves>
loading...ajax2

Dans cet autre exemple, on prendra les actualités de la catégorie checheur de la famille publics.

Exemple
<valves maximum="3" style="class1">
   <affichage>
      <catégories id="publics" préfixe="Publics: "/><titre/><aperçu/>
   </affichage>
   <source-babelbox box="1" type="actualité" catégories="publics:chercheur"/>
</valves>
loading...ajax3

Dans cet exemple, on recherchera les actualité dans la catégorie Recherche ainsi que dans la catégorie chercheur de la famille publics.

Comme ces deux catégories appartiennent à des familles différentes, c'est un ET qui s'applique (les actualités doivent appartenir à la catégorie "Recherche" ET à la catégorie "publics:chercheur").

Exemple
<valves maximum="4" style="class1">
   <affichage>
      <groupe>
         <catégories préfixe="Catégories: "/>
         <sep/>
         <catégories id="publics" préfixe="Publics: "/>
      </groupe>
      <titre/>
      <aperçu/>
   </affichage>
   <source-babelbox box="37" catégories="Recherche|publics:chercheur" type="actualité"/>
</valves>
loading...ajax4

L'exemple ci-contre va chercher un maximum de 4 actualités dans le fil RSS "Culture" du journal Le Soir. Seules les catégories "Cinéma" et "Musiques" sont sélectionnées, grâce à l'attribut catégories.

Les informations seront prises dans l'ordre de leur diffusion. Il est donc possible que si les quatre premières informations rencontrées appartiennent à la catégorie "Cinéma". Dans ce cas, aucune information de la catégorie "Musiques" ne sera affichée.

Exemple
<valves maximum="4" style="class1">
   <affichage>
      <catégories/><titre/><aperçu/>
   </affichage>
   <source-rss href=http://www.lesoir.be/feed/Culture/destination_principale_block"
               catégories="Cinéma|Musiques"/>
</valves>
loading...ajax5

Pour s'assurer d'une meilleure répartition des informations entre les catégories, vous pouvez mentionnez plusieurs fois la même source avec un attribut maximum.

Dans cet exemple-ci, on aura une alternance d'un actualité "Cinéma" suivi d'une actualité "Musiques" et ainsi de suite, car on a fixé sur chaque source le nombre maximum à 1.

Exemple
<valves maximum="4" style="class1">
   <affichage>
      <catégories/><titre/><aperçu/>
   </affichage>
   <source-rss href="http://www.lesoir.be/feed/Culture/destination_principale_block"
               catégories="Cinéma" maximum="1"/>
   <source-rss href="http://www.lesoir.be/feed/Culture/destination_principale_block"
               catégories="Musiques" maximum="1"/>
</valves>
loading...ajax6

Sélection par identificateurs

Chaque information possède un identificateur. Il est donc possible de sélectionner une ou plusieurs informations sur base de cet identificateur, grâce à l'attribut identificateurs. Si cet attribut n'est pas présent, toutes les informations seront utilisées.

La valeur de cet attribut est soit l'identificateur d'une information, soit une liste d'identificateurs séparés par le caractère | (barre verticale).

Comment les sources gèrent les identificateurs:


L'exemple ci-contre va chercher l'information dont l'identificateur est lune.

Exemple
<valves style="class1">
   <source-xml href="http://www.ulb.ac.be/cache/news-test1.xml" 
               identificateurs="lune"/>                 
</valves>
loading...ajax7

L'exemple ci-contre va chercher les informations dont l'identificateur est lune et bidon-sauveur.

Exemple
<valves style="class1">
   <source-xml href="http://www.ulb.ac.be/cache/news-test1.xml" 
               identificateurs="lune|bidon-sauveur"/>                 
</valves>
loading...ajax8

L'exemple ci-contre va chercher une publication particulière du matricule 25761.

Remarquez ici que DI-Fusion utilise des identificateurs qui prennent la forme d'une URL.

Exemple
<valves style="class1">
   <source-difusion matricule="25761" 
       identificateurs="http://hdl.handle.net/2013/ULB-DIPOT:oai:dipot.ulb.ac.be:2013/137534"/>
</valves>
loading...ajax9

Sélection par mots-clés

L'attribut mots-clés="..." sélectionne des informations en fonction d'un ou plusieurs mots-clés. Les mots-clés en question seront recherchés dans le titre, le résumé et le contenu des informations.


L'exemple ci-contre va chercher toutes les informations contenant le mot "bétonnière".

Exemple
<valves style="class1">
   <source-babelbox box="37" type="actualité" mots-clés="bétonnière"/>                 
</valves>
loading...ajax10

L'exemple ci-contre va chercher toutes les informations contenant les mots "bière" et "homme".

Exemple
<valves style="class1">
   <source-babelbox box="37" type="actualité" mots-clés="bière|homme"/>                 
</valves>
loading...ajax11

L'exemple ci-contre va chercher toutes les informations contenant les mots "Colomb", "bidon" et "inconnu".

Dans le cas de la première actualité, le mot-clé "inconnu" se cache dans le contenu de l'actualité, qui ne sera visible que si vous cliquez sur le résumé.

Exemple
<valves style="class1">
   <affichage>
      <résumé>
         <titre/><aperçu/>
      </résumé>
      <titre/><vignette/><contenu/>         
   </affichage>
   <source-xml href="http://www.ulb.ac.be/cache/news-test1.xml"
               mots-clés="Colomb|bidon|inconnu"/>                 
</valves>
loading...ajax12

L'exemple ci-contre va chercher toutes les publications de M. Blanpain (matricule 25761) contenant le mot-clé "skin".

Les publications sont présentées dans des onglets, quatre par quatre.

Exemple
<valves style="class6" onglets="détachés" délai-transition="manuel" maximum-par-onglets="4">
   <affichage>
      <résumé>
         <titre/><aperçu/>
      </résumé>
      <titre/><vignette/><contenu/>         
   </affichage>
   <source-difusion matricule="25761" mots-clés="skin"/>
</valves>
loading...ajax13

Sélection par codes

Une information peut éventuellement posséder un code, placé entre crochets au début du titre de l'information. Cette technique est surtout utilisée dans une source Babelbox ou une source xml.

Par exemple, si vous encodez une actualité dont le titre est "[une]Colomb découvre l'amérique", vous pourrez facilement retrouver cette information en utilisant le code "une". Bien entendu, ce code ne sera pas visible lors de la publication de cette information.

La recherche s'effectuera grâce à l'attribut codes.

La valeur de cet attribut est soit le code d'une information, soit une liste de codes séparés par le caractère | (barre verticale).


L'exemple ci-contre va chercher l'information dont le code est bidon.

Pour que cela fonctionne, il faut que le titre de l'actualité commence par les caractères "[bidon]".

Ce code entre crochets est bien entendu retiré du titre avant d'afficher ce dernier.

Exemple
<valves style="class1">
   <source-xml href="http://www.ulb.ac.be/cache/news-test1.xml" codes="bidon"/>                 
</valves>
loading...ajax14

L'exemple ci-contre va chercher les informations dont le code est une et info.

Dans le Babelbox utilisé, deux actualités ont un titre qui commence par "[une]" et une seule par "[info]".

Exemple
<valves style="class1">
   <source-babelbox box="37" codes="une|info" type="actualité"/>           
</valves>
loading...ajax15

Bien entendu, si aucune information ne possède un titre commencant par le code en question, rien ne sera affiché.

Dans l'exemple ci-contre, il n'y a aucune information dont le titre commence par [tralala], donc rien ne sera affiché.

Exemple
<valves style="class1">
   <source-xml href="http://www.ulb.ac.be/cache/news-test1.xml" codes="tralala"/>                 
</valves>
loading...ajax16

Sélection par date

Plusieurs dates sont associées aux informations:

  • une date de publication;

  • une date de dernière modification;

  • une date de début (pour des événements);

  • une date de fin (pour des événements);

L'attribut dates-publication permet de faire une sélection sur base de la date de publication, qui devra être supérieure ou égale à une date de début et/ou inférieure ou égale à une date de fin.

L'attribut dates-modification permet de faire une sélection sur base de la date de modification, qui devra être supérieure ou égale à une date de début et/ou inférieure ou égale à une date de fin.

L'attribut dates permet de faire une sélection sur base de la date de début et de la date de fin, qui devront être supérieures ou égales à une date de début et/ou inférieures ou égales à une date de fin.

Ces trois attributs utilisent une virgule pour séparer la date de début et la date de fin. On peut préciser uniquement une date de début (pas de virgule nécessaire), une date de début et une date de fin (la virgule sépare les deux dates) ou uniquement une date de fin (la virgule est nécessaire et précède cette date de fin).

Par exemple:

  • 1/1/2012,31/12/2012: recherche toutes les informations entre le premier janvier 2012 et le 31 décembre 2012 (ces deux dates comprises);

  • 1/1/2012,: recherche toutes les informations à partir du premier janvier 2012 (cette date comprise);

  • 1/1/2012: idem;

  • ,31/12/2012: recherche toutes les informations antérieures au 31 janvier 2012 (cette date comprise);

Les dates peuvent être données au format européen (JJ/MM/AAAA) ou américain (AAAA-MM-DD).

Les dates peuvent également être remplacées par des valeurs entières, positives ou négatives. Dans ce cas, elles se réfèrent à la date du jour augmentée ou diminuée d'un certain nombre de jours donné par cette valeur.

Par exemple:

  • 0,7: recherche toutes les informations entre aujourd'hui et les sept jours qui suivent;

  • -6,+1: recherche toutes les informations entre la semaine passé (aujourd'hui moins six jours) et demain (aujourd'hui plus un jour);

Comment les sources gèrent les dates:


Dans cet exemple, on prendra toutes les actualités dont la date de publication est comprise entre les sept jours précédents et les sept jours qui suivent.

Exemple
<valves style="class1" onglets="accolés" maximum-par-onglets="3" délai-transition="manuel">
   <affichage>
      <titre/>
      <date-publication/>
      <aperçu/>
   </affichage>
   <source-babelbox box="1" type="actualité" dates-publication="-7,+7"/>
</valves>
loading...ajax17

Dans cet exemple, on prendra toutes les actualités du jour et des 30 jours qui précèdent.

Exemple
<valves style="class1" onglets="accolés" maximum-par-onglets="3" délai-transition="manuel">
   <affichage>
      <titre/>
      <date-publication/>
      <aperçu/>
   </affichage>
   <source-babelbox box="1" type="actualité" dates-publication="-30"/>
</valves>
loading...ajax18

Dans cet exemple, on prendra toutes les actualités dont la date de publication est comprise entre le XVe et le XXe siècle.

Exemple
<valves style="class1" onglets="accolés" maximum-par-onglets="3" délai-transition="manuel">
   <affichage>
      <titre/>
      <date-publication/>
      <aperçu/>
   </affichage>
   <source-xml href="http://www.ulb.ac.be/cache/news-test1.xml" dates-publication="1/1/1400,31/12/1599"/>
</valves>
loading...ajax19

Dans cet exemple, on prendra toutes les actualités dont la date de publication est antérieure au 1/1/1990.

Exemple
<valves style="class1" onglets="accolés" maximum-par-onglets="3" délai-transition="manuel">
   <affichage>
      <titre/>
      <date-publication/>
      <aperçu/>
   </affichage>
   <source-xml href="http://www.ulb.ac.be/cache/news-test1.xml" dates-publication=",1/1/1990"/>
</valves>
loading...ajax20

Dans cet exemple, on prendra toutes les actualités dont la date de publication est postérieure au 1/1/1990.

Exemple
<valves style="class1" onglets="accolés" maximum-par-onglets="3" délai-transition="manuel">
   <affichage>
      <titre/>
      <date-publication/>
      <aperçu/>
   </affichage>
   <source-xml href="http://www.ulb.ac.be/cache/news-test1.xml" dates-publication="1/1/1990"/>
</valves>
loading...ajax21

Sélection par priorités

Certaines sources associent une priorité aux informations. Dans ce cas, vous pouvez grâce à l'attribut priorities="..." sélectionner les informations à afficher en fonction de leur priorité. Seules les informations dont la priorité est supérieure ou égale à la valeur mentionnée seront affichée.

Si cet attribut n'est pas présent, la valeur supposée est 1, ce qui revient à sélectionner toutes les informations quelle que soit leur priorité.

Comment les sources gèrent la priorité:

L'exemple ci-contre va chercher toutes les informations de priorité 1 et supérieure (ce qui revient à afficher toutes les priorités).

Exemple
<valves style="class1">
   <source-babelbox box="37" type="actualité" priorités="1"/>                 
</valves>
loading...ajax22

L'exemple ci-contre va chercher toutes les informations de priorité 2 et supérieure.

Exemple
<valves style="class1">
   <source-babelbox box="37" type="actualité" priorités="2"/>                 
</valves>
loading...ajax23

L'exemple ci-contre va chercher toutes les informations de priorité 3 et supérieure.

Exemple
<valves style="class1">
   <source-babelbox box="37" type="actualité" priorités="3"/>                 
</valves>
loading...ajax24
ULB - entreprise écodynamique