AgriFeeds

Aggregated News and Events on Agriculture

Lignes-Guide

Notice: The content of this page may be outdated at places, we are enhancing the service and some functionalities may behave differently. We will soon update this page accordingly.
 
01 - Comment créer un feed RSS

Un nombre croissant de sites mettent quotidiennement leur contenu à disposition en utilisant les « flux web ». En utilisant ces flux, les créateurs ont un moyen simple de syndiquer un contenu et les consommateurs, de se tenir à jour de leurs sites favoris sans avoir à les consulter un à un. Les flux contiennent en général une courte description du site et un lien pour accéder à l’article complet ou obtenir un complément d’informations. Les flux web utilisent les formats Really Simple Syndication (RSS) ou ATOM. Les deux formats sont rédigés en XML.


Il existe plusieurs moyens de créer un canal de flux RSS pour insérer une liste d’actualités et d’événements dans votre site ou dans le bulletin d’actualités de votre courrier électronique. Vous pouvez:

  • le créer entièrement avec le bloc-note (ce qui est un système simple dans certains cas, mais inefficace à long terme, par exemple, lorsque les personnes qui y travaillent n’ont pas la capacité de l’éditer en XML);
  • le construire à partir d’un outil autonome, tel que RSS Channel Editor; (exemple)
  • utiliser un outil logiciel pour « tamiser » le site et récupérer les informations les plus importantes qu’il y trouve;
  • utiliser votre système de gestion de contenu (Content Management System) si votre site le permet: les CMS disposent généralement de fonctionnalités pour exporter des données en RSS. Sinon, votre webmaster peut facilement écrire une fonction pour lire tous les contenus et créer une sortie RSS.

Il est certes possible que les outils logiciels ne soient pas suffisamment adaptables pour produire des métadonnées de qualité: il peut être difficile, voire même impossible, d’identifier le thème de certaines informations ou d’utiliser des espaces de noms supplémentaires. Pour créer un flux manuellement ou rédiger une procédure afin d’en créer un à partir de votre base de données ou CMS, vous devez bien connaître le format XML 1.0 et utiliser l’ensemble de métadonnées de l’un des standards de syndication RSS les plus utilisés:

AgriFeeds accepte les flux présentés aux formats RSS (1.0 et 2.0) et Atom. Il est obligatoire de fournir les éléments RSS suivants: titre, description, lien et date de publication (pubDate).


Il est possible d’ajouter des extensions aux formats précités à l’aide d’espaces de nom pour inclure des métadonnées plus spécifiques et informatives: AgriFeeds recommande d’utiliser l’espace de nom du Dublin Core pour soumettre tous les flux, et le Profil d’application des événements pour présenter les flux d’événements. Lorsque votre flux est prêt, vous devez le publier sur un serveur web afin qu’il soit accessible par l’URL du fichier. Vous pouvez alors indiquer cet URL à autant de lecteurs et d’agrégateurs d’actualités que vous le souhaitez.

02 - Comment soumettre un flux
Notice: The content of this section has changed, so the French translation became outdated. This is why you see the text in English..

Create an account in the RING (http://ring.ciard.net/user), log in, click on "Add a service / dataset" and provide.all the required information plus some technical information essential for AgriFeeds to pick up your feed:

  • Under "Content", select "RSS feed" as "Type of service";
  • Under "Access to data":
    • provide the URL of the RSS feed in "URL / target / endpoint";
    • under "Technical details", select "RSS" as protocol and:
      • "RSS core metadata set" as metadata set IF your feed is a normal RSS feed (if in doubt, choose this);.
      • "Ag Event Application profile" as metadata set IF your feed is a feed of events: technically, this means that the RSS feed must contain metadata elements from the Ag Event Application Profile (see our Gudelines for more details);.
      • "Ag Job Application profile" as metadata set IF your feed is a feed of jobs / vacancies: technically, this means that the RSS feed must contain metadata elements from the Ag Job Application Profile (see our Gudelines for more details);.
  • Under "Network", select "AgriFeeds" and under the AgriFeeds link specify if it is a news feed, an event feed or a job feed (considering the technical indications above about the Application profile: if in doubt, choose "News feed").
If you submitted a feed and you cannot see the items in AgriFeeds, this could mean one of the following: a) not all the required steps in the registration in the RING were followed; b) AgriFeeds still has to synchronize with the RING, wait for a few hours; c) AgriFeeds could not parse the RSS file at the URL you provided.
03 - Utiliser des espaces de nom supplémentaires et pourquoi

Vu que leur champ d’application est d’ordre général, les séries d’éléments de métadonnées RSS et Atom sont génériques. Il est toutefois possible d’ajouter des extensions en utilisant des espaces de nom supplémentaires pour inclure des métadonnées plus spécifiques et informatives. AgriFeeds utilise l’espace de nom AgMES pour ajouter des extensions aux flux. Afin d’analyser (lire correctement) les données et de fournir aux usagers des services de meilleure qualité, il faut tenir compte des directives de base ci-après.

