Rasterdaten einbinden

2023-02-28T15:50:16Z

VSC:

Bilder wie z.B. ein gerade aufgenommenes Luftbild besitzen noch keine geographischen Koordinaten. Deshalb müssen die einzelnen Pixelwerte in geographische Koordinaten umgewandelt werden, damit das Bild dann im GIS-Programm ordnungsgemäß als Rasterdatei angezeigt werden kann. Oft bekommt man neben einem aufgenommenem Bild (z.B. im .tif-Format) eine Konvertierungsdatei (z.B. im .tfw-Format) mitgeliefert, die diese Umwandlungsdaten schon beinhält.<br/>

==Kachelberechnung==
GeoMedia SmartClient Kommunal berechnet aus Originalbildern eine Bildpyramide, wobei sich die Anzahl der
Stufen nach dem Maßstabsbereich richtet. Z.B. entstehen für einen Bereich von 1:50 bis
1:50000 fünf Stufen. Jede Stufe wird in Kacheln aufgeteilt.<br/>

Die Anzahl der Kacheln ist pro Stufe unterschiedlich und hängt auch vom Bereich ab den die
Karten abdecken - je kleiner der Maßstab, desto mehr Kacheln sind es. Im Beispiel für den
Maßstabsbereich vom 1:50 bis 1:2000 entstehen 88x100 Kacheln.<br/>

Für normale Luftbilder reicht eine Qualität von 85% aus - es ist fast kein Unterschied zwischen
85% und 100% bei Fotos feststellbar. Je höher die Qualität, desto größer der Speicherbedarf
einer Kachel auf der Festplatte.<br/>

Schaut sich ein Nutzer die Luftbilder an, werden entsprechend des aktuellen Maßstabs und
Bildauschnittes die Kacheln nachgeladen und im Clientcache genauso wie Vektordaten
abgelegt. Hat sich ein Nutzer also das gesamte Luftbild in allen Maßstabsstufen angesehen,
liegt eine komplette Kopie der Bildpyramide vom Server im Clientcache.<br/>

'''Speicherbedarf:'''<br/>
Aus 6 GB Originaldaten entstehen ca. 680 MB Daten als JPEG-Bildpyramide, d.h. am Client
liegen unter Umständen 680 MB im Clientcache auf der Festplatte.
Grundsätzlich muss man bei diesem Verfahren immer die Balance zwischen Speicherbedarf
(auf der Festplatte) und der Qualität finden. Je höher die Qualität, desto höher der
Speicherbedarf und umgekehrt.
== Rasterdaten prüfen==
Um Ihren Rasterdatensatz problemlos in GeoMedia SmartClient Kommunal darstellen zu können, sollten Sie Ihre Daten vor der Einbindung auf einige Eigenschaften überprüfen:
:*Befinden sich Ihre Daten im richtigen Format? Die Bilddatei muss im .tif-Format und die Weltdatei mit den dazugehörigen geographischen Koordinaten im .tfw-Format vorliegen. Wenn dies nicht der Fall ist, müssen Sie Ihre Daten mit einem geeigneten Programm konvertieren.
:*Fehlt die .tfw-Datei, kann diese mit Hilfe von GeoMedia Professional erstellt werden.<br/>
:*Sind die Bezeichnungen Ihrer Bilddatei und Ihres Worldfiles identisch (z.B. Luftbild.tif und Luftbild.tfw)? Dies ist Voraussetzung für Geomedia SmartClient Kommunal, um der Bilddatei das Worldfile automatisch zuordnen zu können.
'''Falls das Raster noch nicht verortet worden ist:'''<br/>
:*Ändern Sie die Koordinaten in der .tfw-Datei des Rasters. Hierfür gehen Sie wie folgt vor:
:*Fahren Sie in GMSC Kommunal mit der Maus über die Stelle im Kartenfenster, an der sich später die linke obere Ecke des Bildes befinden soll.
:*In der Statusleiste unter dem Kartenfenster sind immer die aktuellen Koordinaten abzulesen. Bitte notieren Sie sich diese, z.B. :[[File:Raster.png|185px]].
:*Suchen Sie nun im Verzeichnis Ihres Rasterdatensatzes die dazugehörige .tfw-Datei auf und öffnen Sie diese mit einem Editor-Programm.
:*Ändern Sie die letzten beiden Werte zu den eben notierten Koordinaten ab. Beachten Sie hierbei, dass sich nach der ganzen Zahl kein Komma, sondern ein Punkt befindet.

:[[File:Raster1.png|144px]].

:*Speichern Sie die Änderungen und schließen den Editor.
:*Laden Sie den Datensatz anschließend auf einen Online-Server hoch, z.B. auf den Server, auf dem sich auch Ihre anderen GeoMedia SmartClient Kommunal-Dateien befinden und merken Sie sich das Verzeichnis.
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Die Daten müssen dort auch nach der Publizierung gehalten werden, weshalb es ratsam wäre, sich zuvor über eine logische Datenstruktur Gedanken zu machen. Ebenso muss ausreichend Speicherplatz zur Verfügung stehen. </div>

