Der Schema-Editor bietet Funktionen zum Einbetten semantischer Metadateninformationen in das OpenAPI/JSON-Schema der API. Zwei Schlüsselfunktionen sind die Möglichkeit, den SPARQL-Endpunkt zu konfigurieren, der dann für die Abfrage von RDF-Ressourcen nützlich ist, und die Aktivierung der automatischen Vervollständigung für Terme und Klassen.

Konfigurieren des SPARQL-Endpunkts

Der Schema-Editor fragt externe Ressourcen mit SPARQL ab, einer Sprache, die für die Abfrage von RDF-Datensätzen entwickelt wurde.
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.

So ändern Sie den SPARQL-Endpunkt:

• Klicken Sie auf das Burger-Symbol (≡) in der oberen linken Ecke der Benutzeroberfläche.
• Wählen Sie im Seitenmenü den Eintrag Konfiguration aus.
• 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.

Automatische Vervollständigung verwenden

Der Schema-Editor kann beim Tippen automatisch Begriffe und Klassen vorschlagen, basierend auf einem ausgewählten Satz von Vokabeln, die im schema.gov.it-Katalog verfügbar sind. So verwenden Sie die Selbstvervollständigung:

• Premendo la combinazione CTRL + SPACE si aprirà un menu a tendina con un elenco di suggerimenti compatibili;
• Durch Eingabe von Text wird die Liste dynamisch gefiltert;
• Premendo INVIO su un suggerimento, l’editor completerà automaticamente il campo con l’URI corretto della classe o proprietà selezionata.

Diese Funktionalität vereinfacht das Einfügen korrekter Referenzen erheblich und reduziert das Risiko ungültiger Syntax- oder URI-Fehler.

Immagine descrittiva di funzionamento dell’autocompletamento.

Der Abschnitt Datenmodelle des Schema-Editors bietet eine strukturierte Übersicht über alle im Schema definierten RDF-Klassen. Es soll die Analyse der Eigenschaften erleichtern, die mit jeder Klasse und ihren semantischen Verbindungen verbunden sind.

Hauptfunktionen

1. Automatische Anzeige von RDF-Klassen Der Editor ruft automatisch alle RDF-Klassen im Schema ab. Für jede Klasse werden die folgenden aufgelistet:
   • die zugehörigen Eigenschaften;
   • Semantische Verknüpfungen, die sich aus Mappings mit Referenzklassen ergeben.
2. Details zu jeder Eigenschaft Jede angezeigte Eigenschaft wird mit nützlichen Informationen zum Verständnis des Modells angereichert:
   • Syntaktischer Typ (z.B. String, Zahl, Objekt);
   • Semantischer Typ (assoziierte RDF-URI);
   • Textliche Beschreibung;
   • Anwendungsbeispiel, generiert nach Schemadefinitionen.
3. OntoScore-Berechnung – Semantischer Abdeckungsindikator Der Schema-Editor berechnet einen Indikator namens OntoScore, der den semantischen Mapping-Level des Schemas misst. Es ist definiert als das Verhältnis der Gesamtzahl der im JSON-Schema vorhandenen Eigenschaften zur Anzahl der Eigenschaften, die mit einem rdf:Property korrekt zugeordnet wurden. Dieser Score hilft zu beurteilen, wie semantisch das Schema mit RDF-Vokabularen ausgerichtet ist.
4. Wenn eine Klasse mit einem kontrollierten Vokabular verknüpft ist, wird die Schaltfläche "Werte anzeigen" angezeigt. Wenn Sie darauf klicken, gelangen Sie direkt zum entsprechenden Abschnitt auf schema.gov.it, in dem alle zulässigen Werte für diese Eigenschaft aufgeführt sind.

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

Navigation von Analysetools

Dieser Abschnitt des Schema Editors enthält eine Reihe von Tools, die für die semantische Analyse, RDF-Visualisierung und JSON-LD-Kompatibilitätsvalidierung entwickelt wurden. Durch verschiedene interaktive Panels ist es möglich, die Struktur des Schemas zu erforschen, seine semantische Bedeutung zu verstehen und sein Verhalten in realen RDF-Kontexten zu überprüfen.

JSON-LD Playground verwenden

Mit dem Schema Editor können Sie ein Beispiel automatisch generieren und im externen JSON-LD Playground Tool öffnen. Mit dieser Funktion können Sie:

• Anzeige des vom Schema erzeugten JSON-Eingangs;
• Untersuchen Sie den JSON-LD-Kontext und seinen @type;
• Erhalten Sie eine RDF-Serialisierung in den Formaten Turtle, RDF/XML und N-Quads.

Dieses Tool ist nützlich, um die Richtigkeit der semantischen Darstellung von Daten zu testen.

Deskriptives Bild der semantischen Analyse mit JSON-LD Playground.

Verwenden Sie RDF-Tripletts

Der RDF-Abschnitt zeigt die Schemainformationen in RDF-Trilets (im Formularsubjekt – Prädikat – Objekt) und bietet eine klare Darstellung der semantischen Struktur. Mit dieser Ansicht können Sie:

