Handbücher GDI-Registry

Sie zeigen eine alte Version dieser Seite an. Zeigen Sie die aktuelle Version an.

Unterschiede anzeigen Seitenhistorie anzeigen

« Vorherige Version anzeigen Version 4 Nächste Version anzeigen »

Beispiel:

Sie sind Mitarbeiter des Umweltbundesamtes und möchten folgenden Namensraum anlegen: de.bund.uba

Voraussetzung:

  • sie sind in der Registry registriert
  • ihre Organisation ist bereits in der Registry registriert
  • sie besitzten Rechte zum EInreichen neuer Namensräume (Submitter-Rechte), die Ihnen Ihr Organisationsverwalter gegeben hat

Vorgehen:

lfd. Nr.Beschreibung
1.

In der Namensraumübersicht klicken Sie auf den Button "Addition" um den neuen Namensraum anzulegen

2.

Im Namensraum-Register können nur Objekte mit der Kategorie (Item-Klassen) "Namensraum" angelegt werden.

Bitte wählen Sie diese aus.

3.

Für eine Addition sind zwei "Formular"-Seiten auszufüllen.

  • Fachliche Informationen, welche im Screenshot mit der Überschrift Namensraum beschrieben wird
  • Proposal-Details, welche zusätzliche Informationen für den Antrag enthält

 

 

4.

Füllen Sie zunächst die fachlichen Informationen zum neuen Namensraum aus!

  • Name: Der Name bezeichnet den Namensraum innerhalb der Registry und taucht zusammen mit anderen Namenräumen in der Liste aller Namensräume auf und dient zur Verbesserung der Übersichtlichkeit. Er sollte keine krypischen Zeichen enthalten und aussagekräftig sein. (Beispiel: "Umweltbundesamt")
  • Kurzname und übergeordneter Namensraum : der Kurzname in Verbindung mit dem übergeordneten Namensraum ergibt den neuen Namensraum, den Sie anlegen möchten. (Bsp. Kurzname „uba“ für das Umweltbundesamt und übergeordneter Namensraum "de.bund". Somit wäre der komplette Namensraum "de.bund.uba")
  • Control-Body-Organisation: Durch die Zuweisung einer oder mehrere Control-Body-Organisationen kann die Zuständigkeit für zukünftig vorgeschlagene Unter-Namensräume festgelegt werden. Wird zu einem späteren Zeitpunkt ein neuer Namensraum vorgeschlagen, der diesem Namensraum untergeordnet ist, entscheiden die hier festgelegten Organisationen als Control-Body über das entsprechende Proposal. Im Fall des Beispiels wäre das das Umweltbundesamt, da das Umweltbundesamt selbst Unternamensräume verwalten soll.
  • ID Resolver: Hier wird beschrieben wie der neue Namensraum genutzt werden soll bzw. in welcher Reihenfolge bei welchen URL Mustern wie auf andere URLs umgeleitet wird. Er ist sozusagen ein Weiterleitungsdienst für Namensräume und leitet Anfragen der Form https://<registry-host>/<shortNamePath>/<id>/<version> an die beim Namensraum-Objekt hinterlegte Adresse weiter. Dabei werden die Parameter <id> und <version> in der Zieladresse ersetzt. Ein Namensraum kann mehrere Zieladressen besitzen, die in Abhängigkeit des hinterlegten ID-Musters und ihrer Priorität verwendet werden.
    Wenn Sie bspw. den Namensraum "de.bund.uba" anlegen möchten und dieser Namensraum weitere Unternamensräume erhalten soll, die die Funktionalität der Weiterleitung nutzen, dann lassen Sie diese Felder leer und befüllen Sie dann bei den Unternamensräumen. Wenn Sie jedoch nur diesen Namensraum anlegen möchten und eine Weiterleitung auf eine andere URL einrichten möchten schauen Sie bitte im Kapitel ID-Resolver nach.

  
  
  
  

 

 

 

Für eine Addition sind zwei "Formular"-Seiten auszufüllen.

  • Fachliche Informationen
  • Proposal-Details

 

 

