Eurostat Online Help for Data Browser
Child pages
  • API Catalogue - utiliser les flux RSS

Qu’est le RSS ? Pourquoi est-il utilisé ?

RSS (Rich Site Summary) est un type de contenu web qui permet aux utilisateurs d’accéder aux mises à jour de contenu en ligne dans un format standardisé et lisible.

Dans le contexte de l’API, RSS fournit aux utilisateurs un moyen très simple d’être informés automatiquement des derniers changements sur les produits de données et listes de code publiés par Eurostat.

Comment accéder au contenu RSS ?

L’URL à utiliser pour accéder au flux RSS dépend de :

  • l’agence (exemple : Eurostat).

  • la langue. Il y a un contenu RSS pour chaque langue supportée :

    • Anglais

    • Allemagne

    • Français

Voici les Urls pour les flux RSS :

Comment et quand sont générés les fichiers RSS ?

Les fichiers RSS sont construit automatiquement, à chaque publication des données. Ils listent tous les changements qui ont été disséminés.

Les informations suivantes sont incluses :

  • Les opérations faites sur les ensembles de donnée pendant les 7 derniers jours (les évènements de la catégorie donnée, voir ci-dessous):

    • Création d’un ensemble de données

    • Mise à jour d’un ensemble de donnée

    • Suppression d’un ensemble de donnée

  • Les opérations faites sur les structures de donnée pendant les 7 derniers jours (les évènements de la catégorie structure de donnée, voir ci-dessous)

  • Les opérations faites sur les listes de code pendant les 7 derniers jours (les évènements de la catégorie liste de codes, voir ci-dessous) :

    • Création d’un nouveau code ou nouvelle position dans une liste de codes

    • Suppression d’un code ou d’une position dans une liste de codes

Quelle est la structure et le contenu d’un fichier de flux RSS ?

Chaque fichier RSS est construit avec la structure suivante :

  • L’entête : La première partie contient l’information Générale sur le fichier RSS

  • Les articles : La deuxième partie contient toutes les informations concernant les dernières mises à jour

Champs disponibles dans la partie entête

  • xml : version XML : version 1.0, encodage en UTF-8

  • version : Version du fichier RSS (2.0)

  • channel : Fichier qui contient un seul canal. Dans celui-ci les informations suivantes seront présentes :

    • title : Le titre du fichier RSS (Eurostat - Mises à jour des données et structures de donnée)

    • link : URL vers le fichier RSS

    • description : Description du flux RSS

    • language : Code de la langue du fichier RSS. Les codes existants sont :

      • en : Anglais

      • de : Allemand

      • fr : Français

    • copyright : Information de copyright

    • pubDate : Date la dernière mise à jour du fichier RSS (dans le format suivant: yyyy-MM-dd HH:mm:ss, exemple: 2018-09-25 12:45:18)

    • image

      • link : voir link ci-dessus

      • title : voir title ci-dessus

Champs disponibles dans la partie articles

Dans le fichier RSS, les articles sont triés dans un ordre spécifique :

  • Date du changement en ordre décroissant

  • Type de produit

    • Liste de code

      • Supprimé

      • Nouveau

      • Mis à jour

    • Ensemble de données (changement de donnée ou structure)

      • Supprimé

      • Nouveau

      • Mis à jour

  • Chaque sous-catégorie au point 2 est ensuite triée par ordre alphabétique.

Chaque article indique une modification de l’information contenue dans notre base de données. Chaque article contient les champs suivants :

  • title : Titre de l’article composé de l’identifiant et su type :

    • Identifier : L’ID de l’article en majuscules

    • Type : Le type d’évènement

  • description : Le titre de l’article (dans la langue choisie)

  • category : Le titre de l’article (dans la langue choisie) :

    • DELETED_CODE_LIST

    • NEW_CODE_LIST

    • UPDATED_CODE_LIST

    • DELETED_DATASET

    • NEW_DATASET

    • UPDATED_DATASET_STRUCTURE : dans le cas où uniquement l’annotation UPDATE_STRUCTURE a changée

    • UPDATED_DATASET_DATA : dans le cas où uniquement l’annotation UPDATE_DATA a changée

    • UPDATED_DATASET_STRUCTURE_DATA : dans le cas où les annotations UPDATE_STRUCTURE et UPDATE_DATA ont été changées

  • pubDate : La date et heure de la release (dans le format suivant: yyyy-MM-dd HH:mm:ss, exemple: 2018-09-25 12:45:18.17)

  • link : L’URL qui fournit un accès direct pour télécharger cet article en utilisant l’API :

    • Pour un ensemble de données : URL de la page produit de l’ensemble de données dans Data Browser

    • Pour une liste de code : Le lien de téléchargement de l’API en format TSV de la liste de code dans la langue du flux RSS

Le cas d’un renommage d’un code d’une liste de codes, d’une dimension ou d’un ensemble de données sera rapporté par le flux RSS comme deux événements séparés :

  1. Suppression de l’ancien nom

  2. Insertion du nouveau nom

Quels outils peuvent être utilisés pour manipuler le flux RSS ?

Les utilisateurs doivent s’inscrire au flux en utilisant un lecteur de flux RSS, ou un agrégateur, dans leur navigateur internet. Cet outil vérifiera les mises à jour et notifiera les utilisateurs quand des mises à jour ont été disséminées.

Il existe une variété de lecteurs disponibles et des nouvelles versions apparaissent constamment. La façon de s’inscrire est différente pour chaque lecteur. Celui choisi par l’utilisateur lui décrira la marche à suivre.

Dès que l’utilisateur aura téléchargé et installé le lecteur choisi, il devra suivre les instructions fournies par le lecteur de flux pour ajouter l’URL du flux désiré fourni dans la première section de la page.

Expand all   Collapse all
_