Archives mensuelles : avril 2023

Intéroperabilité des données

L'objet de cet article est de montrer comment diffuser les données déposées sur NAKALA dans un carnet de recherche sur Hypothèses.org.
10/04/2024 
Shannon Bruderer 

Avec une quantité de données produites toujours plus grande et hétéroclites, les disciplines en sciences humaines et sociales (SHS) se trouvent face à de nouvelles problématiques : comment utiliser ces données, travailler avec elles et surtout les archiver dans de bonnes conditions.

Nakala se propose alors aux projets de recherche comme une solution pour déposer leurs données en fin de projet. Nakala est ce que l’on appelle un entrepôt de données. Dédié SHS, sa principale fonction est de conserver et de publier des données de recherche. Il facilite l’auto-dépôt, la publication et l’exposition des données selon les principes FAIR (Findable, Accessible, Interoperable, Réutilisable). Mis à disposition et hébergé par la TGIR Humanum, Nakala offre une plateforme robuste pour la gestion des données de recherche.

En utilisant des services français comme Nakala, les chercheurs mettent aussi à l’épreuve ces services, ce qui permet de faire émerger des besoins, des manques ou des bugs qui, au fur et à mesure de l’utilisation, s’amélioreront. Cette stratégie permet de œuvrer pour (dans la mesure du possible) une souveraineté des données.

Nakala dispose d’une option API (application programming interface). Une API est utilisée pour connecter deux logiciels, afin de faciliter le transfert de données. Les API sont souvent utilisées pour interroger directement la base de données sous-jacente du logiciel et sont donc particulièrement puissantes pour interroger les données quantitativement, ou alors pour effectuer des dépôts via le service de l’API.

Si la possibilité de déposer des données de manière pérenne existe, comment pouvons-nous réutiliser ces données par la suite et notamment les présenter sur un carnet de recherche ?

Comment présenter les données stockées dans NAKALA ?

N’ayant pas encore déposé nos données sur Nakala, nous utilisons ici un exemple d’une donnée déjà présente sur Nakala.

Titre : Statue équestre de Trajan 
Auteur : Anonyme 
Identifiant : 
10.34847/nkl.ae63y390/16649c7b697aeb781b8fec4cd3e0e4d77a9bac62
URL d'intégration : https://api.nakala.fr/embed/10.34847/nkl.ae63y390/16649c7b697aeb781b8fec4cd3e0e4d77a9bac62

Nakala présente le document dans un visualiseur d’images haute résolution, zoomable basé sur le web et open-source, implémenté en JavaScript, adapté à la fois aux ordinateurs de bureau et aux appareils mobiles. Le visualiseur est développé par OpenSeadragon.

En bas du document deux liens très utiles sont présentés : une URL pour l’intégration et une URL pour le téléchargement :

  • Une URL intégration (du type https://api.nakala.fr/embed/…) permettant d’intégrer le fichier avec sa visionneuse dans n’importe quelle page web

https://api.nakala.fr/embed/10.34847/nkl.33098094/81fbf9e17f754be490235b425e78f6833056b0bb

  • Une URL de téléchargement (du type https://api.nakala.fr/data/…) qui peut également être utile pour intégrer le fichier dans une page web.

https://api.nakala.fr/data/10.34847/nkl.33098094/81fbf9e17f754be490235b425e78f6833056b0bb

Intégration du fichier dans le carnet :

Pour intégrer le fichier dans le carnet, nous commençons par récupérer les informations nécessaires, notamment l’URL d’intégration qui contient le lien ’embed’. Une fois le lien copier, il peut être intégré directement dans le carnet. Cette méthode permet de conserver la même résolution que sur Nakala. De plus, elle ne nécessite pas une duplication du fichier mais utilise un lien vers le fichier, ce qui est plus économique en termes d’énergie et de stockage.

https://api.nakala.fr/embed/10.34847/nkl.ae63y390/16649c7b697aeb781b8fec4cd3e0e4d77a9bac62

Maintenant que vous avez le lien et les informations nécessaires, vous pouvez l’utiliser pour intégrer le fichier associé dans votre blog de recherche. C’est plus simple qu’il n’y paraît. Il suffit d’utiliser le code HTML suivant :

<iframe src="https://api.nakala.fr/embed...." width="560" height="315"></iframe>

La balise HTML <iframe> se compose de plusieurs parties. Commencez par <iframe src=, suivi du lien Nakala que vous avez récupéré, que vous devrez insérer entre guillemets. Ensuite, vous pouvez ajuster les dimensions de l’affichage en modifiant les paramètres width et height. Par exemple, changez width="560" height="315" à width="860" height="615" pour voir votre image changer de taille. Ainsi, vous pouvez manipuler la taille de l’affichage selon vos besoins.

—-

<iframe src=

Votre lien https://api.nakala.fr.embed

width=”560″ height=”315″>

—-

Pour intégrer concrètement le fichier, commencez par cliquer sur l’icône ‘plus’ située à droite pour ajouter un nouveau bloc.

Sélectionner “HTML personnalisé”

Vous devriez voir ceci apparaître sur votre page

Copiez et collez le code HTML dans ce bloc :

Supprimez le lien générique dans le code et remplacez-le par votre propre URL d’intégration, du type https://api.nakala.fr/embed/.... Dans notre cas, il s’agit de : https://api.nakala.fr/embed/10.34847/nkl.ae63y390/16649c7b697aeb781b8fec4cd3e0e4d77a9bac62.”

Une fois le code correctement collé dans le champ HTML, cliquez sur le bouton ‘Prévisualiser’ situé en haut à droite pour voir le résultat

Vidéo Tutoriel : https://www.youtube.com/watch?v=TViMGjQgZmM

Bonus :

Pour ajuster directement la taille de l’image à votre carnet de recherche, suivez les instructions ci-dessous.

<iframe src="VOTRE_URL_D'INTÉGRATION_ICI" style="width:100%; height:400px; border:none;"></iframe>

Remplacez VOTRE_URL_D'INTÉGRATION_ICI par l’URL que vous avez obtenue. Ce code crée une iframe dans laquelle le fichier sera affiché, ajusté à la largeur de votre article de blog et avec une hauteur fixe de 400 pixels. Cette méthode assure que le contenu intégré s’affiche correctement, tout en restant responsive pour s’adapter aux différentes tailles d’écran.