L'éditeur de schémas fournit des fonctionnalités permettant d'intégrer des informations de métadonnées sémantiques dans le schéma OpenAPI/JSON de l'API. Deux fonctions clés sont la possibilité de configurer le point de terminaison SPARQL, qui est ensuite utile pour interroger des ressources de type RDF, et l'activation de l'achèvement automatique pour les termes et les classes.

Configurer le point de terminaison SPARQL

L'éditeur de schémas interroge des ressources externes à l'aide de SPARQL, un langage conçu pour interroger des ensembles de données RDF.
Di default, l’editor utilizza un endpoint SPARQL preconfigurato. Tuttavia, è possibile modificarlo per collegarsi a un diverso server SPARQL, utile ad esempio quando si lavora con dataset personalizzato o infrastrutture RDF distribuite. Per farlo, cliccare sull’icona hamburger (≡) situata nell’angolo superiore sinistro dell’interfaccia.

Pour modifier le point de terminaison SPARQL:

• Cliquez sur l'icône burger (≡) dans le coin supérieur gauche de l'interface.
• Sélectionnez l'élément Configuration dans le menu latéral.
• Inserisci l’URL del nuovo endpoint SPARQL nel campo dedicato. Una volta salvata la configurazione, l’editor utilizzerà il nuovo endpoint per tutte le interrogazioni.

Immagine descrittiva di finalizzazione della configurazione dell’endpoint SparQL.

Utiliser l'autocomplétion

L'éditeur de schémas est capable de suggérer automatiquement des termes et des classes lors de la saisie, en fonction d'un ensemble sélectionné de vocabulaires disponibles dans le catalogue schema.gov.it. Pour utiliser l'auto-complétion:

• Premendo la combinazione CTRL + SPACE si aprirà un menu a tendina con un elenco di suggerimenti compatibili;
• En tapant du texte, la liste sera filtrée dynamiquement;
• Premendo INVIO su un suggerimento, l’editor completerà automaticamente il campo con l’URI corretto della classe o proprietà selezionata.

Cette fonctionnalité simplifie grandement l'insertion de références correctes et réduit le risque d'erreurs de syntaxe ou d'URI invalides.

Immagine descrittiva di funzionamento dell’autocompletamento.

La section Modèles de données de l'éditeur de schéma fournit une vue d'ensemble structurée de toutes les classes RDF définies dans le schéma. Il est conçu pour faciliter l'analyse des propriétés associées à chaque classe et de leurs liens sémantiques.

Principales fonctionnalités

1. Affichage automatique des classes RDF L'éditeur récupère automatiquement toutes les classes RDF du schéma. Pour chaque classe, les éléments suivants sont énumérés:
   • Les propriétés associées;
   • Liens sémantiques résultant de mappages avec des classes de référence.
2. Détails pour chaque propriété Chaque propriété affichée est enrichie d'informations utiles pour comprendre le modèle:
   • Type syntaxique (par exemple chaîne, nombre, objet);
   • Type sémantique (URI RDF associé);
   • description textuelle;
   • Exemple d'utilisation, généré selon les définitions de schéma.
3. Calcul OntoScore – Indicateur de couverture sémantique L’éditeur de schéma calcule un indicateur appelé OntoScore, qui mesure le niveau de cartographie sémantique du schéma. Il est défini comme le rapport entre le nombre total de propriétés présentes dans le schéma JSON et le nombre de propriétés correctement mappées avec un rdf:Property. Ce score permet d'évaluer l'alignement sémantique du schéma avec les vocabulaires RDF.
4. Lorsqu'une classe est liée à un vocabulaire contrôlé, le bouton "Afficher les valeurs" apparaît. En cliquant dessus, vous accédez directement à la section correspondante sur schema.gov.it, où toutes les valeurs autorisées pour cette propriété sont répertoriées.

Immagine descrittiva della sezione Data Models con le sue funzionalità.

Navigation des outils d'analyse

Cette section de l'éditeur de schémas rassemble un ensemble d'outils conçus pour l'analyse sémantique, la visualisation RDF et la validation de la compatibilité JSON-LD. Grâce à différents panneaux interactifs, il est possible d'explorer la structure du schéma, de comprendre sa signification sémantique et de vérifier son comportement dans des contextes RDF réels.

Utiliser JSON-LD Playground

L'éditeur de schémas vous permet de générer automatiquement un exemple et de l'ouvrir dans l'outil externe JSON-LD Playground. Cette fonction vous permet de:

