Banque de données de l’IITA

À propos de la banque de données de l’IITA

La version 3 de la banque de données de l’IITA permet d’accéder aux données relatives aux ressources et aux résultats publiées par les organisations, conformément à la norme de l’IITA.

• Actualisation dynamique des données dès leur mise à disposition via le registre de l’IITA. Nous avons pour objectif de traiter toutes les données dans les 24 heures suivant leur mise à disposition.
• Disponibilité de toutes les données valides (c’est-à-dire conformes au schéma de l’IITA pour les données XML) aux formats JSON, CSV et XML.
• Possibilité pour les utilisateurs de rechercher des données de l’IITA à partir de tous les éléments et attributs figurant dans la norme.
• Possibilité de rechercher des données de l’IITA et de les exporter dans l’un des trois formats CSV suivants :
  • Une activité par ligne
  • Une transaction par ligne
  • Un budget par ligne

Accès à la banque de données de l’IITA

Il est possible d’accéder aux données de l’IITA par deux moyens :

• la recherche dans la banque de données de l’IITA
  • la recherche dans la banque de données de l’IITA. Il s’agit de l’interface utilisateur de la banque de données, qui offre des fonctionnalités intuitives de recherche simple et avancée. Toutes les données peuvent être téléchargées aux formats XML, JSON et CSV, ou CSV converti en fichier Excel (plus convivial) sans pagination.
  • La recherche simple fonctionne de la même manière que les moteurs de recherche habituels et permet aux utilisateurs de rechercher rapidement dans les éléments de langage naturels de l’IITA tout mot ou toute expression qui les intéresse.
  • La recherche avancée permet aux utilisateurs de filtrer les résultats de leur recherche en fonction d’un élément de l’IITA et de créer avec ces filtres des chaînes formant des requêtes complexes qui peuvent être enregistrées dans un fichier.
• API de la version 3 de la banque de données de l’IITA
  • Les utilisateurs techniques peuvent faire des requêtes sur des données stockées dans la banque de données de l’IITA via l’API publique. La version 3 de l’API est disponible sur la plateforme unifiée de l’IITA :
  • Accéder à l’API
  • Comment créer un compte pour obtenir une clé API

Quelles sont les données accessibles ?

La banque de données de l’IITA permet d’accéder aux données publiées par les organisations ayant utilisé la version 2 de la norme de l’IITA. Cela fait suite à la décision des membres de l’IITA de déclasser la version 1 de la norme, entrée en vigueur en juillet 2019.

Afin de garantir la qualité des données accessibles aux utilisateurs, la banque de données ne détient aucune information non conforme au schéma de l’IITA. Ce dernier définit l’ordre et le format exacts que les signataires doivent respecter lorsqu’ils soumettent leurs fichiers XML. De plus amples informations sur le schéma de l’IITA sont disponibles sur la page qui lui est consacrée sur le site de l’IITA.

Les fichiers considérés par l’outil de validation de l’IITA comme non valides, car présentant des erreurs critiques, ne figurent pas dans la banque de données de l’IITA.

Sous quels formats puis-je accéder aux données ?

La banque de données de l’IITA vous permet de convertir les fichiers de données de l’IITA, publiés à l’origine au format XML, en deux autres formats : CSV et JSON. Toutes les données de la banque de données sont filtrées et extraites à partir des activités de l’IITA. À noter toutefois une exception lors de la conversion des données au format CSV : vous pouvez également extraire les données par budget et par transaction.

En résumé, vous pouvez extraire les données :

• au format XML – la banque de données renvoie les activités au format XML original. Toutes les informations initialement publiées sont affichées, ainsi que les métadonnées comprises dans le résultat au format XML.
• au format JSON – la banque de données convertit les données initialement publiées au format XML au format JSON. Toutes les informations initialement publiées sont affichées, ainsi que les métadonnées comprises dans le résultat au format XML. Vous pouvez sélectionner les objets dans un fichier JSON de manière à ce qu’ils représentent des activités, budgets ou transactions individuels.
• au format CSV – la banque de données convertit les données initialement publiées au format XML au format CSV. Ce format peut être utilisé pour analyser des informations à l’aide de logiciels de tableur, comme Microsoft Excel, LibreOffice Calc. ou Google Sheets. Vous pouvez, dans un fichier CSV, déterminer si chaque ligne doit correspondre à une activité, à un budget ou à une transaction spécifique.
• Excel (Recherche dans la banque de données uniquement) – la recherche dans la banque de données permet de convertir un fichier CSV en un fichier Excel en cliquant sur le bouton de téléchargement « Excel ». Ce format garantit que Microsoft Excel interprète correctement le codage du fichier et affiche les caractères accentués de manière adéquate en ajoutant un indicateur d’ordre des octets UTF-8. Le format corrige également un bogue que des utilisateurs de Microsoft Excel pourraient rencontrer lors de l’ouverture du fichier au format CSV dans lequel la taille des lignes ne s’ajuste pas automatiquement au centre des cellules plus longues. Ceci est réalisé en tronquant les cellules individuelles comportant plus de 32 700 caractères ; si votre logiciel peut analyser de longues cellules, nous vous recommandons de continuer à utiliser le format de téléchargement initial CSV.

Qui peut utiliser la version 3 de l’API de la banque de données de l’IITA ?

Pour utiliser la banque de données de l’IITA, les utilisateurs devront tout d’abord disposer des compétences techniques nécessaires et comprendre la structure et les éléments fondamentaux de la norme de l’IITA. Cela permet de savoir quels types de données relatives à l’action humanitaire et au développement peuvent être recherchés et consultés. Ces informations sont disponibles dans les supports suivants :

• Comment utiliser l’API de la banque de données
• Contrat d’API pour la version 3
• Documents de référence de l’IITA

Maintenance de la banque de données et contacts

Vous pouvez signaler des bogues ou suggérer des améliorations dans le dispositif de suivi des problèmes de Github.

Si vous avez besoin d’une aide supplémentaire pour passer à la nouvelle API ou pour l’utiliser, contactez nous.