• Erforschen Sie visuell die semantischen Beziehungen zwischen Entitäten und Eigenschaften;
• Überprüfen Sie die Konsistenz des Modells mit dem RDF-Diagramm;
• Verstehen, wie Schemainstanzen in semantischen Systemen interpretiert werden

Beschreibendes Bild von RDF-Tripletts.

JSON-LD-Kontext verwenden

Der Inhalt des Abschnitts JSON-LD-Kontext wird automatisch aus den Metadaten (x-jsonld-Typ und x-jsonld-Kontext) im Schema generiert. Zu den Hauptmerkmalen gehören:

• respektiert die Hierarchie des Systems unter Beibehaltung eines kohärenten Kontexts;
• Anwenden der automatischen Kontextvererbung auf untergeordnete Ebenen, sofern nicht anders angegeben;
• Erzeugt eine Ausgabe, die den JSON-LD-Spezifikationen entspricht und bereit ist, in Systeme integriert zu werden, die auf RDF-Ontologien basieren.

Dieses Panel ist der Schlüssel zur Gewährleistung einer effektiven semantischen Integration und interoperablen Veröffentlichung von Daten.

Beschreibendes Bild des JSON-LD-Kontextabschnitts.

Das Aktionsmenü des Schema-Editors bietet schnellen Zugriff auf mehrere nützliche Funktionen zum Verwalten, Exportieren und Freigeben semantischer Schemata.
Es kann über eine dedizierte Schaltfläche in der Hauptschnittstelle des Editors aufgerufen werden.

Hauptfunktionen

1. Erstellen einer neuen Vorlage Sie können eine Basisvorlage erstellen, die eine einzelne Beispielklasse enthält: Person, mit Eigenschaften givenName und familyName. Dieses Basismodell kann verwendet werden für:
   • Untersuchung der Struktur und Logik des Systems;
   • Einfaches Hinzufügen neuer Klassen und Eigenschaften;
   • Beginnen Sie mit der Definition eines benutzerdefinierten Schemas, z. B. eines semantischen Modells von „Person“ mit verwandten ontologischen Klassen.
2. Das derzeit verwendete Schema kann in verschiedenen Formaten heruntergeladen werden:
   • Natives Format („as-is“), nützlich für die direkte Wiederverwendung im Schema-Editor;
   • JSON-Format, geeignet für die Integration in externe Systeme oder die Weiterverarbeitung.
3. Aufteilung der Regelung
   Es steht eine Option zum Kopieren des Schemas als URL zur Verfügung, die eine schnelle und einfache Freigabe mit anderen Benutzern oder Tools ermöglicht. Dieser Link zeigt eine persistente Darstellung des Schemas, das im selben Editor oder in kompatiblen Umgebungen geöffnet werden kann.
4. Öffnen des Schemas in einer entfernten Instanz
   Das gleiche Schema kann in einer zuvor konfigurierten Remoteinstanz des Schema-Editors geöffnet werden (z.B. in einer Drittanbieteranwendung oder einer benutzerdefinierten Umgebung). Diese Funktion ist besonders nützlich in Kontexten, in denen der Editor in ein Managementsystem, ein Dokumentenportal oder eine dedizierte semantische Entwicklungsumgebung integriert ist.

Immagine descrittiva dell’Action menu.

Der RDF Ontological Class Helper ist ein integriertes Werkzeug im Schema Editor, das Benutzer beim fortgeschrittenen semantischen Design von Schemas unterstützen soll.

Diese Funktion hilft, die RDF-Eigenschaften zu untersuchen, die mit einer bestimmten semantischen Klasse verbunden sind, was die korrekte Zuordnung von Eigenschaften erleichtert und die allgemeine semantische Qualität des Schemas verbessert.

1. Das Tool führt automatisch eine SPARQL-Abfrage für die semantische Klasse aus, die im Feld x-jsonld-type des Schemas angegeben ist.
2. Alle rdf:Eigenschaften, die der Klasse zugeordnet sind, werden abgerufen, mit nützlichen Details für jede Eigenschaft, einschließlich:
   • rdfs:bereich: Gibt die Art des erwarteten Wertes an (z. Literal, URI usw.);
   • rdfs:Kommentar: eine textliche Beschreibung der Immobilie;
   • Anwendungsbeispiel: hilft zu verstehen, wie man die Immobilie richtig in das Schema integriert.

Die identifizierten Eigenschaften werden in ein interaktives Panel eingefügt, von dem aus der Benutzer sie analysieren und entscheiden kann, ob er sie in sein Modell integrieren möchte oder nicht.
Dieses Tool ist besonders nützlich, um die semantische Abdeckung des Schemas zu erweitern, eine ordnungsgemäße Anpassung an Standard-RDF-Vokabulare sicherzustellen, vorhandene Eigenschaften wiederzuverwenden, Redundanzen zu reduzieren und die semantische Interoperabilität zu fördern.

Immagine descrittiva dell’utilizzo di RDF Helper