• Afficher l'entrée JSON produite par le schéma;
• Examiner le contexte JSON-LD et son @type;
• Obtenez une sérialisation RDF aux formats Turtle, RDF/XML et N-Quads.

Cet outil est utile pour tester l'exactitude de la représentation sémantique des données.

Image descriptive de l'analyse sémantique avec JSON-LD Playground.

Utiliser des triplets RDF

La section RDF présente les informations du schéma dans les triplets RDF (sous la forme sujet – prédicat – objet), fournissant une représentation claire de la structure sémantique. Cette vue vous permet de:

• Explorer visuellement les relations sémantiques entre les entités et les propriétés;
• Vérifier la cohérence du modèle avec le graphique RDF;
• Comprendre comment les instances de schéma seront interprétées dans les systèmes sémantiques

Image descriptive des triplets RDF.

Utiliser le contexte JSON-LD

Le contenu de la section Contexte JSON-LD est généré automatiquement à partir des métadonnées (x-jsonld-type et x-jsonld-context) dans le schéma. Parmi les principales caractéristiques:

• respecte la hiérarchie du système, en maintenant un contexte cohérent;
• Appliquer l'héritage de contexte automatique aux niveaux enfants, sauf indication contraire;
• Génère des sorties conformes aux spécifications JSON-LD, prêtes à être intégrées dans des systèmes basés sur des ontologies RDF.

Ce panneau est essentiel pour assurer une intégration sémantique efficace et une publication interopérable des données.

Image descriptive de la section Contexte JSON-LD.

Le menu Action de Schema Editor offre un accès rapide à plusieurs fonctionnalités utiles pour la gestion, l'exportation et le partage de schémas sémantiques.
Il est accessible via un bouton dédié situé dans l'interface principale de l'éditeur.

Principales fonctionnalités

1. Création d'un nouveau modèle Vous pouvez générer un modèle de base, contenant une seule classe d'exemple: Personne, avec propriétés givenName et familyName. Ce modèle de base peut être utilisé pour:
   • Examiner la structure et la logique du régime;
   • Ajoutez facilement de nouvelles classes et propriétés;
   • Commencez à définir un schéma personnalisé, par exemple un modèle sémantique de «personne» avec des classes ontologiques connexes.
2. Le schéma actuellement utilisé peut être téléchargé dans plusieurs formats:
   • format natif («tel quel»), utile pour une réutilisation directe dans l’éditeur de schémas;
   • Format JSON, adapté à l'intégration dans des systèmes externes ou à un traitement ultérieur.
3. Partage du système
   Une option est disponible pour copier le schéma sous forme d'URL, permettant un partage rapide et facile avec d'autres utilisateurs ou outils. Ce lien affiche une représentation persistante du schéma, prêt à être ouvert dans le même éditeur ou dans des environnements compatibles.
4. Ouverture du schéma dans une instance distante
   Le même schéma peut être ouvert dans une instance distante précédemment configurée de l'éditeur de schéma (par exemple dans une application tierce ou un environnement personnalisé). Cette fonction est particulièrement utile dans les contextes où l'éditeur est intégré dans un système de gestion, un portail de documents ou un environnement de développement sémantique dédié.

Immagine descrittiva dell’Action menu.

Le RDF Ontological Class Helper est un outil intégré dans l'éditeur de schémas conçu pour aider les utilisateurs dans la conception sémantique avancée des schémas.

Cette fonctionnalité permet d'explorer les propriétés RDF associées à une classe sémantique spécifique, facilitant la cartographie appropriée des propriétés et améliorant la qualité sémantique globale du schéma.

1. L'outil effectue automatiquement une requête SPARQL sur la classe sémantique indiquée dans le champ de type x-jsonld du schéma.
2. Tous les rdf:Properties associés à la classe sont récupérés, avec des détails utiles pour chaque propriété, y compris:
   • rdfs:range: indique le type de valeur attendue (p. ex. Littéral, URI, etc.);
   • rdfs:commentaire: fournir une description textuelle du bien;
   • Exemple d'utilisation: aide à comprendre comment intégrer correctement la propriété dans le schéma.

Les propriétés identifiées sont insérées dans un panneau interactif, à partir duquel l'utilisateur peut les analyser et décider de les intégrer ou non dans son modèle.
Cet outil est particulièrement utile pour étendre la couverture sémantique du schéma, assurer un alignement correct avec les vocabulaires RDF standard, réutiliser les propriétés existantes, réduire la redondance et favoriser l'interopérabilité sémantique.

Immagine descrittiva dell’utilizzo di RDF Helper