Taxonomies
Une taxonomie est un vocabulaire contrôlé de genres et de termes. Parcourez-la, corrigez un terme et échangez-la en SKOS, avec les mêmes règles d'habilitation que le reste de l'ontologie.
Une taxonomie est un vocabulaire contrôlé : un petit ensemble de genres et, sous chaque genre, les termes qui lui appartiennent. « Employé » et « Entreprise cliente » sont des genres ; « Hannah Taylor » est un terme du genre « Employé ». Un terme peut porter des libellés alternatifs (« Hannah »), qui désignent la même chose, et des libellés masqués, qui servent à la reconnaissance mais ne sont jamais affichés comme nom préféré.
Les taxonomies sont stockées dans le service d'ontologie ; elles suivent donc ses règles d'habilitation, d'historique et d'audit. Elles sont modélisées sur SKOS, qui est aussi le format d'import et d'export.
Genres et termes
| Ce que c'est | Comment ça change | |
|---|---|---|
| Genre | Un concept de la taxonomie, avec un libellé préféré, une définition facultative, un unique genre parent facultatif et des ancrages facultatifs vers des standards externes. | Rarement. Chaque modification de l'ensemble des genres est publiée comme une nouvelle révision immuable. |
| Terme | Une chose nommée, classée sous un genre, avec ses libellés alternatifs et masqués. | Souvent. Chaque modification est enregistrée avec son propre historique et son propre marquage d'habilitation. |
Chaque taxonomie enregistre son origine. Aujourd'hui, une taxonomie est imported : chargée depuis un fichier SKOS (voir Importer et exporter du SKOS). La production automatique de taxonomies à partir d'une base de connaissances n'est pas encore disponible. Chaque terme enregistre aussi sa propre origine, qui devient manual dès qu'une personne le modifie (voir Modifier un terme).
Parcourir une taxonomie
Ouvrez Ontologie → Taxonomies dans Analytics et choisissez une taxonomie dans la liste. La liste ne contient que les taxonomies que votre habilitation permet de voir, triées par nom ; utilisez Charger plus lorsque votre organisation en compte plus d'une page. La page affiche ensuite trois éléments :
- Genres : les genres sous forme d'arbre, selon le parent de chacun.
- Termes : un tableau paginé des termes avec leur genre, leurs libellés et leur origine.
- Publications : l'historique des révisions de l'ontologie des taxonomies, en lecture seule. Les révisions sont partagées par toutes les taxonomies de votre organisation, pas seulement celle affichée.
La même liste est disponible par l'API, GET /kernel/taxonomies (taxonomies.list dans le SDK). Elle renvoie une page d'au plus limit taxonomies (50 par défaut, 100 au maximum) et un nextCursor ; passez ce curseur comme after pour obtenir la page suivante. nextCursor vaut null sur la dernière page.
Vous ne pouvez pas rétablir une version antérieure d'une taxonomie depuis cette page. La publication et le retour arrière sont assurés par le service de taxonomie lui-même, pas par une personne ; la page n'offre donc aucun contrôle de retour arrière.
Habilitation
Chaque genre et chaque terme a son propre marquage de classification, et vous ne voyez que ce que votre habilitation permet :
- Une taxonomie, un genre ou un terme au-dessus de votre habilitation n'est pas listé. Une taxonomie masquée est simplement absente de la liste des taxonomies : elle n'est pas comptée et n'influe pas sur la pagination.
- Un terme dont le genre est au-dessus de votre habilitation reste listé si vous pouvez voir le terme, mais son genre apparaît comme Masqué. Il en va de même pour un genre parent : une référence à un genre que vous ne pouvez pas voir est omise, jamais affichée par son nom. Cela vaut pour la page, l'API, le SDK et l'export SKOS.
- Une taxonomie qui n'existe pas et une taxonomie au-dessus de votre habilitation reçoivent la même réponse : « Cette taxonomie n'existe pas, ou elle est au-dessus de votre habilitation. »
Modifier un terme
Les administrateurs de l'organisation peuvent corriger un terme depuis le tableau des termes (Modifier le terme). Vous pouvez changer son genre et ses libellés alternatifs et masqués. Le libellé préféré identifie le terme ; il ne peut donc pas être modifié ici.
- L'enregistrement constitue une modification manuelle. L'origine du terme devient
manual, ce qui la signale comme une correction faite par une personne. Les mises à jour automatiques, une fois disponibles, n'écraseront jamais un terme dont la dernière modification est manuelle. - Le marquage ne change pas. Une modification conserve le marquage de classification du terme. Une requête qui tente de donner à un terme existant un autre marquage est refusée avec un
409(MARKING_CHANGE_REFUSED). Pour reclasser un terme, retirez-le puis réécrivez-le sous le nouveau marquage. - Un terme dont le genre vous est masqué ne peut pas être modifié, car vous ne pourriez pas voir ce que vous changez.
- Un seul marquage par requête. Une écriture sans marquage ne peut nommer que des termes déjà existants et partageant un même marquage. Sinon elle est refusée avec un
400:MARKING_REQUIREDlorsqu'un terme nommé est nouveau,MIXED_TERM_MARKINGSlorsque les termes couvrent plusieurs marquages. Envoyez une requête par marquage. - Relire sa propre modification. Une écriture de termes renvoie un
watermark. Passez-le enminSeqlorsque vous listez les termes (taxonomies.listTerms({ name, minSeq })) : le serveur attend brièvement que la modification soit lisible. Si elle ne l'est toujours pas, il répond503 PROJECTION_LAGGINGau lieu de renvoyer la liste d'avant votre modification. Le tableau des termes procède ainsi après chaque enregistrement.
Importer et exporter du SKOS
Les administrateurs de l'organisation peuvent importer un vocabulaire SKOS au format Turtle via le point d'entrée d'import de taxonomie, POST /kernel/taxonomies/{name}/import (taxonomies.import dans le SDK). La requête nomme la taxonomie et fournit le texte Turtle, le marquage à appliquer et une clé d'idempotence.
- Un import crée ou remplace une taxonomie dont l'origine est
imported, et n'écrase jamais une taxonomie d'une autre origine. Les noms commençant parkb-sont réservés aux taxonomies que la plateforme produira à partir d'une base de connaissances (pas encore disponible) : un import ne peut pas les revendiquer. - Réimporter un fichier remplace ses genres ; les termes disparus du fichier ne sont pas supprimés automatiquement.
- Un import est contrôlé par rapport à votre habilitation, comme toute autre écriture. L'import d'ontologie générique (
/kernel/rdf/import) et les chemins génériques d'action et de schéma refusent l'ontologie des taxonomies (TAXONOMY_ONTOLOGY_RESERVED) : il n'existe donc qu'une seule voie d'entrée.
Pour exporter, lancez l'export RDF d'ontologie sur l'ontologie des taxonomies, scrydon-knowledge-taxonomies. Les taxonomies sortent en skos:ConceptScheme, les genres et les termes en skos:Concept, avec skos:prefLabel, skos:altLabel, skos:hiddenLabel, skos:broader et skos:inScheme. L'export est construit à partir de ce que vous pouvez lire : les références masquées sont omises et une taxonomie au-dessus de votre habilitation n'est pas exportée. Les termes sont exportés dans leur état actuel, même lorsque l'export est épinglé sur une révision plus ancienne.
Voir aussi
- Branches et propositions : comment les changements de schéma sont versionnés et publiés.
- Concepts : les couches de l'ontologie, y compris les permissions.