Comment interroger et réconcilier vos données avec n’importe quel thésaurus géré dans Opentheso

---

1. Qu’est-ce que la réconciliation ?

La réconciliation est le processus qui consiste à faire correspondre automatiquement des valeurs textuelles libres (dans un tableur, une base de données, un export de catalogue…) avec les concepts d’un référentiel contrôlé — ici, un thésaurus géré dans Opentheso.

Concrètement, cela permet de :

• normaliser des données hétérogènes en les associant à un identifiant pérenne plutôt qu’à du texte libre ;
• enrichir un jeu de données avec des URI stables, condition nécessaire pour publier en Linked Open Data ;
• automatiser un travail de rapprochement qui, fait à la main, serait extrêmement chronophage sur de gros volumes ;
• interconnecter des données provenant de sources différentes autour des mêmes identifiants.

Opentheso expose un service de réconciliation conforme au standard ouvert Reconciliation Service API (protocole utilisé par OpenRefine et par d’autres outils compatibles). Ce module fonctionne pour n’importe quel thésaurus hébergé sur une instance Opentheso — il ne s’agit pas d’un service ad hoc développé pour un thésaurus en particulier, mais d’une fonctionnalité générique du logiciel.

---

2. Comprendre l’URL du service

Chaque thésaurus géré dans une instance Opentheso expose son propre point d’accès (endpoint) de réconciliation, sur ce modèle :

https://<domaine-de-votre-instance>/api/v2/<identifiant-du-thesaurus>/<langue>/reconcile

Élément	Description
<domaine-de-votre-instance>	Le nom de domaine de votre installation Opentheso (ex. pactols.frantiq.fr)
<identifiant-du-thesaurus>	L’identifiant interne du thésaurus dans Opentheso (ex. TH_1, th17…)
<langue>	Le code de langue à utiliser pour la recherche et l’affichage des labels (ex. fr, en, es…)

Exemple concret, sur l’instance Frantiq qui héberge le thésaurus PACTOLS :

• Branche « Sujets » : https://pactols.frantiq.fr/api/v2/TH_1/fr/reconcile
• Branche « Lieux » : https://pactols.frantiq.fr/api/v2/th17/fr/reconcile

Pour réconcilier avec un autre thésaurus (le vôtre, ou tout autre thésaurus tiers hébergé sur une instance Opentheso), il suffit de reconstruire cette URL avec le bon domaine, le bon identifiant de thésaurus, et la langue souhaitée.

---

3. Utiliser le service dans OpenRefine — pas à pas

Étape 1 — Charger vos données

Ouvrez OpenRefine et importez votre jeu de données (CSV, Excel, TSV…) comme d’habitude, sous forme de projet.

Étape 2 — Lancer la réconciliation sur une colonne

1. Repérez la colonne contenant les termes à réconcilier (ex. une colonne « Matériau », « Lieu », « Sujet »…).
2. Cliquez sur la flèche du menu déroulant en haut de la colonne.
3. Choisissez Réconcilier → Démarrer la réconciliation…

Étape 3 — Ajouter le service Opentheso

Si le service n’apparaît pas déjà dans la liste proposée :

1. Cliquez sur « Ajouter un service standard de réconciliation ».
2. Collez l’URL du endpoint correspondant à votre thésaurus, par exemple :
   https://pactols.frantiq.fr/api/v2/TH_1/fr/reconcile
3. Validez. OpenRefine interroge le service, récupère son manifeste (nom, types de concepts disponibles, propriétés interrogeables) et l’ajoute à la liste des services disponibles.

Étape 4 — Configurer et lancer la réconciliation

1. Sélectionnez le service que vous venez d’ajouter.
2. Choisissez éventuellement un type de concept si le thésaurus en propose plusieurs (utile pour restreindre la recherche à une branche particulière).
3. Cliquez sur « Démarrer la réconciliation ».

OpenRefine interroge alors le service pour chaque valeur de la colonne et propose des correspondances candidates, avec un score de confiance pour chacune.

Étape 5 — Valider les correspondances

• Les valeurs avec une correspondance à score élevé et sans ambiguïté sont automatiquement liées (affichées en bleu).
• Les valeurs ambiguës ou à faible score sont surlignées : cliquez dessus pour voir les candidats proposés et choisir manuellement le bon concept, ou laisser la valeur non réconciliée si aucun candidat ne convient.
• Vous pouvez affiner par lots via Facette → Réconciliation → Judgment, pour traiter en masse les valeurs selon leur statut (validées, en conflit, vides…).

---

---