Proposal-Details

  • Defintion
  • Proposal-Bergündung
  • Anmerkungen für den Register-Manager
  • Anmerkungen für den Control-Body

 

 

Jedes registrierte Namensraum-Item repräsentiert einen Namensraum, der von einer geodatenerfassenden oder geodatenhaltenden Stelle registriert ist. Der reservierte Namensraum entspricht einer eindeutigen URL in folgender Form:

https://<registry-host>/id/<domain>

Der Wert <domain> entspricht dabei dem des registrierten Namespace-Items im Namensraum-Register.

Der Geodatenerfasser oder -bereitsteller kann für ein Geoobjekt mit dem von ihm registrierten Namensraum einen eindeutigen Identifikator erzeugen, indem er für ein Geoobjekt einen Identifikator in der Form

<namensraum>/<local-Id>[/<version>]

bildet, also:

https://<registry-host>/id/<domain>/<local-id>[/<version>]

Weiterhin wird das Auffinden der diesem Namensraum zugehörigen Objekte unterstützt. Die IDs von Objekten im gleichen Namensraum unterscheiden sich allein durch unterschiedliche local-IDs sowie ggf. unterschiedliche Versions-Kennungen. Um diese Objekte auffinden zu können, können dem Namensraum eine oder mehrere ID-Resolver (Routen) hinzugefügt werden. Eine ID-Resolver ist eine hinterlegte Ziel-URL, die einen Platzhalter für den Parameter <local-Id> und ggf. auch für den Parameter <version> enthält.

 

Wird ein Objekt über seinen eindeutigen Identifikator aufgerufen, wird die Registry den Aufruf an eine für diesen Namensraum passende Ziel-URL weiterleiten. Welcher ID-Resolver für die Weiterleitung verwendet wird, wird anhand des bei der URL-Vorlage hinterlegten ID-Musters ermittelt. Das ID-Muster ist ein regulärer Ausdruck, der mit der angefragten ID abgeglichen wird. Sofern die angefragte ID auf die Muster von mehreren ID-Resolvern passt, wird der verwendete ID-Resolver unter diesen anhand der vergebenen Priorität ausgewählt.

Die eingetragene Ziel-URL könnte ein GetFeatureByID-Request eines WFS sein, aber es ist grundsätzlich die Angabe beliebiger URLs möglich.

Besitzt der angefragte Namensraum im Register nicht mehr den Status „gültig“, sondern „ersetzt“, wird automatisch der gültige Nachfolger des Namensraums ermittel und für die ID-Auflösung herangezogen. Dadurch wird sichergestellt, dass auch bei der Ersetzung von Namensräumen die Auflösung desselben weiterhin möglich bleibt.

Zuordnen eines übergeordneten Namensraumes

Namensräume können hierarchisch verwaltet werden. Dazu muss im Feld Übergeordneter Namensraum der Namensraum ausgewählt werden, dem der neue Namensraum zugeordnet werden soll.

Zuweisung des zuständigen Control-Body

Durch die Zuweisung einer oder mehrere Control-Body-Organisationen kann die Zuständigkeit für zukünftig vorgeschlagene Unter-Namensräume festgelegt werden. Wird zu einem späteren Zeitpunkt ein neuer Namensraum vorgeschlagen, der diesem Namensraum untergeordnet ist, entscheiden die hier festgelegten Organisationen als Control-Body über das entsprechende Proposal.

ID-Resolver

 

Der ID-Resolver ist ein Weiterleitungsdienst für Namensräume und leitet Anfragen der Form

https://<registry-host>/id/<shortNamePath>/<id>/<version>

an die beim Namensraum-Objekt hinterlegte Adresse weiter. Dabei werden die Parameter <id> und <version> in der Zieladresse ersetzt. Ein Namensraum kann mehrere Zieladressen besitzen, die in Abhängigkeit des hinterlegten ID-Musters und ihrer Priorität verwendet werden.

 

  • Keine Stichwörter