Bei der GSS Suche handelt es sich um ein kostenpflichtiges Modul!

Start:

Im cardo wird die GSS Suche über das Anwendungsmenü aufgerufen. Je nach Definition der xml Datei durch die Administration stehen ihnen verschiedene Suchroutinen zur Verfügung (Adresssuche, Flurstücksuche, ...). Mit einem Klick auf den Pfeil öffnet sich die Liste der Suchroutinen, bei mehreren können Sie hier eine auswählen.

Für das Erstellen der GSS-Suche wird eine XML Datei angepasst. Zu XML gibt es die entsprechende XSD zur Validierung und weiteren Beschreibung der Parameter.

Wir empfehlen bpsw. Visual Studio Code für die einfache Bearbeitung der Dateien.

Aus ihrer Sachdatenbank und den vorkonfigurierten Suchformularen erzeugen Sie mit dem Modul der generisch strukturierten Suche (GSS) eine anwenderfreundliche Suchoberfläche. Das verwendete Suchformular kann über eine XML-Datei erstellt, angepasst und optimiert werden. Die gefundenen Suchtreffer sind mit einer Kartenebene verbunden und lassen sich im Ergebnis der Suche auf der Karte anzeigen.

Die benötigten Dateien zur Konfiguration der GSS finden Sie in dem Ordner cardoSystem\coreWeb3\IIS\helpers\gss:

• structure.xsd
• structure.template.xml
• readme.txt (Beschreibung der Parameter)

und müssen in den Ordner ...\cardoSystem\_Projekt_XXX\Database\gss 

abgelegt werden. Sind die Dateien vorhanden (struckture.xml oder structure_c4.xml), erkennt cardo dies und im Anwendungsmenü finden Sie die blaue Lupe als Icon für diese Anwendung:

Berechtigungen:

Die Suchroutinen sind nicht berechtigungsabhängig. Das bedeutet, dass jeder angemeldete Nutzer diese Anwendung starten und ausführen kann.

Grundidee:

Im GSS können beliebig viele voneinander unabhängige Suchschemas ("Topics") definiert werden. Jedes Suchschema hat eine Id (Tag) und einen Titel. Ist mehr als ein Suchschema hinterlegt, erscheint oben in der Suche eine Liste zur Auswahl der gewünschten Suche.

Ein Suchschema wiederum beinhaltet beliebig viele Themen. Diese Themen können als Liste innerhalb des Suchschemas bereitgestellt werden oder - und das ist der typische Anwendungsfall - als Baumstruktur. Deshalb auch die Bezeichnung "strukturierte Suche". Für jedes Thema sind zahlreiche Eigenschaften zu vergeben. Diese dienen zum einen dazu, die Oberflächenelemente zu konfigurieren. Zum anderen beschreiben sie die Datenquelle, aus der sich ein Thema speist. Und sie legen fest, ob und wie einzelne Themen eines Topics miteinander verknüpft sind. Die einzelnen Eigenschaften sind in der oben erwähnten XSD - also der Strukturdatei zur XML (XML Schema Definition) - beschrieben.

Im Grundsatz kann man zwei Arten von Themen unterscheiden:

• Suchtreffer - d.h. das Thema ist mit einer Kartenebene verknüpft oder liefert direkt eine Verortungsinformation - auf jeden Fall lässt sich ein gefunderner Datensatz in der Karte anzeigen.
• Filter - d.h. das Thema dient dazu, die Listen der untergeordneten Themen einzuschränken

Einzelne Themen können beide Funktionen besitzen.

Beispiel Flurstückssuche

Am Beispiel einer Flurstückssuche lässt sich das vielleicht am besten verdeutlichen. Typischerweise startet diese mit dem Thema "Gemeinde". Dieses kann als reines Filter-Thema eingesetzt werden - der Anwender/in muss zuerst eine Gemeinde wählen. Auf zweiter Stufe gibt es dann die "Gemarkungen". Es werden nur die Gemarkungen angeboten, die sich innerhalb der zuerst gewählten Gemeinde befinden. Dieses Thema könnte als Suchtreffer fungieren - man könnte sich eine Gemarkung direkt auf der Karte anzeigen lassen. Zusätzlich dient das Thema als Filter für das dritte Thema der "Flurstücke". Sobald eine Gemarkung gewählt ist, werden alle Flurstücke der Gemarkung zur Auswahl angeboten. Dieses Thema dient ausschließlich als Suchtreffer - d.h. ein gefundenes Flurstück lässt sich letztentlich auf der Karte anzeigen.

Jedes Thema besteht in der Oberfläche im Kern aus einer Auswahlliste mit den Datensätzen. Diese Liste kann durch übergeordnete Filter-Themen ausgedünnt sein. Sobald eine Verbindung zu einer Kartenebene konfiguriert ist oder die Datensätze direkt eine Geometrie liefern, ermöglicht das Thema die Anzeige der Datensätze auf der Karte.

Vorgehensweise zur Konfiguration:

1. Laden Sie sich die zwei oben genannten Dateien aus dem Verzeichnis herunter!
2. Zum Öffnen und Bearbeiten der XML-Datei nutzen wir das VisualStudio oder Visual Studio Code, eine kostenfreie Testversion kann bei Microsoft heruntergeladen werden!
3. Öffnen Sie beide Dateien mit dem VisualStudio.
4. Nutzen Sie die structure.template.xml als Beispielvorlage!
5. Wie Sie sehen, existieren mehrere vorgefertigte topics (title="Flurstücksuche", title="Adresssuche", ...) in der XML-Datei.
6. Jede topic beschreibt eine Suchroutine!
7. Wird bspw. nur die Adresssuche benötigt, löschen Sie alle weiteren topic-Einträge aus der XML-Datei.
8. Unter jeder topic befindet sich ein theme mit den dazu benötigten Elementen.
9. In der structure.template.xml sind diese Elemente bereits vorhanden.
10. Diese können Sie nutzen oder aber die themes neu definieren.
11. Wenn Sie mit der Definition starten, ermöglicht VisualStudio auf der Basis der XSD-Datei das Autovervollständigen, d. h. für ein theme werden automatisch die benötigten Elemente und deren mögliche Parameter angezeigt.
12. Des Weiteren sehen Sie als Tooltip eine Beschreibung des Elementes und der Eigenschaften.
13. Wollen Sie bspw. wissen was type beschreibt, lassen Sie die Maus einen Moment auf dem type stehen und der Tooltipp (Typ der Datenquelle) erscheint.
14. Fehler in ihrer XML-Datei erscheinen, wenn benötigte Elemente fehlen oder die Parameter nicht richtig gesetzt worden. (Daran erkennen Sie auch, ob ihre xml-Datei vollständig ist.)
15. Speichern Sie die structure.template.xml als structure.xml.
16. Zur Validierung des XML-Dokuments steht die XSD-Datei zur Verfügung. Anschließend wird beim Initialisieren eines Themas zusätzlich eine inhaltliche Konsistenzprüfung durchgeführt.
17. Die neu erstellte structure.xml muss im cardo Datenbankverzeichnis (_Projekt_<IhrProjekt>/Database/gss) liegen.
18. Überprüfen Sie im cardo die Funktionen.