:*Soll das Rasterbild gedreht werden, d.h. ist eine Drehung in den Werten in der .tfw-Datei angegeben, muss das Rasterbild per WebMap eingebunden werden. Ist das Rasterbild schon gedreht referenziert, kann es auch ohne WebMap eingebunden werden.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Rastersicht definieren==
Haben Sie Ihre Rasterdaten wie oben angegeben [[Rasterdaten einbinden#Rasterdaten prüfen|geprüft]], so können Sie in GeoMedia SmartClient Kommunal eine neue Sicht für das Raster definieren:
:*Klicken Sie im Kontextmenü des Explorer mit der rechten Maustaste auf Ihr Projekt, dann auf [[File:neu_16.png|16px]] (''Neu'') und dann auf [[File:neu_16.png|16px]] (''Rasterdaten'').<br/>

'''Im Dialogfenster folgende Einstellungen vornehmen:'''
<br/>
{| class="wikitable" style="width:50%"
|-
! colspan="2"|Rasterdaten-Einstellungen
|-
|'''Bezeichnung'''
||Ein frei wählbarer Name - dieser wird im Explorer angezeigt.

|-
|'''Datenquelle aus Fachanwendung'''
||"Individuelle Fachanwendung" muss ausgewählt werden.

|-
|'''GeoMedia Webmap verwenden'''
||Anhaken, wenn ein Rasterbild per WebMap eingebunden werden soll. Ist das Rasterbild bereits gedreht referenziert, kann es auch ohne WebMap eingebunden werden.<br />
[[File:Raster_GWM.PNG|700px]]

|-
|'''Datenbanktabelle'''
||Ein frei wählbarer Name. Es wird empfohlen, die Tabellen für den Namen der Rasterkarten mit "R_" beginnen zu lassen. Der Name darf noch nicht vorhanden sein und darf nur alphanumerische Zeichen ohne Umlaute oder Sonderzeichen beinhalten. Das Zeichen '_' darf enthalten sein.

|-
|'''Ausgabeformat'''
||Jede Kachel ist ein JPEG oder PNG-Bild (PNG ist für Schwarz-Weiß-Karten besser geeignet). Für JPEGs kann man den Komprimierungsgrad und damit die Qualität festlegen.

|-
|'''Qualität (1 .. 100)'''
||Anzeige-Qualität ähnlich der JPEG-Qualität. (Standardwert 90).

|-
|'''Maßstab von - bis'''
||Maßstabsanzeige der Rasterkarte von - bis. Achtung: Die Standardwerte sind hier auf 500-50.000 gesetzt, was bei einigen Projekten zu niedrig sein mag. Passen Sie die Angaben an Ihr Projekt an.

|-
|'''Rasterdaten-Verzeichnis'''
||Der Pfad zu den Rasterkarten aus der Sicht des Servers. Der Ordner enthält die Rasterdateien und die World-Files (die Georeferenzierungsdateien).

|-
|'''Darstellung'''
||Hier kann eine Darstellung der Rasterdaten ausgewählt werden (z.B. "Standard Rasterdaten"). Mehr zu diesem Thema in Kapitel [[Darstellung#Darstellungen zuordnen|Darstellungen zuordnen]].

|}
<br/>
Befindet sich Ihr Rasterdatensatz auf '''demselben''' Server, auf dem Sie auch GeoMedia SmartClient Kommunal verwenden, können Sie im Feld "Rasterdaten-Verzeichnis" ähnliche Angaben machen wie auf folgendem Screenshot "(C:\...\~.tif)":

[[File:Raster2.png|518px]]

*Klicken Sie auf [[File:Save 16.png|16px]] (''Speichern''). Im Explorer wird eine neue Sicht angelegt. Zum Publizieren folgen Sie nun den Schritten in Kapitel [[#Rastersicht publizieren und darstellen|Rastersicht publizieren und darstellen]].
<br/>

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Befindet sich Ihr Rasterdatensatz auf einem '''anderen''' Server, sind im Feld "Rasterdaten-Verzeichnis" folgende Angaben zu machen: "\\servername\Ordner\....".</div>

Zusätzlich sind folgende Dinge zu beachten:
*Das Verzeichnis, in dem sich Ihre Rasterdaten befinden, muss freigegeben werden. Klicken Sie hierzu mit der rechten Maustaste auf den übergeordneten Ordner, auf Eigenschaften und wechseln dann auf den Reiter Freigabe. Hier können Sie die Freigabeoptionen anpassen und z.B. für verschiedene Benutzer/-gruppen den Zugriff anpassen.
*Der Dienst "Hexagon InteropService" muss unter einem Benutzer laufen, der die Freigabe auf das Rasterverzeichnis hat. Im folgenden Screenshot hat diese zum Beispiel der Administrator. Klicken Sie hierzu mit der rechten Maustaste auf den Dienst. Klicken Sie auf Eigenschaften und wechseln dann zum Reiter "Anmelden". Setzen Sie dort einen Haken vor "Dieses Konto" und geben Sie einen Benutzer und das Kennwort ein.

[[File:Raster4.png|409px]]

*Den Dienst "Intergraph Tile Service" bitte analog dem InteropService einrichten.

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis 1:''' Wollen Sie mehrere Raster auf einmal einbinden, geben Sie im Feld "Rasterdaten-Verzeichnis" nicht nur die einzelne .tif-Datei an, sondern den Ordner, in dem sich die .tif-Dateien befinden (z.B. "C:\farallones\").</div>

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis 2:''' Wenn Sie ein Raster via GeoMedia Webmap in GMSC Kommunal einbinden, ändert sich auf Datenbankebene automatisch die Datenquelle von "Oracle" zu "GWMOracle" bzw. von "SQL Server" zu "GWM SQL Server". Dies kann im Smart Client nachvollzogen werden, indem Sie in "Features" Ihr Raster auswählen (R_ Tabellen) und dann die Eigenschaften unter "Data Source" einsehen.</div>

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Rastersicht publizieren und darstellen==
Damit Ihr Raster dargestellt werden kann, folgen Sie den Schritten:
:*Das Ladeverhalten des Rasters muss beim Speichern auf ''Publiziert'' eingestellt sein. ''Jobs'' öffnet sich im unteren Fenster und der Fortschritt des Publizierauftrags wird ersichtlich.
:*Damit Änderungen in GeoMedia SmartClient Kommunal stattfinden können, starten Sie das Programm bitte neu und öffnen dann wieder Ihr Projekt.
:*Setzen Sie einen Haken vor Ihrer neu angelegten Sicht und Ihr Raster wird angezeigt.
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Bitte achten Sie auf den Maßstab, in dem Sie sich befinden und vergleichen Sie diesen mit dem Maßstab, den Sie beim Definieren der Sicht angegeben haben.</div>
:*Die linke obere Ecke des Rasters wird auf die in der .tfw-Datei angegebenen Koordinaten projeziert.

:[[File:Raster3.png|800px]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Transparente Raster==
===Transparenz eines ganzen Rasters===
In GMSC Kommunal lässt sich die Transparenz (Deckkraft) eines Rasters folgendermaßen einstellen:
*Klicken Sie mit der rechten Maustaste auf Ihre Rastersicht und dann auf [[File:Raster_Deckkraft.png|19px]] (''Deckkraft'').
*Stellen Sie nun eine Deckkraft zwischen 0 und 100 ein.

===Transparente Flächenteile===
In Rasterdaten lassen sich auch Flächenteile desselben Farbwerts transparent schalten. Diese Funktion ist nützlich, um z.B. zu sehen, was sich unter dem Raster an bestimmten Stellen befindet. Ein Beispiel zeigt, wie Ihre Rasterdateien aussehen könnten, ohne einen Farbwert transparent geschaltet zu haben:

[[File:Raster_Transparent3.png|800px]]

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis''': Diese Funktion ist aktuell noch nicht direkt in GMSC Kommunal integriert. Im Folgenden wird ein Workaround mit Hilfe des Smart Clients beschrieben.</div>

'''Workaround:'''
*Öffnen Sie die Administratorseite des Smart Clients ("http://servername/GMSC/Administrator").
<br/>
*Je nachdem, ob Sie eine neue Bibliothek anlegen wollen, oder nicht, klicken Sie bei "Symbology" auf "New Library" oder auf "Libraries".
**Haben Sie "New Library" gewählt, geben Sie einen Namen ein und klicken auf "Save".
**Haben Sie "Libraries" gewählt, klicken Sie im Abschnitt "Symbology Definition" auf "Add".
<br/>
*Danach klicken Sie auf "From Editor".
*Vergeben Sie nun einen Namen für Ihre Darstellung (z.B. "Raster_transparent") und wählen Sie als Geometrietyp "Raster" aus.
*Klicken Sie dann auf "Load Editor" (lassen Sie ggf. noch die Java-Anwendung in Ihrem Browser zu).
<br/>
*Bleiben Sie im "Easy Mode" des Editors.
*Geben Sie nun einen Maßstabsbereich ein, in dem Ihr Raster angezeigt werden soll (z.B. 0 - 1000000000).
*Wählen Sie "pick transparent color" unter dem Reiter "Raster".

[[File:Raster_Transparent1.png|800px]]

*Um den gewollten Farbwert zu bestimmen, stehen Ihnen verschiedene externe Programme zur Verfügung. Eine Möglichkeit bietet das Programm "Paint".
**Öffnen Sie Ihr Raster in "Paint" und verwenden Sie das Pipettenwerkzeug ([[File:Raster_Pipette.png|25px]]).
**Klicken Sie damit einmal auf die Fläche mit dem gewollten Farbwert. Dieser wurde nun in der Palette zwischengespeichert.
**Klicken Sie nun auf "Palette bearbeiten" und versichern Sie sich, dass die Farbe ausgewählt ist.
**Notieren Sie sich den Rot-, Grün- und Blauwert.
*Klicken Sie im Smart Client nun in das Feld hinter "Opacity".
*Wechseln Sie zum Reiter "RGB" und geben die notierten RGB-Werte ein.

[[File:Raster_Transparent2.png|677px]]

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis''':
*Es bestehen verschiedene Möglichkeiten, im Smart Client einen Farbwert anzugeben. Andere externe Programme bestimmen den Farbwert beispielsweise auch als Farbcode (z.B. "F7EFE7"). In diesem Fall müsste lediglich der Farbcode in den Smart Client eingegeben werden (ohne einzelne RGB-Werte).
*Allgemein handelt es sich hierbei um tatsächliche Farbwerte, nicht um einen Farbindex- oder Pixelwert (0-255).</div>

*Der Farbwert "F7EFE7" wurde gewählt, um aus obigem Raster-Overlay-Screenshot einige Grundstücke der Farbe "F7EFE7" auszublenden und die darunterliegenden Luftbild-Flächen darzustellen.
*Bestätigen Sie Ihre Eingaben mit einem Klick auf "OK".
*Klicken Sie nun im Fenster unten auf "Save", damit Ihre Darstellung gespeichert wird.

*Wechseln Sie nun zu GMSC Kommunal.
*Hier können Sie jetzt entweder Ihr bestehendes Raster in der Darstellung ändern, oder Sie legen ein neues Raster an. In beiden Fällen jedoch muss das Raster [[Rasterdaten einbinden#Rastersicht publizieren und darstellen|publiziert]] und GMSC Kommunal danach neu gestartet werden.
*Wählen Sie Ihre neu erstelle Darstellung für das Raster aus.
*Wählen Sie als Ausgabeformat "'''PNG'''" aus.

[[File:Raster_Transparent4.png|609px]]

*Klicken Sie auf [[File:Save_16.png|16px]] (''Speichern'').

*Nun klicken Sie im Explorer mit der rechten Maustaste auf Ihr Raster und wählen [[File:Werkzeuge_16.png|16px]] (''Werkzeuge'') und dann [[File:Raster_publizieren.png|16px]] (''Publizieren'').
*Starten Sie GMSC Kommunal neu und lassen Sie sich Ihr Raster anzeigen.
Ihr Raster könnte nun so aussehen:

[[File:Raster_Transparent.png|800px]]

Da, wo sich Flächen mit dem Farbwert "F7EFE7" befanden, ist das Raster nun ausgeschnitten und die darunter liegenden Flächen sind sichtbar.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Rastermanager==
''ab Version 2022, 13.12.2022''

Es besteht die Möglichkeit große Mengen von Einzelrasterbildern, z.B. eingescannte B-Pläne, in einer einzigen Sicht zusammenzufassen. Diese Einzelbilder können aber trotzdem separat sichtbar oder unsichtbar geschaltet werden. Dazu registriert man die Bilder in einer sog. Rastermanager-Sicht. Der Vorteil des Rastermanagers liegt in der Reduktion der Anzahl der benötigten Sichten und damit einer Performanceverbesserung. Das Verfahren zu Registrierung von Rasterdaten im Rastermananger ist dabei ähnlich wie für eine normale Rasterdatensicht: Wählen Sie im Kontextmenü des gewünschten Explorer-Ordners den Punkt "Neu->Rasterdaten". Füllen Sie zunächst den Rasterdaten-Editor wie gewünscht und weiter oben beschrieben aus. Im Feld "Rasterdaten-Verzeichnis" tragen Sie das serverseitige Verzeichnis ein, welches die Einzelrasterbilder enthält. Dann haken Sie die Option "als Rastermanager-Sicht registrieren" an.

Es besteht die Möglichkeit zusätzlich zur Rastersicht eine passende Sicht für die Umringe der Bilder anzulegen. Füllen Sie dazu das Feld "Darstellung Umring-Sicht" aus. Sie benötigen dafür eine Darstellungsdefinition für Flächen. Optional können Sie der Darstellungsdefinition noch einen Text hinzufügen, welcher auf das Attribut "NAME" (Objektklasse "Rasterdaten") verweist.

Wenn Sie die Einstellungen nun speichern, wird eine Rastersicht angelegt und dieser eine zweite Sicht zugeordnet, welche die zugehörigen Umringe enthält. Um nun ein Einzelrasterbild, z.B. einen konkreten B-Plan, anzuzeigen öffnen Sie die Tabelle der Umringe durch Doppelklick auf die Umringe-Sicht. Erstellen Sie, falls noch nicht vorhanden, einen Spaltenaufbau mit den Attributen "Sichtbarkeit", "Name", "Priorität". Jeder Eintrag in der Tabelle entspricht einem Einzelrasterbild. In der ersten Spalte befinden sich für jeden Datensatz die Button zum Ein- oder Ausschalten des Bildes (diese befinden sich auch nochmal in der Toolbar). Schalten Sie ein Bild ein, wird automatisch zu der Stelle in der Karte gezoomt, die Rastersicht wird eingeschaltet und das Einzelrasterbild angezeigt. Die Spalte "Sichtbarkeit" zeigt außerdem den aktuellen Zustand an. Mit dem Feld "Priorität" kann die Darstellungsreihenfolge in der Einzelbilder in der Karte geregelt werden, was ggf. bei Überlappungen nützlich sein kann.

Für eine bestehende Rastermanager-Sicht können auch nachträglich noch weitere Einelrasterbilder registriert werden. Kopieren Sie dazu die neuen Bilder (und ggf. deren TFW-Dateien) in das Rasterdaten-Verzeichnis der Sicht. Öffnen Sie dann die Eigenschaften der Sicht und klicken Sie auf "Speichern". Die neuen Rasterbilder sind nun auch über die Umringe-Sicht verfügbar.

Sie können einer Rastermanager-Sicht auch neue Bilder durch Georeferenzierung hinzufügen. Wählen Sie dazu im Kontextmenü der Rastermanager-Sicht den Punkt "Neu -> Rasterdaten (georeferenzieren)". Wählen Sie die gewünschte Bilddatei aus und
referenzieren Sie sie. Sie wird dann automatisch der Rastermanager-Sicht zugeordnet.

Es besteht auch die Möglichkeit eine Rastermanager-Sicht durch Georeferenzierung eines Bildes neu anzulegen. Wählen Sie dazu im Kontextmenü des gewünschten Zielordners den Punkt "Neu -> Rasterdaten (georeferenzieren)" aus. Nach der Auswhal der Bilddatei werden Sie aufgefordert ein Unterverzeichnis auf dem Server anzugeben. Wählen Sie hier einen passenden eindeutigen Namen, z.B. den Gebietsnamen der B-Pläne. Dieser Unterordner wird von der Rastermanager-Sicht verwendet, um dort alle Einzelbilder, die zur dieser Sicht gehören, abzulegen. Nach Abschluss der Georeferenzierung öffnet sich der Editor für die Registrierung von Rasterdaten. Aktivieren Sie hier die Option "als Rastermanager-Sicht registrieren" und ordnen Sie die "Darstellung Umring-Sicht" zu. Nach dem Speichern wird die Rastermanager-Sicht und die Umringe-Sicht angelegt, welcher Sie nun weitere Bilder durch Georeferenzierung hinzufügen können.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Höhenprofil aus DGM/DOM-Daten==
''ab Version 2022, 30.01.2023''

DGM- (Digitales Geländemodell) und DOM- (Digitales Oberflächenmodell) Daten liegen entweder als XYZ- oder GeoTiff-Dateien vor und enthalten die Zuordnung von Höhen zu einer Koordinaten. Sie werden also als Raster mit einer bestimmen Bodenauflösung zur Verfügung gestellt. Um diese in GMSC-K einzulesen öffnet man im Explorer das Kontextmenü eines Ordners und wählt den Punkt "Import -> DGM/DOM aus XYZ/GeoTiff". Im folgenden Dialog wählt man entweder eine einzelne Datei oder eine Zip-Datei mit mehreren Dateien aus. Des weiteren kann man die Einfärbung der Daten zur Darstellung in der Karte auswählen (topografisch, grau, rot, grün oder blau und die Anzahl der Farbstufen). Außerdem kann man optional, falls bekannt, den minimalen und maximalen Höhenwert und die Bodenauflösung der Daten eingeben. Falls man diese Angaben nicht ausfüllt werden sie automatisch bestimmt, was aber etwas Laufzeit kostet. Dann startet man den Import.

Nach der internen Umwandlung in Rasterdaten öffnet sich ein Editor für eine Rasterdatenebene. Hier kann man zusätzliche Einstellungen vornehmen und diese dann speichern. Nun kann sind in der Karte die Höhendaten als Rasterbild zu sehen.

===Höhenprofil erstellen===

[[Datei:Hoehenprofil.png|mini]]

Um ein Höhenprofil zu erstellen wählt man im Kontextmenü einer DGM/DOM-Rasterdatensicht den Punkt "Werkzeuge -> Höhenprofil". Unterhalb der Karte öffnet sich dann ein neuer Reiter. Hier hat man verschiedene Werkzeuge zur Verfügung:

* Einzeichnen einer Referenzlinie: Klicken Sie diesen Button und zeichnen Sie dann in der Karte eine Polylinie entlang derer das Profil erstellt werden soll. Nach Abschluss der Linie mit Doppelklick wird im Höhenprofileditor das zugehörige Diagramm angezeigt, also die Höhendaten entlang der Linie.
* Kopieren eine bestehenden Geometrie als Referenzlinie: Klicken Sie in der Karte die gewünschte Geometrie an. Sie können eine Linie oder Fläche wählen, wobei bei Flächen der Umring verwendet wird.
* Anzeige der Höhe an einer Koordinate: Klicken Sie auf einen Punkt in der Karte und die Höhe wird angezeigt.
* Löschen aller Höhenprofile
* Export der Grafik nach SVG
* Einbinden der Grafik in der Karte an einer gewünschten Position
* Anzeige des Höhenprofiles in einer Tabelle: die Koordinaten der Höhenlinie werden mit Höhe und Station (gemessen vom Anfang der Linie) in einer Tabelle angezeigt. Von hier aus können die Daten dann weiter exportiert werden.
* Mit der Option "Anzeigen der Referenzgeometrie" wird im Diagramm durch eine gestrichelte Linie die Referenzgeometrie im Verhältnis zur Höhenlinie dargestellt. Voraussetzung ist allerdings, dass die Geometriekoordinaten z-Werte besitzen.

Es können auch mehrere Höhenprofile erfasst werden, welche zusammen im Diagramm angezeigt werden. Dabei gibt es immer ein aktives Profil, dessen Linie dicker gezeichnet wird und dessen Statistikdaten in der Toolbar zu sehen sind. Das aktive Profil kann mit einem Klick auf die entsprechende Linie gewechselt werden. Im Diagramm kann mit Klicken und Ziehen die Höhe an einer bestimmten Station angezeigt werden. Diese Position wird auch in der Karte eingezeichnet. Des weiteren können im Diagramm mit einem Doppelklick Marker an einer Station gesetzt werden. Für diese wird auf der Höhenlinie die entsprechende Höhe eingeblendet. Ein Marker kann mit Doppelklick wieder gelöscht werden.

Höhenprofile können auch in Reports eingebunden werden. Dazu muss in der Reportdefinition als Bildgenerator "Höhenprofil" gewählt werden. Als Referenzgeometrie wird das Objekt verwendet, für das der Report gestartet wird.

Es ist auch möglich eine Höhenlinie in einen Haltungslängsschnitt einzublenden. Dazu muss man in der Einstellungen des Haltungslängsschnittes die entsprechende DGM/DOM-Sicht auswählen.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

Abfragen und Auswertungen

2022-07-07T07:46:23Z

VSC: /* Installation der Crystal-Reports-Laufzeitumgebung */

==Suchcenter==

Mit dem Suchcenter können Sie in GeoMedia SmartClient Kommunal vorgefertigte Suchanfragen starten. Sie können z.B. nach Adressen oder Flurstücken suchen, indem Sie die entsprechende vordefinierte Suchanfrage auswählen. Ist noch keine Suchanfrage auswählbar oder sollen neue, individuelle Suchanfragen über das Suchcenter bereitgestellt werden, so können diese mithilfe des [[Konfigurationen#Filterkonfiguration|Filter-Managers]] konfiguriert werden.

Das Fenster "Suchcenter" öffnen Sie mit einem Klick auf [[File:search_center_16.png|16px]] ''(Suchcenter)'' in der [[Client-Benutzeroberfläche#Statusleiste|Statusleiste]]. Wählen Sie aus der Liste aus, wonach Sie suchen wollen. Im unteren Teil des Fensters erscheinen die Eingabefelder. Tragen Sie Ihre Suchbegriffe dort ein. Sollte Ihnen die genaue Schreibweise nicht bekannt sein, können Sie mit einem Platzhalter (*) die Eingabe abkürzen. Sie können die Suche nun mit der Schaltfläche "Suche starten" initiieren.

[[File:suchanleitung.PNG|800px]]

Das Ergebnis wird in einer Tabelle angezeigt, die mit der Suchcenter-Abfrage verknüpft ist. In der Statusleiste wird die Anzahl der gefundenen Ergebnisse angezeigt.

[[File:suchanleitung2.PNG|800px]]

Wenn zu viele Ergebnisse in der Tabelle erscheinen, müssen Sie Ihre Suche präzisieren. Das können Sie tun, indem Sie ein weiteres Eingabefeld füllen (falls vorhanden). Nach Eingabe des Wertes starten Sie die Abfrage erneut mit "Suche starten". Das Ergebnis aktualisiert sich in der noch geöffneten Tabelle. Um ein Ergebnis in der Karte anzuzeigen, klicken Sie auf das Symbol [[File:Karten_selektion_16.png|16px]] neben dem Tabelleneintrag. Um die zu dem Ergebnis zugehörigen Daten anzuzeigen und gegebenenfalls zu ändern, klicken Sie auf das Symbol [[File:bearbeiten__16.png|16px]].

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Sind mehrere Sichten auf eine Objektklasse vorhanden, die alle einen Sichtenfilter definiert haben, wird die Funktion [[File:karten_selektion_48.png|16px]] ''(Objekte in der Karte anzeigen)'' in der Tabellen Toolbar nicht angezeigt. Gibt es nur eine Sicht auf die Objektklasse, die keinen Sichtenfilter beinhaltet, ist die Funktion vorhanden. Wie [[Datenstruktur#Datenstruktur|hier]] beschrieben, kann eine Sicht die gesamten Datensätze einer Objektklasse darstellen oder eine Teilmenge davon. Die Suche im Suchcenter greift auf die Objektklasse und nicht auf die Sicht zu. <br />
Ist die Funktion nicht vorhanden, gibt es keine ungefilterte Sicht auf die entsprechende Objektklasse. In diesem Fall wird ihnen die Auswahl der Sichten angezeigt, sofern sie die Funktion [[File:karten_selektion_48.png|16px]] ''(Objekte in der Karte anzeigen)'' eines einzelnen Eintrags öffnen, in deren Objektklasse sich das gesuchte Objekt befindet. Je nachdem welche Sicht Sie dann auswählen, wird das Objekt in dieser Sicht angezeigt. Zum Beispiel entspricht dann die Darstellung der Definition der ausgewählten Sicht. Um die Funktion also dauerhaft angezeigt zu bekommen, muss mindestens eine ungefilterte Sicht auf die Objektklasse vorhanden sein.</div>

Falls keine Suchergebnisse gefunden werden, erscheint eine entsprechende Meldung.

[[File:keinesuchergebnisse.PNG|300px]]

Die Darstellung der Suchergebnisse können Sie über Spalten- und Sortierkonfiguration
beeinflussen. Unter "Filterkonfiguration" stehen in der zugehörigen Auswahlliste vordefinierte Filterfunktionen zur Verfügung, um die Suchergebnisse nach beliebigen Kriterien zu filtern. Wenn Sie Filterergebnisse rückgängig machen wollen, sodass wieder alle Datensätze in der Tabelle angezeigt werden, dann müssen Sie nur den Standard-Filter "keine" aus der Filterliste
wählen.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Abfragen aus der Karte==

*Ein oder mehrere Objekte in der Karte können ausgewählt werden.
*Je nach Einstellung wird die Auswahl durch eine andere Darstellung hervorgehoben (eine Markierung).
*Die Markierung ist eine Darstellungsdefinition, die pro Sicht individuell definiert werden kann.
*Standardmäßig werden Farben in rötlichen Tönen für die Hervorhebung ausgewählter Datensätze verwendet.
*Für die Auswahl der Objekte in der Karte stehen in der Werkzeugleiste der Karte mehrere Funktionen zur Verfügung:

{| class="wikitable" style="width:50%"
|-
! colspan="2"|Funktionen
|-
! Symbol
! Definition
|-
![[File:quickpickpunkt_24.png|24px]]
| Punktauswahl.
Mit dieser Funktion können Sie sich über
Objekte auf der Karte informieren. Durch
Mausklick wird die Funktion aktiviert, dann
klicken Sie auf der Karte auf das gefragte
Objekt.
|-
![[File:quickpick_rechteck_24.png|24px]]
| Rechteckauswahl.
Mit dieser Funktion werden alle Objekte
innerhalb eines frei vergrößerbaren
Rechtecks ausgewählt.
Dafür ziehen Sie mit gedrückter linker
Maustaste ein Auswahlrechteck auf und
lassen die Maustaste los, sobald sich die
gewünschten Objekte in dem
Auswahlrechteck befinden.
|-
![[File:quickpick_kreis_24.png|24px]]
| Kreisauswahl.
Mit dieser Funktion werden alle Objekte
innerhalb eines frei vergrößerbaren Kreises
ausgewählt.
Dafür klicken Sie mit der linken Maustaste
auf eine bestimmte Stelle in der Karte und
setzen so den Mittelpunkt des Kreises.
Anschließend bewegen Sie die Maus weg
von diesem Punkt. Der Kreis wird
aufgezogen. Ein weiterer Klick mit der
linken Maustaste beendet die Auswahl.
|-
![[File:quickpick_polygon_24.png|24px]]
| Polygonauswahl.
Diese Funktion ermöglicht das Auswählen
eines Bereiches in beliebiger Form.
Besonders geeignet, wenn nur bestimmte
Objekte ausgewählt werden sollen.
Mit der linken Maustaste setzen Sie die
Punkte des Rahmens. Mit Doppelklick
beenden Sie diesen Vorgang und zeichnen
somit den Rahmen.
|-
![[File:quickpick_linie_24.png|24px]]
|Linienauswahl.
Diese Funktion ermöglicht das Auswählen
von Objekten, die eine Linie schneiden. Mit
der linken Maustaste setzen Sie die Punkte
der Linie. Schließen Sie mit Doppelklick ab.
|-
![[File:ObjektalsBegrenzung.PNG|40px]]
|Markiertes Objekt als Begrenzung
Diese Funktion ermöglicht das Auswählen
von Objekten, welche sich innerhalb des ausgewählten Objekts befinden.
|-
![[File:QuickPickKartenausschnitt.PNG|40px]]
|Kartenausschnitt
Diese Funktion ermöglicht das Auswählen
von Objekten, welche sich innerhalb des aktuellen Kartenausschnitts befinden.
|}

'''Arbeitsschritte:'''
*Klicken Sie die gewünschte Funktion an.
*Klicken Sie das Objekt in der Karte an oder zeichnen Sie je nach Funktion die Auswahlfläche (als Rechteck oder Kreis o.ä.) in die Karte. Bestätigen Sie mit Linksklick.

'''Ergebnis:'''
*In der Karte erscheint ein Kontextmenü mit einer Auflistung der "gefundenen" Objekte pro Sicht.
*Die Art des Kontextmenüs hängt von der Anzahl der Objekte unterhalb des Mauszeigers ab. Dabei kann es vorkommen, dass mehrere Objekte einer oder mehrerer Sichten gefunden werden. Im Kontextmenü werden die Sichten, in denen sich die Objekte befinden, aufgelistet. Sie müssen sich dann für ein Objekt (einer Sicht) entscheiden.

In der folgenden Beispiel-Abbildung wurde per Punktauswahl ein Gebäude auf einem Flurstück ausgewählt. Da sich die markierte Stelle mit anderen Objekten auf der Karte (z.B. Flurstücke, Adressen) überschneidet, stehen diese Objekte im Kontextmenü zur Auswahl. Im Beispiel wird das Objekt "Gebäude für Handel- und Dienstleistungen" ausgewählt.

[[File:aus_karte_waehlen.PNG|800px]]

'''Was können Sie mit den ausgewählten Objekten tun?'''<br />
<br />
Es öffnet sich ein weiteres Kontextmenü. (Im Beispiel das von "Gebäude für Handels- und Dienstleistungen".)

[[File:kartenobjekt_kontextmenue.PNG|320px]]

Sie haben in Abhängigkeit des Geometrietyps (Punkt, Linie, Text, Fläche) und Ihrer Nutzer- bzw. Gruppen-Berechtigungen folgende
Optionen zur Verfügung:
{| class="wikitable" style="width:50%"
|-
! colspan="2"|Funktionen
|-
! Symbol
! Definition

|-
![[File:eigenschaften_16.png|16px]]
| Öffnen der Sicht-Eigenschaften (hier können die graphische Ausprägung, die maßstabsabhängige Darstellung bzw. Filter definiert werden)

|-
![[File:explorer_16.png|16px]]
| Anzeigen der Sicht im Explorer

|-
![[File:Alleauswaehlen.PNG|24px]]
| Auswählen (das Objekt wird graphisch hervorgehoben)

|-
![[File:aktiv_schalten_16.png|16px]]
|Aktivsetzen der Sicht

|-
![[File:mark_in_tabelle_16.png|16px]]
|Öffnen der zum Datensatz des Objekts zugehörigen Tabelle

|-
![[File:ebene_ausblenden_16.png|16px]]
|Ausblenden der Sicht

|-
![[File:bearbeiten_16.png|16px]]
|Öffnen des Objekt-Datensatzes in der Maskenansicht

|-
![[File:objektbrowser_bearbeiten_16.png|16px]]
|Hinzufügen zur aktuellen Objektliste

|-
![[File:dokument_16.png|16px]]
|Öffnen des Dokuments
|-
![[File:digitalisieren_16.png|16px]]
|Erstellen (Digitalisieren) eines neuen Objekts in der ausgewählten Sicht

|-
![[File:bearbeiten_16.png|16px]]
|Bearbeiten (vorhandene Objekte verschieben, Geometriepunkte löschen oder einfügen u.a.)

|-
![[File:graphische_selektion_16.png|16px]]
|Übernehmen der Geometrie

|-
![[File:loeschen_16.png|16px]]
|Löschen des Objekts

|-
![[File:geometry_punkt_16.png|16px]]
|Setzen eines Schwerpunkts

|}

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Räumliche Untertabellen==

In GeoMedia SmartClient Kommunal ist es möglich, räumliche [[Konfigurationen#Konfiguration von Zuordnungen|Zuordnungen]] von Objekten unterschiedlicher Objektklassen zu ermitteln. Diese Informationen können an den Objektklassen mittels räumlicher Untertabellen dargestellt werden.

===Überblick===

Als Beispiel sollen alle Gebäude auf einem Flurstück angezeigt werden. Das ist die Situation auf der Karte:

[[File:flurstueck_waehlen.PNG|800px]]

Es wurde also ein Flurstück auf der Karte mit darauf liegenden Wohngebäuden ausgewählt und die zugehörige Tabelle mit dem Datensatz geöffnet (siehe [[#Abfragen aus der Karte|Abfragen aus der Karte]]). Der Datensatz wird über [[File:bearbeiten_16.png|16px]] ''(Öffnen)'' aufgerufen. Im Maskenexplorer in der linken oberen Ecke wird im Beispiel nun die Registerkarte "Fachobjekte" ausgewählt. Im zugehörigen Fenster werden unterliegende Objekte angezeigt, in diesem Fall also Wohngebäude, die sich mit dem gewählten Flurstück überschneiden. Diese können jeweils über [[File:bearbeiten_16.png|16px]] bearbeitet werden oder ggf. auch mit [[File:Karten_selektion_16.png|16px]] zentriert in der Karte angezeigt werden.

[[File:fachobjekte.PNG|800px]]

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis''': Um eine solche räumliche Untertabelle für überschneidende Objekte einer beliebigen Sicht zu erhalten, muss sie erst konfiguriert werden. Dies wird im Folgenden beschrieben.
</div>

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Konfiguration===

Prinzipiell können alle Objekte, die in räumlicher Beziehung zu anderen Objekten stehen, in der räumlichen Untertabelle angezeigt werden. Dazu sind folgende Konfigurationen nötig:

*Es wird eine Registerkarte mit der räumlichen Untertabelle angelegt. Diese soll im Maskenexplorer erscheinen, wenn der Datensatz geöffnet wird. (Im obigen Beispiel war dies "Fachobjekte" für die Sicht "Flurstücke"). Das Anlegen dieser Registerkarte mit der Untertabelle erfolgt über den [[Konfigurationen#Maskenkonfiguration|Masken-Designer]] (siehe unten).
*Es wird eine [[Konfigurationen#Spaltenkonfiguration|Spaltenkonfiguration]] für die Tabelleneinträge der räumlichen Untertabelle erstellt, um festzulegen, welche Datenfelder in der Tabelle dargestellt werden sollen.

Beginnen Sie Ihre Konfiguration mit dem [[Konfigurationen#Maskenkonfiguration|Masken-Designer]], indem Sie diesen über Rechtsklick auf eine Sicht (im Beispiel: ''Flurstücke'') [[File:gis-daten_16.png|16px]] > [[File:konfiguration_16.png|16px]] ''Konfiguration'' > [[File:maskendesigner_16.png|16px]] ''Masken-Designer'' aufrufen.

Die räumliche Untertabelle der Beispiel-Sicht "Flurstücke" befindet sich in der Registerkarte "Fachobjekte" (in der Beispielabbildung rechts oben zu erkennen). Ist in Ihrer Sicht noch keine Untertabelle vorhanden, so legen Sie zunächst eine neue Registerkarte an, indem Sie das Symbol [[File:registerkarte.PNG|16px]] anklicken und auf die Registerkartenleiste im rechten Fenster hinüberziehen (siehe auch unter [[Konfigurationen#Allgemeine Vorgehensweise|Allgemeine Vorgehensweise]] bei Maskenkonfigurationen). Unter "Value" in der zugehörigen Einstellungsmaske (im Fenster weiter unten) können Sie die Registerkarte benennen. Ziehen Sie anschließend eine räumliche Untertabelle über das zugehörige Symbol [[File:maskendesigner_16.png|16px]] ''(räumliche Untertabelle)'' in die erstellte Registerkarte.

[[File:maskendesigner.PNG|800px]]

Um Konfigurationen an der räumlichen Untertabelle vornehmen zu können, klicken Sie zunächst auf Ihre Tabelle, sodass nun im unteren Abschnitt des Masken-Designers die zugehörige Einstellungsmaske erscheint. Darin lässt sich die Auswahl der Objektklassen für den räumlichen Filter vornehmen. Klicken Sie hierzu auf das Symbol [[File:objektklasse_auswaehlen_16.png|16px]] ''(Objektklasse auswählen)''.

[[File:maskendesigner3.PNG|601px]]

Es öffnet sich die Objektklassenauswahl. Über Eingabe in das Feld "Filtereingabe" kann nach einer Objektklasse gesucht werden oder die Auswahl durch die Eingabe eines Teilbegriffs eingeschränkt werden. Alternativ kann eine Fachanwendung gewählt und die gewünschte Objektklasse aus der zugehörigen Liste ausgesucht werden.

[[File:editor_objektklasse.PNG|400px]]

Die gewählten Objektklassen erscheinen nun im Maskenfeld "Objektklasse". Mit Doppelklick lassen sie sich wieder aus dem Feld entfernen. Rechts neben dem Feld kann der räumliche Filter gesetzt werden (im Beispiel: "schneidet", d.h. alle Objektklassen, die das betreffende Flurstück schneiden, werden aufgelistet - zu weiteren räumlichen Operatoren siehe [[Abfragen und Auswertungen#Topologische Operatoren|Topologische Operatoren]]).

Anschließend wird die Konfiguration über [[File:save_16.png|16px]] ''(Speichern)'' gespeichert. Beim Öffnen des Datensatzes zu einem Objekt der entsprechenden Sicht wird nun die erstellte Registerkarte angezeigt. Öffnen Sie diese, so finden Sie darin die im Masken-Designer definierte räumliche Untertabelle. Nun können Sie noch bestimmen, welche Datenfelder zu den Objekten der Tabelle aufgelistet werden sollen.

Klicken Sie hierzu auf das Symbol [[File:spaltenaufbau_16.png|16px]] ''(Spalten-Assistent)'' über der Tabelle, um die Spaltenkonfiguration vorzunehmen. Ziehen Sie die gewünschten Datenfelder von der Liste ins rechte Fenster (siehe hierzu [[Konfigurationen#Spaltenkonfiguration|Spaltenkonfiguration]]) und speichern Sie.

Öffnen Sie nun erneut die räumliche Untertabelle zu einem Objekt der entsprechenden Sicht, so werden dort - falls vorhanden - unterliegende Objekte nach benutzerdefiniertem Spaltenaufbau angezeigt.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Räumliche Abfragen==

Mit räumlichen Abfragen können Sie räumliche Beziehungen zwischen Objekten analysieren.
Die Ergebnisse sind Datensätze, die in einer Tabelle zur weiteren Bearbeitung oder Ausgabe angezeigt werden.

Den Editor zum Erstellen räumlicher Abfragen können Sie in jeder Tabelle über das Symbol [[File:Raeumliche_abfrage_16.png|16px]] ''(Öffnet den Editor zum Erstellen von räumlichen Abfragen)'' öffnen.

[[File:editoroeffnen.PNG|669px]]

Sie können im Editor eine benutzerdefinierte räumliche Abfrage anlegen, indem Sie auf [[File:neu_16.png|16px]] ''(neue räumliche Abfrage erstellen)'' klicken.

[[File:editor_neu.PNG|260px]]

Vergeben Sie einen Namen und ggf. einen Beschreibungstext für die Abfrage. Anschließend wählen Sie die gesuchte Objektklasse aus. Damit legen Sie die Tabelle fest, die sich nach dem Starten der Abfrage mit den Ergebnissen öffnet. Klicken Sie hierzu auf das Symbol [[File:objektklasse_auswaehlen_16.png|16px]] ''(Objektklasse auswählen)''. Es öffnet sich die Objektklassenauswahl (siehe oben). Dort können Sie nach einem Objektklassen-Namen suchen oder erst die Fachanwendung wählen und dann die gewünschte Objektklasse aus der zugehörigen Liste.

Anschließend können Sie zusätzlich noch einen Filter auswählen. Dieser muss allerdings im Vorfeld schon angelegt worden sein (siehe [[Konfigurationen#Filterkonfiguration|Filterkonfiguration]]). In der Beispiel-Abbildung unten wurde der Filter "Gebäudefunktion – Wohngebäude" gewählt.

Neben der gesuchten brauchen Sie anschließend auch eine zu verschneidende Objektklasse. Dazu wählen Sie die gesuchte Objektklasse über das zugehörige Symbol das Symbol [[File:objektklasse_auswaehlen_16.png|16px]] aus (im Beispiel: "Flurstück"). Auch bei der zu verschneidenden Objektklasse können Sie einen Filter wählen, der die Datenmenge einschränkt (im Beispiel: "Flurstücke städtisch").

Alternativ gibt es die Möglichkeit, in der Tabelle oder in der Karte markierte Objektklassen auszuwählen. Die Wahl von Objektklassen aus der Tabelle bedeutet, dass Sie die Tabelle der zu verschneidenden Objektklasse öffnen und Datensätze markieren müssen. Bei der Wahl von Objektklassen aus der Karte müssen Sie zuvor Objekte in der Karte markieren. Mit der Schaltfläche [[File:refresh_16.png|16px]] aktualisieren Sie die Anzahl der in der Tabelle ausgewählten Datensätze, falls diese sich geändert hat.

Der räumliche Filter entscheidet nun, [[#Topologische Operatoren|in welcher Art und Weise]] (siehe unten) die räumliche Verschneidung durchgeführt wird (im Beispiel: innerhalb, d.h. alle Gebäude, die sich innerhalb von städtischen Flurstücken befinden).

[[File:editor_abfrage_definition.PNG|749px]]

Die Abfrage kann nun über Klick auf [[File:start_16.png|16px]] ''(räumliche Abfrage ausführen)'' gestartet werden. Es öffnet sich die Tabelle mit den gefundenen Objektklassen. In der Statusleiste wird die Anzahl an Ergebnissen (Anzahl der geladenen Datensätze) angezeigt. Die Datensätze der (Ergebnis-)Tabelle können nun eingesehen werden bzw. die Objekte zentriert in der Karte dargestellt werden.

Wenn die Ergebnisse Ihren Erwartungen entsprechen, kann die räumliche Abfrage über [[File:save_16.png|16px]] gespeichert werden. Die Abfrage erscheint ab jetzt in der Liste links im Editor unter dem Ordner der entsprechenden Fachanwendung. Per Doppelklick kann die Abfrage wieder ausgewählt und bearbeitet werden.

===Topologische Operatoren ===

Es stehen verschiedene topologische Operatoren (räumliche Beziehungen) zur Wahl, die als räumlicher Filter für die Abfrage genutzt werden können. Dazu gehören:

*Enthält
*Kreuzt
*Verschieden
*IstGleich(Räumlich)
*Schneidet
*Überschneidet
*Berührt
*Innerhalb
*im Abstand von

Im Folgenden sollen diese Beziehungen (außer bei Linien-Geometrien) anhand des Beispiels "Wohnhäuser auf Flurstücken" erläutert werden. Hierzu wurde jeweils ein einzelnes Flurstück mit Wohngebäuden [[#Abfragen aus der Karte|per Punktauswahl]] ausgewählt und die zugehörige Tabelle geöffnet. Der Tabelleneintrag wurde ausgewählt und der Editor zum Erstellen von räumlichen Abfragen geöffnet. Als gesuchte Objektklasse wurden Wohngebäude gewählt, als zu verschneidende Objektklasse Flurstücke, und es wurde über Markierung von "in Tabelle ausgewählte Objekte" der aktuelle Flurstück-Datensatz ausgewählt. Anschließend wurden die zur Verfügung stehenden räumlichen Filter getestet (Gebäude "..." Flurstück):

'''Enthält:'''

Es werden alle Objekte herausgefiltert, die Objekte der zu verschneidenden Objektklasse enthalten. Im Beispiel wäre dies ein Gebäude (in der folgenden Abbildung blau dargestellt), das das betreffende Flurstück "enthält", d.h. das so groß ist, dass es das Flurstück überdeckt. In der Abbildung werden die Grenzen des enthaltenen Flurstücks mit grünen Linien angedeutet.

[[File:enthaelt.PNG|600px]]

'''Kreuzt:'''

Dies betrifft Linien-Geometrien. Es werden alle Objekte herausgefiltert, die sich mit Objekten der zu verschneidenden Objektklasse kreuzen. Im Beispiel kreuzt eine strittige Flurstücksgrenze (rot eingezeichnet) das betreffende Flurstück (grün markiert).

[[File:kreuzt.PNG|600px]]

'''Verschieden:'''

Es werden alle Objekte herausgefiltert, die von der zu verschneidenden Objektklasse verschieden sind - im Beispiel also alle Wohngebäude außerhalb des gewählten Flurstücks.

'''IstGleich(Räumlich):'''

Es werden alle Objekte herausgefiltert, die (räumlich) gleich einem Objekt der zu verschneidenden Objektklasse sind. Im Beispiel wäre dies also ein Wohnhaus (in der folgenden Abbildung blau dargestellt), das genau die Fläche des Flurstücks abdeckt:

[[File:istgleich.PNG|600px]]

'''Schneidet:'''

Es werden alle Objekte herausgefiltert, die sich mit der zu verschneidenden Objektklasse schneiden, d.h. es gibt an irgendwelchen Stellen räumliche Schnittpunkte zwischen den verschiedenen Objekten. In der Beispiel-Abbildung schneiden sich fünf Gebäude mit dem grün markierten Flurstück, da sie sich gleiche Flächen teilen. Das blaue Gebäude oben links in der Abbildung gehört nicht mit zu den Ergebnissen, da es sich nicht mit dem betreffenden Flurstück schneidet.

[[File:schneidet.PNG||600px]]

'''Überschneidet:'''

Es werden alle Objekte herausgefiltert, die sich mit Objekten der zu verschneidenden Objektklasse überlappen. Dies betrifft im Beispiel also Gebäude, die nur zu einem Teil auf dem entsprechenden Flurstück stehen (in der Abbildung ist dies das markierte Gebäude auf dem grünen Flurstück). Die ermittelten Gebäude würden also sowohl bei "schneidet" als auch bei "überschneidet" gelistet werden.

[[File:ueberschneidet.PNG||600px]]

'''Berührt:'''

Es werden alle Objekte herausgefiltert, die sich an den Grenzen mit einem Objekt der zu verschneidenden Objektklasse berühren.

'''Innerhalb:'''

Das Gegenteil von "enthält". Es werden nur die Objekte herausgefiltert, die sich komplett innerhalb der zu verschneidenden Objektklasse befinden. In der Beispiel-Abbildung sind dies also nur die markierten Wohngebäude, die sich komplett innerhalb des grünen Flurstücks befinden:

[[File:innerhalb.PNG||600px]]

'''Im Abstand von:'''

Bei Wahl dieses Filters erscheint ein zusätzliches Textfeld im Editor, in das ein beliebiger Abstand (in Metern) zur zu verschneidenden Objektklasse eingegeben werden kann:

[[File:abstand_von.PNG||440px]]

Im Beispiel wird nach Gebäuden gefiltert, die sich in einem Abstand von bis zu 10 Metern zum gewählten (grün markierten) Flurstück befinden. Die ermittelten Wohngebäude sind in der Karte rot markiert:

[[File:abstand.PNG||600px]]
<br />
<br />
[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

= Report erstellen =
GMSC-K vefügt ab Version 2016 SP2 über drei verschiedene Reportsoftwareanbindungen: Crystal Reports, Eclipse BIRT und Jasper Reports. Damit können Sie Daten aus GMSC-K unter Angabe einer Vorlage in ein PDF exportieren wobei auch die Möglichkeit besteht ein Kartenbild einzubinden. Zunächst eine kurze Übersicht:
{| class="wikitable" border="1"
|-
!
! Crystal Reports
! Eclipse BIRT
! Jasper Reports
|-
| Homepage
| https://www.crystalreports.com/
| https://www.eclipse.org/birt/
| https://community.jaspersoft.com/
|-
| Lizenz
| Kommerziell
| OpenSource
| OpenSource mit kommerziellen Erweiterungen und Support
|-
| Support vom Hersteller
| Ja
| Ja, über Mailinglisten
| Ja
|-
| Reportlayout
| Millimeter genau möglich
| Automatisches Layout mit Größenvorgaben
| Millimeter genau möglich
|-
| Unterreports
| Ja, eigene Unterreportvorlage
| Ja, direkte Einbindung von Untertabellen ohne eigene Unterreportvorlage
| Ja, direkte Einbindung von Untertabellen oder eigene Unterreportvorlage
| Skriptsprache
| Ja
| Ja
| Ja
|}

* Objekte für die man einen Report erstellen möchte in Tabelle markieren
* mit der Maus auf das Report-Icon in der Tabelle klicken, es öffnet sich der Reportdefinitons-Editor.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Aufbau des Reportdefinitons-Editors==

[[File:Reportdef editor.png|900px]]

# Liste der zur Verfügung stehenden Reports
# Eine neue Reportdefinition wird angelegt. Dabei wird der Name und Reportpfad aus den entsprechenden darüber liegenden Eingabefeldern verwendet.
# Die aktuell ausgewählte Reportdefinition wird mit den aktuellen Daten der Eingabefelder gespeichert.
# Die aktuell ausgewählte Reportdefinition wird gelöscht.
# Name des aktuell ausgewählten Report bzw. Namen-Eingabefeld für einen neu anzulegenden Report
# Auswahl der Reportsoftware (''ab Version 2016 SP2'')
# Optionale Aktion, die vor der Ausführung Reports gestartet werden soll, z.B. ALB-Abrufprotokoll
# Format der Reportergebnisdatei (PDF, Word etc.)
# Eingabefeld für den Pfad zur Reportvorlagedatei, die für einen neu anzulegenden Report verwendet werden soll. Zur Pfadauswahl dient der Button am rechten Ende des Eingabefeldes
# Eingabefeld für den Pfad zur Reportvorlagedatei, welche in der aktuell ausgewählten Reportdefinition gespeichert werden soll. Mit dem Pfadauswahl-Button kann dabei ein externern vorliegender Report ausgewählt werden.
# Öffnet die Reportvorlagedatei der aktuellen Reportdefinition lokal in der dafür vorgesehenen Anwendung. Dabei wird der lokale Pfad zu diesem Report in Feld 10 eingetragen.
# Ersetzt die Reportvorlage in der aktuellen Reportdefinition mit dem im Feld 10 angegebenen Report.
# Speichert die Reportvorlagedatei lokal in einem selbstgewählten Ordner.
# Eingabefeld für den Namen des Alternativreports. Der Name muss der einer bereits angelegten Reportdefinition sein. Diese Funktionalität spielt nur bei der Verwendung von Kartenausschnitten als Bild innerhalb des Reports eine Rolle. Der hier angegebene Report wird dann verwendet, wenn die Maßstabsangaben des Hauptreports zu klein für die Erstellung des Kartenausschnittbildes sind. Weiterhin wird dies nur bei der Einzelreporterstellung ausgewertet.
# Zugeordnet Reports können verwendet werden, um innerhalb eines Report verschiedene Papierformate zu verwenden. Z.B. kann für dies Ausgabe der Sachdaten das A4-Format verwendet werden, für die Ausgabe der Karte jedoch A3. Reports können durch Drag&Drop aus der Reportliste links in die Tabelle der zugeordneten Reports eingefügt werden. Ein Report mit zugeordneten Reports besitzt selbst keine Reportvorlage sondern für jeden Datensatz werden nacheinander die zugeordneten Reports ausgeführt und das Ergebnis in einer Gesamt-PDF-Datei gespeichert.
# Erstellt einen neuen Bilddefinitionseintrag in der darunter liegenden Bilddefinitionstabelle. Dies wird benötigt um Kartenausschnitte als Bild in den Report einzufügen.
# Löscht den aktuell ausgewählten Bilddefinitionseintrag.
# Kopiert den aktuell ausgewählten Bilddefinitionseintrag.
# Zeigt wahlweise nur die Bilddefinitionseinträge des aktuellen Projektes an oder alle. Damit kann ein Bilddefinitionseintrag einfach von einem Projekt in ein anderes kopiert werden.
# Name der Bilddefinition. Dies muss sich auf einen entsprechenden Parameter in der Reportvorlagedatei beziehen.
# Breite des zu Bildbereichs in der Reportvorlagedatei in Millimeter, d.h. das Bild wird mit dieser Breite von Kartenauschnitt erzeugt. Wird hier ein anderer Betrag angegeben als im Bildbereich, wird das Bild im Report entsprechend skaliert.
# Höhe des zu Bildbereichs in der Reportvorlagedatei in Millimeter, d.h. das Bild wird mit dieser Höhe von Kartenauschnitt erzeugt. Wird hier ein anderer Betrag angegeben als im Bildbereich, wird das Bild im Report entsprechend skaliert.
# Die Größe des Randbereichs des Bildes um das Fachobjekt in Prozent.
# Liste von Attributen, welche eine Verknüpfung zu anderen Objekten darstellen, von denen die Geometrie als Grundlage für die Erstellung des Kartenausschnittes genommen werden soll. Die Angabe erfolgt dabei in der Punktnotation wie sie im Maskeneditor zur Information verwendet wird. Wird hier nichts angegeben, wird automatisch nur die Geometrie des selektierten Objektes verwendet. Sobald hier ein Eintrag vorhanden ist, werden nur noch die hier angegebenen verknüpften Objektgeometrien verwendet. Um dann auch das selektierte (Haupt-)Objekt mit einzubeziehen muss dies durch die Angabe von „position“ als Attributname geschehen. Als Trenner ist Komma (,) oder Semikolon (;) möglich. Aber immer nur eins von beiden.
# Liste der möglichen Maßstäbe, die diese Bilddefinition unterstützt, z.B. bei 1:1000 Angabe von 1000. Wird kein passender Maßstab gefunden, wird der Alternativreport ausgeführt. Als Trenner ist Komma (,) oder Semikolon (;) möglich. Aber immer nur eins von beiden.
# Zu verwendete Arbeitssitzung für die Erstellung des Kartenausschnittbildes. Dadurch ist es möglich sich gezielt eine Arbeitssitzung zu definieren, welche den Vorstellungen für den Kartenausschnitt entsprechen und immer wieder verwendet werden kann.
# Hier kann optional der Name einer Darstellungsvariante angegeben werden.
# Liste der Sichtenfilter. Hier kann man genauer definieren, welche Objekte man in den einzelnen Sichten des Kartenausschnittes haben möchte. Die Syntax ist wie folgt: Objektklassen-ID = Attributpfad. Die Objektklassen-ID erhält man im Eigenschaftsdialog der jeweiligen Sicht. Der Attributpfad entspricht den verknüpften Objekten ausgehend von dem selektierten Hauptobjekt (wie in Punkt 25 beschrieben). Als Trenner ist Komma (,) oder Semikolon (;) möglich. Aber immer nur eins von beiden.
# Die ID des Projektes, für die dieser Bilddefinitionseintrag angelegt wurde. Ein Bilddefinitionseintrag ist immer einem Projekt zugeordnet da die Angaben zur Sichtenzuordnung in Punkt 29 immer projektabhängig sind.
# Gibt die gewünschte Auslösung für Rasterdaten an, die ggf. im Kartenbild ausgegeben werden.
# Erstellt einen Report und öffnet die fertige Datei danach automatisch mit der dafür vorgesehenen Anwendung lokal.
# Erstellt einen Report und speichert diesen in einem vom Nutzer definierten Ordner.
# Erstellt einen Report und öffnet die fertige Datei danach automatisch mit der dafür vorgesehenen Anwendung lokal. Ausserdem wird für jedes selektierte Objekt ein Dokument in GeoMedia SmartClient Kommunal angelegt, das die eben erstellten Report enthält und damit dauerhaft in GeoMedia SmartClient Kommunal hinterlegt ist.
# Erstellt für jedes selektierte Objekt eine einzelnen Report und hinterlegt diesen per Dokument-Objekt in GeoMedia SmartClient Kommunal.
# Führt eines Testlauf durch, bei dem kein Report erzeugt wird. Am Ende öffnet sich eine Textdatei mit dem Ergebnis des Testlaufs. Dies ist vor allem sinnvoll, um vorher zu überprüfen, ob der angegebene Maßstab für den Kartenausschnitt ausreicht.

=== Reportparameter ===
''(ab Version 2020, 23.08.2021)''

Für Reports können zusätzliche Parameter definiert werden, die dann im Report ausgewertet werden können. Ein Reportparameter wird wie folgt definiert:

# Name: Name, mit welchem im Report auf den Parameter zugegriffen wird
# Bezeichner: Bezeichner, welcher dem Nutzer bei Ausführung des Reports angezeigt wird
# Typ: der Datentyp - Text, Zahl, Gleitkommazahl, Datum, Auswahlliste
# Standardwert: ein Wert entsprechend des Datentyps, welcher beim Ausführen des Reports voreingestellt ist. Für Auswahllisten wird hier eine kommaseparierte Liste von Werten angegeben, welche dann dem Nutzer als Klappbox gezeigt wird. Der Standardwert kann in dieser Liste mit ein '*' markiert werden, z.B. "5,6*,7".
# Nutzerdefiniert: der Nutzer kann den Wert des Parameters ändern
# Pflichtfeld: der Nutzer muss zwingend einen Wert eingeben

Diese Angaben können durch Doppelklick in die entsprechenden Spalte der Tabelle der Parameter im Reporteditor geändert werden.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Crystal Reports==

===Installation der Crystal-Reports-Laufzeitumgebung===
'''ACHTUNG:''' Ab Version 2016 SP2 wird die Crystal-Reports-Laufzeitumgebung nicht mehr mit ausgeliefert sondern muss separat heruntergeladen und installiert werden. Gehen Sie dazu wie folgt vor:

* Laden Sie die Laufzeitumgebung von hier herunter: https://www.crystalreports.com/cre/confirm/?url_id=text-us-sapcom-creclipse-trial-landing (Download "Runtime libraries").
* Packen Sie die Zip-Datei aus und kopieren Sie alle Dateien aus dem Order ''lib'' in das GMSC-K-Installationsverzeichnis unter C:\Program Files\Intergraph\GeoMedia SmartClient Kommunal\Instances\Default\Server\thirdparty\CrystalReports\.
* Starten Sie anschliessend den GMSC-K-Server-Dienst neu.

===Vorbereiten einer Crystal Report-Datei für die Integration von Kartenausschnitten===

* In der CR-Datei muss ein Bildbereich definiert werden. (Einfügen OLE-Objekt)
* Per rechte Maustaste im Bild den Grafik-Formatieren Dialog aufrufen und den Haken aus „Kann grösser werden entfernen“

[[File:Format editor.png|500px]]

* Im Reiter „Bild“ kann man die Bildgrösse in Millimeter einsehen. Im selben Tab den Button „Speicherort der“ betätigen, um einen dynamischen Speicherort anzugeben.

[[File:Format editor2.png|500px]]

* Im nun geöffneten Formeleditor eingeben, wie sich der Bildpfad zur Laufzeit berechnet:

[[File:Formel editor.png|900px]]

Dabei wird ein Crystal Report-Parameter verwendet (?bild1) gefolgt von der ID der Objektes welches in diesem Report dargestellt werden soll (KA_Haltung.ID) und die Dateiendung des Bildes (.png).
Der Name des Bild-Parameters wird dabei als Name für die Bilddefinition verwendet. Über diesen schreibt GeoMedia SmartClient Kommunal zur Laufzeit einen Teil des Bildpfades in diesen Parameter und Crystal Report vervollständigt diesen mit Hilfe der oben angegebenen Formel.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Integration des Massstabes zu einem Kartenauschnitt===

* Für diese Funktion muss ein Parameter mit den Namen „reportdatenid“ erstellt werden. Dieser wird genutzt um zur Laufzeit eine eindeutige ID für jeden Reporterstellungsprozess zu erzeugen.
* Dies erfolgt mit Hilfe eines Unterberichts in Crystal Report. Also muss zuerst ein Unterbericht erstellt werden ( Einfügen  Unterbericht)
* Zuerst einen Namen eingeben und dann den Berichtsassistenten aufrufen

[[File:Unterbericht einf.png|500px]]

* Dann die Tabelle „Reportdaten“ auswählen.

[[File:Standardberichterst assi.png|900px]]

* Dann den „Datenwert01“ der Tabelle „Reportdaten“ anzuzeigenden Wert auswählen

[[File:Standardberichterst assi2.png|900px]]

* Danach diesen Dialog per Weiter-Button beenden
* Im Verknüpfung-Reiter die ID des Hauptobjektes und den Parameter „reportdatenid“ übernehmen.

[[File:Unterbericht einf2.png|500px]]

* Den Dialog mit OK bestätigen, Unterbericht einfügen und per Doppelklick öffnen.
* Im Menü Bericht  Auswahl-Assistenz  Datensatz den Auswahl-Assistent öffnen.
* Hier wird definiert wie der Massstab zur Laufzeit aus der Zwischentabelle Reportdaten ermittelt wird. Die Ermittlung erfolgt dabei auf dem Feld „Datenschlüssel“ dieser Tabelle und der setzt sich in diesem Fall wie folgt zusammen: ID der Reportdaten + ID des Hauptobjektes + Name des Bildparameters/Bilddefinition
* Die Tabelle der Reportdaten wird zur Laufzeit von GeoMedia SmartClient Kommunal gefüllt und nach der Reporterstellung wieder geleert.

[[File:Auswahl assi.png|600px]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Nutzen von Shared Variablen===

Shared Variablen (SV) werden verwendet um Dateninhalte an verschiedenen Stellen eines Reports gemeinsam zu verwenden. Dies ist besonders für den Informationsaustausch zwischen dem Hauptbericht und den Unterberichten interessant. Dabei kann zum Beispiel ein Unterbericht genutzt werden, um bestimmte Daten aufzubereiten (z.B. Personen die mit einer bestimmten Personenart verknüpft sind oder Summenberechnungen über Datensätze, die mit dem Hauptobjekt verknüpft sind) und das Ergebnis danach in die Shared Variable zu schreiben, so dass das es im Hauptbericht zur Verfügung steht.

'''Beispiel:''' Finden der Person mit einer bestimmten Personenrolle (Notar)

:1) Shared Variablen werden mit Hilfe von Formeln genutzt. Zuerst wird eine Formel angelegt, die die SV initialisiert:

:[[File:formel editor3.png|600px]]

:2) Diese SV muss nun in einen möglichst weit oben liegenden Bereich des Berichtes eingefügt werden. Dieser Bereich muss ein anderer Bereich sein und er muss über dem Bereich angeordnet sein, in dem die SV genutzt werden soll. Dies dient dazu, das die SV erst von CR initialisert werden muss, um dann in den weiter unten liegenden Bereichen verwendbar zu sein. Der Bereich in dem die SV eingefügt wird, kann (oder sollte) dann ausgeblendet werden. (Der passende Screenshot dazu befindet sich weiter unten in Abschnitt 5)
:3) Jetzt wird ein Unterbericht erstellt, der die Personen, die dem Hauptobjekt zugewiesen sind nach einer bestimmten Personenart filtert (hier 'NT' für Notar):

:[[File:datenbank assi.png|600px]]

:[[File:Haltungsbericht testen.png|600px]]

:4) Zuerst benötigen wir eine Formel, die die SV zurücksetzt. Dies ist notwendig, wenn man einen Report für mehrere Datensätze macht und die SV ansonsten noch den Inhalt des vorherigen Datensatzes enthält. Diese Formel sollte in den Berichtskopf des Unterberichts eingefügt werden:

:<syntaxhighlight lang="sql" line >
SHARED StringVar Notar_Nachname;
Notar_Nachname := '';
</syntaxhighlight>

:[[File:formel editor4.png|600px]]

:5) Danach wird die SV in diesem Unterbericht mit einer weiteren Formel mit Inhalt gefüllt (Zeile 2: der Nachname wird zugewiesen). Wichtig ist dabei, das die SV im Unterbericht selber vorkommen (z.B. in den Detailbereich gezogen) muss, damit diese auch ausgeführt wird. Die unten aufgeführte Formel listet alle Notar-Nachnamen komma-separiert auf. Möchten man nur einen Notar anzeigen reicht es den If-The-Else Teil komplett durch die Zeile nach dem Then-Befehl zu nutzen:

:<syntaxhighlight lang="sql" line >
if( Notar_Nachname = '' )
then
Notar_Nachname := {AX_PERSON.NACHNAMEODERFIRMA}
else
Notar_Nachname := Notar_Nachname + ", " + {AX_PERSON.NACHNAMEODERFIRMA};
</syntaxhighlight>

:[[File:formel editor5.png|600px]]

:6) Jetzt den Unterbericht ebenso wie die SV zur Initialisierung in einen möglichst weit oben liegenden Detail-Bereich des Hauptberichtes ziehen. Dies sollte aber nicht der Seiten- oder Berichtskopf sein, damit die SV sich nur auf den aktuellen Datensatz bezieht:

:[[File:haltungsbericht.png|600px]]

:7) Die vorherigen Schritte dienten nur dem Erzeugen und Befüllen der SV. Um die SV zu nutzen wird im Hauptbericht eine weitere Formel angelegt, die den Inhalt der SV zurück gibt. Diese Formel kann dan als normales Textfeld beliebig oft im Hauptbericht verwendet werden. Bitte darauf achten das Semikolon in der zweiten Zeile weg zu lassen:

:[[File:formel editor6.png|600px]]

:[[File:haltungsbericht2.png|600px]]

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
'''Tip:''' Hier wird eine SV vom Typ String/Text verwendet, für Zahlen gibt es den Variablentyp 'NumberVar'.</div>

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===MSSQL-Datenbank per ODBC einbinden===
Die ODBC-Verbindung bezieht sich auf eine Verbindung zu einem Datenbankserver, auf denen sich die eigentlichen Datenbanken befinden. D.h. Schritte 1 bis 7 beziehen sich auf das Einrichten einer Verbindung zu diesem Datenbankserver mit Hilfe von ODBC. Im Schritt 8 wir dann über diese Datenbankserver-Verbindung die eigentliche Datenbank ausgewählt, die man in Crystal Reports verwenden möchte.

:1. Zuerst muss in Windows eine ODBC-Verbindung eingerichtet werden. Dazu die Datenquellenverwaltung öffnen.

:[[Datei:ODBC sys.PNG|643px]]

:2. Eine neue Datenquelle hinzufügen.

:[[Datei:Datenquelle.PNG|643px]]

:3. SQL-Server auswählen.
:4. Dann einen Namen vergeben (so taucht diese Verbindung später in Crystal Reports wieder auf) und einen im Netzwerk vorhandenen Server auswählen.
:5. Dann auf "Weiter" klicken und die Anmeldedaten eintragen.
:6. In den nachfolgenden (per "Weiter" geklickt) Dialogfenstern entsprechende Einstellungen vornehmen (können auch alle auf den voreingestellten Werten gelassen werden) und im letzten Dialogfenster "Fertig stellen" klicken.
:7. Nun Crystal Reports öffnen und unter dem Menüpunkt Datenbank den Datenbankassistenten aufrufen. Dann das Kreuz links neben dem ODBC-Eintrag auswählen und dann den Datenbank-Server (den eben erstellten ODBC-Eintrag) auswählen den man verwenden möchte.
:8. Im letzten Schritt noch die Benutzerdaten eintragen und die Datenbank auswählen. Die Datenbank kann man erst auswählen, wenn die Anwender-ID und Kennwort richtig eingetragen sind.

==Eclipse BIRT==
''(ab Version 2016 SP2)''

Eclipse BIRT ist eine Open Source Reportsoftware. Der BIRT Designer kann hier heruntergeladen werden: http://download.eclipse.org/birt/downloads/#designer.
Im folgenden wird beschrieben wie Sie einen BIRT-Report in GMSC-K einbinden.
Eine komplette Beispielreportvorlage findet Sie hier: [[Datei:Stammblatt_Flurstuecke.zip]]

===Report-Parameter definieren===
Im ersten Schritt müssen Sie folgende Report-Parameter definieren, die später beim Aufruf des Reports aus GMSC-K übergeben werden:

* jdbcDriverClass - Datenbankverbindung
* jdbcDriverUrl - Datenbankverbindung
* jdbcUsername - Datenbankverbindung
* jdbcPassword - Datenbankverbindung
* selectionId - Verweis auf markierte Datensätze, die im Report angezeigt werden sollen
* reportDataId (optional) - Verweis auf zusätzlich Daten, wenn ein Kartenbild eingebunden wird
* karte (optional) - Verweis auf ein Kartenbild, der Name dieses Parameters muss mit dem Namen des Bildes in der Reportdefinition in GMSC-K übereinstimmen

:[[Datei:birt_reportparameter.PNG|245px]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Datenquelle erstellen===

Legen Sie nun eine neue JDBC-Datenquelle an

:[[Datei:birt_datasource.PNG|876px]]

und verbinden Sie deren Eigenschaften (Properties) mit den entsprechenden Reportparameteren.

:[[Datei:birt_datasource_properties.PNG|876px]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Daten einbinden===

Im nächsten Schritt legen Sie ein Dataset an und verweisen Sie in der SQL-Abfrage durch einen Join mit der Tabelle ''MARKIERUNG'' und dem Parameter ''selectionId'' auf die in GMSC-K selektierten Datensätze:

:[[Datei:birt_dataset_query.PNG]]

Verbinden Sie den Parameter der SQL-Abfrage mit dem Reportparameter ''selectionId''.

:[[Datei:birt_dataset_parameters.PNG]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Kartenbild integrieren===

Um ein Kartenbild zu integrieren benötigen Sie den Reportparameter ''karte'' (siehe Abschnitt zu Reportparametern). Legen Sie dann in im Report an der gewünschten Stelle ein Bild an und setzen die URI auf den Wert

''params["karte"].value + row["FLURSTUECK_ID"] + ".png"''

wobei ''FLURSTUECK_ID'' der Verweis auf die ID des aktuellen Datensatzes ist, der wie unten gezeigt angelegt wird.

:[[Datei:birt_karte_einbinden.PNG|1079px]]

<br />
<br />

:[[Datei:birt_karte_einbinden_2.PNG|759px]]

Der Maßstab des Bildes kann über die Reportdaten angezeigt werden. Legen Sie dazu den Reportparameter ''reportDataId'' und ein Dataset für die Tabelle ''REPORTDATEN'' mit dem Parameter ''reportDataId'' an:

:[[Datei:birt_reportdaten_query.PNG|786px]]

:[[Datei:birt_reportdaten_parameter.PNG|786px]]

Im Data Set Parameter-Binding geben Sie für den Parameter ''reportDataId'' den Wert ''params["reportDataId"].value + row["FLURSTUECK_ID"] + "karte"'' an.
Benutzen Sie dann die Spalte ''DATENWERT01'' aus dem Dataset, um den Maßstab einzubinden:

:[[Datei:birt_reportdaten_massstab.PNG|1067px]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

== JasperReports ==
''(ab Version 2016 SP1)''
JasperReports ist eine Open Source Reportsoftware. Der Designer JapserReports Studio kann hier heruntergeladen werden: https://community.jaspersoft.com/community-download.

Hinweis: Im Unterschied zu BIRT oder Crystal Reports können Unterberichte auch als separate Dateien eingebunden werden. Damit GMSC-K alle Reportdateien zur Verfügung hat, müssen Sie alle nötigen jrxml-Dateien in eine Zip-Datei packen und diese in GMSC-K hochladen. Dabei muss die Hauptreportdatei folgender Namenskonvention entsprechen: [GMSC-K-Reportdefinitionname]_main.jrxml. Verwenden Sie für Unterreports eingebettete Tabellen können Sie einfach nur die jrxml-Datei hochladen, deren Name dann beliebig sein kann.

Eine Beispielreportvorlage, die sowohl Unterberichte aus Dateien als auch aus eingebetteten Tabellen verwendet, findet Sie hier: [[Datei:JasperReports Stammblatt.zip]]

Im folgenden wird beschrieben wie Sie einen JasperReport in GMSC-K einbinden.

===Report-Parameter definieren===
Im ersten Schritt müssen Sie folgende Report-Parameter definieren, die später beim Aufruf des Reports aus GMSC-K übergeben werden:

* selectionId - Verweis auf markierte Datensätze, die im Report angezeigt werden sollen
* reportDataId (optional) - Verweis auf zusätzlich Daten, wenn ein Kartenbild eingebunden wird
* karte (optional) - Verweis auf ein Kartenbild, der Name dieses Parameters muss mit dem Namen des Bildes in der Reportdefinition in GMSC-K übereinstimmen

:[[Datei:jasper_reportparameter.PNG|343px]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Datenquelle erstellen===

Legen Sie nun eine neue JDBC-Datenquelle an:

:[[Datei:jasper_datasource.PNG]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Daten einbinden===

Im nächsten Schritt legen Sie ein Dataset an und verweisen Sie in der SQL-Abfrage durch einen Join mit der Tabelle ''MARKIERUNG'' und dem Parameter ''selectionId'' auf die in GMSC-K selektierten Datensätze:
Verbinden Sie den Parameter der SQL-Abfrage mit dem Reportparameter ''selectionId''.

:[[Datei:jasper_dataset_query.PNG]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Kartenbild integrieren===

Um ein Kartenbild zu integrieren benötigen Sie den Reportparameter ''karte'' (siehe Abschnitt zu Reportparametern). Legen Sie dann in im Report an der gewünschten Stelle ein Bild an und setzen die URI auf den Wert

''$P{karte} + $F{ID} + ".png"''

wobei ''$F{ID}'' der Verweis auf die ID des aktuellen Datensatzes ist, der wie unten gezeigt angelegt wird.

:[[Datei:jasper_karte_einbinden.PNG]]

Der Maßstab des Bildes kann über die Reportdaten angezeigt werden. Legen Sie dazu den Reportparameter ''reportDataParameter'' und ein Dataset für die Tabelle ''REPORTDATEN'' mit dem Parameter ''reportDataId'' an:

:[[Datei:jasper_reportdaten_query.PNG]]

Im Data Set Parameter-Binding geben Sie für den Parameter ''reportDataParameter'' den Wert ''$P{reportDataId} + $F{ID} + "karte"'' an.

:[[Datei:jasper_reportdaten_parameter.PNG]]

Benutzen Sie dann die Spalte ''DATENWERT01'' aus dem Dataset, um den Maßstab einzubinden.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

=Flächenbilanz=

'''Flächenbilanz einzeln:'''
:*Klicken Sie mit der rechten Maustaste auf [[File:Projekte_16.png|16px]] (''Projekt'') > [[File:Exportieren_16.png|16px]] (''Export'') > [[File:neu_16.png|16px]] (''Flächenbilanz (einzeln)'').

:[[File:x53.png|800px]]

Es öffnet sich zunächst der schon für den DXF-Export verwendete Dialog zur Markierung von Objekten in der Karte, wobei dieser Dialog nur Sichten mit Geometrietyp „Fläche" oder „beliebig" anzeigt und beachtet.
:*Zeichnen Sie ein oder mehrere Polygone über das Auswahltool des Markierungsdialogs ein. Die getroffenen Objekte werden in der Karte als markiert dargestellt, wobei Objekte markiert werden, die innerhalb der Markierungspolygone liegen oder davon geschnitten werden.
:*Die Anzahl der markierten Objekte pro Sicht wird in der Sichtenliste angezeigt.

:[[File:x54.png|800px]]

:*Klicken Sie auf [[File:Exportieren_16.png|16px]] (''Export'') in der Toolbar des Markierungsdialoges. Es wird ein modaler Dialog geöffnet der nochmals die Liste der Sichten anzeigt, welche durch die Markierung betroffen sind.

:[[File:x55.png|400px]]

:*Nachdem Sie „OK" geklickt haben, schliessen sich Export- und Markierung-Dialog und die Berechnung startet mit Fortschrittsanzeige. Dabei wird eine CSV-Datei erzeugt.
:*Nach Abschluss der Berechnung wird die CSV zum Client transferiert, dort im temporären Verzeichnis gespeichert und das über das Betriebssystem registrierte Programm für CSV-Dateien (Excel, OpenOffice, etc.) automatisch damit geöffnet:

:[[File:x56.png|800px]]

Bei der Flächenbilanz (einzeln) wird eine CSV-Datei nach folgenden Regeln erzeugt:
#Innenliegende Flächen werden komplett übernommen
#Schneidende Flächen werden mit ihrem Anteil, der innerhalb der Begrenzungsfläche liegt, übernommen. Pro Objekt und Sicht gibt es immer nur eine Flächenausgabe, d.h. entstehen durch die Verschneidung eines Objektes einer Sicht mehrere Teilflächen, geht nur die Gesamtsumme dieser Teilflächen in die Statistik ein.
#Kommt ein Objekt mehrfach in den gewählten Sichten vor, geht das Objekt auch mehrfach, also einmal pro Sicht, in die Statistik ein.

Im Modus „Einzeln" wird pro markiertes Objekt eine Zeile in der CSV-Datei unter Angabe von Objekt-ID (Spalte A), Fläche (Spalte B), Sichtenname (Spalte C) und den ggf. im Spaltenaufbau definierten Attributen erzeugt.

'''Flächenbilanz Einzeln mit Spaltenaufbau:'''
:*Klicken Sie mit der rechten Maustaste auf [[File:Projekte_16.png|16px]] (''Projekt'') > [[File:Exportieren_16.png|16px]] (''Export'') > [[File:neu_16.png|16px]] (''Flächenbilanz (einzeln)'').
:*Wählen Sie ein Objekt aus und starten Sie Export. Es öffnet sich ein Dialogfenster, in dem Spaltenaufbauten angegeben werden können, um zu definieren welche Attribute mit ausgegeben werden.
:*Öffnen Sie Spalteneditor hinter einer Sicht:

:[[File:x60.png|600px]]

Spalteneditor öffnet sich, kann erstellt und gespeichert werden.

[[File:x61.png|800px]]

:*Klicken Sie auf "OK".

:[[File:x62.png|600px]]

Export startet. CSV datei wird geöffnet. Die im Spaltenaufbau für die Sicht gespeicherten Attribute werden mit ausgegeben.

'''Flächenbilanz Summe:'''
:*Klicken Sie mit der rechten Maustaste auf [[File:Projekte_16.png|16px]] (''Projekt'') > [[File:Exportieren_16.png|16px]] (''Export'') > [[File:neu_16.png|16px]] (''Flächenbilanz (Summe)'')

:[[File:x57.png|800px]]

:*Alle Schritte wie bei der Flächebilanz (einzeln).

:[[File:x58.png|300px]]

Bei der Flächenbilanz (Summe) wird eine CSV-Datei nach folgenden Regeln erzeugt:
#Innenliegende Flächen werden komplett übernommen
#Schneidende Flächen mit ihrem Anteil, der innerhalb der Begrenzungsfläche liegt, übernommen. Pro Objekt und Sicht gibt es immer nur eine Flächenausgabe, d.h. entstehen durch die Verschneidung eines Objektes einer Sicht mehrere Teilflächen, geht nur die Gesamtsumme dieser Teilflächen in die Statistik ein.
#Kommt ein Objekt mehrfach in den gewählten Sichten vor, geht das Objekt auch mehrfach, also einmal pro Sicht, in die Statistik ein.

:[[File:x59.png|800px]]

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

Vorgangsverwaltung

2022-05-24T11:43:02Z

VSC:

[[Category:GeoMedia SmartClient Kommunal Fachanwendungen]]

Im Basissystem von GeoMedia SmartClient Kommunal ist die Funktionalität der Vorgangsverwaltung enthalten. Hierbei geht es um das Anlegen, Planen und Dokumentieren von Maßnahmen und Tätigkeiten, wie z.B. Baumkontrollen, Spielplatzkontrolle, Straßenkontrolle, Inspektionen, Wartungen usw., inkl. eventueller Kosten- und Gebührenberechnungen. Soll z.B. für einen Stadtteil eine Baumkontrolle durchgeführt werden, so werden die betroffenen Bäume einem Vorgang zugeordnet. Zu den verschiedenen Vorgangsarten erstellt der Anwender Templates, d.h. es wird festgelegt was im Zuge eines Vorganges alles abgearbeitet werden muss. Im Zuge einer Baumkontrolle z.B. steht anschließend für jeden Baum eine „Checkliste“ (Tätigkeitsliste) zur Verfügung.

<br />
<br />

Dieser Bereich beschreibt den Aufbau und die Funktionen der Fachanwendung Vorgangsverwaltung, die aber Bestandteil des Basissystems ist.
<br>
<br>

=Grundlagen=

Die Funktionalität ist Fachanwendungsübergreifend (nicht IFA), d.h. mit dieser Funktionalität können Baumkontrollen genauso wie Schieberinspektionen etc. abgebildet werden. Auf der einen Seite sind die Fachobjekte (Baum, Gebäude, Schieber, Kanalschacht usw.) vorhanden und auf der anderen Seite werden Vorgänge angelegt, in denen definiert wird, welche Maßnahmen wann und eventuell von wem durchgeführt werden sollen. Die Objekte (keine IFA-Objekte) werden also den Vorgängen zugeordnet oder umgekehrt. Im Zuge der Zuordnung können auch Kosten berechnet werden und Ressourcen zugeordnet werden.

[[File:VG_001_1.png|900px]]

'''Folgende Objektklassen stehen zur Verfügung''':

* Vorgang
* Vorgangspositionen
* Befunde/Tätigkeiten
* Ressourcen
* Budget

Jeder Vorgang kann beliebig viele Vorgangspositionen enthalten. Die Vorgangsposition ist z.B. für die Unterscheidung von investiven oder Wartungsmaßnahmen gedacht, kann aber auch „einfach“ als Gruppierung genutzt werden. Den Vorgängen können 1 oder mehrere Budgets zugeordnet werden.
Vorgangspositionen können beliebig viele Befunde/Tätigkeiten, Ressourcen und Kostenpositionen haben.

'''Beispiel für eine Schieberprüfung / -kontrolle:'''

Definition Vorgang

[[File:VG_002_1.png|800px]]

Über die Bezeichnung (hier „Schieber Süd_Ost 2016“) wird der Name des Vorgangs festgelegt. Mit Beginn und Ende kann der Durchführungszeitraum definiert werden.

Die Gesamtkosten ergeben sich aus der Summe der Kostenpositionen der jeweiligen Vorgangspositionen.

Definition Vorgangsposition

[[File:VG_003_1.png|800px]]

In diesem Fall wurden 2 Vorgangspositionen gebildet, um eine Unterscheidung nach Inspektion und Wartung zu haben.

[[File:VG_005_1.png|800px]]

Jeder Vorgangsposition lassen sich beliebig viele Kostenpositionen zuordnen. Hier kann z.B. festgelegt werden, dass eine Inspektion pro Objekt 20,00 EUR kostet. Die Gesamtkosten ergeben sich dann aus der Multiplikation aus Anzahl zugeordneter Fachobjekte und dem pauschalen Einzelpreis.

Die Kosten könnten statt pauschal aber auch in Abhängigkeit der Objektgröße berechnet werden, wenn z.B. eine Rasenfläche gemäht werden soll und die Kosten sich dann auf den Quadratmeter beziehen.

Definition der Befunde / Tätigkeiten

[[File:VG_006_1.png|800px]]

Hier werden die einzelnen Befunde / Tätigkeiten (oder auch Maßnahmen) aufgelistet, die am jeweiligen Objekt durchgeführt werden sollen. Die Check- oder Tätigkeitsliste wird entweder direkt digital erfasst, oder kann auch ausgedruckt werden um sie dann im Felde analog zu bearbeiten. Die Ergebnisse könnten dann anschließend eingegeben werden oder z.B. auch als gescannte Liste dem Vorgang als Dokument zugeordnet werden.

=Erstellen eines Templates=

Öffnen Sie die Tabelle der Vorgänge und legen einen neuen Datensatz an. Es öffnet sich folgende Maske:

[[File:VG_007_1.png|800px]]

Setzen Sie bitte

* den Haken „ist Vorlage“
* vergeben mindestens einen Namen (Bezeichnung) für die Vorlage und
* ordnen diese Vorlage einer „Fachanwendung“ zu.

Der Begriff Fachanwendung kann an dieser Stelle gerne auch als Thema, Gruppe etc. verstanden werden und hat nichts mit den eventuell lizenzierten Fachanwendungen zu tun. Die Tabelle der Fachanwendungen zur Pflege finden Sie unter:

[[File:VG_008_1.png|800px]]

Wenn Sie die 3 Werte vergeben haben, speichern Sie den Datensatz bitte ab. Alle weiteren Attribute sind Eventualattribute und müssen nicht zwingend vergeben werden.

Im Anschluss gehen Sie im Maskenexplorer auf die Untertabelle der „Vorgangspositionen“. Jetzt erscheint folgendes Bild:

[[File:VG_009_1.png|800px]]

Hier klicken Sie auf die Schaltfläche „Neuer Datensatz“ und legen in der sich dann öffnenden Maske eine Vorgangsposition an.

[[File:VG_010_1.png|800px]]

Vergeben Sie auch hier einen Namen und ordnen Sie die Vorgangsposition wieder der Fachanwendung zu. Speichern Sie anschließend die Vorgangsposition.

Um dieser Vorgangsposition z.B. pauschale Kosten pro Baum zuzuordnen klicken Sie in der eingebetteten Tabelle „Kosten“ auf die Schaltfläche neuer Datensatz. Jetzt werden Sie aufgefordert eine Kostenposition anzulegen.

[[File:VG_011_1.png|800px]]

Hier wird ebenfalls wieder ein Name vergeben, der Preis für die Einheit festgelegt und für einen pauschalen Betrag wird der Haken „fester Betrag“ gesetzt. Jetzt bitte diesen Datensatz speichern und den Reiter schließen.

Wir sind wieder zurück in der Datenmaske der Vorgangsposition.

[[File:VG_012_1.png|800px]]

Jetzt werden die durchzuführenden Tätigkeiten angelegt. Hierzu gehen Sie bitte im Maskenexplorer auf „Befunde der Tätigkeiten“ und es öffnet sich die Untertabelle.

[[File:VG_013_1.png|800px]]

Hier bitte ebenfalls einen neuen Datensatz anlegen.

[[File:VG_014_1.png|800px]]

Hier legen Sie bitte mindestens die Attribute Befundart und Prüfart fest (Verfahrensweise s. nächster Absatz). Anschließend speichern Sie den Datensatz ab und schließen den Reiter. Jetzt ist die erste Tätigkeit zugeordnet.

Sowohl Befundart als auch Prüfart sind Einträge aus der jeweiligen Untertabelle, d.h. eine einmal erstellte Befundart z.B. kann bei beliebigen Befunden / Tätigkeiten verwendet werden. Sollten also schon Einträge zur Befund- oder Prüfart vorliegen, öffnen Sie die Tabelle und ziehen den gewünschten Eintrag via Drag&Drop auf das Feld Befund- oder Prüfart. In der jeweiligen Untertabelle können bei Bedarf jederzeit auch neue Datensätze angelegt werden, die nach Abspeicherung sofort verwendet werden können.

[[File:VG_015_1.png|800px]]

Nach Festlegung der ersten Tätigkeit legen Sie auf die gleiche Art jetzt alle weiteren Tätigkeiten zu dieser Vorgangsposition an.

Möchten Sie zu der Vorgangsposition auch Ressourcen zuordnen, dann gehen Sie bitte im Maskenexplorer auf „Ressourcen“ und es öffnet sich die Untertabelle zu den Ressourcen.

[[File:VG_016_1.png|800px]]

Die Festlegung und Erfassung der Ressourcen erfolgt analog zu den Befunden/Tätigkeiten. Danach ist Ihr Template erstellt und Sie können den Reiter Vorgangsposition und Vorgang schließen.

=Verwendung der Templates=
(Zuordnung Objekt – Vorgang)

Für die Zuordnung der zu bearbeitenden Objekte müssen die gewünschten Objekte sich in der Tabelle befinden. Wenn Sie z.B. die Bäume eines Stadtteils, Baublocks, Parks oder einer Straße kontrollieren wollen, so filtern Sie die betroffenen Bäume (andere Objektklassen analog) in der Tabelle. Hierzu können Sie verschiedene Methoden einsetzen.

* Tabelle öffnen und alphanumerisch einen Filter (z.B. Straße) verwenden. So haben Sie die gewünschte Fundmenge in der Tabelle.
* Betroffene Objekte in der Karte z.B. über QuickPick Polygon auswählen / selektieren und anschließend mit der Funktion „Tabelle öffnen“ in die Tabellenansicht bringen. Auch so haben Sie die gewünschte Fundmenge in der Tabelle.
* Eventuell haben Sie die gewünschten Objekte über mehrere verschiedene Filteraktionen in einer Objektliste zusammengestellt. Öffnen Sie aus dem Objektbrowser heraus die Tabelle. Über diesen Weg haben sie ebenfalls die gewünschte Fundmenge in der Tabelle.

Jetzt markieren Sie die Datensätze in der Tabelle und rufen die Funktion „Erzeuge Vorgangspositionen zu ausgewählten Objekten“ auf.

[[File:VG_017_1.png|800px]]

Anschließend werden Sie aufgefordert die Aktion, Fachanwendung, Vorlagen und den Namen des Vorganges festzulegen.

[[File:VG_018_1.png|600px]]

'''Aktion:'''

Hier wählen Sie „Neuen Vorgang mit Positionen pro Objekt anlegen“. Dies bedeutet, dass bei jedem Objekt, hier bei jedem Baum, die Checkliste zur Verfügung steht.

Alternativ könnten Sie „Neuen Vorgang anlegen“ wählen. Dann würde die Checkliste nur ein einziges Mal angelegt werden und die Ergebnisse gelten dann für alle Objekte. Ist eher die Ausnahme, da i.d.R. „Objektscharf“ (also Pro Objekt) geprüft wird.

Sollten Sie bei der ersten Anlage eines Projektes Objekte nicht zugeordnet haben, oder es sind z.B. neue Objekte hinzugekommen, dann können diese Objekte nachträglich einem bestehenden Vorgang zugeordnet werden. Hierbei kann ebenfalls wieder nach Positionen pro Objekt bzw. gesamt pro Vorgang unterschieden werden.

[[File:VG_019_1.png|600px]]

'''Fachanwendung:'''

Hier wählen Sie die in Ihrem Vorgang vergebene Fachanwendung aus, z.B. Baum. GMSC-K versucht anhand der Objektklasse automatisch die Fachanwendung zu bestimmen. Das setzt voraus, dass die Codeliste "Fachanwendung" mit den passenden Werten gefüllt ist, d.h. für jede Fachanwendung, die im Zusammenhang mit Vorgängen benutzt werden soll, muss ein Eintrag mit dem Namen der Fachanwendung vorhanden sein.

'''Vorlage für Vorgang:'''

In Abhängigkeit der gewählten Fachanwendung werden alle Vorlagen als Auswahl aufgelistet. Wählen Sie Ihr erstelltes Template aus.

'''Bezeichnung für neuen Vorgang:'''

Vergeben Sie hier den Namen für Ihren Vorgang, wie hier z.B. „Baumkontrolle Stadtteil XY. An dieser Stelle wird deutlich, dass mittels des Templates (Vorlage) verschiedene gleichartige Vorgänge z.B. pro Stadtteil angelegt werden können. Die wesentliche Unterscheidung dieser Vorgänge liegt dann meist „nur“ in der Terminierung.

Hätten Sie bei Aktion die Option der Vorgangserweiterung gewählt, dann wird das Feld „gefundene Vorgänge“ aktiv und die Bezeichnung für neuen Vorgang inaktiv.

''(ab Version 2016 SP2)'' '''Dieser Dialog kann über Zugriffsrechte und Fachanwendungsparameter konfiguriert werden:'''
* Die Aktion kann mit einem Standardwert belegt werden. Öffnen Sie dazu in den Projekteigenschaften die Fachanwendung "Basis" und setzen dort den Fachanwendungsparameter "Standardaktion für neue Vorgangspositionen" auf den gewünschten Wert.
* Die Einstellung für "Aktion" und "Fachanwendung" kann für einzelne Nutzer unterbunden werden. Öffnen Sie dazu im Adminer die Funktionberechtigungen für das Projekt und stellen dort die entsprechenden Rechte in der Kategorie "Vorgänge" ein ("Aktion für neue Vorgangspositionen festlegen" und "Fachanwendung für neue Vorgangspositionen festlegen").
* Wenn Sie für die Objektklasse Vorgänge eine Datensatznummerierung anlegen und diese als Standardkonfiguration (Haken "Standard" im Datensatznummerierungseditor) markieren, wird diese verwendet um die Bezeichung des neuen Vorgangs zu generieren.

'''Neuen Vorgang aus Template anlegen:'''

Haben Sie die Felder Aktion, Fachanwendung, Vorlagen und den Namen des Vorganges festgelegt und mit OK bestätigt geht die Vorgangsmaske auf.

[[File:VG_020_1.png|800px]]

Diesen Vorgang können Sie jetzt mit diesen Angaben speichern, oder Sie ergänzen noch um Attribute wie Beginn, Ende usw.

Das Feld der Gesamtkosten ist bereits gefüllt, wenn Sie Kostenpositionen vergeben haben. Nach dem Speichern des Vorgangs sind die Vorgangspositionen angelegt und die Verknüpfung zu den Objekten ist erstellt. Sie können jetzt an den Fachobjekten die Vorgangspositionen, Tätigkeiten usw. abrufen bzw. bearbeiten.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

Projektumgebung

2021-02-17T12:10:45Z

VSC: /* Zoom */

Im Folgenden wird die Einrichtung einer GeoMedia SmartClient Kommunal-Umgebung beschrieben. Zu einer solchen Umgebung gehören:

* Eine Datenquelle, die den Speicherort der verwendeten Daten festlegt
* Ein Projekt, das die Geodaten verwaltet
* Eine oder mehrere Fachanwendungen, die Sachdaten verwalten
* Eine Mappe, die festlegt, welche Projekte geladen werden
* Nutzergruppen und Nutzer, die mit den Geodaten arbeiten - siehe hierzu [[Nutzerverwaltung]]

Im Folgenden wird auch das Anlegen eines WMS (Web Map Service) beschrieben. Diese Komponente ist für die Umgebung optional. Davon abgesehen gibt die Vorgehensweise die Reihenfolge wieder, in der die einzelne Komponenten hinzugefügt/konfiguriert werden sollten. Sollten Sie schon über eine GeoMedia SmartClient Kommunal-Umgebung
verfügen und möchten diese nur erweitern oder ändern, können Sie dafür einfach an den entsprechenden Stellen nachlesen, statt von vorne zu beginnen.
<br />

==Anlegen einer Datenbankverbindung==
Über Rechtsklick auf [[File:db__verbindung_16.png|16px]] ''Datenbanken'' > [[File:neu_16.png|16px]] ''Neu'' > [[File:neu_16.png|16px]] ''Datensatz'' wird eine neue Datenbank angelegt.

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Es wird vorausgesetzt, dass Sie ein Datenbankmanagementsystem (Oracle oder Microsoft SQL Server) installiert und einen [[Datenbank-Benutzer]] (Oracle) bzw. eine Datenbank (und einen Datenbank-Benutzer für Microsoft SQL Server) eingerichtet haben. Die Datenbank-Benutzer müssen darüber hinaus über ausreichende Berechtigungen verfügen (Oracle: siehe Script; SQL Server: Standardeinstellungen). Desweiteren muss ein [[Tablespace]] vorhanden sein. Die Bezeichnung des Tablespace ist variabel (Beispiel:INDX). </div>

Folgende Felder müssen ausgefüllt werden:

* ''Datenbanktyp'': Oracle oder Microsoft SQL Server
* ''Bezeichnung'': Name der Datenbank (frei wählbar)
* ''Datenbankserver'': Rechnername oder IP-Adresse des Rechners/Servers auf dem die Datenbank läuft.
* ''Datenbankname'': Name der Datenbank.
* ''Port'': Standard-Ports sind für Oracle 1521 und für Microsoft SQL Server 1433
* ''Index'': Hier ist der Tablespace in Großbuchstaben anzugeben. Die Bezeichnung ist variabel.
* ''Nutzername'': Name des Datenbank-Benutzers
* ''Kennwort'': Passwort des Datenbank-Benutzers

Optional anzugeben:
* ''JDBC-/GMSC-Verbindungsdeskriptor (ab Version 2020)'': Hier kann optional der Verbindungsdeskriptor manuell angegeben werden. Das kann z.B. verwendet werden, um den Zugriff auf einen Oracle-Cluster zu ermöglichen. Hinweise für diese Angaben finden sich z.B. unter https://www.connectionstrings.com (JDBC- und .NET-Connectionstring). Der JDBC-Deskriptor wird zum Zugriff auf die Sachdaten verwendet. Der GMSC-Deskriptor wird von der Karte verwendet.
* ''Verbindungspool-Größe (ab Version 2020)'': gibt an wie viele Verbindungen max. für diese Datenbankverbindung pro Fachanwendung geöffnet werden sollen, wobei als Fachanwendung jede IFA, Fremddatenanbindung sowie alle sonstigen Fachanwendungen zusammengefasst zählen. Beispiel: Für eine Datenbankverbindung sind die Fachanwendungen Basis, Flurstücksverwaltung, Kanal, IFA, IFA Stammdaten und Fremddaten registriert. Die Verbindungspool-Größe beträgt 5. Dann werden max. 20 Verbindungen zur Datenbank offen gehalten.

Optional bei Fremddatenanbindung anzugeben:
* ''Sachdaten-Schemaname'': Die Bezeichnung des Schemas, in dem die eigentlichen Fremddaten liegen.
* ''Basis-Schemaname'': Die Bezeichnung des Schemas, in dem die Markierungs-Tabellen und das DBO-Package liegen.
Beispiel:

[[File:datenbank.PNG|504px]]

Über das Symbol [[File:check_db_16.png|16px]] ''(Datenquelle prüfen)'' kann die definierte Verbindung überprüft werden. War der Verbindungsversuch erfolgreich, erscheint eine entsprechende Meldung:

[[File:verbindung.PNG|266px]]

Die Verbindung kann nun über das Symbol [[File:save_16.png|16px]] ''(Speichern)'' gespeichert werden und erscheint als Eintrag im Explorer.

Nach Rechtsklick auf diesen Eintrag lässt sich die Verbindung über [[File:bearbeiten_16.png|16px]] ''(Eigenschaften)'' einsehen und bearbeiten, über [[File:CopyToClipboard_16.png|16px]] ''(Kopieren)'' kopieren und über [[File:loeschen_16.png|16px]] ''(Löschen)'' entfernen.

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Löschen können Sie eine Datenquelle nur, wenn Sie in keinem Projekt und keiner
Fachanwendung mehr verwendet wird. </div>

Über [[File:gruppe_16.png|16px]] ''(Freigabe und Berechtigung)'' lässt sich bestimmen, für welche Nutzer die Datenbank freigegeben wird (vgl. [[Nutzerverwaltung#Freigabe und Berechtigung| Freigabe und Berechtigung]]).
<br />

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Anlegen eines Projekts==

Per Rechtsklick auf [[File:Projekte_16.png|16px]] ''Projekte'' > [[File:neu_16.png|16px]] ''Neu'' > [[File:neu_16.png|16px]] ''Datensatz'' wird ein neues Projekt erstellt.

Folgende Felder müssen ausgefüllt werden:

* ''Bezeichnung:'' Projektname (frei wählbar). Empfehlenswert ist es, einen Namen zu verwenden, der den räumlichen oder einen Sachbezug nahelegt
* ''Projektkoordinatensystem:'' Verwendetes Koordinatensystem (aus Liste zu wählen)
* ''Koordinatenkennzahl:'' aus Liste zu wählen - ''ohne'' oder ''gekürzt''. Wählen Sie ''komplett'', wenn Sie den Koordinaten aus GK2-4 und UTM 31-33 die entsprechenden Zahlen vorschalten wollen. Z.B. wird bei UTM 31 den Koordinaten die Zahl "31" vorgeschaltet.
* ''Projektkoordinaten:'' Rechts- und Hochwerte für das Projektgebiet
* ''Standard-Datenquelle:'' Datenquelle, die standardmäßig bei der Zuordnung der Fachanwendungen angeboten wird (optional)

Um Fachanwendungen zuzuordnen, werden diese durch Klick auf [[File:neu_16.png|16px]] ''(Fachanwendung hinzufügen)'' ausgewählt.

[[File:fachanwendung2.PNG|643px]]

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Wenn keine Fachanwendung lizenziert ist bzw. dem neu angelegten Projekt keine Fachanwendung zugewiesen werden soll, müssen zumindest die individuelle Fachanwendung und die individuellen Stammdaten dem Projekt zugeordnet werden, um Daten anlegen oder importieren zu können. </div>

Im Fenster "Fachanwendung" müssen folgende Felder ausgefüllt werden:

* ''Fachanwendung'' (aus Liste zu wählen)
* ''Bezeichnung:'' Der Name der Fachanwendung wird entsprechend der aus der Liste gewählten Fachanwendung automatisch eingetragen, kann aber auch geändert werden
* ''Datenquelle:'' Die Datenquelle wird in Abhängigkeit der gewählten Standard-Datenquelle automatisch eingetragen, kann aber auch geändert werden

[[File:fachanwendung.PNG|612px]]

Durch Klick auf das Symbol [[File:Kategorie_definiert_16.png|16px]] ''(Fachanwendung übernehmen)'' wird die definierte Fachanwendung für das Projekt übernommen. Im Fenster "Projekt" können Fachanwendungen mit Klick auf [[File:bearbeiten_16.png|16px]] ''(Fachanwendung bearbeiten)'' nachträglich geändert werden. Über [[File:loeschen_16.png|16px]] ''(Fachanwendung entfernen)'' kann die Fachanwendung gelöscht werden.

Das Projekt kann nun über das Symbol [[File:save_16.png|16px]] gespeichert werden und nachträglich mit Rechtsklick auf den Explorereintrag bearbeitet, gelöscht oder kopiert werden.

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Löschen können Sie ein Projekt nur, wenn es aus allen Mappen entfernt wurde! </div>

Über [[File:gruppe_16.png|16px]] ''(Freigabe und Berechtigung)'' lässt sich bestimmen, für welche Nutzer das Projekt freigegeben wird. Darüber hinaus lassen sich hier auch Berechtigungen für einzelne Funktionen und Daten zuweisen (vgl. [[Nutzerverwaltung#Freigabe und Berechtigung| Freigabe und Berechtigung]]).

<br />

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

==Anlegen einer Mappe==

Per Rechtsklick auf [[File:mappen_16.png|16px]] ''Mappen'' > [[File:neu_16.png|16px]] ''Neu'' > [[File:neu_16.png|16px]] ''Datensatz'' wird eine neue Mappe erstellt.

Hier können folgende Felder ausgefüllt werden:

* ''Bezeichnung:'' Name der Mappe (frei wählbar)
* ''Anzeigekoordinatensystem:'' Verwendetes Koordinatensystem (aus der Liste zu wählen)
* ''Mappe sperren?'': Setzen Sie hier nur dann ein Häkchen, wenn Sie die Mappe für die Nutzung sperren wollen. Sie können eine eigene Sperrmeldung eingeben oder aber die bereits voreingestellte Nachricht verwenden.
* ''GIS:'' Verwendetes Geoinformationssystem (aus der Liste zu wählen). Bei der Wahl des GeoMedia SmartClients erscheint zusätzlich eine Auswahlliste für ein zugeordnetes SmartClient-Projekt.
* ''Kleinster Kartenmaßstab'': Geben Sie hier eine Zahl für den kleinsten Kartenmaßstab ein.

Vor diejenigen Projekte, welche mit der Mappe geladen werden sollen, müssen nun Häkchen gesetzt werden. Anschließend kann die Mappe über das Symbol [[File:save_16.png|16px]] ''(Speichern)'' gespeichert werden. Mit Rechtsklick auf die Mappe und Klick auf [[File:bearbeiten_16.png|16px]] ''(Eigenschaften)'' im Explorer kann die Mappe nachträglich bearbeitet werden. Des Weiteren kann Sie gelöscht oder kopiert werden. Über [[File:gruppe_16.png|16px]] ''(Freigabe und Berechtigung)'' lässt sich bestimmen, für welche Nutzer die Mappe freigegeben wird (vgl. [[Nutzerverwaltung#Freigabe und Berechtigung| Freigabe und Berechtigung]]).

[[File:mappe_anlegen.PNG|560px]]

<br />

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Wenn Sie einer Mappe mehrere Projekte zuordnen, dann dürfen diese keine identischen Fachapplikationen (z.B. Kanal) enthalten! </div>

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

===Zoom===

:*Wählen Sie nun Ihre Mappe mit einem Rechtsklick aus und klicken Sie auf Eigenschaften. <br />

Nun kann man die "kleinste Kartenmaßstabszahl" eingeben <br />
Das heißt, umso kleiner die Zahl, desto größer ist die maximale Zoomgröße.
Näher kann also nicht in das Projekt gezoomt werden. <br />
<br />
'''Beispiel:'''<br />
Bei einer kleinsten Kartenmaßstabszahl von 50, ist der größte Maßstab für das Projekt 1:50. <br />

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">'''Hinweis:''' Der größte Kartenmaßstab in GMSCK kann 1:1 betragen, d.h. die kleinste Kartenmaßstabszahl ist 1. </div>
<br />
<br />
:*Klicken Sie auf [[File:Save 16.png|16px]] (''Speichern'').

:[[Datei:Massstabszahl.PNG|643px]]

:*Klicken Sie mit der rechten Maustaste auf das GeoMedia SmartClient Kommunal-Logo und dann auf "Mappe wechseln".

:[[Datei:Zoom51.png|209px]]

:*Wählen Sie Ihre Mappe aus.

:[[Datei:Zoom61.png|600px]]

:*Setzen Sie einen Haken vor Ihr Projekt, um die Daten im Kartenfenster sichtbar zu machen, falls noch nicht geschehen.
Rechts unten in der Statusbar sehen Sie den aktuellen Maßstab. Wenn sie mit dem Mausrad rein- oder rauszoomen, ändert sich dieser. Sie können den Maßstab auch händisch eingeben, indem Sie in das Feld klicken und einen Wert eingeben. Dieser Maßstab geht nun jedoch nicht mehr über 1:50, weil dieser vorhin im Adminer so festgelegt worden ist.

[[{{{hochlink|#top}}}|Hoch zum {{{hochtext|Seitenanfang}}}]]

2021-01-15T13:41:50Z

VSC:

Datei:Verschneidung001.jpg

2021-01-15T13:41:19Z

VSC: