Utilisation du registre de l’IITA
Découvrez comment utiliser le registre de l’IITA pour manier des fichiers de données.
Découvrez le registre de l’IITA« Le registre est votre seul point d’accès aux liens vers les données de l’IITA ».
Qu’est-ce que le registre de l’IITA ?
Le registre de l’IITA est l’index de l’ensemble des fichiers de données publiées conformément à l’Initiative internationale pour la transparence de l’aide (IITA). Il ne contient pas les données en soi, mais les liens vers les données publiées et vers les métadonnées décrivant le contenu des fichiers.
Toutes les organisations signataires de l’IITA possèdent un compte dans le registre de l’IITA. Si vous souhaitez savoir comment publier des données conformes à la norme de l’IITA, veuillez consulter la rubrique Conseils et assistance.
À qui est destiné le registre ?
Le registre de l’IITA est principalement destiné aux signataires, qui y gèrent les informations concernant leur organisation et y ajoutent des liens vers leurs fichiers de données. Le registre permet également de chercher les coordonnées d’un signataire et, si l’on possède les compétences techniques nécessaires, d’accéder aux fichiers de données brutes via les API.
Si vous disposez de solides connaissances techniques, par exemple si vous êtes un développeur, et que vous souhaitez accéder aux métadonnées et aux fichiers de données brutes de l’IITA et les importer, le registre est fait pour vous. Si ce n’est pas le cas et que vous avez simplement besoin de chercher et de consulter les données de l’IITA de manière conviviale, rendez-vous sur d-portal ou consultez la rubrique Outils et ressources relatifs à l’utilisation des données pour en savoir plus sur les autres outils.
Le format des fichiers de données IITA au format XML est lisible par machine et permet l’échange et l’utilisation des données à l’aide d’un nombre croissant d’outils et d’applications.
Quelles informations puis-je trouver dans le registre ?
Le registre de l’IITA contient les métadonnées concernant toutes les organisations signataires et les fichiers qu’elles ont publiés au format XML requis par l’IITA. Les fichiers sont stockés à différents endroits de la toile.
La page d’accueil du registre affiche le nombre total d’organisations ayant adhéré à l’IITA et publié au moins un fichier de données. Ce nombre change automatiquement au fur et à mesure des nouvelles adhésions.
Les métadonnées du registre permettent également aux utilisateurs de données de voir la liste de toutes les organisations signataires de l’IITA, leur point de contact auprès de l’IITA, l’emplacement de leurs fichiers et la date de leur première publication.
Le registre de l’IITA comprend des sections sur :
- les signataires – vous pouvez y voir la liste complète des organisations signataires, ainsi que leur nom, leur identifiant IITA, le type d’organisation dont il s’agit et le nombre de fichiers de données qu’elles ont publiés. Si vous cliquez sur le nom d’un signataire, vous verrez la liste des fichiers d’organisation et d’activités ainsi que des métadonnées concernant chaque fichier, comme la date de la dernière mise à jour.
- les données – vous pouvez filtrer vos recherches dans le registre par nom ou pays du signataire, type d’organisation et pays bénéficiaire. Cela correspond aux champs des métadonnées remplis par les signataires pour décrire leur organisation et les données qu’ils publient. Les résultats affichés fournissent les liens vers les fichiers de données brutes au format XML.
Comment trouver les coordonnées d’un signataire
Chaque signataire de l’IITA est tenu de fournir une adresse électronique dans le registre de l’IITA et peut ajouter un lien vers son site Internet. Pour trouver ces coordonnées, cliquez sur la page du signataire concerné, et son adresse électronique s’affichera à droite de l’écran sous la mention « Contact ». S’il l’a ajouté, vous trouverez également un lien vers son site Internet qui fournit souvent d’autres coordonnées de l’organisation.
Certaines organisations associent également une adresse électronique à chaque activité dans le fichier XML. Pour vérifier, trouvez une activité spécifique sur d-portal puis sélectionnez « Voir le fichier source XML » sous la mention « Intitulé du projet ». Dans le fichier source XML, vous pouvez utiliser le raccourci clavier CTRL + F pour rechercher le terme « email ».
Comment obtenir des données à partir du registre de l’IITA ?
Le registre est votre seul point d’accès aux liens vers les données de l’IITA. Vous pouvez accéder à des ensembles de données spécifiques à l’aide de nos outils intégrés. Les utilisateurs possédant de solides connaissances techniques peuvent utiliser l’API du registre pour accéder aux métadonnées, ainsi que l’adresse URL de chaque fichier de données IITA.
Accès à des ensembles de données spécifiques
Le registre de l’IITA permet le téléchargement de fichiers XML spécifiques ; il est relié à deux outils d’accès aux données, qui sont gérés par l’équipe technique de l’IITA.
Vous trouverez sur les pages des signataires quatre liens vers les fichiers de données IITA, à savoir :
- Voir les métadonnées : Vous pouvez consulter les informations supplémentaires concernant le fichier en question, comme le type de fichier, le pays bénéficiaire des activités contenues dans le fichier et la date de la dernière mise à jour.
- Télécharger : Vous pouvez télécharger le fichier de données brutes au format XML.
- Outil de prévisualisation : Vous pouvez rapidement prévisualiser les données d’un signataire sous un format facilement lisible. Chaque élément de niveau supérieur est présenté sur une ligne séparée ; vous pouvez élargir cette section pour consulter les données qu’elle contient.
- Outil de conversion CSV : Vous pouvez convertir des fichiers de données relatives aux activités de l’IITA du format XML au format CSV. Vous devez pour cela choisir l’une des trois options proposées. Vous pouvez ensuite télécharger le fichier CSV et utiliser les données relatives à l’organisation que vous avez sélectionnée.
- Résumé simple des activités (CSV)
- Toutes les données des activités (CSV)
- Toutes les transactions (CSV)
Utilisation de l’API métadonnées du registre
Vous pouvez utiliser une API pour accéder à l’ensemble des métadonnées contenues dans le registre. L’API permet d’extraire les données au format JSON. L’API du registre est une application de l’API de CKAN – voir la documentation complète de l’API de CKAN. Le lien URL vers chaque fichier publié figure en tant que métadonnée dans le registre de l’IITA. Une fois que vous disposez de la liste des URL pertinents, vous pouvez lancer l’importation des données brutes de l’IITA.
Exemples d’utilisation
Extraire les métadonnées du fichier d’organisation :
http://iatiregistry.org/api/3/action/package_search?q=extras_filetype:organisation
Extraire les métadonnées du fichier d’activités :
http://iatiregistry.org/api/3/action/package_search?q=extras_filetype:activity
Ces recherches ne permettent pas d’extraire tous les résultats par défaut. Vous devrez sélectionner le nombre de résultats que vous souhaitez afficher en modifiant différents paramètres (décalage et limite). Par exemple :
http://iatiregistry.org/api/3/action/package_search?q=extras_filetype:activity&start=100&rows=100
Pour extraire les métadonnées d’un ensemble de données spécifique, vous devez utiliser son identifiant. Les détails complets des ensembles de données comprennent des informations sur les ressources téléchargeables (p. ex., les fichiers de données IITA au format XML).
http://iatiregistry.org/api/3/action/package_show?id=aa-organisation
Les informations relatives au fichier téléchargeable sont disponibles dans le champ « resource.url » de la réponse JSON.
Filtres
Vous pouvez filtrer les réponses par pays (code ISO à deux chiffres) ou par signataire (appelé « organisation » dans le registre).
Par exemple, pour extraire toutes les métadonnées des fichiers d’activités du ministère du Développement international du Royaume-Uni (DFID), vous utiliserez :
http://iatiregistry.org/api/3/action/package_search?q=organization:dfid
Pour extraire toutes les métadonnées des fichiers d’activités ayant le Ghana comme segment principal, vous utiliserez :
API pour les données au format XML
L’IITA fournit plusieurs API. Si vous avez besoin d’une API pour travailler directement avec les données IITA au format XML, vous pouvez utiliser l’API données avec la banque de données de l’IITA.
Qui assure la maintenance du registre ?
Le Secrétariat de l’IITA est responsable de la maintenance du registre de l’IITA et travaille directement avec Derilinx, prestataire de pointe s’agissant du développement et de l’hébergement de CKAN, qui fournit et gère le registre.
Si vous avez des questions ou rencontrez des problèmes, veuillez contacter l’équipe technique de l’IITA.