Banque de données de l’IITA

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 faisant appel à la norme de l’IITA.

La banque de données de l’IITA fournit deux voies d’accès aux données de l’IITA :

1. L’API de la banque de données : les utilisateurs de données techniques peuvent extraire les données de tous les champs de données (dénommés « éléments ») de la norme de l’IITA.
2. Le générateur de requêtes de la banque de données : ce procédé moins technique permet de générer des requêtes portant sur 32 éléments de la norme de l’IITA. Les utilisateurs peuvent sélectionner les options dans les filtres déroulants et en saisie libre.

Pour utiliser la banque de données de l’IITA, il faut tout d’abord 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 :

• La documentation relative à l’API de la banque de données.
• Le guide de l’utilisateur pour la génération de requêtes (disponible prochainement).

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 fournit 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.

Pour en savoir plus sur les nombreuses fonctionnalités de la banque de données, lisez la documentation relative à son API.

Les deux exemples de recherche de données ci-après illustrent le fonctionnement de l’API de la banque de données :

Scénario 1 : « Je recherche des données sur la localisation et le budget des projets d’aide humanitaire et de développement des ONG nationales aux Philippines. »

Dans ce scénario, l’utilisateur doit filtrer les données par type d’organisation (ONG nationales) et par pays bénéficiaire (les Philippines), et structurer les résultats autour des champs de localisation et de budget. Le lien URL suivant permet d’effectuer cette requête :

https://iatidatastore.iatistandard.org/api/activities/?reporting_org_type=22&recipient_country=PH&fields=locations,budgets&format=json

• reporting_org_type=22 précise que seules les activités du type d’organisation associée au code 22 (ONG nationales) seront affichées.
• recipient_country=PH signale que seules les activités en lien avec le code de pays PH (les Philippines) seront affichées.
• fields=locations,budgets signifie que les données relatives à la localisation et au budget des activités ciblées seront affichées.

Scénario 2 : « Je cherche à savoir quelles organisations ont participé à des projets de formation des enseignants au Kenya et en Ouganda depuis 2012. »

Dans ce scénario, l’utilisateur doit filtrer les données par type de secteur (formation des enseignants), par pays bénéficiaire (Kenya et Ouganda) et par date de début (à partir de 2012), et structurer les résultats autour des organisations participantes. Le lien URL suivant permet d’effectuer cette requête :

• sector=11130 précise que seules les activités correspondant au code de secteur 11130 (formation des enseignants) seront affichées.
• recipient_country=KE,UG signale que seules les activités en lien avec les codes de pays bénéficiaires KE et UG (Kenya et Ouganda) seront affichées.
• actual_start_date_gte=2012-01-01 indique que seules les activités ayant débuté au plus tôt le 01/01/2012 seront affichées.
• fields=participating_organisations signifie que les données des organisations participantes en lien avec les activités ciblées seront affiché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, à 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 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 présente les activités au format XML, telles qu’elles ont été publiées à l’origine. Ces données peuvent être enrichies avec des métadonnées, précisant la version de la norme de l’IITA à l’aune de laquelle les activités en question ont été publiées, et fournissant des précisions sur le résultat de la requête.
• au format CSV – la banque de données convertit les données publiées initialement 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, sélectionner différentes lignes pour représenter des budgets, des transactions ou des activités spécifiques en fonction du format de visualisation choisi. Il est ensuite possible de trier par secteur ou pays afin d’analyser le fractionnement en pourcentage.
• au format JSON – la banque de données convertit les données publiées initialement au format XML au format JSON. Toutes les informations publiées initialement sont affichées, ainsi que les métadonnées comprises dans le résultat au format XML.

Le générateur de requêtes de la banque de données de l’IITA a été mis à l’essai fin 2019 et se trouve actuellement en phase de pré-lancement. Il sera lancé officiellement aura lieu en 2020. Nous recommandons aux utilisateurs de ne migrer aucun outil utilisant actuellement l’ancienne banque de données jusqu’au lancement officiel de la nouvelle banque de données.

Nous annoncerons prochainement la date du lancement officiel du nouveau générateur de requêtes de la banque de données de l’IITA ; l’ancien générateur de requêtes CSV de la banque de données pourra continuer à être utilisé pendant six mois à compter de cette date. Si vous avez des questions d’ordre technique sur l’utilisation de l’actuel générateur de requêtes tant qu’il est disponible, vous pouvez consulter le registre Github. Si vous avez des questions sur l’actuel générateur de requêtes, veuillez écrire au service d’assistance de l’IITA à l’adresse : support@iatistandard.org

La banque de données de l’IITA a été conçue par Zimmerman & Zimmerman et l’équipe technique de l’IITA. 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’aide pour effectuer une requête (via l’API ou à l’aide du générateur de requêtes), veuillez contacter l’équipe technique de l’IITA.