Metadatensuchclient (CSW): Unterschied zwischen den Versionen
(→Metadatensuchclient (CSW)) |
|||
| (23 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | + | == Allgemeines == | |
| − | + | ||
Mit der Metadatensuchclient - Komponente des GeoFachDatenServers können Sie Ihre Webseite oder Webanwendung besonders attraktiv gestalten und Ihren Nutzern einen zusätzlichen Service bieten. Die Einbindung dieses Dienstes in Portale, Webanwendungen und Fremdsysteme ist über die bereitgestellte Schnittstelle möglich. Mit dem Metadatensuchclient können Metadaten – Dienste1 abgefragt und in einer Nutzerfreundlichen Ausgabe dargestellt werden. | Mit der Metadatensuchclient - Komponente des GeoFachDatenServers können Sie Ihre Webseite oder Webanwendung besonders attraktiv gestalten und Ihren Nutzern einen zusätzlichen Service bieten. Die Einbindung dieses Dienstes in Portale, Webanwendungen und Fremdsysteme ist über die bereitgestellte Schnittstelle möglich. Mit dem Metadatensuchclient können Metadaten – Dienste1 abgefragt und in einer Nutzerfreundlichen Ausgabe dargestellt werden. | ||
| Zeile 7: | Zeile 6: | ||
* Der Metadatensuchclient benötigt direkten Zugriff zum jeweils konfigurierten Metadaten - Dienst. Es ist Ein- sowie Ausgehender Netzwerkverkehr via HTTP Protokoll (Port 80) notwendig, ggf. müssen Änderungen an der Netzwerk-konfiguration der GeoFachDatenServer Infrastruktur vorgenommen werden. | * Der Metadatensuchclient benötigt direkten Zugriff zum jeweils konfigurierten Metadaten - Dienst. Es ist Ein- sowie Ausgehender Netzwerkverkehr via HTTP Protokoll (Port 80) notwendig, ggf. müssen Änderungen an der Netzwerk-konfiguration der GeoFachDatenServer Infrastruktur vorgenommen werden. | ||
| − | + | === Das Metadatensuchclient Modul === | |
Das Metadatensuchclient Modul folgt einem gängigen Bedienkonzept und kann je nach Kundenwunsch und Anwendungsfall beliebig konfiguriert werden: | Das Metadatensuchclient Modul folgt einem gängigen Bedienkonzept und kann je nach Kundenwunsch und Anwendungsfall beliebig konfiguriert werden: | ||
* Einfache Suche nach Suchbegriff | * Einfache Suche nach Suchbegriff | ||
| Zeile 17: | Zeile 16: | ||
* Filterung nach Zeiträumen (am, von, bis, Intervall ) | * Filterung nach Zeiträumen (am, von, bis, Intervall ) | ||
Der Bedienkomfort wird durch die moderne Ajax-Technologie gewährleistet. Dabei werden Karten und Informationen bei Bedarf separat nachgeladen. | Der Bedienkomfort wird durch die moderne Ajax-Technologie gewährleistet. Dabei werden Karten und Informationen bei Bedarf separat nachgeladen. | ||
| + | [[Image:Metadatensuchclient Modul.png|thumb|500px|none|Abbildung 1: Das Metadatensuchclient Modul (Quelle der Daten: PortalU)]] | ||
| + | |||
| + | === Aufbau des Moduls === | ||
| + | Der Metadatensuchclient ist in die drei Bereiche Suchformular (Abb.1 Punkt 1), Suchkriterien (Abb. 1 Punkt 2) und Trefferliste (Abb. 1 Punkt 3) aufgeteilt. Das Suchformular bietet je nach Konfigurierten Suchoptionen diverse Filtermöglichkeiten. Oberhalb des Suchformulars werden die vom Nutzer festgelegten Suchkriterien aufgeführt. Unterhalb des Suchformulars erscheint die Trefferliste mit Listenpaginierung. | ||
| + | {| border="0" | ||
| + | | [[Image:Suchkriterien Thematische Filter.png|thumb|500px|none|Abbildung 2: Erweiterte Suchkriterien, Thematische Filter]] | ||
| + | | [[Image:Suchkriterien Temporale Filter.png|thumb|500px|none|Abbildung 3: Erweiterte Suchkriterien, Temporale Filter]] | ||
| + | |} | ||
| + | [[Image:Suchkriterien Spatialer Filter.png|thumb|500px|none|Abbildung 4: Erweiterte Suchkriterien, Spatialer Filter]] | ||
| + | |||
| + | === Bedienkonzept === | ||
| + | Das grundlegende Bedienkonzept folgt der Regel: je mehr Suchfilter gesetzt werden, desto genauer wird das Ergebnis. Werden in der Konfiguration keine Initial-Suchfilter definiert, so umfasst die erste Ergebnismenge immer alle Datensätze des Dienstes. | ||
| + | |||
| + | Wurde eine Suchanfrage mit einem oder mehreren Suchfiltern gestartet, so werden die Nutzereingaben in der Übersicht der Suchkriterien aufgeschlüsselt. An dieser Stelle hat der Nutzer die Möglichkeit einzelne Suchfilter direkt zu entfernen. Alternativ kann der Filter auch im Suchformular geändert oder entfernt werden. | ||
| + | [[Image:Suchkriterien Filter entfernen.png|thumb|500px|none|Abbildung 5: Suchkriterien Filter entfernen]] | ||
| + | |||
| + | ==== Kartendienste ==== | ||
| + | Handelt es sich bei einem Suchtreffer um einen Kartendienst (WMS), so besteht die Möglichkeit diesen in eine Karte einbinden zu lassen. Der Nutzer muss hierfür lediglich den Hyperlink „WMS zur Karte hinzufügen“ anklicken. | ||
| + | [[Image:WMS Dienst hinzufügen CSW.png|thumb|400px|none|Abildung 6: WMS Dienst auf Karte hinzufügen]] | ||
| + | Da diese Interaktion möglicherweise einige Sekunden dauert, wird der Nutzer via Dialogfenster informiert. | ||
| + | [[Image:WMS Dienst hinzugefügt CSW.png|thumb|400px|none|Abildung 7: WMS Dienst erfolgreich auf der Karte hinzugefügt]] | ||
| + | Konnte der Dienst der Karte hinzugefügt werden, so erhält der Nutzer eine entsprechende Erfolgsmeldung. Im Fehlerfall wird der Nutzer übe die Ursache des Fehlers informiert. | ||
| + | |||
| + | ''Mögliche Fehlerursachen:'' | ||
| + | Im Metadaten - Datensatz wurde eine fehlerhafte oder ungültige Dienst ‑ Adresse angegeben. Eine ungültige Adresse kann z.B. eine WMS Url sein, die lediglich aus einem Intranet erreichbar ist. Eine weitere mögliche Fehlerquelle ist ein inkompatibles Koordinatensystem. Das ist der Fall, wenn der WMS das Koordinatensystem der Karte nicht unterstützt. | ||
| + | |||
| + | == Konfiguration == | ||
| + | |||
| + | Das folgende Kapitel beschreibt die Bereitstellung und Konfigurationsoptionen für einen Metadatensuchclient auf Basis des GeoFachDatenServers. | ||
| + | |||
| + | Nach der erfolgreichen Anmeldung am System muss der Menüpunkt „Kartenvorlagen“ aufgerufen werden, um die Kartenvorlagenverwaltung zu starten. | ||
| + | |||
| + | == Einbidnung in Fremdanwendungen == | ||
| + | Der Modulinhalt kann in Fremdanwendungen eingebunden werden. Dazu muss eine entsprechende Seite im GeoCMS mit dem Modul Metadatensuchclient (CSW) angelegt und konfiguriert werden (siehe oben) z.B. unter http://www.example.com/metadatensuche.html. Die Einbindung in die Fremdanwendung erfolgt über entsprechende Mechanismen des einbindenden Systems, wie z.B. diverser "Fetch"- oder "Proxy"-Module. Zur Einbindung muss die Seite mit dem Metadatensuchclient (CSW) vom GeoCMS mit dem zusätlichen Parameter include=1 abgerufen werden, also z.B. http://www.example.com/metadatensuche.html?include=1. Das GeoCMS liefert in diesem Falle nicht den gesamten Seiteninhalt, sondern nur den Inhalt aus dem Hauptbereich (im HTML nur das Markup innerhalb des BODY-Tags). Über den Parameter "exclude" können diverse JavaScript- und CSS-Einbindungen ausgeschlossen werden. Standardmäßig werden sämtliche, vom Modul benötigte Ressourcen, mitgeliefert. Bringt nun das einbindende System eigene CSS-Dateien zum Styling des Moduls mit oder bindet JavaScript-Bibliothelen selbst ein, können diese exkludiert werden. Dabei ist zu beachten, das die Versionen der JavaScript-Bibliotheken kompatibel mit dem GeoCMS sind. | ||
| + | |||
| + | Folgende "exclude" - Anweisungen sind möglich | ||
| + | {| class="wikitable" | ||
| + | |- | ||
| + | ! exclude - Anweisung !! Beschreibung | ||
| + | |- | ||
| + | | gc || Deaktiviert die Einbindung der Basis-JavaScript-Dateien des GeoCMS. | ||
| + | |- | ||
| + | | csw || Deaktiviert die Einbindung der modulspezifischen JavaScript-Dateien des Metadatensuchclienten. | ||
| + | |- | ||
| + | | jquery || Deaktiviert die Einbindung der benötigten jQuery-Bibliothek. | ||
| + | |- | ||
| + | | jquery-ui || Deaktiviert die Einbindung der benötigten jQuery-UI-Bibliothek (JavaScript und CSS). | ||
| + | |- | ||
| + | | jquery-ui-datepicker || Deaktiviert die Einbindung der benötigten jQuery-UI-Bibliothek für die Datumsauswahl. | ||
| + | |- | ||
| + | | fe-widget || Deaktiviert die benötigte JavaScript-Datei des GeoCMS für den Detaildialog. | ||
| + | |} | ||
| + | |||
| + | Beispiel - Einbindung von jQuery und jQuery-UI deaktivieren: | ||
| + | http://www.example.com/metadatensuche.html?include=1&exclude=jquery,jquery-ui | ||
Aktuelle Version vom 20. Januar 2017, 12:36 Uhr
Inhaltsverzeichnis
Allgemeines
Mit der Metadatensuchclient - Komponente des GeoFachDatenServers können Sie Ihre Webseite oder Webanwendung besonders attraktiv gestalten und Ihren Nutzern einen zusätzlichen Service bieten. Die Einbindung dieses Dienstes in Portale, Webanwendungen und Fremdsysteme ist über die bereitgestellte Schnittstelle möglich. Mit dem Metadatensuchclient können Metadaten – Dienste1 abgefragt und in einer Nutzerfreundlichen Ausgabe dargestellt werden.
Wichtig:
- Die Nutzung des Metadatensuchclient erfordert aktiviertes JavaScript.
- Der Metadatensuchclient benötigt direkten Zugriff zum jeweils konfigurierten Metadaten - Dienst. Es ist Ein- sowie Ausgehender Netzwerkverkehr via HTTP Protokoll (Port 80) notwendig, ggf. müssen Änderungen an der Netzwerk-konfiguration der GeoFachDatenServer Infrastruktur vorgenommen werden.
Das Metadatensuchclient Modul
Das Metadatensuchclient Modul folgt einem gängigen Bedienkonzept und kann je nach Kundenwunsch und Anwendungsfall beliebig konfiguriert werden:
- Einfache Suche nach Suchbegriff
- Erweiterte Suche nach Suchbegriff und zusätzlichen Suchparametern
Zu den erweiterten Suchparametern zählen:
- Filterung nach Gebiet: Geografische Lage als Bezeichner, z.B.: Sachsen-Anhalt oder als Koordinaten (Bounding Box) auf Grundlage eines Kartenausschnitts
- Filterung nach Bereich (Art des Datensatzes, z.B. Dienst, Anwendung…)
- Filterung nach Thema (z.B.: INSPIRE Themenkatalog)
- Filterung nach Zeiträumen (am, von, bis, Intervall )
Der Bedienkomfort wird durch die moderne Ajax-Technologie gewährleistet. Dabei werden Karten und Informationen bei Bedarf separat nachgeladen.
Aufbau des Moduls
Der Metadatensuchclient ist in die drei Bereiche Suchformular (Abb.1 Punkt 1), Suchkriterien (Abb. 1 Punkt 2) und Trefferliste (Abb. 1 Punkt 3) aufgeteilt. Das Suchformular bietet je nach Konfigurierten Suchoptionen diverse Filtermöglichkeiten. Oberhalb des Suchformulars werden die vom Nutzer festgelegten Suchkriterien aufgeführt. Unterhalb des Suchformulars erscheint die Trefferliste mit Listenpaginierung.
Bedienkonzept
Das grundlegende Bedienkonzept folgt der Regel: je mehr Suchfilter gesetzt werden, desto genauer wird das Ergebnis. Werden in der Konfiguration keine Initial-Suchfilter definiert, so umfasst die erste Ergebnismenge immer alle Datensätze des Dienstes.
Wurde eine Suchanfrage mit einem oder mehreren Suchfiltern gestartet, so werden die Nutzereingaben in der Übersicht der Suchkriterien aufgeschlüsselt. An dieser Stelle hat der Nutzer die Möglichkeit einzelne Suchfilter direkt zu entfernen. Alternativ kann der Filter auch im Suchformular geändert oder entfernt werden.
Kartendienste
Handelt es sich bei einem Suchtreffer um einen Kartendienst (WMS), so besteht die Möglichkeit diesen in eine Karte einbinden zu lassen. Der Nutzer muss hierfür lediglich den Hyperlink „WMS zur Karte hinzufügen“ anklicken.
Da diese Interaktion möglicherweise einige Sekunden dauert, wird der Nutzer via Dialogfenster informiert.
Konnte der Dienst der Karte hinzugefügt werden, so erhält der Nutzer eine entsprechende Erfolgsmeldung. Im Fehlerfall wird der Nutzer übe die Ursache des Fehlers informiert.
Mögliche Fehlerursachen: Im Metadaten - Datensatz wurde eine fehlerhafte oder ungültige Dienst ‑ Adresse angegeben. Eine ungültige Adresse kann z.B. eine WMS Url sein, die lediglich aus einem Intranet erreichbar ist. Eine weitere mögliche Fehlerquelle ist ein inkompatibles Koordinatensystem. Das ist der Fall, wenn der WMS das Koordinatensystem der Karte nicht unterstützt.
Konfiguration
Das folgende Kapitel beschreibt die Bereitstellung und Konfigurationsoptionen für einen Metadatensuchclient auf Basis des GeoFachDatenServers.
Nach der erfolgreichen Anmeldung am System muss der Menüpunkt „Kartenvorlagen“ aufgerufen werden, um die Kartenvorlagenverwaltung zu starten.
Einbidnung in Fremdanwendungen
Der Modulinhalt kann in Fremdanwendungen eingebunden werden. Dazu muss eine entsprechende Seite im GeoCMS mit dem Modul Metadatensuchclient (CSW) angelegt und konfiguriert werden (siehe oben) z.B. unter http://www.example.com/metadatensuche.html. Die Einbindung in die Fremdanwendung erfolgt über entsprechende Mechanismen des einbindenden Systems, wie z.B. diverser "Fetch"- oder "Proxy"-Module. Zur Einbindung muss die Seite mit dem Metadatensuchclient (CSW) vom GeoCMS mit dem zusätlichen Parameter include=1 abgerufen werden, also z.B. http://www.example.com/metadatensuche.html?include=1. Das GeoCMS liefert in diesem Falle nicht den gesamten Seiteninhalt, sondern nur den Inhalt aus dem Hauptbereich (im HTML nur das Markup innerhalb des BODY-Tags). Über den Parameter "exclude" können diverse JavaScript- und CSS-Einbindungen ausgeschlossen werden. Standardmäßig werden sämtliche, vom Modul benötigte Ressourcen, mitgeliefert. Bringt nun das einbindende System eigene CSS-Dateien zum Styling des Moduls mit oder bindet JavaScript-Bibliothelen selbst ein, können diese exkludiert werden. Dabei ist zu beachten, das die Versionen der JavaScript-Bibliotheken kompatibel mit dem GeoCMS sind.
Folgende "exclude" - Anweisungen sind möglich
| exclude - Anweisung | Beschreibung |
|---|---|
| gc | Deaktiviert die Einbindung der Basis-JavaScript-Dateien des GeoCMS. |
| csw | Deaktiviert die Einbindung der modulspezifischen JavaScript-Dateien des Metadatensuchclienten. |
| jquery | Deaktiviert die Einbindung der benötigten jQuery-Bibliothek. |
| jquery-ui | Deaktiviert die Einbindung der benötigten jQuery-UI-Bibliothek (JavaScript und CSS). |
| jquery-ui-datepicker | Deaktiviert die Einbindung der benötigten jQuery-UI-Bibliothek für die Datumsauswahl. |
| fe-widget | Deaktiviert die benötigte JavaScript-Datei des GeoCMS für den Detaildialog. |
Beispiel - Einbindung von jQuery und jQuery-UI deaktivieren:
http://www.example.com/metadatensuche.html?include=1&exclude=jquery,jquery-ui