Flux d’actualités

  • Indiquez toutes les métadonnées de base nécessaires pour les formats RSS ou Atom.
  • Lorsque cela est possible, indiquez les éléments tirés de l’espace de nom du Dublin Core si possible à l’aide d’AGROVOC ou d’un autre vocabulaire contrôlé; il est en effet généralement plus facile à compiler que l’élément RSS correspondant). Attention: si le format de la date n’est pas indiqué ou qu’il est incorrect, l’information risque de ne pas être publiée dans le bon ordre chronologique.
  • Flux d’événements

  • Indiquez toutes les métadonnées de base nécessaires pour les formats RSS ou Atom: titre, lien, description et date de publication (pubDate).
  • Précisez la date de commencement (ags:startDate) et de de fin de l’événement (ags:endDate) ainsi que les données concernant la disponibilité (ags:location et ses sous-éléments) tirés de l'espace de nom AgMES. Attention: si les noms des pays et /ou les dates (de commencement et de fin) ne sont pas indiqués ou qu’ils sont inexacts (les codes de pays ISO comportent trois lettres), les événements risquent de ne pas apparaître dans les recherches ou de ne pas être publiées dans le bon ordre chronologique.
04 - Comment vérifier qu’un flux a été accepté?

Avant de soumettre des flux à AgriFeeds, vérifiez qu’il sont conformes en utilisant le Validateur de flux. Cette étape est essentielle.

En plus des conditions de base requises pour un flux RSS, les éléments suivants sont obligatoires:

A)
• (RSS) Titre
• (RSS) Lien
• (RSS) Description
• (RSS) Date de publication (pubDate)

En outre, les éléments/raffinements complémentaires suivants sont obligatoires pour décrire les événements:

B)
• (AGS) Date de commencement
• (AGS) Date de fin
• (AGS) Ville
• (AGS) Pays
(Ne soumettez votre flux comme flux d’actualités que si ces éléments sont indiqués et présentés au format demandé).

Si les conditions requises en A) ne sont pas remplies, votre flux risque ne pas être téléchargé.

Si les conditions supplémentaires requises ne sont pas remplies (voir nos Directives), les informations risquent de ne pas être publiées au bon endroit ou dans le bon ordre chronologique.

Les espaces de nom dont sont issus les éléments sont indiqués entre parenthèses. Pour de plus amples informations sur les éléments, consultez:
• AGS: http://www.fao.org/aims/
• RSS: http://purl.org/net/rss1.1

05 - Quel est l’ensemble minimum de métadonnées nécessaire pour créer un flux d’événements valide?

Le Profil d’application des événements fournit les éléments nécessaires à la description détaillée des événements. Il est toutefois parfois impossible d’obtenir toutes les informations concernant un événement donné. Lorsque vous créez un flux d’événements, les champs les plus importants à remplir sont les suivants:

  • ags:dateStart
  • ags:dateEnd
  • ags:location (ags:locationCity, ags:locationCountry)

Pour illustration, consultez un fichier échantillon. Dans le champ ags:locationCountry, insérez le code de pays ISO composé de trois lettres.

Rappelez-vous aussi qu’en plus des éléments de base nécessaires pour un flux RSS, les éléments/raffinements suivants sont obligatoires pour tous le types de flux:

• (RSS) Titre
• (RSS) Lien
• (RSS) Description
• (RSS) Date de publication (pubDate)

 

06 - Outre les éléments obligatoires, quels sont les autres éléments acceptés par AgriFeeds?

AgriFeeds accepte les éléments suivants:

 Source: AGS:

       <ags:organizer>Global Forum on Agricultural Research (GFAR)</ags:organizer>


Source DC:

       <dc:title xml:lang="en">Inter-Regional Consultation on ICM4ARD</dc:title>
      <dc:description xml:lang="en">2007-09-26 - 2007-09-26 Rome, ITA</dc:description>
      <dc:subject xsi:type="ags:AGROVOC" xml:lang="en">International cooperation</dc:subject>
      <dc:subject xsi:type="ags:AGROVOC" xml:lang="en">Agricultural research</dc:subject>
      <dc:subject xsi:type="ags:AGROVOC" xml:lang="en">Agricultural policies</dc:subject>
      <dc:identifier xsi:type="dcterms:URI">http://www.egfar.org/egfar/website/action/GFARevents/eventsitem?contentId=1736</dc:identifier>

 
Cela ne garantit pas toutefois que les éléments soient correctement analysés ou compris dans la mesure où seuls les éléments obligatoires sont analysés et inclus dans les fonctionnalités de filtrage et de navigation.

Facilitated by
Facilitated by FAO Facilitated by GFAR
AgriFeeds partners
CGIAR CTA FAO GFAR GFIS IAALD
Supporting CIARD