Bei der GSS 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 den Administrator 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.

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 benötigten Dateien 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 in der Anwenderoberfläche/Anwendermenü finden Sie die blaue Lupe als Icon für diese Anwendung:

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

Für ehemalige cardo3 Nutzer:

Einige Features des GSS sind im cardo4 nicht implementiert. Somit kann für cardo4 eine eigene structure_c4.xml hinterlegt werden und in dieser die Features auskommentiert oder entfernt werden (siehe letzter Paragraph)

Befindet sich eine eigene xml für cardo4 im Ordner, so wird diese bevorzugt genutzt.

Vorgehensweise:

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, 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.

//Selbox muss im cardo4 immer da sein
if (!theme.selBoxAvailable) 
  {
    throw new System.Exception(String.Format("Thema '{0}' hat derzeit keine 
    SelBox aktiviert - in cardo4 muss diese da sein!", theme.tag));
  }
if (theme.source.userMappingClassSpecified)
  {
    throw new System.Exception(String.Format("Thema '{0}' ist Benutzermapping 
    aktiviert - cardo4 unterstützt dieses nicht!", theme.tag));
  }
//AddSelFields - noch nicht implementiert ...
if (theme.source.addSelFields != null && theme.source.addSelFields.Length > 0)
  {
    throw new System.Exception(
    String.Format("Beim Thema '{0}' ist mindestens ein AddSelField hinterlegt - 
    diese werden von cardo4 nicht ausgewertet!", theme.tag));
  }
//feste ZusatzButtons - im cardo4 gibt es nur den ResetButton: useReset
if (theme.addButtons != null
&& (theme.addButtons.useShowAtMap || theme.addButtons.useBubble))
{
  throw new System.Exception(
  String.Format("Das Thema '{0}' sind showAtMap oder useBubble als Zusatzbuttons 
  aktiviert - diese werden von cardo4 nicht unterstützt.", theme.tag));
}
//Freie Buttons - gibt es nicht in cardo4
if (theme.addButtons != null
&& theme.addButtons.addButton != null
&& theme.addButtons.addButton.Length > 0)
{
  throw new System.Exception(
  String.Format("Das Thema '{0}' sind freie Zusatzbuttons aktiviert - 
  diese werden von cardo4 nicht unterstützt.", theme.tag));
}