GeoMediaKommunal - Benutzerbeiträge [de-at]

MobileAppBasis

2020-02-19T10:03:06Z

Rreiss: /* Konfiguration der Vorbelegungen */

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; float:right; width=30px ;
border:1px solid #cccccc; background-color:#CAE1FF;
padding: 0.5em;">
[[File:KTGIS_Stempel.png|200px]] 
 
'''Erforderliche Lizenzen''' 
zur mobileApp '''Basis''' 
* GMSC-K Basis-Lizenzen
* GMSC mobileApp Basis
</div>
[[Datei:MobileApp Basis.png|500px]]

= Voraussetzungen=

Die mobilen Applikationen dienen der Kontrolle und Erfassung von ausgewählten Daten im Offlinemodus auf einem robusten, für den Außendienst tauglichen Tablet. 

Voraussetzung der mobilen Applikationen sind drei Bestandteile: 
* GMSC-K Basis Software
* GMSC-K Fachanwendung
* Geeignete Hardware – wie DELL oder Getac Tablets
Software-Bestandteile der mobilen Applikationen:
* GMSC mobileApp Basis
* GMSC mobileApp [Anwendung]

= Definitionen =

* '''GMSC-K''': das Basisprogramm für den Server
* '''GMSC-K Fachanwendung oder nur Fachanwendung''': die Fachanwendung auf dem Server
* '''Applikation''': die Applikation zur Bearbeitung eines Fachthemas auf der mobilen Lösung. Die Applikation ist meist mit einer bestimmten Fachanwendung assoziiert.
* '''Tablet''': das Hardwaregerät für den Außendienst.
* '''Online Modus''': die mobile Applikation hat Zugang zum zentralen GMSC-K Server. Relevant für Datenübertragung durch mobile Daten oder einen WLAN-Zugang
* '''Offline Modus''': die mobile Applikation hat keinen Zugang zum zentralen GMSC-K Server. Relevant für Datenänderung und Erfassung

= Programmstart =

[[File:MAP_1_anmelden.jpg|300px|mini|Startbildschirm mit Login]] 
# Doppelklick auf dem eingerichteten Icon auf dem Desktop.
# Anmeldefenster mit Nutzername und Kennwort wird geladen.
# Nutzername und Kennwort eintragen und mit Anmelden bestätigen.

[[File:MAP_3_arbeitsitzung.jpg|300px|mini|Arbeitssitzungen nach Login]] 

Nach dem Einloggen werden die Lizenzen geprüft. Im Falle fehlender Lizenzen erfolgt ein entsprechender Hinweis.

=== Arbeitssitzung ===

Die eingerichteten Arbeitssitzungen für die mobilen Apps werden als Kacheln abgebildet. Mit einem Klick auf der gewünschten Kachel laden Sie die Arbeitssitzung. Der Ladedauer hängt vom Umfang der Arbeitssitzung ab.

==== Konfiguration der Arbeitssitzungen ====
Arbeitssitzungen werden im GMSC-K definiert. Eine Arbeitssitzung wird je Applikation definiert. Diese befindet sich nach der Installation als Konfigurationsdatei lokal auf dem Tablet. Die Dateien heißen [Applikation].json, z.B. baum.json. In die Zeile „bookmarks“: [„Bezeichnung der Arbeitssitzung in GMSC-K“] tragen Sie die Bezeichnung der Arbeitssitzung aus GMSC-K ein. 

= Arbeitsfenster-Aufbau =
[[Datei:Arbeitsfenster.jpg|500px|mini|Aufbau des Arbeitsfensters]]

=== Rechts ===
Funktionen zum Zoomen und Sachdatenabfrage

* [[Datei:Plus.png|30px]] und [[Datei:Minus.png|30px]] ermöglichen das rein- und rauszoomen der Karte.
* [[Datei:Info-button.png|30px]]: Für die Sachdatenanfrage aus der Karte. Nachdem Sie das Symbol geklickt haben, müssen Sie das gewünschte Objekt in der Karte anklicken. Vorausgesetzt, es sind Sachdaten für die Anzeige auf der mobilen App freigegeben, erhalten Sie eine entsprechende Sachdatenmaske. Andernfalls erhalten Sie die Anzeige „kein Datensatz“.

=== Unten ===
Infoleiste für die Koordinaten des Kartenmittelpunkts und Maßstab des momentanen Kartenausschnitt

=== Oben ===
'''Hinweis:''' erscheint nur, wenn man am oberen Rand tippt. Hier sind Funktionen zum Minimieren, Fenstermodus / Vollbildmodus und Schließen des Fensters
[[File:MAP_9_leiste_oben.jpg|500px]] 

=== Links ===
Die Funktionsleiste ist eine vertikale Leiste, die mehrere Funktionen & Favoriten beinhaltet (siehe folgenden Abschnitt).

= Funktionsleiste & Standardfunktionen =
[[File:MAP_5_Sichten.jpg|200px|mini|Sichtenanzeige-Sidebar]]
Standardmäßig sind die Funktionen ''Sichtenanzeige'' und ''Konfiguration''. Weitere Schaltflächen können als Favoriten hinzugefügt werden, siehe unten.

===[[File:MAP_legende.PNG|50px]] Sichtenanzeige ===
Die Sichtenanzeige listet Arbeitssitzungen und deren enthaltenen Sichten auf. Die in der Karte vorhandenen Sichten werden einschließlich ihrer Symbolik bzw. Farbe angezeigt. Mit einem Klick auf die Arbeitssitzung können Sie den gesamten Inhalt der Arbeitssitzung in die Karte laden oder ausblenden. Ausgeblendete Sichten werden mit einem roten Statusbalken markiert.

Mit einem Klick auf das Symbol <big>'''>'''</big> (Rechts von der Bezeichnung der Arbeitssitzung) gelangen Sie zu der Liste der enthaltenen Sichten. Mit einem Klick auf die Bezeichnung der Sicht können Sie einzelne Sichten innerhalb der Arbeitssitzung in die Karte laden oder ausblenden.

[[Datei:Kacheln.png|mini|Übersicht der Funktionen]]
===[[Datei:Ktgis.png|50px]] Funktionsübersicht ===
Mit diesem Button gelangen Sie zu der Übersicht der freigeschalteten Apps und Funktionen. Die Funktionen werden nach der Zugehörigkeit zu einer App sortiert. Allgemeine Funktionen werden unter der Überschrift Standard abgebildet.

Mit einem langen Klick auf eine Kachel erscheint eine Schaltfläche zum Hinzfügen eines Favoriten. Nachdem man diese bestätigt hat, erscheint die Funktion auf der Funktionsleiste. Um sie wieder zu entfernen, einfach in der Funktionsleiste lange gedrückt halten, bis sich die Schaltfläche ''von Favoriten entfernen'' öffnet und diese bestätigen.

=== [[Datei:Mapview.png|50px]] Lesezeichen ===
Sie können eine bestimmte Position auf der Karte als Lesezeichen speichern und wieder aufrufen. Mit einem Doppelklick auf das Symbol speichern Sie die aktuelle Position in der Karte. Mit einem einfachen Klick rufen Sie die Definition ab, d.h. die Kartenansicht springt zur gespeicherten Ansicht.

=== [[Datei:Auskunft Suche.png|50px]] Freitextsuche ===
Die Freitextsuche können Objekte durchsucht werden. ''Die Suche in bestimmten Ebenen muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Gps deaktiviert.png|50px]] GPS ===
Um die eigene Position in der Karte anzeigen zu lassen, muss GPS aktiviert sein. Ist GPS eingeschaltet, wechselt der Button zu einem weißen Pin. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Nutzerposition.png|50px]] zur Position zoomen ===
Falls Sie GPS aktiviert haben und Ihre Position nicht finden können, ist es möglich, mithilfe dieser Funktion die aktuelle Position in der Karte anzeigen zu lassen. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''
[[Datei:MobileApp-Messen.gif|400px|mini|Anwendung der Messen-Funktion (zum Abspielen des Videos bitte klicken)]]
=== [[Datei:Messen-button.png|50px]] Messen ===
Mit einem Klick auf diesen Button öffnet sich die Funktion des Messens in Form eines Fadenkreuzes und drei Werkzeug Buttons. Mit dem Fadenkreuz wird die Position des Ankerpunktes auf der Karte festgelegt. Der Knoten+ Button bestätigt die aktuelle Position und lässt einen weiteren Knotenpunkt hinzufügen. Mit dem Speichern Button wird die Messung gespeichert und beendet. Um ohne Speichern zu beenden, einfach auf das große X klicken. Die gespeicherte Messung bleibt auf der Karte für die Sitzung bestehen. Möchten Sie die Messung wieder löschen, betätigen Sie den Button ''Messungen löschen''.

=== [[Datei:Backup.png|50px]] Backup DB ===
Die lokale Datenbank kann mit Hilfe dieser Funktion in einer lokalen Sicherungsdatei abgelegt werden. Bei erfolgreichem Backup erscheint ein Dialog mit dem Pfad zur ZIP-Datei.

=== [[Datei:DB Schema Update.png|50px]] Update DB-Schema ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Die lokalen Tabellen werden gemäß dem Datenbankaufbau des Servers erstellt / angepasst. Dabei kann es zu Löschungen der lokalen Tabellen kommen. Ein Dialog öffnet sich, der bestätigt werden muss.
[[Datei:Sync-dialog.png|400px|mini|Synchronisierungsdialog zum Auswählen der Daten]]
=== [[File:sync.png|50px]] Offlinefähigkeit ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Sie können damit die Daten auf ihrem Tablet mit denen auf dem Server synchronisieren. Dazu öffnet sich ein Dialog, über den Sie die gewünschten Daten auswählen können. Je nach Ihren Fachanwendungen sind diese aufgelistet.

== Fachspezifische Funktionen ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| Baum hinzufügen, Baumbestand Suche, Baum-Geometrie bearbeiten|| [[MobileAppBaum#Funktionen | mobileApp Baum Funktionen]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || Grünfläche hinzufügen, Grünbestand-Suche, Grünflächen-Geometrie bearbeiten || [[MobileAppGruen#Funktionen | mobileApp Grün Funktionen]]
|}

= Datenmaske =
In der mobileApp ist eine der Grundfunktionen das Anlegen von Befunden zu einem Objekt der Fachanwendung. Je nach Fachanwendung kann sich die Eingabemaske und möglichen Inhalten unterscheiden. In diesem Abschnitt wird der allgemeine Aufbau einer solchen Eingabemaske erklärt.

Beim Anlegen eines neuen Objektes öffnet sich nach dem Speichern der Geometrie die Befund-Eingabemaske automatisch, um Sachdaten zum Objekt anzugeben (wie das funktioniert, wird in der fachspezifischen Dokumentation erklärt). Um einen Befund für ein existierendes Objekt anzulegen, wählt man ein Objekt mithilfe des Info-Buttons [[Datei:Info-button.png|30px]] aus. Daraufhin öffnet sich die Eingabemaske zum Objekt.

Änderungen lassen sich durch den Speicher-Button [[Datei:Speichern-mobileApp.png|30px]] oben links bestätigen oder durch den Schließen-Button [[Datei:Schliessen-mobileApp.png|30px]] oben rechts abbrechen.

[[Datei:Grunddaten-gruen.png|mini|Grunddatenmaske am Beispiel Grünfläche]]
=== Grunddaten ===
'''Hinweis''': Je nach Fachanwendung kann dieser Reiter eine andere Bezeichnung haben, tritt allerdings immer als erster Reiter auf.

Bereits vorliegende Daten werden im Reiter '''Grunddaten''' entsprechend angezeigt und es besteht die Möglichkeit diese zu aktualisieren oder zu ergänzen. Felder, die grau hinterlegt sind, lassen sich nicht bearbeiten. Folgende Eingabefelder können auftreten:
* Text-Eingabefelder
* Dropdown-Auswahlliste bei einer kleinen Menge an Auswahlmöglichkeiten
* Alphabet-Auswahlliste bei vielen Auswahlmöglichkeiten
* Umschalt-Buttons (toggle) die durch eine grüne Unterstreichung aktiviert oder durch eine Ausgrauung deaktiviert werden

[[Datei:Massnahmen-baum.png|mini|Maßnahmenmaske am Beispiel Baum]]
=== Maßnahmen & Befunde ===
Der Maßnahmen-Reiter werden notwendige Tätgkeiten am Objekt und bereits aufgenommene Maßnahmen aufgelistet. Im Reiter '''Befunddaten''' werden Schäden und Auffälligkeiten am Objekt dokumentiert. Die Funktionsweise ist für beide Reiter gleich.

Wenn Sie im jeweiligen Reiter Daten hinzufügen möchten, können Sie diese über den Dialog nach Klicken des '''Hinzufügen'''-Buttons auswählen.
* Links: Die Kategorien, in die die Maßnahmen/Befunde unterteilt sind.
* Rechts: Die Maßnahmen/Befunde, die zu einer Kategorie zugeordnet sind.

Die getroffene Auswahl wird dabei grün hinterlegt.

'''Hinweis:''' Je nach Fachanwendung unterscheiden sich natürlich die Auswahlmöglichkeiten der Maßnahmen. Die Kategorien und die Zuordnung zu den einzelnen Maßnahmen sind frei definierbar und kann im GMSC-K individualisiert werden.

Nach dem Bestätigen werden diese der Liste hinzugefügt und lassen sich für weitere Informationen bearbeiten; zu erkennen an der schwarzen Umrandung. Dabei ist darauf zu achten:
# Der erste Klick ist, um den Datensatz zu markieren.
# Der zweite Klick, um die Eingabe in das gewünschte Feld zu aktivieren.

=== Dokumente ===
Der Reiter Dokumente gibt eine Übersicht aller angehängten Dateien zum Objekt. Oftmals handelt es sich dabei um ein Foto. Die Datei wird in der für das Dateiformat entsprechenden App geöffnet, wenn Sie auf den Eintrag klicken.

==== Foto anhängen ====
Möchten Sie einem Befund ein Foto anhängen, öffnen Sie dafür die Kamera-App Ihres Tablets. Dabei verlassen Sie die mobileApp. Sobald Sie ein Foto geschossen haben, wechseln Sie wieder zurück zur mobileApp. In der Übersicht ist ein neuer Eintrag mit dem aktuellen Erstelldatum aufgelistet, ohne dass Sie noch weitere Schritte vornehmen müssen. Speichern Sie Ihre Änderungen.

== Fachspezifische Reiter ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| '''Anmerkung''': Ein freies Textfeld für zusätzliche Informationen, die den Baum betreffen. || [[MobileAppBaum#Datenmaske | mobileApp Baum Befunde]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || '''Pflanzen''': Hier können die auf der Grünfläche angelegten Pflanzen ergänzt oder überprüft werden.|| [[MobileAppGruen#Datenmaske| mobileApp Grün Befunde]]
|}

= Konfiguration =

Für die Konfiguration sind zwei lokale Dateien auf dem Tablet relevant:
* '''mobile.json''': Angaben zur Verbindung zum Server 
* '''[Applikation].json''' (z.B. baum.json): Angaben zu Arbeitssitzung, Suchmaske, Auswahllisten. Wird pro Applikation definiert 

== Allgemeine Verbindungseinstellungen ==
Eine Einführung zu dem Datumsform JSON finden Sie im [https://wiki.selfhtml.org/wiki/JSON JSON - SELFHTML-Wiki].

Konfiguration in der Datei „mobile.json“:

{| class="wikitable"
|-
! Parameter !! Typ!! Beschreibung
|-
| "serverURL" || Text|| Verbindungsdaten des GMSCK Servers
|-
| "codebase"|| Text|| Verbindungsdaten für die Kartenkomponente GMSC
|-
| "virtualSite" || Text||
|-
| "workspace" || Text|| Die zu öffnende Arbeitsmappe von GMSC-K
|-
| "login" || Text|| Voreinstellung für das Login des Nutzers
|-
| "picturePath" || Text|| Der Dateipfad, unter welchem die Kamera-App die aufgenommenen Bilder speichert
|-
| "gpsMode" || Text|| Der Modus für GPS
|-
| "gpsComPort" || Text|| Der virtuelle COM-Port an welchem die NMEA-Daten des GPS Sensors ausgelesen werden können.
|-
| "gpsRefreshRate" || Integer|| Die Zeitspanne, in der die GPS-Daten in der Kartenkomponente aktualisiert werden (in Sekunden)
|-
| "offlineWorkspacePath"|| Beispiel || Der Dateipfad, unter welchem die Sitzungsdaten der mobileApp gespeichert werden.
|-
| "tabletMode" || Boolean|| Aktivierung des Tabletmodus oder Desktopmodus
|-
| "styles" || Text|| Zusätzliche Stylesheets für die mobileApp, z.B. für spezielle Bildschirmauflösungen.
|-
| Beispiel || Beispiel || Beispiel
|}

==Arbeitssitzungen==

Für jede mobile Fachanwendung kann Sie mehrere Arbeitssitzungen (Bookmarks) angeben, die in der mobileApp verfügbar sein sollen. Die Arbeitssitzungen werden wie gewohnt innerhalb von GMSC-K eingerichtet.
Dabei ist zu beachten, dass die Arbeitssitzungen für den mobilen Nutzer über die Nutzer-/Rechteverwaltung freigegeben sind.

{
"bookmarks" : ["Luftbild", "Grundkarte"]
}

==Filterkonfigurationen für Sachdaten==

Viele Sichten in GMSC-K verwenden einen Sichtenfilter.
Um sicherzustellen, dass in der mobileApp die Anzahl der Datensätze in der Karte mit der Anzahl der Sachdaten übereinstimmt, müssen die Sachdaten über einen Filter eingeschränkt werden.
Dies wird mit Hilfe von SQL-Filtern umgesetzt. Dabei muss der SQL-Filter dem Sichtenfilter in GMSC-K entsprechen.
Weiterhin können komplexe Stammdaten wie z.B. Adressen oder Straßen mit SQL-Filtern für die mobileApp auf die notwendige Anzahl eingeschränkt werden.

"filter" : {
"filterBaum" : "(baum.FAELLUNG <> 1 OR baum.FAELLUNG IS NULL)",
"filterStrasse" : "this_.STRASSESCHLUESSELG IS NOT NULL"
}
==Filterkonfigurationen für Stammdaten (Auswahllisten)==

Auswahllisten (Codelisten) innerhalb der mobileApp können über Auswahleinschränkungen auf die nur benötigten Werte angepasst werden.

"auswahlStatus" : {"auswahlName" : "FA", "auswahlWert" : "Vorgangsposition" },
"auswahlKategorie" : {"auswahlName" : "FA", "auswahlWert" : "Baum" }

==Konfiguration der Befundarten/Schadensarten==

In der mobileApp kann man für viele Fachobjekte Befunde bzw. Schäden erfassen. Abhängig von Fachobjekt sind unterschiedliche Arten von Befunden/Schäden möglich.
Dabei kann man die Befundarten mit Hilfe von Auswahleinschränkungen in unterschiedliche Kategorien einordnen.

"befundartConfigs" : [
{ "label" : "kritische Schäden",
"auswahleinschraenkung" : {"auswahlName" : "Befundart", "auswahlWert" : "kritisch" }
},
{ "label" : "geringe Schäden",
"auswahleinschraenkung" : {"auswahlName" : "Befundart", "auswahlWert" : "gering" }
}
]

==Konfiguration der Maßnahmenarten==

Wie Befunde oder Schäden kann man bei vielen Fachobjekten in der mobileApp auch Maßnahmen (Vorgangsposition) erfassen. Auch die Maßnahmenarten werden wie die Befundarten mit Hilfe von Auswahleinschränkungen konfiguriert.
Es ist aber zu beachten, dass hier als Gliederung eine Oberkategorie verwendet wird, die auch als Datensatz einer Kategorie in GMSC-K vorhanden sein muss.
Die Oberkategorie wird über das Kürzel festgelegt und der Vorgangsposition in das Datenfeld '''kategorie''' zugeordnet. Die ausgewählte Maßnahmenart wird in das Feld '''kategorie1''' geschrieben.

"massnahmenConfigs" : [
{
"parentKategorie" : { "label" : "Maßnahmen", "code" : "MASS"},
"auswahleinschraenkung" : {"auswahlName" : "Massnahme", "auswahlWert" : "MASS" }
}
]

==Konfiguration der Vorbelegungen==

In der mobileApp können für Maßnahmen (darunter auch die Kontrollen), Befunde und Dokumente Vorbelegungen definiert werden. Bestimmte Felder werden auf diese Art automatisch bei einer Neuanlage ausgefüllt.
Dabei sind Vorbelegungen für Auswahllisten (type=codelist) oder Texte (type=string) möglich. Bei einer Vorbelegung muss man den Typ, das Feld und den Wert angeben.
Es können mehrere Vorbelegungen festgelegt werden, dabei sind null-Werte auch möglich.

"vorbelegungenByType" : {
"Kontrolle" : [
{
"type" : "codelist",
"attribute" : "status",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Status", "code" : "durchgeführt" }
},
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"MN_Vorgangsposition" : [
{
"type" : "codelist",
"attribute" : "status",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Status", "code" : "offen" }
},
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"MN_Befund" : [
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"Dokument" : [
{
"type" : "codelist",
"attribute" : "dokumentart",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.Dokumentart", "code" : "FOTO" }
},
{
"type" : "string",
"attribute" : "bezeichnung",
"value" : "Bild"
}
]
}

= Datenübertragung an Server =
[[File:MAP_Baum_synch.jpg|400px|mini|Dialog bei Änderungen am Offline-Datenbestand am Beispiel Baum]]
[[File:MAP_Baum_synch_erfolgreich.jpg|300px|mini]]
# Mobile App schließen
# Das Tablet an die Dockingstation anschließen. Achten Sie darauf, dass die Dockingstation am Netz angeschlossen ist.
# Mobile App starten.
# Eine Arbeitssitzung auswählen.
# Sind Änderungen am Offline-Datenbestand festgestellt wurden, dann erhalten Sie eine entsprechende Abfrage, ob Sie die Änderungen auf dem Server übertragen möchten. Mit OK starten Sie die Übertragung.
# Wenn die Übertragung fertig ist, dann erhalten Sie eine entsprechende Meldung, dass die Übertragung abgeschlossen ist.
# Mobile App schließen.
# Tablet aus der Dockingstation entfernen.
==== Erläuterung ====
Die Datenübertragung findet intern in zwei Schritten statt.
* die geänderten Daten auf dem Tablet werden auf den GMSC-K zentralen Server übertragen.
* der gesamte und durch den Schritt 1 aktualisierte Datenbestand wird dann komplett auf dem Tablett übertragen.

MobileAppBasis

2020-02-19T09:46:12Z

Rreiss: /* Arbeitssitzungen */

MobileAppBasis

2020-02-19T09:42:53Z

Rreiss: /* Konfiguration der Vorbelegungen */

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; float:right; width=30px ;
border:1px solid #cccccc; background-color:#CAE1FF;
padding: 0.5em;">
[[File:KTGIS_Stempel.png|200px]] 
 
'''Erforderliche Lizenzen''' 
zur mobileApp '''Basis''' 
* GMSC-K Basis-Lizenzen
* GMSC mobileApp Basis
</div>
[[Datei:MobileApp Basis.png|500px]]

= Voraussetzungen=

Die mobilen Applikationen dienen der Kontrolle und Erfassung von ausgewählten Daten im Offlinemodus auf einem robusten, für den Außendienst tauglichen Tablet. 

Voraussetzung der mobilen Applikationen sind drei Bestandteile: 
* GMSC-K Basis Software
* GMSC-K Fachanwendung
* Geeignete Hardware – wie DELL oder Getac Tablets
Software-Bestandteile der mobilen Applikationen:
* GMSC mobileApp Basis
* GMSC mobileApp [Anwendung]

= Definitionen =

* '''GMSC-K''': das Basisprogramm für den Server
* '''GMSC-K Fachanwendung oder nur Fachanwendung''': die Fachanwendung auf dem Server
* '''Applikation''': die Applikation zur Bearbeitung eines Fachthemas auf der mobilen Lösung. Die Applikation ist meist mit einer bestimmten Fachanwendung assoziiert.
* '''Tablet''': das Hardwaregerät für den Außendienst.
* '''Online Modus''': die mobile Applikation hat Zugang zum zentralen GMSC-K Server. Relevant für Datenübertragung durch mobile Daten oder einen WLAN-Zugang
* '''Offline Modus''': die mobile Applikation hat keinen Zugang zum zentralen GMSC-K Server. Relevant für Datenänderung und Erfassung

= Programmstart =

[[File:MAP_1_anmelden.jpg|300px|mini|Startbildschirm mit Login]] 
# Doppelklick auf dem eingerichteten Icon auf dem Desktop.
# Anmeldefenster mit Nutzername und Kennwort wird geladen.
# Nutzername und Kennwort eintragen und mit Anmelden bestätigen.

[[File:MAP_3_arbeitsitzung.jpg|300px|mini|Arbeitssitzungen nach Login]] 

Nach dem Einloggen werden die Lizenzen geprüft. Im Falle fehlender Lizenzen erfolgt ein entsprechender Hinweis.

=== Arbeitssitzung ===

Die eingerichteten Arbeitssitzungen für die mobilen Apps werden als Kacheln abgebildet. Mit einem Klick auf der gewünschten Kachel laden Sie die Arbeitssitzung. Der Ladedauer hängt vom Umfang der Arbeitssitzung ab.

==== Konfiguration der Arbeitssitzungen ====
Arbeitssitzungen werden im GMSC-K definiert. Eine Arbeitssitzung wird je Applikation definiert. Diese befindet sich nach der Installation als Konfigurationsdatei lokal auf dem Tablet. Die Dateien heißen [Applikation].json, z.B. baum.json. In die Zeile „bookmarks“: [„Bezeichnung der Arbeitssitzung in GMSC-K“] tragen Sie die Bezeichnung der Arbeitssitzung aus GMSC-K ein. 

= Arbeitsfenster-Aufbau =
[[Datei:Arbeitsfenster.jpg|500px|mini|Aufbau des Arbeitsfensters]]

=== Rechts ===
Funktionen zum Zoomen und Sachdatenabfrage

* [[Datei:Plus.png|30px]] und [[Datei:Minus.png|30px]] ermöglichen das rein- und rauszoomen der Karte.
* [[Datei:Info-button.png|30px]]: Für die Sachdatenanfrage aus der Karte. Nachdem Sie das Symbol geklickt haben, müssen Sie das gewünschte Objekt in der Karte anklicken. Vorausgesetzt, es sind Sachdaten für die Anzeige auf der mobilen App freigegeben, erhalten Sie eine entsprechende Sachdatenmaske. Andernfalls erhalten Sie die Anzeige „kein Datensatz“.

=== Unten ===
Infoleiste für die Koordinaten des Kartenmittelpunkts und Maßstab des momentanen Kartenausschnitt

=== Oben ===
'''Hinweis:''' erscheint nur, wenn man am oberen Rand tippt. Hier sind Funktionen zum Minimieren, Fenstermodus / Vollbildmodus und Schließen des Fensters
[[File:MAP_9_leiste_oben.jpg|500px]] 

=== Links ===
Die Funktionsleiste ist eine vertikale Leiste, die mehrere Funktionen & Favoriten beinhaltet (siehe folgenden Abschnitt).

= Funktionsleiste & Standardfunktionen =
[[File:MAP_5_Sichten.jpg|200px|mini|Sichtenanzeige-Sidebar]]
Standardmäßig sind die Funktionen ''Sichtenanzeige'' und ''Konfiguration''. Weitere Schaltflächen können als Favoriten hinzugefügt werden, siehe unten.

===[[File:MAP_legende.PNG|50px]] Sichtenanzeige ===
Die Sichtenanzeige listet Arbeitssitzungen und deren enthaltenen Sichten auf. Die in der Karte vorhandenen Sichten werden einschließlich ihrer Symbolik bzw. Farbe angezeigt. Mit einem Klick auf die Arbeitssitzung können Sie den gesamten Inhalt der Arbeitssitzung in die Karte laden oder ausblenden. Ausgeblendete Sichten werden mit einem roten Statusbalken markiert.

Mit einem Klick auf das Symbol <big>'''>'''</big> (Rechts von der Bezeichnung der Arbeitssitzung) gelangen Sie zu der Liste der enthaltenen Sichten. Mit einem Klick auf die Bezeichnung der Sicht können Sie einzelne Sichten innerhalb der Arbeitssitzung in die Karte laden oder ausblenden.

[[Datei:Kacheln.png|mini|Übersicht der Funktionen]]
===[[Datei:Ktgis.png|50px]] Funktionsübersicht ===
Mit diesem Button gelangen Sie zu der Übersicht der freigeschalteten Apps und Funktionen. Die Funktionen werden nach der Zugehörigkeit zu einer App sortiert. Allgemeine Funktionen werden unter der Überschrift Standard abgebildet.

Mit einem langen Klick auf eine Kachel erscheint eine Schaltfläche zum Hinzfügen eines Favoriten. Nachdem man diese bestätigt hat, erscheint die Funktion auf der Funktionsleiste. Um sie wieder zu entfernen, einfach in der Funktionsleiste lange gedrückt halten, bis sich die Schaltfläche ''von Favoriten entfernen'' öffnet und diese bestätigen.

=== [[Datei:Mapview.png|50px]] Lesezeichen ===
Sie können eine bestimmte Position auf der Karte als Lesezeichen speichern und wieder aufrufen. Mit einem Doppelklick auf das Symbol speichern Sie die aktuelle Position in der Karte. Mit einem einfachen Klick rufen Sie die Definition ab, d.h. die Kartenansicht springt zur gespeicherten Ansicht.

=== [[Datei:Auskunft Suche.png|50px]] Freitextsuche ===
Die Freitextsuche können Objekte durchsucht werden. ''Die Suche in bestimmten Ebenen muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Gps deaktiviert.png|50px]] GPS ===
Um die eigene Position in der Karte anzeigen zu lassen, muss GPS aktiviert sein. Ist GPS eingeschaltet, wechselt der Button zu einem weißen Pin. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Nutzerposition.png|50px]] zur Position zoomen ===
Falls Sie GPS aktiviert haben und Ihre Position nicht finden können, ist es möglich, mithilfe dieser Funktion die aktuelle Position in der Karte anzeigen zu lassen. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''
[[Datei:MobileApp-Messen.gif|400px|mini|Anwendung der Messen-Funktion (zum Abspielen des Videos bitte klicken)]]
=== [[Datei:Messen-button.png|50px]] Messen ===
Mit einem Klick auf diesen Button öffnet sich die Funktion des Messens in Form eines Fadenkreuzes und drei Werkzeug Buttons. Mit dem Fadenkreuz wird die Position des Ankerpunktes auf der Karte festgelegt. Der Knoten+ Button bestätigt die aktuelle Position und lässt einen weiteren Knotenpunkt hinzufügen. Mit dem Speichern Button wird die Messung gespeichert und beendet. Um ohne Speichern zu beenden, einfach auf das große X klicken. Die gespeicherte Messung bleibt auf der Karte für die Sitzung bestehen. Möchten Sie die Messung wieder löschen, betätigen Sie den Button ''Messungen löschen''.

=== [[Datei:Backup.png|50px]] Backup DB ===
Die lokale Datenbank kann mit Hilfe dieser Funktion in einer lokalen Sicherungsdatei abgelegt werden. Bei erfolgreichem Backup erscheint ein Dialog mit dem Pfad zur ZIP-Datei.

=== [[Datei:DB Schema Update.png|50px]] Update DB-Schema ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Die lokalen Tabellen werden gemäß dem Datenbankaufbau des Servers erstellt / angepasst. Dabei kann es zu Löschungen der lokalen Tabellen kommen. Ein Dialog öffnet sich, der bestätigt werden muss.
[[Datei:Sync-dialog.png|400px|mini|Synchronisierungsdialog zum Auswählen der Daten]]
=== [[File:sync.png|50px]] Offlinefähigkeit ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Sie können damit die Daten auf ihrem Tablet mit denen auf dem Server synchronisieren. Dazu öffnet sich ein Dialog, über den Sie die gewünschten Daten auswählen können. Je nach Ihren Fachanwendungen sind diese aufgelistet.

== Fachspezifische Funktionen ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| Baum hinzufügen, Baumbestand Suche, Baum-Geometrie bearbeiten|| [[MobileAppBaum#Funktionen | mobileApp Baum Funktionen]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || Grünfläche hinzufügen, Grünbestand-Suche, Grünflächen-Geometrie bearbeiten || [[MobileAppGruen#Funktionen | mobileApp Grün Funktionen]]
|}

= Datenmaske =
In der mobileApp ist eine der Grundfunktionen das Anlegen von Befunden zu einem Objekt der Fachanwendung. Je nach Fachanwendung kann sich die Eingabemaske und möglichen Inhalten unterscheiden. In diesem Abschnitt wird der allgemeine Aufbau einer solchen Eingabemaske erklärt.

Beim Anlegen eines neuen Objektes öffnet sich nach dem Speichern der Geometrie die Befund-Eingabemaske automatisch, um Sachdaten zum Objekt anzugeben (wie das funktioniert, wird in der fachspezifischen Dokumentation erklärt). Um einen Befund für ein existierendes Objekt anzulegen, wählt man ein Objekt mithilfe des Info-Buttons [[Datei:Info-button.png|30px]] aus. Daraufhin öffnet sich die Eingabemaske zum Objekt.

Änderungen lassen sich durch den Speicher-Button [[Datei:Speichern-mobileApp.png|30px]] oben links bestätigen oder durch den Schließen-Button [[Datei:Schliessen-mobileApp.png|30px]] oben rechts abbrechen.

[[Datei:Grunddaten-gruen.png|mini|Grunddatenmaske am Beispiel Grünfläche]]
=== Grunddaten ===
'''Hinweis''': Je nach Fachanwendung kann dieser Reiter eine andere Bezeichnung haben, tritt allerdings immer als erster Reiter auf.

Bereits vorliegende Daten werden im Reiter '''Grunddaten''' entsprechend angezeigt und es besteht die Möglichkeit diese zu aktualisieren oder zu ergänzen. Felder, die grau hinterlegt sind, lassen sich nicht bearbeiten. Folgende Eingabefelder können auftreten:
* Text-Eingabefelder
* Dropdown-Auswahlliste bei einer kleinen Menge an Auswahlmöglichkeiten
* Alphabet-Auswahlliste bei vielen Auswahlmöglichkeiten
* Umschalt-Buttons (toggle) die durch eine grüne Unterstreichung aktiviert oder durch eine Ausgrauung deaktiviert werden

[[Datei:Massnahmen-baum.png|mini|Maßnahmenmaske am Beispiel Baum]]
=== Maßnahmen & Befunde ===
Der Maßnahmen-Reiter werden notwendige Tätgkeiten am Objekt und bereits aufgenommene Maßnahmen aufgelistet. Im Reiter '''Befunddaten''' werden Schäden und Auffälligkeiten am Objekt dokumentiert. Die Funktionsweise ist für beide Reiter gleich.

Wenn Sie im jeweiligen Reiter Daten hinzufügen möchten, können Sie diese über den Dialog nach Klicken des '''Hinzufügen'''-Buttons auswählen.
* Links: Die Kategorien, in die die Maßnahmen/Befunde unterteilt sind.
* Rechts: Die Maßnahmen/Befunde, die zu einer Kategorie zugeordnet sind.

Die getroffene Auswahl wird dabei grün hinterlegt.

'''Hinweis:''' Je nach Fachanwendung unterscheiden sich natürlich die Auswahlmöglichkeiten der Maßnahmen. Die Kategorien und die Zuordnung zu den einzelnen Maßnahmen sind frei definierbar und kann im GMSC-K individualisiert werden.

Nach dem Bestätigen werden diese der Liste hinzugefügt und lassen sich für weitere Informationen bearbeiten; zu erkennen an der schwarzen Umrandung. Dabei ist darauf zu achten:
# Der erste Klick ist, um den Datensatz zu markieren.
# Der zweite Klick, um die Eingabe in das gewünschte Feld zu aktivieren.

=== Dokumente ===
Der Reiter Dokumente gibt eine Übersicht aller angehängten Dateien zum Objekt. Oftmals handelt es sich dabei um ein Foto. Die Datei wird in der für das Dateiformat entsprechenden App geöffnet, wenn Sie auf den Eintrag klicken.

==== Foto anhängen ====
Möchten Sie einem Befund ein Foto anhängen, öffnen Sie dafür die Kamera-App Ihres Tablets. Dabei verlassen Sie die mobileApp. Sobald Sie ein Foto geschossen haben, wechseln Sie wieder zurück zur mobileApp. In der Übersicht ist ein neuer Eintrag mit dem aktuellen Erstelldatum aufgelistet, ohne dass Sie noch weitere Schritte vornehmen müssen. Speichern Sie Ihre Änderungen.

== Fachspezifische Reiter ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| '''Anmerkung''': Ein freies Textfeld für zusätzliche Informationen, die den Baum betreffen. || [[MobileAppBaum#Datenmaske | mobileApp Baum Befunde]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || '''Pflanzen''': Hier können die auf der Grünfläche angelegten Pflanzen ergänzt oder überprüft werden.|| [[MobileAppGruen#Datenmaske| mobileApp Grün Befunde]]
|}

= Konfiguration =

Für die Konfiguration sind zwei lokale Dateien auf dem Tablet relevant:
* '''mobile.json''': Angaben zur Verbindung zum Server 
* '''[Applikation].json''' (z.B. baum.json): Angaben zu Arbeitssitzung, Suchmaske, Auswahllisten. Wird pro Applikation definiert 

== Allgemeine Verbindungseinstellungen ==
Eine Einführung zu dem Datumsform JSON finden Sie im [https://wiki.selfhtml.org/wiki/JSON JSON - SELFHTML-Wiki].

Konfiguration in der Datei „mobile.json“:

{| class="wikitable"
|-
! Parameter !! Typ!! Beschreibung
|-
| "serverURL" || Text|| Verbindungsdaten des GMSCK Servers
|-
| "codebase"|| Text|| Verbindungsdaten für die Kartenkomponente GMSC
|-
| "virtualSite" || Text||
|-
| "workspace" || Text|| Die zu öffnende Arbeitsmappe von GMSC-K
|-
| "login" || Text|| Voreinstellung für das Login des Nutzers
|-
| "picturePath" || Text|| Der Dateipfad, unter welchem die Kamera-App die aufgenommenen Bilder speichert
|-
| "gpsMode" || Text|| Der Modus für GPS
|-
| "gpsComPort" || Text|| Der virtuelle COM-Port an welchem die NMEA-Daten des GPS Sensors ausgelesen werden können.
|-
| "gpsRefreshRate" || Integer|| Die Zeitspanne, in der die GPS-Daten in der Kartenkomponente aktualisiert werden (in Sekunden)
|-
| "offlineWorkspacePath"|| Beispiel || Der Dateipfad, unter welchem die Sitzungsdaten der mobileApp gespeichert werden.
|-
| "tabletMode" || Boolean|| Aktivierung des Tabletmodus oder Desktopmodus
|-
| "styles" || Text|| Zusätzliche Stylesheets für die mobileApp, z.B. für spezielle Bildschirmauflösungen.
|-
| Beispiel || Beispiel || Beispiel
|}

==Arbeitssitzungen==

Jede mobile Fachanwendung kann mehrere Arbeitssitzungen angeben, die in der mobileApp verfügbar sein sollen. Die Arbeitssitzungen werden wie gewohnt innerhalb von GMSC-K eingerichtet.
Dabei ist zu beachten, dass die Arbeitssitzungen für den mobilen Nutzer über die Nutzer-/Rechteverwaltung freigegeben sind.

{
"bookmarks" : ["Luftbild", "Grundkarte"]
}

==Filterkonfigurationen für Sachdaten==

Viele Sichten in GMSC-K verwenden einen Sichtenfilter.
Um sicherzustellen, dass in der mobileApp die Anzahl der Datensätze in der Karte mit der Anzahl der Sachdaten übereinstimmt, müssen die Sachdaten über einen Filter eingeschränkt werden.
Dies wird mit Hilfe von SQL-Filtern umgesetzt. Dabei muss der SQL-Filter dem Sichtenfilter in GMSC-K entsprechen.
Weiterhin können komplexe Stammdaten wie z.B. Adressen oder Straßen mit SQL-Filtern für die mobileApp auf die notwendige Anzahl eingeschränkt werden.

"filter" : {
"filterBaum" : "(baum.FAELLUNG <> 1 OR baum.FAELLUNG IS NULL)",
"filterStrasse" : "this_.STRASSESCHLUESSELG IS NOT NULL"
}
==Filterkonfigurationen für Stammdaten (Auswahllisten)==

Auswahllisten (Codelisten) innerhalb der mobileApp können über Auswahleinschränkungen auf die nur benötigten Werte angepasst werden.

"auswahlStatus" : {"auswahlName" : "FA", "auswahlWert" : "Vorgangsposition" },
"auswahlKategorie" : {"auswahlName" : "FA", "auswahlWert" : "Baum" }

==Konfiguration der Befundarten/Schadensarten==

In der mobileApp kann man für viele Fachobjekte Befunde bzw. Schäden erfassen. Abhängig von Fachobjekt sind unterschiedliche Arten von Befunden/Schäden möglich.
Dabei kann man die Befundarten mit Hilfe von Auswahleinschränkungen in unterschiedliche Kategorien einordnen.

"befundartConfigs" : [
{ "label" : "kritische Schäden",
"auswahleinschraenkung" : {"auswahlName" : "Befundart", "auswahlWert" : "kritisch" }
},
{ "label" : "geringe Schäden",
"auswahleinschraenkung" : {"auswahlName" : "Befundart", "auswahlWert" : "gering" }
}
]

==Konfiguration der Maßnahmenarten==

Wie Befunde oder Schäden kann man bei vielen Fachobjekten in der mobileApp auch Maßnahmen (Vorgangsposition) erfassen. Auch die Maßnahmenarten werden wie die Befundarten mit Hilfe von Auswahleinschränkungen konfiguriert.
Es ist aber zu beachten, dass hier als Gliederung eine Oberkategorie verwendet wird, die auch als Datensatz einer Kategorie in GMSC-K vorhanden sein muss.
Die Oberkategorie wird über das Kürzel festgelegt und der Vorgangsposition in das Datenfeld '''kategorie''' zugeordnet. Die ausgewählte Maßnahmenart wird in das Feld '''kategorie1''' geschrieben.

"massnahmenConfigs" : [
{
"parentKategorie" : { "label" : "Maßnahmen", "code" : "MASS"},
"auswahleinschraenkung" : {"auswahlName" : "Massnahme", "auswahlWert" : "MASS" }
}
]

==Konfiguration der Vorbelegungen==

In der mobileApp können für Maßnahmen (darunter auch die Kontrollen), Befunde und Dokumente Vorbelegungen definiert werden. Bestimmte Felder werden auf diese Art automatisch bei einer Neuanlage ausgefüllt.
Dabei sind Vorbelegungen für Auswahllisten (type=codelist) oder Texte (type=string) möglich. Bei einer Vorbelegung muss man den Typ, das Feld und den Wert angeben.
Es können mehrere Vorbelegungen festgelegt werden, dabei sind null-Werte auch möglich.

"vorbelegungenByType" : {
"Kontrolle" : [
{
"type" : "codelist",
"attribute" : "status",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Status", "code" : "durchgeführt" }
},
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"MN_Vorgangsposition" : [
{
"type" : "codelist",
"attribute" : "status",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Status", "code" : "offen" }
},
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"MN_Befund" : [
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"Dokument" : [
{
"type" : "codelist",
"attribute" : "dokumentart",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.Dokumentart", "code" : "FOTO" }
},
{
"type" : "string",
"attribute" : "bezeichnung",
"value" : "Bild"
}
]
}

= Datenübertragung an Server =
[[File:MAP_Baum_synch.jpg|400px|mini|Dialog bei Änderungen am Offline-Datenbestand am Beispiel Baum]]
[[File:MAP_Baum_synch_erfolgreich.jpg|300px|mini]]
# Mobile App schließen
# Das Tablet an die Dockingstation anschließen. Achten Sie darauf, dass die Dockingstation am Netz angeschlossen ist.
# Mobile App starten.
# Eine Arbeitssitzung auswählen.
# Sind Änderungen am Offline-Datenbestand festgestellt wurden, dann erhalten Sie eine entsprechende Abfrage, ob Sie die Änderungen auf dem Server übertragen möchten. Mit OK starten Sie die Übertragung.
# Wenn die Übertragung fertig ist, dann erhalten Sie eine entsprechende Meldung, dass die Übertragung abgeschlossen ist.
# Mobile App schließen.
# Tablet aus der Dockingstation entfernen.
==== Erläuterung ====
Die Datenübertragung findet intern in zwei Schritten statt.
* die geänderten Daten auf dem Tablet werden auf den GMSC-K zentralen Server übertragen.
* der gesamte und durch den Schritt 1 aktualisierte Datenbestand wird dann komplett auf dem Tablett übertragen.

MobileAppBasis

2020-02-19T09:41:57Z

Rreiss: /* Konfiguration der Maßnahmenarten */

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; float:right; width=30px ;
border:1px solid #cccccc; background-color:#CAE1FF;
padding: 0.5em;">
[[File:KTGIS_Stempel.png|200px]] 
 
'''Erforderliche Lizenzen''' 
zur mobileApp '''Basis''' 
* GMSC-K Basis-Lizenzen
* GMSC mobileApp Basis
</div>
[[Datei:MobileApp Basis.png|500px]]

= Voraussetzungen=

Die mobilen Applikationen dienen der Kontrolle und Erfassung von ausgewählten Daten im Offlinemodus auf einem robusten, für den Außendienst tauglichen Tablet. 

Voraussetzung der mobilen Applikationen sind drei Bestandteile: 
* GMSC-K Basis Software
* GMSC-K Fachanwendung
* Geeignete Hardware – wie DELL oder Getac Tablets
Software-Bestandteile der mobilen Applikationen:
* GMSC mobileApp Basis
* GMSC mobileApp [Anwendung]

= Definitionen =

* '''GMSC-K''': das Basisprogramm für den Server
* '''GMSC-K Fachanwendung oder nur Fachanwendung''': die Fachanwendung auf dem Server
* '''Applikation''': die Applikation zur Bearbeitung eines Fachthemas auf der mobilen Lösung. Die Applikation ist meist mit einer bestimmten Fachanwendung assoziiert.
* '''Tablet''': das Hardwaregerät für den Außendienst.
* '''Online Modus''': die mobile Applikation hat Zugang zum zentralen GMSC-K Server. Relevant für Datenübertragung durch mobile Daten oder einen WLAN-Zugang
* '''Offline Modus''': die mobile Applikation hat keinen Zugang zum zentralen GMSC-K Server. Relevant für Datenänderung und Erfassung

= Programmstart =

[[File:MAP_1_anmelden.jpg|300px|mini|Startbildschirm mit Login]] 
# Doppelklick auf dem eingerichteten Icon auf dem Desktop.
# Anmeldefenster mit Nutzername und Kennwort wird geladen.
# Nutzername und Kennwort eintragen und mit Anmelden bestätigen.

[[File:MAP_3_arbeitsitzung.jpg|300px|mini|Arbeitssitzungen nach Login]] 

Nach dem Einloggen werden die Lizenzen geprüft. Im Falle fehlender Lizenzen erfolgt ein entsprechender Hinweis.

=== Arbeitssitzung ===

Die eingerichteten Arbeitssitzungen für die mobilen Apps werden als Kacheln abgebildet. Mit einem Klick auf der gewünschten Kachel laden Sie die Arbeitssitzung. Der Ladedauer hängt vom Umfang der Arbeitssitzung ab.

==== Konfiguration der Arbeitssitzungen ====
Arbeitssitzungen werden im GMSC-K definiert. Eine Arbeitssitzung wird je Applikation definiert. Diese befindet sich nach der Installation als Konfigurationsdatei lokal auf dem Tablet. Die Dateien heißen [Applikation].json, z.B. baum.json. In die Zeile „bookmarks“: [„Bezeichnung der Arbeitssitzung in GMSC-K“] tragen Sie die Bezeichnung der Arbeitssitzung aus GMSC-K ein. 

= Arbeitsfenster-Aufbau =
[[Datei:Arbeitsfenster.jpg|500px|mini|Aufbau des Arbeitsfensters]]

=== Rechts ===
Funktionen zum Zoomen und Sachdatenabfrage

* [[Datei:Plus.png|30px]] und [[Datei:Minus.png|30px]] ermöglichen das rein- und rauszoomen der Karte.
* [[Datei:Info-button.png|30px]]: Für die Sachdatenanfrage aus der Karte. Nachdem Sie das Symbol geklickt haben, müssen Sie das gewünschte Objekt in der Karte anklicken. Vorausgesetzt, es sind Sachdaten für die Anzeige auf der mobilen App freigegeben, erhalten Sie eine entsprechende Sachdatenmaske. Andernfalls erhalten Sie die Anzeige „kein Datensatz“.

=== Unten ===
Infoleiste für die Koordinaten des Kartenmittelpunkts und Maßstab des momentanen Kartenausschnitt

=== Oben ===
'''Hinweis:''' erscheint nur, wenn man am oberen Rand tippt. Hier sind Funktionen zum Minimieren, Fenstermodus / Vollbildmodus und Schließen des Fensters
[[File:MAP_9_leiste_oben.jpg|500px]] 

=== Links ===
Die Funktionsleiste ist eine vertikale Leiste, die mehrere Funktionen & Favoriten beinhaltet (siehe folgenden Abschnitt).

= Funktionsleiste & Standardfunktionen =
[[File:MAP_5_Sichten.jpg|200px|mini|Sichtenanzeige-Sidebar]]
Standardmäßig sind die Funktionen ''Sichtenanzeige'' und ''Konfiguration''. Weitere Schaltflächen können als Favoriten hinzugefügt werden, siehe unten.

===[[File:MAP_legende.PNG|50px]] Sichtenanzeige ===
Die Sichtenanzeige listet Arbeitssitzungen und deren enthaltenen Sichten auf. Die in der Karte vorhandenen Sichten werden einschließlich ihrer Symbolik bzw. Farbe angezeigt. Mit einem Klick auf die Arbeitssitzung können Sie den gesamten Inhalt der Arbeitssitzung in die Karte laden oder ausblenden. Ausgeblendete Sichten werden mit einem roten Statusbalken markiert.

Mit einem Klick auf das Symbol <big>'''>'''</big> (Rechts von der Bezeichnung der Arbeitssitzung) gelangen Sie zu der Liste der enthaltenen Sichten. Mit einem Klick auf die Bezeichnung der Sicht können Sie einzelne Sichten innerhalb der Arbeitssitzung in die Karte laden oder ausblenden.

[[Datei:Kacheln.png|mini|Übersicht der Funktionen]]
===[[Datei:Ktgis.png|50px]] Funktionsübersicht ===
Mit diesem Button gelangen Sie zu der Übersicht der freigeschalteten Apps und Funktionen. Die Funktionen werden nach der Zugehörigkeit zu einer App sortiert. Allgemeine Funktionen werden unter der Überschrift Standard abgebildet.

Mit einem langen Klick auf eine Kachel erscheint eine Schaltfläche zum Hinzfügen eines Favoriten. Nachdem man diese bestätigt hat, erscheint die Funktion auf der Funktionsleiste. Um sie wieder zu entfernen, einfach in der Funktionsleiste lange gedrückt halten, bis sich die Schaltfläche ''von Favoriten entfernen'' öffnet und diese bestätigen.

=== [[Datei:Mapview.png|50px]] Lesezeichen ===
Sie können eine bestimmte Position auf der Karte als Lesezeichen speichern und wieder aufrufen. Mit einem Doppelklick auf das Symbol speichern Sie die aktuelle Position in der Karte. Mit einem einfachen Klick rufen Sie die Definition ab, d.h. die Kartenansicht springt zur gespeicherten Ansicht.

=== [[Datei:Auskunft Suche.png|50px]] Freitextsuche ===
Die Freitextsuche können Objekte durchsucht werden. ''Die Suche in bestimmten Ebenen muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Gps deaktiviert.png|50px]] GPS ===
Um die eigene Position in der Karte anzeigen zu lassen, muss GPS aktiviert sein. Ist GPS eingeschaltet, wechselt der Button zu einem weißen Pin. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Nutzerposition.png|50px]] zur Position zoomen ===
Falls Sie GPS aktiviert haben und Ihre Position nicht finden können, ist es möglich, mithilfe dieser Funktion die aktuelle Position in der Karte anzeigen zu lassen. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''
[[Datei:MobileApp-Messen.gif|400px|mini|Anwendung der Messen-Funktion (zum Abspielen des Videos bitte klicken)]]
=== [[Datei:Messen-button.png|50px]] Messen ===
Mit einem Klick auf diesen Button öffnet sich die Funktion des Messens in Form eines Fadenkreuzes und drei Werkzeug Buttons. Mit dem Fadenkreuz wird die Position des Ankerpunktes auf der Karte festgelegt. Der Knoten+ Button bestätigt die aktuelle Position und lässt einen weiteren Knotenpunkt hinzufügen. Mit dem Speichern Button wird die Messung gespeichert und beendet. Um ohne Speichern zu beenden, einfach auf das große X klicken. Die gespeicherte Messung bleibt auf der Karte für die Sitzung bestehen. Möchten Sie die Messung wieder löschen, betätigen Sie den Button ''Messungen löschen''.

=== [[Datei:Backup.png|50px]] Backup DB ===
Die lokale Datenbank kann mit Hilfe dieser Funktion in einer lokalen Sicherungsdatei abgelegt werden. Bei erfolgreichem Backup erscheint ein Dialog mit dem Pfad zur ZIP-Datei.

=== [[Datei:DB Schema Update.png|50px]] Update DB-Schema ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Die lokalen Tabellen werden gemäß dem Datenbankaufbau des Servers erstellt / angepasst. Dabei kann es zu Löschungen der lokalen Tabellen kommen. Ein Dialog öffnet sich, der bestätigt werden muss.
[[Datei:Sync-dialog.png|400px|mini|Synchronisierungsdialog zum Auswählen der Daten]]
=== [[File:sync.png|50px]] Offlinefähigkeit ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Sie können damit die Daten auf ihrem Tablet mit denen auf dem Server synchronisieren. Dazu öffnet sich ein Dialog, über den Sie die gewünschten Daten auswählen können. Je nach Ihren Fachanwendungen sind diese aufgelistet.

== Fachspezifische Funktionen ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| Baum hinzufügen, Baumbestand Suche, Baum-Geometrie bearbeiten|| [[MobileAppBaum#Funktionen | mobileApp Baum Funktionen]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || Grünfläche hinzufügen, Grünbestand-Suche, Grünflächen-Geometrie bearbeiten || [[MobileAppGruen#Funktionen | mobileApp Grün Funktionen]]
|}

= Datenmaske =
In der mobileApp ist eine der Grundfunktionen das Anlegen von Befunden zu einem Objekt der Fachanwendung. Je nach Fachanwendung kann sich die Eingabemaske und möglichen Inhalten unterscheiden. In diesem Abschnitt wird der allgemeine Aufbau einer solchen Eingabemaske erklärt.

Beim Anlegen eines neuen Objektes öffnet sich nach dem Speichern der Geometrie die Befund-Eingabemaske automatisch, um Sachdaten zum Objekt anzugeben (wie das funktioniert, wird in der fachspezifischen Dokumentation erklärt). Um einen Befund für ein existierendes Objekt anzulegen, wählt man ein Objekt mithilfe des Info-Buttons [[Datei:Info-button.png|30px]] aus. Daraufhin öffnet sich die Eingabemaske zum Objekt.

Änderungen lassen sich durch den Speicher-Button [[Datei:Speichern-mobileApp.png|30px]] oben links bestätigen oder durch den Schließen-Button [[Datei:Schliessen-mobileApp.png|30px]] oben rechts abbrechen.

[[Datei:Grunddaten-gruen.png|mini|Grunddatenmaske am Beispiel Grünfläche]]
=== Grunddaten ===
'''Hinweis''': Je nach Fachanwendung kann dieser Reiter eine andere Bezeichnung haben, tritt allerdings immer als erster Reiter auf.

Bereits vorliegende Daten werden im Reiter '''Grunddaten''' entsprechend angezeigt und es besteht die Möglichkeit diese zu aktualisieren oder zu ergänzen. Felder, die grau hinterlegt sind, lassen sich nicht bearbeiten. Folgende Eingabefelder können auftreten:
* Text-Eingabefelder
* Dropdown-Auswahlliste bei einer kleinen Menge an Auswahlmöglichkeiten
* Alphabet-Auswahlliste bei vielen Auswahlmöglichkeiten
* Umschalt-Buttons (toggle) die durch eine grüne Unterstreichung aktiviert oder durch eine Ausgrauung deaktiviert werden

[[Datei:Massnahmen-baum.png|mini|Maßnahmenmaske am Beispiel Baum]]
=== Maßnahmen & Befunde ===
Der Maßnahmen-Reiter werden notwendige Tätgkeiten am Objekt und bereits aufgenommene Maßnahmen aufgelistet. Im Reiter '''Befunddaten''' werden Schäden und Auffälligkeiten am Objekt dokumentiert. Die Funktionsweise ist für beide Reiter gleich.

Wenn Sie im jeweiligen Reiter Daten hinzufügen möchten, können Sie diese über den Dialog nach Klicken des '''Hinzufügen'''-Buttons auswählen.
* Links: Die Kategorien, in die die Maßnahmen/Befunde unterteilt sind.
* Rechts: Die Maßnahmen/Befunde, die zu einer Kategorie zugeordnet sind.

Die getroffene Auswahl wird dabei grün hinterlegt.

'''Hinweis:''' Je nach Fachanwendung unterscheiden sich natürlich die Auswahlmöglichkeiten der Maßnahmen. Die Kategorien und die Zuordnung zu den einzelnen Maßnahmen sind frei definierbar und kann im GMSC-K individualisiert werden.

Nach dem Bestätigen werden diese der Liste hinzugefügt und lassen sich für weitere Informationen bearbeiten; zu erkennen an der schwarzen Umrandung. Dabei ist darauf zu achten:
# Der erste Klick ist, um den Datensatz zu markieren.
# Der zweite Klick, um die Eingabe in das gewünschte Feld zu aktivieren.

=== Dokumente ===
Der Reiter Dokumente gibt eine Übersicht aller angehängten Dateien zum Objekt. Oftmals handelt es sich dabei um ein Foto. Die Datei wird in der für das Dateiformat entsprechenden App geöffnet, wenn Sie auf den Eintrag klicken.

==== Foto anhängen ====
Möchten Sie einem Befund ein Foto anhängen, öffnen Sie dafür die Kamera-App Ihres Tablets. Dabei verlassen Sie die mobileApp. Sobald Sie ein Foto geschossen haben, wechseln Sie wieder zurück zur mobileApp. In der Übersicht ist ein neuer Eintrag mit dem aktuellen Erstelldatum aufgelistet, ohne dass Sie noch weitere Schritte vornehmen müssen. Speichern Sie Ihre Änderungen.

== Fachspezifische Reiter ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| '''Anmerkung''': Ein freies Textfeld für zusätzliche Informationen, die den Baum betreffen. || [[MobileAppBaum#Datenmaske | mobileApp Baum Befunde]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || '''Pflanzen''': Hier können die auf der Grünfläche angelegten Pflanzen ergänzt oder überprüft werden.|| [[MobileAppGruen#Datenmaske| mobileApp Grün Befunde]]
|}

= Konfiguration =

Für die Konfiguration sind zwei lokale Dateien auf dem Tablet relevant:
* '''mobile.json''': Angaben zur Verbindung zum Server 
* '''[Applikation].json''' (z.B. baum.json): Angaben zu Arbeitssitzung, Suchmaske, Auswahllisten. Wird pro Applikation definiert 

== Allgemeine Verbindungseinstellungen ==
Eine Einführung zu dem Datumsform JSON finden Sie im [https://wiki.selfhtml.org/wiki/JSON JSON - SELFHTML-Wiki].

Konfiguration in der Datei „mobile.json“:

{| class="wikitable"
|-
! Parameter !! Typ!! Beschreibung
|-
| "serverURL" || Text|| Verbindungsdaten des GMSCK Servers
|-
| "codebase"|| Text|| Verbindungsdaten für die Kartenkomponente GMSC
|-
| "virtualSite" || Text||
|-
| "workspace" || Text|| Die zu öffnende Arbeitsmappe von GMSC-K
|-
| "login" || Text|| Voreinstellung für das Login des Nutzers
|-
| "picturePath" || Text|| Der Dateipfad, unter welchem die Kamera-App die aufgenommenen Bilder speichert
|-
| "gpsMode" || Text|| Der Modus für GPS
|-
| "gpsComPort" || Text|| Der virtuelle COM-Port an welchem die NMEA-Daten des GPS Sensors ausgelesen werden können.
|-
| "gpsRefreshRate" || Integer|| Die Zeitspanne, in der die GPS-Daten in der Kartenkomponente aktualisiert werden (in Sekunden)
|-
| "offlineWorkspacePath"|| Beispiel || Der Dateipfad, unter welchem die Sitzungsdaten der mobileApp gespeichert werden.
|-
| "tabletMode" || Boolean|| Aktivierung des Tabletmodus oder Desktopmodus
|-
| "styles" || Text|| Zusätzliche Stylesheets für die mobileApp, z.B. für spezielle Bildschirmauflösungen.
|-
| Beispiel || Beispiel || Beispiel
|}

==Arbeitssitzungen==

Jede mobile Fachanwendung kann mehrere Arbeitssitzungen angeben, die in der mobileApp verfügbar sein sollen. Die Arbeitssitzungen werden wie gewohnt innerhalb von GMSC-K eingerichtet.
Dabei ist zu beachten, dass die Arbeitssitzungen für den mobilen Nutzer über die Nutzer-/Rechteverwaltung freigegeben sind.

{
"bookmarks" : ["Luftbild", "Grundkarte"]
}

==Filterkonfigurationen für Sachdaten==

Viele Sichten in GMSC-K verwenden einen Sichtenfilter.
Um sicherzustellen, dass in der mobileApp die Anzahl der Datensätze in der Karte mit der Anzahl der Sachdaten übereinstimmt, müssen die Sachdaten über einen Filter eingeschränkt werden.
Dies wird mit Hilfe von SQL-Filtern umgesetzt. Dabei muss der SQL-Filter dem Sichtenfilter in GMSC-K entsprechen.
Weiterhin können komplexe Stammdaten wie z.B. Adressen oder Straßen mit SQL-Filtern für die mobileApp auf die notwendige Anzahl eingeschränkt werden.

"filter" : {
"filterBaum" : "(baum.FAELLUNG <> 1 OR baum.FAELLUNG IS NULL)",
"filterStrasse" : "this_.STRASSESCHLUESSELG IS NOT NULL"
}
==Filterkonfigurationen für Stammdaten (Auswahllisten)==

Auswahllisten (Codelisten) innerhalb der mobileApp können über Auswahleinschränkungen auf die nur benötigten Werte angepasst werden.

"auswahlStatus" : {"auswahlName" : "FA", "auswahlWert" : "Vorgangsposition" },
"auswahlKategorie" : {"auswahlName" : "FA", "auswahlWert" : "Baum" }

==Konfiguration der Befundarten/Schadensarten==

In der mobileApp kann man für viele Fachobjekte Befunde bzw. Schäden erfassen. Abhängig von Fachobjekt sind unterschiedliche Arten von Befunden/Schäden möglich.
Dabei kann man die Befundarten mit Hilfe von Auswahleinschränkungen in unterschiedliche Kategorien einordnen.

"befundartConfigs" : [
{ "label" : "kritische Schäden",
"auswahleinschraenkung" : {"auswahlName" : "Befundart", "auswahlWert" : "kritisch" }
},
{ "label" : "geringe Schäden",
"auswahleinschraenkung" : {"auswahlName" : "Befundart", "auswahlWert" : "gering" }
}
]

==Konfiguration der Maßnahmenarten==

Wie Befunde oder Schäden kann man bei vielen Fachobjekten in der mobileApp auch Maßnahmen (Vorgangsposition) erfassen. Auch die Maßnahmenarten werden wie die Befundarten mit Hilfe von Auswahleinschränkungen konfiguriert.
Es ist aber zu beachten, dass hier als Gliederung eine Oberkategorie verwendet wird, die auch als Datensatz einer Kategorie in GMSC-K vorhanden sein muss.
Die Oberkategorie wird über das Kürzel festgelegt und der Vorgangsposition in das Datenfeld '''kategorie''' zugeordnet. Die ausgewählte Maßnahmenart wird in das Feld '''kategorie1''' geschrieben.

"massnahmenConfigs" : [
{
"parentKategorie" : { "label" : "Maßnahmen", "code" : "MASS"},
"auswahleinschraenkung" : {"auswahlName" : "Massnahme", "auswahlWert" : "MASS" }
}
]

==Konfiguration der Vorbelegungen==

In der mobileApp können für Maßnahmen (darunter auch die Kontrollen), Befunde und Dokumente Vorbelegungen definiert werden. Bestimmte Felder können auf diese Art automatisch bei einer Neuanlage ausgefüllt werden.
Dabei sind Vorbelegungen für Auswahllisten (type=codelist) oder Texte (type=string) möglich. Bei einer Vorbelegung muss man den Typ, das Feld und den Wert angeben.
Es können mehrere Vorbelegungen festgelegt werden, dabei sind null-Werte auch möglich.

"vorbelegungenByType" : {
"Kontrolle" : [
{
"type" : "codelist",
"attribute" : "status",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Status", "code" : "durchgeführt" }
},
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"MN_Vorgangsposition" : [
{
"type" : "codelist",
"attribute" : "status",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Status", "code" : "offen" }
},
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"MN_Befund" : [
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"Dokument" : [
{
"type" : "codelist",
"attribute" : "dokumentart",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.Dokumentart", "code" : "FOTO" }
},
{
"type" : "string",
"attribute" : "bezeichnung",
"value" : "Bild"
}
]
}

= Datenübertragung an Server =
[[File:MAP_Baum_synch.jpg|400px|mini|Dialog bei Änderungen am Offline-Datenbestand am Beispiel Baum]]
[[File:MAP_Baum_synch_erfolgreich.jpg|300px|mini]]
# Mobile App schließen
# Das Tablet an die Dockingstation anschließen. Achten Sie darauf, dass die Dockingstation am Netz angeschlossen ist.
# Mobile App starten.
# Eine Arbeitssitzung auswählen.
# Sind Änderungen am Offline-Datenbestand festgestellt wurden, dann erhalten Sie eine entsprechende Abfrage, ob Sie die Änderungen auf dem Server übertragen möchten. Mit OK starten Sie die Übertragung.
# Wenn die Übertragung fertig ist, dann erhalten Sie eine entsprechende Meldung, dass die Übertragung abgeschlossen ist.
# Mobile App schließen.
# Tablet aus der Dockingstation entfernen.
==== Erläuterung ====
Die Datenübertragung findet intern in zwei Schritten statt.
* die geänderten Daten auf dem Tablet werden auf den GMSC-K zentralen Server übertragen.
* der gesamte und durch den Schritt 1 aktualisierte Datenbestand wird dann komplett auf dem Tablett übertragen.

MobileAppBasis

2020-02-19T09:37:26Z

Rreiss:

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; float:right; width=30px ;
border:1px solid #cccccc; background-color:#CAE1FF;
padding: 0.5em;">
[[File:KTGIS_Stempel.png|200px]] 
 
'''Erforderliche Lizenzen''' 
zur mobileApp '''Basis''' 
* GMSC-K Basis-Lizenzen
* GMSC mobileApp Basis
</div>
[[Datei:MobileApp Basis.png|500px]]

= Voraussetzungen=

Die mobilen Applikationen dienen der Kontrolle und Erfassung von ausgewählten Daten im Offlinemodus auf einem robusten, für den Außendienst tauglichen Tablet. 

Voraussetzung der mobilen Applikationen sind drei Bestandteile: 
* GMSC-K Basis Software
* GMSC-K Fachanwendung
* Geeignete Hardware – wie DELL oder Getac Tablets
Software-Bestandteile der mobilen Applikationen:
* GMSC mobileApp Basis
* GMSC mobileApp [Anwendung]

= Definitionen =

* '''GMSC-K''': das Basisprogramm für den Server
* '''GMSC-K Fachanwendung oder nur Fachanwendung''': die Fachanwendung auf dem Server
* '''Applikation''': die Applikation zur Bearbeitung eines Fachthemas auf der mobilen Lösung. Die Applikation ist meist mit einer bestimmten Fachanwendung assoziiert.
* '''Tablet''': das Hardwaregerät für den Außendienst.
* '''Online Modus''': die mobile Applikation hat Zugang zum zentralen GMSC-K Server. Relevant für Datenübertragung durch mobile Daten oder einen WLAN-Zugang
* '''Offline Modus''': die mobile Applikation hat keinen Zugang zum zentralen GMSC-K Server. Relevant für Datenänderung und Erfassung

= Programmstart =

[[File:MAP_1_anmelden.jpg|300px|mini|Startbildschirm mit Login]] 
# Doppelklick auf dem eingerichteten Icon auf dem Desktop.
# Anmeldefenster mit Nutzername und Kennwort wird geladen.
# Nutzername und Kennwort eintragen und mit Anmelden bestätigen.

[[File:MAP_3_arbeitsitzung.jpg|300px|mini|Arbeitssitzungen nach Login]] 

Nach dem Einloggen werden die Lizenzen geprüft. Im Falle fehlender Lizenzen erfolgt ein entsprechender Hinweis.

=== Arbeitssitzung ===

Die eingerichteten Arbeitssitzungen für die mobilen Apps werden als Kacheln abgebildet. Mit einem Klick auf der gewünschten Kachel laden Sie die Arbeitssitzung. Der Ladedauer hängt vom Umfang der Arbeitssitzung ab.

==== Konfiguration der Arbeitssitzungen ====
Arbeitssitzungen werden im GMSC-K definiert. Eine Arbeitssitzung wird je Applikation definiert. Diese befindet sich nach der Installation als Konfigurationsdatei lokal auf dem Tablet. Die Dateien heißen [Applikation].json, z.B. baum.json. In die Zeile „bookmarks“: [„Bezeichnung der Arbeitssitzung in GMSC-K“] tragen Sie die Bezeichnung der Arbeitssitzung aus GMSC-K ein. 

= Arbeitsfenster-Aufbau =
[[Datei:Arbeitsfenster.jpg|500px|mini|Aufbau des Arbeitsfensters]]

=== Rechts ===
Funktionen zum Zoomen und Sachdatenabfrage

* [[Datei:Plus.png|30px]] und [[Datei:Minus.png|30px]] ermöglichen das rein- und rauszoomen der Karte.
* [[Datei:Info-button.png|30px]]: Für die Sachdatenanfrage aus der Karte. Nachdem Sie das Symbol geklickt haben, müssen Sie das gewünschte Objekt in der Karte anklicken. Vorausgesetzt, es sind Sachdaten für die Anzeige auf der mobilen App freigegeben, erhalten Sie eine entsprechende Sachdatenmaske. Andernfalls erhalten Sie die Anzeige „kein Datensatz“.

=== Unten ===
Infoleiste für die Koordinaten des Kartenmittelpunkts und Maßstab des momentanen Kartenausschnitt

=== Oben ===
'''Hinweis:''' erscheint nur, wenn man am oberen Rand tippt. Hier sind Funktionen zum Minimieren, Fenstermodus / Vollbildmodus und Schließen des Fensters
[[File:MAP_9_leiste_oben.jpg|500px]] 

=== Links ===
Die Funktionsleiste ist eine vertikale Leiste, die mehrere Funktionen & Favoriten beinhaltet (siehe folgenden Abschnitt).

= Funktionsleiste & Standardfunktionen =
[[File:MAP_5_Sichten.jpg|200px|mini|Sichtenanzeige-Sidebar]]
Standardmäßig sind die Funktionen ''Sichtenanzeige'' und ''Konfiguration''. Weitere Schaltflächen können als Favoriten hinzugefügt werden, siehe unten.

===[[File:MAP_legende.PNG|50px]] Sichtenanzeige ===
Die Sichtenanzeige listet Arbeitssitzungen und deren enthaltenen Sichten auf. Die in der Karte vorhandenen Sichten werden einschließlich ihrer Symbolik bzw. Farbe angezeigt. Mit einem Klick auf die Arbeitssitzung können Sie den gesamten Inhalt der Arbeitssitzung in die Karte laden oder ausblenden. Ausgeblendete Sichten werden mit einem roten Statusbalken markiert.

Mit einem Klick auf das Symbol <big>'''>'''</big> (Rechts von der Bezeichnung der Arbeitssitzung) gelangen Sie zu der Liste der enthaltenen Sichten. Mit einem Klick auf die Bezeichnung der Sicht können Sie einzelne Sichten innerhalb der Arbeitssitzung in die Karte laden oder ausblenden.

[[Datei:Kacheln.png|mini|Übersicht der Funktionen]]
===[[Datei:Ktgis.png|50px]] Funktionsübersicht ===
Mit diesem Button gelangen Sie zu der Übersicht der freigeschalteten Apps und Funktionen. Die Funktionen werden nach der Zugehörigkeit zu einer App sortiert. Allgemeine Funktionen werden unter der Überschrift Standard abgebildet.

Mit einem langen Klick auf eine Kachel erscheint eine Schaltfläche zum Hinzfügen eines Favoriten. Nachdem man diese bestätigt hat, erscheint die Funktion auf der Funktionsleiste. Um sie wieder zu entfernen, einfach in der Funktionsleiste lange gedrückt halten, bis sich die Schaltfläche ''von Favoriten entfernen'' öffnet und diese bestätigen.

=== [[Datei:Mapview.png|50px]] Lesezeichen ===
Sie können eine bestimmte Position auf der Karte als Lesezeichen speichern und wieder aufrufen. Mit einem Doppelklick auf das Symbol speichern Sie die aktuelle Position in der Karte. Mit einem einfachen Klick rufen Sie die Definition ab, d.h. die Kartenansicht springt zur gespeicherten Ansicht.

=== [[Datei:Auskunft Suche.png|50px]] Freitextsuche ===
Die Freitextsuche können Objekte durchsucht werden. ''Die Suche in bestimmten Ebenen muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Gps deaktiviert.png|50px]] GPS ===
Um die eigene Position in der Karte anzeigen zu lassen, muss GPS aktiviert sein. Ist GPS eingeschaltet, wechselt der Button zu einem weißen Pin. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Nutzerposition.png|50px]] zur Position zoomen ===
Falls Sie GPS aktiviert haben und Ihre Position nicht finden können, ist es möglich, mithilfe dieser Funktion die aktuelle Position in der Karte anzeigen zu lassen. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''
[[Datei:MobileApp-Messen.gif|400px|mini|Anwendung der Messen-Funktion (zum Abspielen des Videos bitte klicken)]]
=== [[Datei:Messen-button.png|50px]] Messen ===
Mit einem Klick auf diesen Button öffnet sich die Funktion des Messens in Form eines Fadenkreuzes und drei Werkzeug Buttons. Mit dem Fadenkreuz wird die Position des Ankerpunktes auf der Karte festgelegt. Der Knoten+ Button bestätigt die aktuelle Position und lässt einen weiteren Knotenpunkt hinzufügen. Mit dem Speichern Button wird die Messung gespeichert und beendet. Um ohne Speichern zu beenden, einfach auf das große X klicken. Die gespeicherte Messung bleibt auf der Karte für die Sitzung bestehen. Möchten Sie die Messung wieder löschen, betätigen Sie den Button ''Messungen löschen''.

=== [[Datei:Backup.png|50px]] Backup DB ===
Die lokale Datenbank kann mit Hilfe dieser Funktion in einer lokalen Sicherungsdatei abgelegt werden. Bei erfolgreichem Backup erscheint ein Dialog mit dem Pfad zur ZIP-Datei.

=== [[Datei:DB Schema Update.png|50px]] Update DB-Schema ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Die lokalen Tabellen werden gemäß dem Datenbankaufbau des Servers erstellt / angepasst. Dabei kann es zu Löschungen der lokalen Tabellen kommen. Ein Dialog öffnet sich, der bestätigt werden muss.
[[Datei:Sync-dialog.png|400px|mini|Synchronisierungsdialog zum Auswählen der Daten]]
=== [[File:sync.png|50px]] Offlinefähigkeit ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Sie können damit die Daten auf ihrem Tablet mit denen auf dem Server synchronisieren. Dazu öffnet sich ein Dialog, über den Sie die gewünschten Daten auswählen können. Je nach Ihren Fachanwendungen sind diese aufgelistet.

== Fachspezifische Funktionen ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| Baum hinzufügen, Baumbestand Suche, Baum-Geometrie bearbeiten|| [[MobileAppBaum#Funktionen | mobileApp Baum Funktionen]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || Grünfläche hinzufügen, Grünbestand-Suche, Grünflächen-Geometrie bearbeiten || [[MobileAppGruen#Funktionen | mobileApp Grün Funktionen]]
|}

= Datenmaske =
In der mobileApp ist eine der Grundfunktionen das Anlegen von Befunden zu einem Objekt der Fachanwendung. Je nach Fachanwendung kann sich die Eingabemaske und möglichen Inhalten unterscheiden. In diesem Abschnitt wird der allgemeine Aufbau einer solchen Eingabemaske erklärt.

Beim Anlegen eines neuen Objektes öffnet sich nach dem Speichern der Geometrie die Befund-Eingabemaske automatisch, um Sachdaten zum Objekt anzugeben (wie das funktioniert, wird in der fachspezifischen Dokumentation erklärt). Um einen Befund für ein existierendes Objekt anzulegen, wählt man ein Objekt mithilfe des Info-Buttons [[Datei:Info-button.png|30px]] aus. Daraufhin öffnet sich die Eingabemaske zum Objekt.

Änderungen lassen sich durch den Speicher-Button [[Datei:Speichern-mobileApp.png|30px]] oben links bestätigen oder durch den Schließen-Button [[Datei:Schliessen-mobileApp.png|30px]] oben rechts abbrechen.

[[Datei:Grunddaten-gruen.png|mini|Grunddatenmaske am Beispiel Grünfläche]]
=== Grunddaten ===
'''Hinweis''': Je nach Fachanwendung kann dieser Reiter eine andere Bezeichnung haben, tritt allerdings immer als erster Reiter auf.

Bereits vorliegende Daten werden im Reiter '''Grunddaten''' entsprechend angezeigt und es besteht die Möglichkeit diese zu aktualisieren oder zu ergänzen. Felder, die grau hinterlegt sind, lassen sich nicht bearbeiten. Folgende Eingabefelder können auftreten:
* Text-Eingabefelder
* Dropdown-Auswahlliste bei einer kleinen Menge an Auswahlmöglichkeiten
* Alphabet-Auswahlliste bei vielen Auswahlmöglichkeiten
* Umschalt-Buttons (toggle) die durch eine grüne Unterstreichung aktiviert oder durch eine Ausgrauung deaktiviert werden

[[Datei:Massnahmen-baum.png|mini|Maßnahmenmaske am Beispiel Baum]]
=== Maßnahmen & Befunde ===
Der Maßnahmen-Reiter werden notwendige Tätgkeiten am Objekt und bereits aufgenommene Maßnahmen aufgelistet. Im Reiter '''Befunddaten''' werden Schäden und Auffälligkeiten am Objekt dokumentiert. Die Funktionsweise ist für beide Reiter gleich.

Wenn Sie im jeweiligen Reiter Daten hinzufügen möchten, können Sie diese über den Dialog nach Klicken des '''Hinzufügen'''-Buttons auswählen.
* Links: Die Kategorien, in die die Maßnahmen/Befunde unterteilt sind.
* Rechts: Die Maßnahmen/Befunde, die zu einer Kategorie zugeordnet sind.

Die getroffene Auswahl wird dabei grün hinterlegt.

'''Hinweis:''' Je nach Fachanwendung unterscheiden sich natürlich die Auswahlmöglichkeiten der Maßnahmen. Die Kategorien und die Zuordnung zu den einzelnen Maßnahmen sind frei definierbar und kann im GMSC-K individualisiert werden.

Nach dem Bestätigen werden diese der Liste hinzugefügt und lassen sich für weitere Informationen bearbeiten; zu erkennen an der schwarzen Umrandung. Dabei ist darauf zu achten:
# Der erste Klick ist, um den Datensatz zu markieren.
# Der zweite Klick, um die Eingabe in das gewünschte Feld zu aktivieren.

=== Dokumente ===
Der Reiter Dokumente gibt eine Übersicht aller angehängten Dateien zum Objekt. Oftmals handelt es sich dabei um ein Foto. Die Datei wird in der für das Dateiformat entsprechenden App geöffnet, wenn Sie auf den Eintrag klicken.

==== Foto anhängen ====
Möchten Sie einem Befund ein Foto anhängen, öffnen Sie dafür die Kamera-App Ihres Tablets. Dabei verlassen Sie die mobileApp. Sobald Sie ein Foto geschossen haben, wechseln Sie wieder zurück zur mobileApp. In der Übersicht ist ein neuer Eintrag mit dem aktuellen Erstelldatum aufgelistet, ohne dass Sie noch weitere Schritte vornehmen müssen. Speichern Sie Ihre Änderungen.

== Fachspezifische Reiter ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| '''Anmerkung''': Ein freies Textfeld für zusätzliche Informationen, die den Baum betreffen. || [[MobileAppBaum#Datenmaske | mobileApp Baum Befunde]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || '''Pflanzen''': Hier können die auf der Grünfläche angelegten Pflanzen ergänzt oder überprüft werden.|| [[MobileAppGruen#Datenmaske| mobileApp Grün Befunde]]
|}

= Konfiguration =

Für die Konfiguration sind zwei lokale Dateien auf dem Tablet relevant:
* '''mobile.json''': Angaben zur Verbindung zum Server 
* '''[Applikation].json''' (z.B. baum.json): Angaben zu Arbeitssitzung, Suchmaske, Auswahllisten. Wird pro Applikation definiert 

== Allgemeine Verbindungseinstellungen ==
Eine Einführung zu dem Datumsform JSON finden Sie im [https://wiki.selfhtml.org/wiki/JSON JSON - SELFHTML-Wiki].

Konfiguration in der Datei „mobile.json“:

{| class="wikitable"
|-
! Parameter !! Typ!! Beschreibung
|-
| "serverURL" || Text|| Verbindungsdaten des GMSCK Servers
|-
| "codebase"|| Text|| Verbindungsdaten für die Kartenkomponente GMSC
|-
| "virtualSite" || Text||
|-
| "workspace" || Text|| Die zu öffnende Arbeitsmappe von GMSC-K
|-
| "login" || Text|| Voreinstellung für das Login des Nutzers
|-
| "picturePath" || Text|| Der Dateipfad, unter welchem die Kamera-App die aufgenommenen Bilder speichert
|-
| "gpsMode" || Text|| Der Modus für GPS
|-
| "gpsComPort" || Text|| Der virtuelle COM-Port an welchem die NMEA-Daten des GPS Sensors ausgelesen werden können.
|-
| "gpsRefreshRate" || Integer|| Die Zeitspanne, in der die GPS-Daten in der Kartenkomponente aktualisiert werden (in Sekunden)
|-
| "offlineWorkspacePath"|| Beispiel || Der Dateipfad, unter welchem die Sitzungsdaten der mobileApp gespeichert werden.
|-
| "tabletMode" || Boolean|| Aktivierung des Tabletmodus oder Desktopmodus
|-
| "styles" || Text|| Zusätzliche Stylesheets für die mobileApp, z.B. für spezielle Bildschirmauflösungen.
|-
| Beispiel || Beispiel || Beispiel
|}

==Arbeitssitzungen==

Jede mobile Fachanwendung kann mehrere Arbeitssitzungen angeben, die in der mobileApp verfügbar sein sollen. Die Arbeitssitzungen werden wie gewohnt innerhalb von GMSC-K eingerichtet.
Dabei ist zu beachten, dass die Arbeitssitzungen für den mobilen Nutzer über die Nutzer-/Rechteverwaltung freigegeben sind.

{
"bookmarks" : ["Luftbild", "Grundkarte"]
}

==Filterkonfigurationen für Sachdaten==

Viele Sichten in GMSC-K verwenden einen Sichtenfilter.
Um sicherzustellen, dass in der mobileApp die Anzahl der Datensätze in der Karte mit der Anzahl der Sachdaten übereinstimmt, müssen die Sachdaten über einen Filter eingeschränkt werden.
Dies wird mit Hilfe von SQL-Filtern umgesetzt. Dabei muss der SQL-Filter dem Sichtenfilter in GMSC-K entsprechen.
Weiterhin können komplexe Stammdaten wie z.B. Adressen oder Straßen mit SQL-Filtern für die mobileApp auf die notwendige Anzahl eingeschränkt werden.

"filter" : {
"filterBaum" : "(baum.FAELLUNG <> 1 OR baum.FAELLUNG IS NULL)",
"filterStrasse" : "this_.STRASSESCHLUESSELG IS NOT NULL"
}
==Filterkonfigurationen für Stammdaten (Auswahllisten)==

Auswahllisten (Codelisten) innerhalb der mobileApp können über Auswahleinschränkungen auf die nur benötigten Werte angepasst werden.

"auswahlStatus" : {"auswahlName" : "FA", "auswahlWert" : "Vorgangsposition" },
"auswahlKategorie" : {"auswahlName" : "FA", "auswahlWert" : "Baum" }

==Konfiguration der Befundarten/Schadensarten==

In der mobileApp kann man für viele Fachobjekte Befunde bzw. Schäden erfassen. Abhängig von Fachobjekt sind unterschiedliche Arten von Befunden/Schäden möglich.
Dabei kann man die Befundarten mit Hilfe von Auswahleinschränkungen in unterschiedliche Kategorien einordnen.

"befundartConfigs" : [
{ "label" : "kritische Schäden",
"auswahleinschraenkung" : {"auswahlName" : "Befundart", "auswahlWert" : "kritisch" }
},
{ "label" : "geringe Schäden",
"auswahleinschraenkung" : {"auswahlName" : "Befundart", "auswahlWert" : "gering" }
}
]

==Konfiguration der Maßnahmenarten==

Wie Befunde oder Schäden kann man bei vielen Fachobjekten in der mobileApp auch Maßnahmen (Vorgangsposition) erfassen. Auch die Maßnahmenarten werden wie die Befundarten mit Hilfe von Auswahleinschränkungen konfiguriert.
Es ist aber zu beachten, dass hier als Gliederung eine Oberkategorie verwendet wird, die auch als Datensatz einer Kategorie in GMSC-K vorhanden sein muss.
Die Oberkategorie wird über das Kürzel festgelegt und der Vorgangsposition in das Datenfeld kategorie zugeordnet. Die ausgewählte Maßnahmenart wird in das Feld kategorie1 geschrieben.

"massnahmenConfigs" : [
{
"parentKategorie" : { "label" : "Maßnahmen", "code" : "MASS"},
"auswahleinschraenkung" : {"auswahlName" : "Massnahme", "auswahlWert" : "MASS" }
}
]

==Konfiguration der Vorbelegungen==

In der mobileApp können für Maßnahmen (darunter auch die Kontrollen), Befunde und Dokumente Vorbelegungen definiert werden. Bestimmte Felder können auf diese Art automatisch bei einer Neuanlage ausgefüllt werden.
Dabei sind Vorbelegungen für Auswahllisten (type=codelist) oder Texte (type=string) möglich. Bei einer Vorbelegung muss man den Typ, das Feld und den Wert angeben.
Es können mehrere Vorbelegungen festgelegt werden, dabei sind null-Werte auch möglich.

"vorbelegungenByType" : {
"Kontrolle" : [
{
"type" : "codelist",
"attribute" : "status",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Status", "code" : "durchgeführt" }
},
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"MN_Vorgangsposition" : [
{
"type" : "codelist",
"attribute" : "status",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Status", "code" : "offen" }
},
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"MN_Befund" : [
{
"type" : "codelist",
"attribute" : "fachanwendung",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.PF_Fachanwendung", "code" : "BW" }
}
],
"Dokument" : [
{
"type" : "codelist",
"attribute" : "dokumentart",
"value" : { "featuretype" : "de.iac_leipzig.polygis.data.model.base.Dokumentart", "code" : "FOTO" }
},
{
"type" : "string",
"attribute" : "bezeichnung",
"value" : "Bild"
}
]
}

= Datenübertragung an Server =
[[File:MAP_Baum_synch.jpg|400px|mini|Dialog bei Änderungen am Offline-Datenbestand am Beispiel Baum]]
[[File:MAP_Baum_synch_erfolgreich.jpg|300px|mini]]
# Mobile App schließen
# Das Tablet an die Dockingstation anschließen. Achten Sie darauf, dass die Dockingstation am Netz angeschlossen ist.
# Mobile App starten.
# Eine Arbeitssitzung auswählen.
# Sind Änderungen am Offline-Datenbestand festgestellt wurden, dann erhalten Sie eine entsprechende Abfrage, ob Sie die Änderungen auf dem Server übertragen möchten. Mit OK starten Sie die Übertragung.
# Wenn die Übertragung fertig ist, dann erhalten Sie eine entsprechende Meldung, dass die Übertragung abgeschlossen ist.
# Mobile App schließen.
# Tablet aus der Dockingstation entfernen.
==== Erläuterung ====
Die Datenübertragung findet intern in zwei Schritten statt.
* die geänderten Daten auf dem Tablet werden auf den GMSC-K zentralen Server übertragen.
* der gesamte und durch den Schritt 1 aktualisierte Datenbestand wird dann komplett auf dem Tablett übertragen.

MobileAppBasis

2020-02-19T09:32:38Z

Rreiss: /* Allgemeine Verbindungseinstellungen */

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; float:right; width=30px ;
border:1px solid #cccccc; background-color:#CAE1FF;
padding: 0.5em;">
[[File:KTGIS_Stempel.png|200px]] 
 
'''Erforderliche Lizenzen''' 
zur mobileApp '''Basis''' 
* GMSC-K Basis-Lizenzen
* GMSC mobileApp Basis
</div>
[[Datei:MobileApp Basis.png|500px]]

= Voraussetzungen=

Die mobilen Applikationen dienen der Kontrolle und Erfassung von ausgewählten Daten im Offlinemodus auf einem robusten, für den Außendienst tauglichen Tablet. 

Voraussetzung der mobilen Applikationen sind drei Bestandteile: 
* GMSC-K Basis Software
* GMSC-K Fachanwendung
* Geeignete Hardware – wie DELL oder Getac Tablets
Software-Bestandteile der mobilen Applikationen:
* GMSC mobileApp Basis
* GMSC mobileApp [Anwendung]

= Definitionen =

* '''GMSC-K''': das Basisprogramm für den Server
* '''GMSC-K Fachanwendung oder nur Fachanwendung''': die Fachanwendung auf dem Server
* '''Applikation''': die Applikation zur Bearbeitung eines Fachthemas auf der mobilen Lösung. Die Applikation ist meist mit einer bestimmten Fachanwendung assoziiert.
* '''Tablet''': das Hardwaregerät für den Außendienst.
* '''Online Modus''': die mobile Applikation hat Zugang zum zentralen GMSC-K Server. Relevant für Datenübertragung durch mobile Daten oder einen WLAN-Zugang
* '''Offline Modus''': die mobile Applikation hat keinen Zugang zum zentralen GMSC-K Server. Relevant für Datenänderung und Erfassung

= Programmstart =

[[File:MAP_1_anmelden.jpg|300px|mini|Startbildschirm mit Login]] 
# Doppelklick auf dem eingerichteten Icon auf dem Desktop.
# Anmeldefenster mit Nutzername und Kennwort wird geladen.
# Nutzername und Kennwort eintragen und mit Anmelden bestätigen.

[[File:MAP_3_arbeitsitzung.jpg|300px|mini|Arbeitssitzungen nach Login]] 

Nach dem Einloggen werden die Lizenzen geprüft. Im Falle fehlender Lizenzen erfolgt ein entsprechender Hinweis.

=== Arbeitssitzung ===

Die eingerichteten Arbeitssitzungen für die mobilen Apps werden als Kacheln abgebildet. Mit einem Klick auf der gewünschten Kachel laden Sie die Arbeitssitzung. Der Ladedauer hängt vom Umfang der Arbeitssitzung ab.

==== Konfiguration der Arbeitssitzungen ====
Arbeitssitzungen werden im GMSC-K definiert. Eine Arbeitssitzung wird je Applikation definiert. Diese befindet sich nach der Installation als Konfigurationsdatei lokal auf dem Tablet. Die Dateien heißen [Applikation].json, z.B. baum.json. In die Zeile „bookmarks“: [„Bezeichnung der Arbeitssitzung in GMSC-K“] tragen Sie die Bezeichnung der Arbeitssitzung aus GMSC-K ein. 

= Arbeitsfenster-Aufbau =
[[Datei:Arbeitsfenster.jpg|500px|mini|Aufbau des Arbeitsfensters]]

=== Rechts ===
Funktionen zum Zoomen und Sachdatenabfrage

* [[Datei:Plus.png|30px]] und [[Datei:Minus.png|30px]] ermöglichen das rein- und rauszoomen der Karte.
* [[Datei:Info-button.png|30px]]: Für die Sachdatenanfrage aus der Karte. Nachdem Sie das Symbol geklickt haben, müssen Sie das gewünschte Objekt in der Karte anklicken. Vorausgesetzt, es sind Sachdaten für die Anzeige auf der mobilen App freigegeben, erhalten Sie eine entsprechende Sachdatenmaske. Andernfalls erhalten Sie die Anzeige „kein Datensatz“.

=== Unten ===
Infoleiste für die Koordinaten des Kartenmittelpunkts und Maßstab des momentanen Kartenausschnitt

=== Oben ===
'''Hinweis:''' erscheint nur, wenn man am oberen Rand tippt. Hier sind Funktionen zum Minimieren, Fenstermodus / Vollbildmodus und Schließen des Fensters
[[File:MAP_9_leiste_oben.jpg|500px]] 

=== Links ===
Die Funktionsleiste ist eine vertikale Leiste, die mehrere Funktionen & Favoriten beinhaltet (siehe folgenden Abschnitt).

= Funktionsleiste & Standardfunktionen =
[[File:MAP_5_Sichten.jpg|200px|mini|Sichtenanzeige-Sidebar]]
Standardmäßig sind die Funktionen ''Sichtenanzeige'' und ''Konfiguration''. Weitere Schaltflächen können als Favoriten hinzugefügt werden, siehe unten.

===[[File:MAP_legende.PNG|50px]] Sichtenanzeige ===
Die Sichtenanzeige listet Arbeitssitzungen und deren enthaltenen Sichten auf. Die in der Karte vorhandenen Sichten werden einschließlich ihrer Symbolik bzw. Farbe angezeigt. Mit einem Klick auf die Arbeitssitzung können Sie den gesamten Inhalt der Arbeitssitzung in die Karte laden oder ausblenden. Ausgeblendete Sichten werden mit einem roten Statusbalken markiert.

Mit einem Klick auf das Symbol <big>'''>'''</big> (Rechts von der Bezeichnung der Arbeitssitzung) gelangen Sie zu der Liste der enthaltenen Sichten. Mit einem Klick auf die Bezeichnung der Sicht können Sie einzelne Sichten innerhalb der Arbeitssitzung in die Karte laden oder ausblenden.

[[Datei:Kacheln.png|mini|Übersicht der Funktionen]]
===[[Datei:Ktgis.png|50px]] Funktionsübersicht ===
Mit diesem Button gelangen Sie zu der Übersicht der freigeschalteten Apps und Funktionen. Die Funktionen werden nach der Zugehörigkeit zu einer App sortiert. Allgemeine Funktionen werden unter der Überschrift Standard abgebildet.

Mit einem langen Klick auf eine Kachel erscheint eine Schaltfläche zum Hinzfügen eines Favoriten. Nachdem man diese bestätigt hat, erscheint die Funktion auf der Funktionsleiste. Um sie wieder zu entfernen, einfach in der Funktionsleiste lange gedrückt halten, bis sich die Schaltfläche ''von Favoriten entfernen'' öffnet und diese bestätigen.

=== [[Datei:Mapview.png|50px]] Lesezeichen ===
Sie können eine bestimmte Position auf der Karte als Lesezeichen speichern und wieder aufrufen. Mit einem Doppelklick auf das Symbol speichern Sie die aktuelle Position in der Karte. Mit einem einfachen Klick rufen Sie die Definition ab, d.h. die Kartenansicht springt zur gespeicherten Ansicht.

=== [[Datei:Auskunft Suche.png|50px]] Freitextsuche ===
Die Freitextsuche können Objekte durchsucht werden. ''Die Suche in bestimmten Ebenen muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Gps deaktiviert.png|50px]] GPS ===
Um die eigene Position in der Karte anzeigen zu lassen, muss GPS aktiviert sein. Ist GPS eingeschaltet, wechselt der Button zu einem weißen Pin. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Nutzerposition.png|50px]] zur Position zoomen ===
Falls Sie GPS aktiviert haben und Ihre Position nicht finden können, ist es möglich, mithilfe dieser Funktion die aktuelle Position in der Karte anzeigen zu lassen. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''
[[Datei:MobileApp-Messen.gif|400px|mini|Anwendung der Messen-Funktion (zum Abspielen des Videos bitte klicken)]]
=== [[Datei:Messen-button.png|50px]] Messen ===
Mit einem Klick auf diesen Button öffnet sich die Funktion des Messens in Form eines Fadenkreuzes und drei Werkzeug Buttons. Mit dem Fadenkreuz wird die Position des Ankerpunktes auf der Karte festgelegt. Der Knoten+ Button bestätigt die aktuelle Position und lässt einen weiteren Knotenpunkt hinzufügen. Mit dem Speichern Button wird die Messung gespeichert und beendet. Um ohne Speichern zu beenden, einfach auf das große X klicken. Die gespeicherte Messung bleibt auf der Karte für die Sitzung bestehen. Möchten Sie die Messung wieder löschen, betätigen Sie den Button ''Messungen löschen''.

=== [[Datei:Backup.png|50px]] Backup DB ===
Die lokale Datenbank kann mit Hilfe dieser Funktion in einer lokalen Sicherungsdatei abgelegt werden. Bei erfolgreichem Backup erscheint ein Dialog mit dem Pfad zur ZIP-Datei.

=== [[Datei:DB Schema Update.png|50px]] Update DB-Schema ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Die lokalen Tabellen werden gemäß dem Datenbankaufbau des Servers erstellt / angepasst. Dabei kann es zu Löschungen der lokalen Tabellen kommen. Ein Dialog öffnet sich, der bestätigt werden muss.
[[Datei:Sync-dialog.png|400px|mini|Synchronisierungsdialog zum Auswählen der Daten]]
=== [[File:sync.png|50px]] Offlinefähigkeit ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Sie können damit die Daten auf ihrem Tablet mit denen auf dem Server synchronisieren. Dazu öffnet sich ein Dialog, über den Sie die gewünschten Daten auswählen können. Je nach Ihren Fachanwendungen sind diese aufgelistet.

== Fachspezifische Funktionen ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| Baum hinzufügen, Baumbestand Suche, Baum-Geometrie bearbeiten|| [[MobileAppBaum#Funktionen | mobileApp Baum Funktionen]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || Grünfläche hinzufügen, Grünbestand-Suche, Grünflächen-Geometrie bearbeiten || [[MobileAppGruen#Funktionen | mobileApp Grün Funktionen]]
|}

= Datenmaske =
In der mobileApp ist eine der Grundfunktionen das Anlegen von Befunden zu einem Objekt der Fachanwendung. Je nach Fachanwendung kann sich die Eingabemaske und möglichen Inhalten unterscheiden. In diesem Abschnitt wird der allgemeine Aufbau einer solchen Eingabemaske erklärt.

Beim Anlegen eines neuen Objektes öffnet sich nach dem Speichern der Geometrie die Befund-Eingabemaske automatisch, um Sachdaten zum Objekt anzugeben (wie das funktioniert, wird in der fachspezifischen Dokumentation erklärt). Um einen Befund für ein existierendes Objekt anzulegen, wählt man ein Objekt mithilfe des Info-Buttons [[Datei:Info-button.png|30px]] aus. Daraufhin öffnet sich die Eingabemaske zum Objekt.

Änderungen lassen sich durch den Speicher-Button [[Datei:Speichern-mobileApp.png|30px]] oben links bestätigen oder durch den Schließen-Button [[Datei:Schliessen-mobileApp.png|30px]] oben rechts abbrechen.

[[Datei:Grunddaten-gruen.png|mini|Grunddatenmaske am Beispiel Grünfläche]]
=== Grunddaten ===
'''Hinweis''': Je nach Fachanwendung kann dieser Reiter eine andere Bezeichnung haben, tritt allerdings immer als erster Reiter auf.

Bereits vorliegende Daten werden im Reiter '''Grunddaten''' entsprechend angezeigt und es besteht die Möglichkeit diese zu aktualisieren oder zu ergänzen. Felder, die grau hinterlegt sind, lassen sich nicht bearbeiten. Folgende Eingabefelder können auftreten:
* Text-Eingabefelder
* Dropdown-Auswahlliste bei einer kleinen Menge an Auswahlmöglichkeiten
* Alphabet-Auswahlliste bei vielen Auswahlmöglichkeiten
* Umschalt-Buttons (toggle) die durch eine grüne Unterstreichung aktiviert oder durch eine Ausgrauung deaktiviert werden

[[Datei:Massnahmen-baum.png|mini|Maßnahmenmaske am Beispiel Baum]]
=== Maßnahmen & Befunde ===
Der Maßnahmen-Reiter werden notwendige Tätgkeiten am Objekt und bereits aufgenommene Maßnahmen aufgelistet. Im Reiter '''Befunddaten''' werden Schäden und Auffälligkeiten am Objekt dokumentiert. Die Funktionsweise ist für beide Reiter gleich.

Wenn Sie im jeweiligen Reiter Daten hinzufügen möchten, können Sie diese über den Dialog nach Klicken des '''Hinzufügen'''-Buttons auswählen.
* Links: Die Kategorien, in die die Maßnahmen/Befunde unterteilt sind.
* Rechts: Die Maßnahmen/Befunde, die zu einer Kategorie zugeordnet sind.

Die getroffene Auswahl wird dabei grün hinterlegt.

'''Hinweis:''' Je nach Fachanwendung unterscheiden sich natürlich die Auswahlmöglichkeiten der Maßnahmen. Die Kategorien und die Zuordnung zu den einzelnen Maßnahmen sind frei definierbar und kann im GMSC-K individualisiert werden.

Nach dem Bestätigen werden diese der Liste hinzugefügt und lassen sich für weitere Informationen bearbeiten; zu erkennen an der schwarzen Umrandung. Dabei ist darauf zu achten:
# Der erste Klick ist, um den Datensatz zu markieren.
# Der zweite Klick, um die Eingabe in das gewünschte Feld zu aktivieren.

=== Dokumente ===
Der Reiter Dokumente gibt eine Übersicht aller angehängten Dateien zum Objekt. Oftmals handelt es sich dabei um ein Foto. Die Datei wird in der für das Dateiformat entsprechenden App geöffnet, wenn Sie auf den Eintrag klicken.

==== Foto anhängen ====
Möchten Sie einem Befund ein Foto anhängen, öffnen Sie dafür die Kamera-App Ihres Tablets. Dabei verlassen Sie die mobileApp. Sobald Sie ein Foto geschossen haben, wechseln Sie wieder zurück zur mobileApp. In der Übersicht ist ein neuer Eintrag mit dem aktuellen Erstelldatum aufgelistet, ohne dass Sie noch weitere Schritte vornehmen müssen. Speichern Sie Ihre Änderungen.

== Fachspezifische Reiter ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| '''Anmerkung''': Ein freies Textfeld für zusätzliche Informationen, die den Baum betreffen. || [[MobileAppBaum#Datenmaske | mobileApp Baum Befunde]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || '''Pflanzen''': Hier können die auf der Grünfläche angelegten Pflanzen ergänzt oder überprüft werden.|| [[MobileAppGruen#Datenmaske| mobileApp Grün Befunde]]
|}

= Konfiguration =

Für die Konfiguration sind zwei lokale Dateien auf dem Tablet relevant:
* '''mobile.json''': Angaben zur Verbindung zum Server 
* '''[Applikation].json''' (z.B. baum.json): Angaben zu Arbeitssitzung, Suchmaske, Auswahllisten. Wird pro Applikation definiert 

== Allgemeine Verbindungseinstellungen ==
Eine Einführung zu dem Datumsform JSON finden Sie im [https://wiki.selfhtml.org/wiki/JSON JSON - SELFHTML-Wiki].

Konfiguration in der Datei „mobile.json“:

{| class="wikitable"
|-
! Parameter !! Typ!! Beschreibung
|-
| "serverURL" || Text|| Verbindungsdaten des GMSCK Servers
|-
| "codebase"|| Text|| Verbindungsdaten für die Kartenkomponente GMSC
|-
| "virtualSite" || Text||
|-
| "workspace" || Text|| Die zu öffnende Arbeitsmappe von GMSC-K
|-
| "login" || Text|| Voreinstellung für das Login des Nutzers
|-
| "picturePath" || Text|| Der Dateipfad, unter welchem die Kamera-App die aufgenommenen Bilder speichert
|-
| "gpsMode" || Text|| Der Modus für GPS
|-
| "gpsComPort" || Text|| Der virtuelle COM-Port an welchem die NMEA-Daten des GPS Sensors ausgelesen werden können.
|-
| "gpsRefreshRate" || Integer|| Die Zeitspanne, in der die GPS-Daten in der Kartenkomponente aktualisiert werden (in Sekunden)
|-
| "offlineWorkspacePath"|| Beispiel || Der Dateipfad, unter welchem die Sitzungsdaten der mobileApp gespeichert werden.
|-
| "tabletMode" || Boolean|| Aktivierung des Tabletmodus oder Desktopmodus
|-
| "styles" || Text|| Zusätzliche Stylesheets für die mobileApp, z.B. für spezielle Bildschirmauflösungen.
|-
| Beispiel || Beispiel || Beispiel
|}

==Arbeitssitzungen==

Jede mobile Fachanwendung kann mehrere Arbeitssitzungen angeben, die in der mobileApp verfügbar sein sollen. Die Arbeitssitzungen werden wie gewohnt innerhalb von GMSC-K eingerichtet.
Dabei ist zu beachten, dass die Arbeitssitzungen für den mobilen Nutzer über die Nutzer-/Rechteverwaltung freigegeben sind.

{
"bookmarks" : ["Luftbild", "Grundkarte"]
}

==Filterkonfigurationen für Sachdaten==

Viele Sichten in GMSC-K verwenden einen Sichtenfilter.
Um sicherzustellen, dass in der mobileApp die Anzahl der Datensätze in der Karte mit der Anzahl der Sachdaten übereinstimmt, müssen die Sachdaten über einen Filter eingeschränkt werden.
Dies wird mit Hilfe von SQL-Filtern umgesetzt. Dabei muss der SQL-Filter dem Sichtenfilter in GMSC-K entsprechen.
Weiterhin können komplexe Stammdaten wie z.B. Adressen oder Straßen mit SQL-Filtern für die mobileApp auf die notwendige Anzahl eingeschränkt werden.

"filter" : {
"filterBaum" : "(baum.FAELLUNG <> 1 OR baum.FAELLUNG IS NULL)",
"filterStrasse" : "this_.STRASSESCHLUESSELG IS NOT NULL"
}

= Datenübertragung an Server =
[[File:MAP_Baum_synch.jpg|400px|mini|Dialog bei Änderungen am Offline-Datenbestand am Beispiel Baum]]
[[File:MAP_Baum_synch_erfolgreich.jpg|300px|mini]]
# Mobile App schließen
# Das Tablet an die Dockingstation anschließen. Achten Sie darauf, dass die Dockingstation am Netz angeschlossen ist.
# Mobile App starten.
# Eine Arbeitssitzung auswählen.
# Sind Änderungen am Offline-Datenbestand festgestellt wurden, dann erhalten Sie eine entsprechende Abfrage, ob Sie die Änderungen auf dem Server übertragen möchten. Mit OK starten Sie die Übertragung.
# Wenn die Übertragung fertig ist, dann erhalten Sie eine entsprechende Meldung, dass die Übertragung abgeschlossen ist.
# Mobile App schließen.
# Tablet aus der Dockingstation entfernen.
==== Erläuterung ====
Die Datenübertragung findet intern in zwei Schritten statt.
* die geänderten Daten auf dem Tablet werden auf den GMSC-K zentralen Server übertragen.
* der gesamte und durch den Schritt 1 aktualisierte Datenbestand wird dann komplett auf dem Tablett übertragen.

MobileAppBasis

2020-02-19T09:31:10Z

Rreiss:

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; float:right; width=30px ;
border:1px solid #cccccc; background-color:#CAE1FF;
padding: 0.5em;">
[[File:KTGIS_Stempel.png|200px]] 
 
'''Erforderliche Lizenzen''' 
zur mobileApp '''Basis''' 
* GMSC-K Basis-Lizenzen
* GMSC mobileApp Basis
</div>
[[Datei:MobileApp Basis.png|500px]]

= Voraussetzungen=

Die mobilen Applikationen dienen der Kontrolle und Erfassung von ausgewählten Daten im Offlinemodus auf einem robusten, für den Außendienst tauglichen Tablet. 

Voraussetzung der mobilen Applikationen sind drei Bestandteile: 
* GMSC-K Basis Software
* GMSC-K Fachanwendung
* Geeignete Hardware – wie DELL oder Getac Tablets
Software-Bestandteile der mobilen Applikationen:
* GMSC mobileApp Basis
* GMSC mobileApp [Anwendung]

= Definitionen =

* '''GMSC-K''': das Basisprogramm für den Server
* '''GMSC-K Fachanwendung oder nur Fachanwendung''': die Fachanwendung auf dem Server
* '''Applikation''': die Applikation zur Bearbeitung eines Fachthemas auf der mobilen Lösung. Die Applikation ist meist mit einer bestimmten Fachanwendung assoziiert.
* '''Tablet''': das Hardwaregerät für den Außendienst.
* '''Online Modus''': die mobile Applikation hat Zugang zum zentralen GMSC-K Server. Relevant für Datenübertragung durch mobile Daten oder einen WLAN-Zugang
* '''Offline Modus''': die mobile Applikation hat keinen Zugang zum zentralen GMSC-K Server. Relevant für Datenänderung und Erfassung

= Programmstart =

[[File:MAP_1_anmelden.jpg|300px|mini|Startbildschirm mit Login]] 
# Doppelklick auf dem eingerichteten Icon auf dem Desktop.
# Anmeldefenster mit Nutzername und Kennwort wird geladen.
# Nutzername und Kennwort eintragen und mit Anmelden bestätigen.

[[File:MAP_3_arbeitsitzung.jpg|300px|mini|Arbeitssitzungen nach Login]] 

Nach dem Einloggen werden die Lizenzen geprüft. Im Falle fehlender Lizenzen erfolgt ein entsprechender Hinweis.

=== Arbeitssitzung ===

Die eingerichteten Arbeitssitzungen für die mobilen Apps werden als Kacheln abgebildet. Mit einem Klick auf der gewünschten Kachel laden Sie die Arbeitssitzung. Der Ladedauer hängt vom Umfang der Arbeitssitzung ab.

==== Konfiguration der Arbeitssitzungen ====
Arbeitssitzungen werden im GMSC-K definiert. Eine Arbeitssitzung wird je Applikation definiert. Diese befindet sich nach der Installation als Konfigurationsdatei lokal auf dem Tablet. Die Dateien heißen [Applikation].json, z.B. baum.json. In die Zeile „bookmarks“: [„Bezeichnung der Arbeitssitzung in GMSC-K“] tragen Sie die Bezeichnung der Arbeitssitzung aus GMSC-K ein. 

= Arbeitsfenster-Aufbau =
[[Datei:Arbeitsfenster.jpg|500px|mini|Aufbau des Arbeitsfensters]]

=== Rechts ===
Funktionen zum Zoomen und Sachdatenabfrage

* [[Datei:Plus.png|30px]] und [[Datei:Minus.png|30px]] ermöglichen das rein- und rauszoomen der Karte.
* [[Datei:Info-button.png|30px]]: Für die Sachdatenanfrage aus der Karte. Nachdem Sie das Symbol geklickt haben, müssen Sie das gewünschte Objekt in der Karte anklicken. Vorausgesetzt, es sind Sachdaten für die Anzeige auf der mobilen App freigegeben, erhalten Sie eine entsprechende Sachdatenmaske. Andernfalls erhalten Sie die Anzeige „kein Datensatz“.

=== Unten ===
Infoleiste für die Koordinaten des Kartenmittelpunkts und Maßstab des momentanen Kartenausschnitt

=== Oben ===
'''Hinweis:''' erscheint nur, wenn man am oberen Rand tippt. Hier sind Funktionen zum Minimieren, Fenstermodus / Vollbildmodus und Schließen des Fensters
[[File:MAP_9_leiste_oben.jpg|500px]] 

=== Links ===
Die Funktionsleiste ist eine vertikale Leiste, die mehrere Funktionen & Favoriten beinhaltet (siehe folgenden Abschnitt).

= Funktionsleiste & Standardfunktionen =
[[File:MAP_5_Sichten.jpg|200px|mini|Sichtenanzeige-Sidebar]]
Standardmäßig sind die Funktionen ''Sichtenanzeige'' und ''Konfiguration''. Weitere Schaltflächen können als Favoriten hinzugefügt werden, siehe unten.

===[[File:MAP_legende.PNG|50px]] Sichtenanzeige ===
Die Sichtenanzeige listet Arbeitssitzungen und deren enthaltenen Sichten auf. Die in der Karte vorhandenen Sichten werden einschließlich ihrer Symbolik bzw. Farbe angezeigt. Mit einem Klick auf die Arbeitssitzung können Sie den gesamten Inhalt der Arbeitssitzung in die Karte laden oder ausblenden. Ausgeblendete Sichten werden mit einem roten Statusbalken markiert.

Mit einem Klick auf das Symbol <big>'''>'''</big> (Rechts von der Bezeichnung der Arbeitssitzung) gelangen Sie zu der Liste der enthaltenen Sichten. Mit einem Klick auf die Bezeichnung der Sicht können Sie einzelne Sichten innerhalb der Arbeitssitzung in die Karte laden oder ausblenden.

[[Datei:Kacheln.png|mini|Übersicht der Funktionen]]
===[[Datei:Ktgis.png|50px]] Funktionsübersicht ===
Mit diesem Button gelangen Sie zu der Übersicht der freigeschalteten Apps und Funktionen. Die Funktionen werden nach der Zugehörigkeit zu einer App sortiert. Allgemeine Funktionen werden unter der Überschrift Standard abgebildet.

Mit einem langen Klick auf eine Kachel erscheint eine Schaltfläche zum Hinzfügen eines Favoriten. Nachdem man diese bestätigt hat, erscheint die Funktion auf der Funktionsleiste. Um sie wieder zu entfernen, einfach in der Funktionsleiste lange gedrückt halten, bis sich die Schaltfläche ''von Favoriten entfernen'' öffnet und diese bestätigen.

=== [[Datei:Mapview.png|50px]] Lesezeichen ===
Sie können eine bestimmte Position auf der Karte als Lesezeichen speichern und wieder aufrufen. Mit einem Doppelklick auf das Symbol speichern Sie die aktuelle Position in der Karte. Mit einem einfachen Klick rufen Sie die Definition ab, d.h. die Kartenansicht springt zur gespeicherten Ansicht.

=== [[Datei:Auskunft Suche.png|50px]] Freitextsuche ===
Die Freitextsuche können Objekte durchsucht werden. ''Die Suche in bestimmten Ebenen muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Gps deaktiviert.png|50px]] GPS ===
Um die eigene Position in der Karte anzeigen zu lassen, muss GPS aktiviert sein. Ist GPS eingeschaltet, wechselt der Button zu einem weißen Pin. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''

=== [[Datei:Nutzerposition.png|50px]] zur Position zoomen ===
Falls Sie GPS aktiviert haben und Ihre Position nicht finden können, ist es möglich, mithilfe dieser Funktion die aktuelle Position in der Karte anzeigen zu lassen. ''Die GPS Kompatibilität muss seitens der Administration oder im Rahmen der Einrichtung und Customizing definiert werden.''
[[Datei:MobileApp-Messen.gif|400px|mini|Anwendung der Messen-Funktion (zum Abspielen des Videos bitte klicken)]]
=== [[Datei:Messen-button.png|50px]] Messen ===
Mit einem Klick auf diesen Button öffnet sich die Funktion des Messens in Form eines Fadenkreuzes und drei Werkzeug Buttons. Mit dem Fadenkreuz wird die Position des Ankerpunktes auf der Karte festgelegt. Der Knoten+ Button bestätigt die aktuelle Position und lässt einen weiteren Knotenpunkt hinzufügen. Mit dem Speichern Button wird die Messung gespeichert und beendet. Um ohne Speichern zu beenden, einfach auf das große X klicken. Die gespeicherte Messung bleibt auf der Karte für die Sitzung bestehen. Möchten Sie die Messung wieder löschen, betätigen Sie den Button ''Messungen löschen''.

=== [[Datei:Backup.png|50px]] Backup DB ===
Die lokale Datenbank kann mit Hilfe dieser Funktion in einer lokalen Sicherungsdatei abgelegt werden. Bei erfolgreichem Backup erscheint ein Dialog mit dem Pfad zur ZIP-Datei.

=== [[Datei:DB Schema Update.png|50px]] Update DB-Schema ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Die lokalen Tabellen werden gemäß dem Datenbankaufbau des Servers erstellt / angepasst. Dabei kann es zu Löschungen der lokalen Tabellen kommen. Ein Dialog öffnet sich, der bestätigt werden muss.
[[Datei:Sync-dialog.png|400px|mini|Synchronisierungsdialog zum Auswählen der Daten]]
=== [[File:sync.png|50px]] Offlinefähigkeit ===
Diese Funktion ist nur verfügbar, wenn man online ist, d.h. mit dem Server verbunden ist. Sie können damit die Daten auf ihrem Tablet mit denen auf dem Server synchronisieren. Dazu öffnet sich ein Dialog, über den Sie die gewünschten Daten auswählen können. Je nach Ihren Fachanwendungen sind diese aufgelistet.

== Fachspezifische Funktionen ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| Baum hinzufügen, Baumbestand Suche, Baum-Geometrie bearbeiten|| [[MobileAppBaum#Funktionen | mobileApp Baum Funktionen]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || Grünfläche hinzufügen, Grünbestand-Suche, Grünflächen-Geometrie bearbeiten || [[MobileAppGruen#Funktionen | mobileApp Grün Funktionen]]
|}

= Datenmaske =
In der mobileApp ist eine der Grundfunktionen das Anlegen von Befunden zu einem Objekt der Fachanwendung. Je nach Fachanwendung kann sich die Eingabemaske und möglichen Inhalten unterscheiden. In diesem Abschnitt wird der allgemeine Aufbau einer solchen Eingabemaske erklärt.

Beim Anlegen eines neuen Objektes öffnet sich nach dem Speichern der Geometrie die Befund-Eingabemaske automatisch, um Sachdaten zum Objekt anzugeben (wie das funktioniert, wird in der fachspezifischen Dokumentation erklärt). Um einen Befund für ein existierendes Objekt anzulegen, wählt man ein Objekt mithilfe des Info-Buttons [[Datei:Info-button.png|30px]] aus. Daraufhin öffnet sich die Eingabemaske zum Objekt.

Änderungen lassen sich durch den Speicher-Button [[Datei:Speichern-mobileApp.png|30px]] oben links bestätigen oder durch den Schließen-Button [[Datei:Schliessen-mobileApp.png|30px]] oben rechts abbrechen.

[[Datei:Grunddaten-gruen.png|mini|Grunddatenmaske am Beispiel Grünfläche]]
=== Grunddaten ===
'''Hinweis''': Je nach Fachanwendung kann dieser Reiter eine andere Bezeichnung haben, tritt allerdings immer als erster Reiter auf.

Bereits vorliegende Daten werden im Reiter '''Grunddaten''' entsprechend angezeigt und es besteht die Möglichkeit diese zu aktualisieren oder zu ergänzen. Felder, die grau hinterlegt sind, lassen sich nicht bearbeiten. Folgende Eingabefelder können auftreten:
* Text-Eingabefelder
* Dropdown-Auswahlliste bei einer kleinen Menge an Auswahlmöglichkeiten
* Alphabet-Auswahlliste bei vielen Auswahlmöglichkeiten
* Umschalt-Buttons (toggle) die durch eine grüne Unterstreichung aktiviert oder durch eine Ausgrauung deaktiviert werden

[[Datei:Massnahmen-baum.png|mini|Maßnahmenmaske am Beispiel Baum]]
=== Maßnahmen & Befunde ===
Der Maßnahmen-Reiter werden notwendige Tätgkeiten am Objekt und bereits aufgenommene Maßnahmen aufgelistet. Im Reiter '''Befunddaten''' werden Schäden und Auffälligkeiten am Objekt dokumentiert. Die Funktionsweise ist für beide Reiter gleich.

Wenn Sie im jeweiligen Reiter Daten hinzufügen möchten, können Sie diese über den Dialog nach Klicken des '''Hinzufügen'''-Buttons auswählen.
* Links: Die Kategorien, in die die Maßnahmen/Befunde unterteilt sind.
* Rechts: Die Maßnahmen/Befunde, die zu einer Kategorie zugeordnet sind.

Die getroffene Auswahl wird dabei grün hinterlegt.

'''Hinweis:''' Je nach Fachanwendung unterscheiden sich natürlich die Auswahlmöglichkeiten der Maßnahmen. Die Kategorien und die Zuordnung zu den einzelnen Maßnahmen sind frei definierbar und kann im GMSC-K individualisiert werden.

Nach dem Bestätigen werden diese der Liste hinzugefügt und lassen sich für weitere Informationen bearbeiten; zu erkennen an der schwarzen Umrandung. Dabei ist darauf zu achten:
# Der erste Klick ist, um den Datensatz zu markieren.
# Der zweite Klick, um die Eingabe in das gewünschte Feld zu aktivieren.

=== Dokumente ===
Der Reiter Dokumente gibt eine Übersicht aller angehängten Dateien zum Objekt. Oftmals handelt es sich dabei um ein Foto. Die Datei wird in der für das Dateiformat entsprechenden App geöffnet, wenn Sie auf den Eintrag klicken.

==== Foto anhängen ====
Möchten Sie einem Befund ein Foto anhängen, öffnen Sie dafür die Kamera-App Ihres Tablets. Dabei verlassen Sie die mobileApp. Sobald Sie ein Foto geschossen haben, wechseln Sie wieder zurück zur mobileApp. In der Übersicht ist ein neuer Eintrag mit dem aktuellen Erstelldatum aufgelistet, ohne dass Sie noch weitere Schritte vornehmen müssen. Speichern Sie Ihre Änderungen.

== Fachspezifische Reiter ==
{| class="wikitable"
|-
! Fachanwendung !! Beschreibung !! weiterführende Dokumentation
|-
|[[Datei:Baum.png|40px|ohne]] Baum|| '''Anmerkung''': Ein freies Textfeld für zusätzliche Informationen, die den Baum betreffen. || [[MobileAppBaum#Datenmaske | mobileApp Baum Befunde]]
|-
| [[Datei:Gruen.png|40px|ohne]] Grün || '''Pflanzen''': Hier können die auf der Grünfläche angelegten Pflanzen ergänzt oder überprüft werden.|| [[MobileAppGruen#Datenmaske| mobileApp Grün Befunde]]
|}

= Konfiguration =

Für die Konfiguration sind zwei lokale Dateien auf dem Tablet relevant:
* '''mobile.json''': Angaben zur Verbindung zum Server 
* '''[Applikation].json''' (z.B. baum.json): Angaben zu Arbeitssitzung, Suchmaske, Auswahllisten. Wird pro Applikation definiert 

== Allgemeine Verbindungseinstellungen ==
Konfiguration in der Datei „mobile.json“:

{| class="wikitable"
|-
! Parameter !! Typ!! Beschreibung
|-
| "serverURL" || Text|| Verbindungsdaten des GMSCK Servers
|-
| "codebase"|| Text|| Verbindungsdaten für die Kartenkomponente GMSC
|-
| "virtualSite" || Text||
|-
| "workspace" || Text|| Die zu öffnende Arbeitsmappe von GMSC-K
|-
| "login" || Text|| Voreinstellung für das Login des Nutzers
|-
| "picturePath" || Text|| Der Dateipfad, unter welchem die Kamera-App die aufgenommenen Bilder speichert
|-
| "gpsMode" || Text|| Der Modus für GPS
|-
| "gpsComPort" || Text|| Der virtuelle COM-Port an welchem die NMEA-Daten des GPS Sensors ausgelesen werden können.
|-
| "gpsRefreshRate" || Integer|| Die Zeitspanne, in der die GPS-Daten in der Kartenkomponente aktualisiert werden (in Sekunden)
|-
| "offlineWorkspacePath"|| Beispiel || Der Dateipfad, unter welchem die Sitzungsdaten der mobileApp gespeichert werden.
|-
| "tabletMode" || Boolean|| Aktivierung des Tabletmodus oder Desktopmodus
|-
| "styles" || Text|| Zusätzliche Stylesheets für die mobileApp, z.B. für spezielle Bildschirmauflösungen.
|-
| Beispiel || Beispiel || Beispiel
|}

==Arbeitssitzungen==

Jede mobile Fachanwendung kann mehrere Arbeitssitzungen angeben, die in der mobileApp verfügbar sein sollen. Die Arbeitssitzungen werden wie gewohnt innerhalb von GMSC-K eingerichtet.
Dabei ist zu beachten, dass die Arbeitssitzungen für den mobilen Nutzer über die Nutzer-/Rechteverwaltung freigegeben sind.

{
"bookmarks" : ["Luftbild", "Grundkarte"]
}

==Filterkonfigurationen für Sachdaten==

Viele Sichten in GMSC-K verwenden einen Sichtenfilter.
Um sicherzustellen, dass in der mobileApp die Anzahl der Datensätze in der Karte mit der Anzahl der Sachdaten übereinstimmt, müssen die Sachdaten über einen Filter eingeschränkt werden.
Dies wird mit Hilfe von SQL-Filtern umgesetzt. Dabei muss der SQL-Filter dem Sichtenfilter in GMSC-K entsprechen.
Weiterhin können komplexe Stammdaten wie z.B. Adressen oder Straßen mit SQL-Filtern für die mobileApp auf die notwendige Anzahl eingeschränkt werden.

"filter" : {
"filterBaum" : "(baum.FAELLUNG <> 1 OR baum.FAELLUNG IS NULL)",
"filterStrasse" : "this_.STRASSESCHLUESSELG IS NOT NULL"
}

= Datenübertragung an Server =
[[File:MAP_Baum_synch.jpg|400px|mini|Dialog bei Änderungen am Offline-Datenbestand am Beispiel Baum]]
[[File:MAP_Baum_synch_erfolgreich.jpg|300px|mini]]
# Mobile App schließen
# Das Tablet an die Dockingstation anschließen. Achten Sie darauf, dass die Dockingstation am Netz angeschlossen ist.
# Mobile App starten.
# Eine Arbeitssitzung auswählen.
# Sind Änderungen am Offline-Datenbestand festgestellt wurden, dann erhalten Sie eine entsprechende Abfrage, ob Sie die Änderungen auf dem Server übertragen möchten. Mit OK starten Sie die Übertragung.
# Wenn die Übertragung fertig ist, dann erhalten Sie eine entsprechende Meldung, dass die Übertragung abgeschlossen ist.
# Mobile App schließen.
# Tablet aus der Dockingstation entfernen.
==== Erläuterung ====
Die Datenübertragung findet intern in zwei Schritten statt.
* die geänderten Daten auf dem Tablet werden auf den GMSC-K zentralen Server übertragen.
* der gesamte und durch den Schritt 1 aktualisierte Datenbestand wird dann komplett auf dem Tablett übertragen.

StadtAnalyst

2017-11-13T14:07:18Z

Rreiss: /* Arbeitsschritte */

Achtung! Diese Seite befindet sich noch in Bearbeitung!

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; float:right; width=30px ;
border:1px solid #cccccc; background-color:#CAE1FF;
padding: 0.5em;">
[[File:KTGIS_Stempel.png|200px]] 
 
'''Erforderliche Lizenzen''' 
zur Fachanwendung '''Sta(d)tAnalyst''' 
* GMSC-K Basis-Fachklassen (Basis-Lizenz)
* GMSC-K Basis-Stammdaten (Basis-Lizenz)
* GMSC-K Stadtanalyst
</div>

== Vorwort ==
Die Fachanwendung GMSC-K Sta(d)tAnalyst wird inhaltlich durch die Firma [http://ktgis.de/ Kompetenzteam GIS] betreut 
 

== Ziel ==
GMSC-K – Sta(d)tAnalyst erlaubt die umfassende Erfassung aller erforderlichen Daten zu Kommunalverwaltung und ermöglicht dadurch das Monitoring. 
 
Statistische Abfragen und Auswertungen zu den unterschiedlichsten kommunalen Daten, Wohnungsstand oder Bevölkerung können gebietsbezogen durchgeführt werden. 

== Ausgewählte Symbole der Programmoberfläche ==
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[[Benutzeroberfläche]]
</div>
 

== Aufbau ==

 
Der Aufbau der zentralen Fachanwendungen (Basis-Fachklassen, Basis-Stammdaten) ist für alle Applikationen einheitlich. In diesem Beitrag wird nur auf die spezifische Fachanwendung und Objektklassen der Fachanwendung Sta(d)tAnalyst eingegangen. 
Die Fachanwendung Sta(d)tAnalyst beinhaltet unter anderem folgende Objektklassen: 
* Adressstatistikdaten
* Gebietsstatistikdaten
* Gebietswanderungen
* Kindereinrichtungen
* Medizinische Einrichtungen
* Prognosen
* Prozesssteuerung
* Schulen
* Wanderungsbewegungen
* u.a.
 
Für eine Reihe von Sachgruppen, z.B. Adressstatistik, Gebietsstatistik u.a. gibt es Objektklassen mit dem Zusatz "historisch". Hier werden die Daten aus früheren Erhebungen archiviert. 
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Für eine weitere detaillierte Beschreibung der Grundfunktionen nutzen Sie bitte die Online-Beschreibung unter: 
[[Fachanwendungskonzept]]
</div>
 
 

== Arbeitsschritte ==

{| class="wikitable" border="1"
|-
! Übersicht und Reihenfolge der Arbeitsschritte:
|-
| Anlegen der Projektstruktur (Einmalig)

|-
| Datenübernahme / Migration von Altdaten (Einmalig)

|-
| Anlegen bzw. Anpassen von Gebieten
|-
| Zuweisung von Adressen zu Gebieten
|-
| Historisieren des Datenbestandes (Funktion Jahresabschluss)
|-
| Einlesen der EWO-Daten aus CSV-Datei
|-
| Einlesen der Daten zu Wanderungsbewegungen aus CSV-Datei
|-
| Daten-Aggregierung
|-
| Erstellen von Auswertungen (Indikatoren etc.)
|}

=== Einmalig auszuführende Arbeitsschritte ===
==== Anlegen der Projektstruktur ====
* Einlesen der Explorer-Struktur und der Maskenkonfigurationen über ein XPMF-File

==== Datenübernahme / Migration von Altdaten ====
Bereits vorhandene (Alt-)Daten können in verschiedenen Formaten vorliegen und müssen in das Format CSV überführt werden. 
Zu diesem Arbeitsschritt nehmen Sie bitte gern Kontakt zu uns auf. Zu Projektbeginn können - zum Beispiel im Rahmen eines Workshops - die Ausgangdaten gemeinsam analysiert und der effektivste Weg besprochen werden, diese für die Verwendung in GMSC-K nutzbar zu machen. 

=== Routinemäßig auszuführende Arbeitsschritte ===

'''HINWEIS:''' Die speziellen Funktionalitäten der Fachanwendung "Sta(d)tAnalyst" werden jeweils im Kopf der zugehörigen Tabellen über die Schaltflächen [[File:KS_schaltflaeche01.JPG|40px]] bzw. [[File:KS_schaltflaeche02.JPG|40px]] aufgerufen. 

==== Anlegen von Gebieten ====
Bei Gebieten handelt es sich beispielsweise um Monitoring-Gebiete oder Sanierungsgebiete etc. 
* Sie werden in der Objektklasse "Gebiete" der Basis-Fachklassen gespeichert
* Sie werden als Flächenobjekt in der Karte digitalisiert und können bei Bedarf jederzeit bearbeitet/angepaßt werden

==== Zuweisung von Adressen zu Gebieten ====
Die Zuweisung von Adressen zu Gebieten erfolgt über eine Räumliche Abfrage und das "Hineinziehen" des Abfrageergebnisses in die Untertabelle "Zugeordnete Fachobjekte" in der Datenmaske "Gebiet": 

[[File:KS_adress01.JPG|500px]] 

 

==== Jahresabschluss ====

Bevor aktuelle Daten zur Einwohnern und Wanderungsbewegungen eingelesen werden, wird in der Regel ein '''Jahresabschluss''' durchgeführt. 
Dabei werden die derzeit aktuellen Daten aus folgenden Sachgruppen historisiert, d.h. die Datensätze werden jeweils in eine "Tabelle-historisch" kopiert:
* Adressstatistik --> Adressstatistikdaten (historisch)
* Gebietsstatistik --> Gebietsstatistik (historisch)
* Wanderungsbewegungen --> Gebietswanderungen (historisch), Umzüge aus anderen Gebieten (historisch)
* Prognosen --> Prognosen (historisch)
* Prozesssteuerung --> Prozesssteuerung (historisch)
 
'''Schritt 1 - Jahresabschluss in Tabelle "Adressen"''': 

[[File:KS_jahrab01.JPG|200px]] 

Die gewünschten Datensätze müssen markiert sein! 
Mit dem Start der Funktion erfolgt die Aufforderung, ein Bezugsjahr einzugeben: 

[[File:KS_jahrab04.JPG|250px]] 

Im Ergebnis werden für alle ausgewählten Adressen die aktuellen Adressstatistiken in die Tabelle Adressstatistikdaten (historisch) überführt (kopiert). 
'''Anschließend (!)''' wird das gewählte Bezugsjahr in den Datensatz in der Tabelle "Adressstatistik" eingetragen: 

[[File:KS_jahrab05a.JPG|500px]] 

'''Schritt 2 - Jahresabschluß in Tabelle "Gebiete"''': 
[[File:KS_jahrab02.JPG|200px]] 
Die gewünschten Datensätze müssen markiert sein! 
Analog zum "Jahresabschluss Adressen" erfolgt die Aufforderung, ein Bezugsjahr anzugeben. 

Im Ergebnis werden für alle ausgewählten Gebiete die aktuellen Statistiken in die Tabellen
* Gebietsstatistik (historisch)
* Gebietswanderungen (historisch)
* Umzüge aus anderen Gebieten (historisch)
* Prognosen (historisch)
* Prozesssteuerung (historisch)

überführt (kopiert). 

==== Einlesen der EWO-Daten aus CSV-Datei ====

In einem ersten Schritt ist der Inhalt der Tabelle "Einwohner" zu löschen.

Die EWO-Daten werden von den Meldeämtern im CSV-Format geliefert. Es existiert kein einheitlicher bundesweiter Standard. Eine EWO-Datei kann bespielhaft wie folgt aussehen: 
[[File:KS_ewo03.JPG|600px]]
 
Beim Import der EWO-Daten erfolgt eine Verknüpfung der Einwohner mit der jeweiligen Adresse. Diese Verknüpfung geschieht über den Straßenschlüssel. 
Hierbei ist zu '''BEACHTEN''': der Straßenschlüssel bei den Meldeämtern (EWO) ist nicht zwingend identisch mit dem Straßenschlüssel der Vermessungsämter (ALKIS). Die Aggregierung der Einwohner auf die Adresse erfolgt über den '''EWO-Straßenschlüssel'''. Der Nutzer muß hier, ggf. manuell, sicherstellen, daß die Tabelle "Adressen" den richtigen EWO-Straßenschlüssel beinhaltet. 
Der Datenbestand der EWO-Datei ist nicht immer konsistent. Zum Beispiel können Schreibfehler auftreten ("m?nnlich" statt "männlich"), welche beim Import dann nicht richtig interpretiert und deshalb übersprungen werden. Weiterhin können Adressen in den EWO-Daten (Straßenschlüssel + Hausnummer) in den Adressdaten des ALKIS nicht vorhanden sein. 

Vor dem Einlesen der EWO-Daten erfolgt deshalb eine '''Validierung''': 
In der Tabelle "Einwohner" wird über die Schaltfläche "StadtAnalyst" ein '''Testdurchlauf''' für den Import gestartet: 

[[File:KS_ewo01.JPG|200px]]

 

[[File:KS_ewo04a.JPG|600px]]
 
Das Jobfenster öffnet sich, und nach beendetem Testlauf kann über "Ergebnis" die Log-Datei gespeichert werden. 
In der Log-Datei werden alle festgestellten Inkonsistenzen gelistet. Das kann beispielhaft so aussehen: 

[[File:KS_ewo05.JPG|300px]] 
Der Nutzer hat anhand der Log-Datei die Möglichkeit, die EWO-Datei zu korrigieren. Falls keine Korrektur erfolgt, werden die betroffenen Datensätze beim Import übersprungen. 
Der Testdurchlauf kann beliebig oft wiederholt werden. 

Wenn die Konsistenz der EWO-Datei hergestellt ist, erfolgt der Import der Einwohnerdaten in die Tabelle "Einwohner": 

[[File:KS_ewo02.JPG|200px]]

 
Im '''Ergebnis''' wird die Tabelle "Einwohner" gefüllt, noch nicht vorhandene Adressen werden angelegt. 

==== Einlesen der Daten zu Wanderungsbewegungen aus CSV-Datei ====
 '''HINWEIS:''' prinzipiell erfolgt das Einlesen der Wanderungsbewegungen analog zu den EWO-Daten, siehe zuvor.
 

Wanderungsbewegungen beziehen sich jeweils auf ein Gebiet. Sie beinhalten folgende Möglichkeiten:
* Zuzug in ein Gebiet
* Weggzug aus einem Gebiet
* Umzug innerhalb eines Gebietes
* Geburt
* Tod
 
Die Wanderungsdaten-Daten werden von den Meldeämtern im CSV-Format geliefert. Es existiert kein einheitlicher bundesweiter Standard. Eine Wanderungs-Datei kann bespielhaft wie folgt aussehen: 
[[File:KS_wanderung03.JPG|600px]]
 
Beim Import der Wanderungs-Daten erfolgt eine Verknüpfung des "Ereignisses" mit der jeweiligen Adresse. Diese Verknüpfung geschieht über den '''EWO-Straßenschlüssel'''. 
Wie auch die EWO-Daten können die Wanderungsdaten Inkonsistenzen aufweisen. Deshalb erfolgt auch hier eine '''Validierung''': 

In der Tabelle "Wanderungsbewegungen" wird über die Schaltfläche "StadtAnalyst" ein '''Testdurchlauf''' für den Import gestartet: 

[[File:KS_wanderung01.JPG|200px]]

 
Das Jobfenster öffnet sich, und nach beendetem Testlauf kann über "Ergebnis" die Log-Datei gespeichert werden. 
In der Log-Datei werden alle festgestellten Inkonsistenzen gelistet. Das kann beispielhaft so aussehen: 

[[File:KS_wanderung05.JPG|300px]] 
Der Nutzer hat anhand der Log-Datei die Möglichkeit, die Wanderungs-Datei zu korrigieren. Falls keine Korrektur erfolgt, werden die betroffenen Datensätze beim Import übersprungen. 
Der Testdurchlauf kann beliebig oft wiederholt werden. 

Wenn die Konsistenz der Wanderungs-Datei hergestellt ist, erfolgt der Import der Wanderungsdaten in die Tabelle "Wanderungsbewegungen": 

[[File:KS_wanderung02.JPG|200px]]

 
Im '''Ergebnis''' wird die Tabelle "Wanderungsbewegungen" gefüllt, noch nicht vorhandene Adressen werden angelegt. 

==== Daten-Aggregierung ====
Bei der Datenaggregierung werden auf der Basis der Einwohner-Daten sowie Wanderungsbewegungen Statistiken zu den Adressen und Gebieten angelegt. 
Der Aufruf der entsprechenden Scripte erfolgt über die Schaltfläche im Kopf der Tabellen "Adressstatistik" und "Gebietsstatistik", die Ausführung erfolgt nach der nummerierten Reihenfolge: 

[[File:KS_aggreg01.JPG|200px]]

 
===== Adressstatistik =====

[[File:KS_aggreg02.JPG|400px]]
 
Die Ausführung der jeweiligen Scripte wird per Klick auf den grünen Pfeil gestartet. 
Die Jahreszahl (hier beispielhaft 2016) besagt, daß sich bestimmte Parameter der Aggregierung änden können (zum Beispiel Zusammenfassung von Altersgruppen), und dieses konkrete Script hier für die Aggregierung der Daten im Jahr 2016 gültig ist. 

===== Gebietsstatistik =====

[[File:KS_aggreg03.JPG|400px]]

 
Die Ausführung der jeweiligen Scripte wird per Klick auf den grünen Pfeil gestartet. 
Die Jahreszahl (hier beispielhaft 2016) besagt, daß sich bestimmte Parameter der Aggregierung änden können (zum Beispiel Zusammenfassung von Altersgruppen), und dieses konkrete Script hier für die Aggregierung der Daten im Jahr 2016 gültig ist. 

==== Erstellen von Auswertungen (Indikatoren etc.) ====
Die Erstellung der Indikatoren erfolgt, wie in der Abbildung zuvor ersichtlich, als Punkt 4 ebenfalls über das SQL-Script-Menü der "Gebietsstatistik"
 
 
Die Indikatoren werden in der Tabelle "Indikatorenergebnisse" gespeichert.
 
 
Hinweis: Für die Bundesländer Sachsen-Anhalt und Thüringen liegen fertige Indikatorenlisten gemäß Landesmomitoring vor.
 
 

== Datenmasken ==
=== Datenmaske ===
Beispiel für die Datenmaske der Objektklasse Adressstatistik: 
[[File:KS_maske_adr01.JPG|500px]]
 
Hinweis: Datenmasken können hinsichtlich Layout und angezeigter Datenfelder individuell vom Nutzer angepasst werden. 

=== Maskenexplorer ===
Wenn ein Datensatz geöffnet wird, dann wird links oben der sog. Maskenexplorer zum Datensatz geladen. Der Maskenexplorer bildet die Seiten der Maske zum Datensatz. 
Beispiel für den Maskenexplorer der Objektklasse Adressstatistik: 
[[File:KS_maske_adr02.JPG|250px]]
 
Hinweis: Aufbau, Anzahl, Reihenfolge und Bezeichnung der Seiten kann individuell vom Nutzer angepasst werden. 

=== Datenfeldtypen ===
{| class="wikitable" border="1"
|-
! Feld
! Typ

|-
| [[File:KS_auswahlfeld.JPG|250px]]
| Auswahlliste

|-
| [[File:KS_eingabefeld.JPG|130px]]
| Eingabefeld
|-
| [[File:KS_datumsfeld.JPG|200px]]
| Datumsfeld
|-
| [[File:Untertabelle.png|300px]]
| Untertabelle
|}

== Erfassungsregeln ==
Es ist '''zwingend notwendig''', den Datensatz zu speichern, bevor Verknüpfungen zu anderen Fachobjekten, Vorgängen, Dokumenten etc. (Stichwort: Untertabellen) angelegt werden. 
Der Nutzer hat die Möglichkeit, Datensätze "leer" anzulegen und eventuell die Lage in der Karte zu erfassen, um zu einem späteren Zeitpunkt die (restlichen) Sachinformationen einzutragen. Mögliche Pflichtfelder sind in der Maske als solche gekennzeichnet. 

== Konfigurationen ==
Zur Definition müssen die entsprechenden Editoren geöffnet werden. Grundsätzlich stehen zwei Varianten zur Verfügung, um die Konfigurationseditoren zu öffnen: 
* über die Sicht im Explorer > RMT > Kontextmenü > Konfiguration >
* über die Werkzeugleiste der geöffneten Tabelle (grünes Plus-Zeichen anklicken)
 

=== Spaltenkonfiguration ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Konfigurationen#Spaltenkonfiguration_f.C3.BCr_Tabellen Spaltenkonfiguration]
</div>
 

=== Sortierkonfiguration ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Konfigurationen#Sortierkonfiguration Sortierkonfiguration]
</div>
 

=== Filterkonfiguration ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Konfigurationen#Filterkonfiguration Filterkonfiguration]
</div>
 

== Vorbereitungsarten ==
=== Relevante Auswahllisten ===
Auswahllisten und deren Auswahleinschränkungen vor der Erfassung editieren und auf die individuellen Vorgaben anpassen. Das erleichtert sowohl die Erfassung als auch die spätere Auswertung der Daten.
 
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Auswahleinschränkung im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Fachanwendungsstruktur#Auswahleinschr.C3.A4nkungen Auswahleinschränkungen]
</div>

== Ausgewählte Funktionen ==

=== Serienbrief-Funktion ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Client-Benutzeroberfl%C3%A4che#Serienbrief Serienbrief]
</div>

StadtAnalyst

2017-11-13T14:06:01Z

Rreiss: /* Jahresabschluss */

Achtung! Diese Seite befindet sich noch in Bearbeitung!

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; float:right; width=30px ;
border:1px solid #cccccc; background-color:#CAE1FF;
padding: 0.5em;">
[[File:KTGIS_Stempel.png|200px]] 
 
'''Erforderliche Lizenzen''' 
zur Fachanwendung '''Sta(d)tAnalyst''' 
* GMSC-K Basis-Fachklassen (Basis-Lizenz)
* GMSC-K Basis-Stammdaten (Basis-Lizenz)
* GMSC-K Stadtanalyst
</div>

== Vorwort ==
Die Fachanwendung GMSC-K Sta(d)tAnalyst wird inhaltlich durch die Firma [http://ktgis.de/ Kompetenzteam GIS] betreut 
 

== Ziel ==
GMSC-K – Sta(d)tAnalyst erlaubt die umfassende Erfassung aller erforderlichen Daten zu Kommunalverwaltung und ermöglicht dadurch das Monitoring. 
 
Statistische Abfragen und Auswertungen zu den unterschiedlichsten kommunalen Daten, Wohnungsstand oder Bevölkerung können gebietsbezogen durchgeführt werden. 

== Ausgewählte Symbole der Programmoberfläche ==
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[[Benutzeroberfläche]]
</div>
 

== Aufbau ==

 
Der Aufbau der zentralen Fachanwendungen (Basis-Fachklassen, Basis-Stammdaten) ist für alle Applikationen einheitlich. In diesem Beitrag wird nur auf die spezifische Fachanwendung und Objektklassen der Fachanwendung Sta(d)tAnalyst eingegangen. 
Die Fachanwendung Sta(d)tAnalyst beinhaltet unter anderem folgende Objektklassen: 
* Adressstatistikdaten
* Gebietsstatistikdaten
* Gebietswanderungen
* Kindereinrichtungen
* Medizinische Einrichtungen
* Prognosen
* Prozesssteuerung
* Schulen
* Wanderungsbewegungen
* u.a.
 
Für eine Reihe von Sachgruppen, z.B. Adressstatistik, Gebietsstatistik u.a. gibt es Objektklassen mit dem Zusatz "historisch". Hier werden die Daten aus früheren Erhebungen archiviert. 
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Für eine weitere detaillierte Beschreibung der Grundfunktionen nutzen Sie bitte die Online-Beschreibung unter: 
[[Fachanwendungskonzept]]
</div>
 
 

== Arbeitsschritte ==

{| class="wikitable" border="1"
|-
! Übersicht und Reihenfolge der Arbeitsschritte:
|-
| Anlegen der Projektstruktur (Einmalig)

|-
| Datenübernahme / Migration von Altdaten (Einmalig)

|-
| Anlegen bzw. Anpassen von Gebieten
|-
| Zuweisung von Adressen zu Gebieten
|-
| Historisieren des Datenbestandes (Funktion Jahresabschluß)
|-
| Einlesen der EWO-Daten aus CSV-Datei
|-
| Einlesen der Daten zu Wanderungsbewegungen aus CSV-Datei
|-
| Daten-Aggregierung
|-
| Erstellen von Auswertungen (Indikatoren etc.)
|}

=== Einmalig auszuführende Arbeitsschritte ===
==== Anlegen der Projektstruktur ====
* Einlesen der Explorer-Struktur und der Maskenkonfigurationen über ein XPMF-File

==== Datenübernahme / Migration von Altdaten ====
Bereits vorhandene (Alt-)Daten können in verschiedenen Formaten vorliegen und müssen in das Format CSV überführt werden. 
Zu diesem Arbeitsschritt nehmen Sie bitte gern Kontakt zu uns auf. Zu Projektbeginn können - zum Beispiel im Rahmen eines Workshops - die Ausgangdaten gemeinsam analysiert und der effektivste Weg besprochen werden, diese für die Verwendung in GMSC-K nutzbar zu machen. 

=== Routinemäßig auszuführende Arbeitsschritte ===

'''HINWEIS:''' Die speziellen Funktionalitäten der Fachanwendung "Sta(d)tAnalyst" werden jeweils im Kopf der zugehörigen Tabellen über die Schaltflächen [[File:KS_schaltflaeche01.JPG|40px]] bzw. [[File:KS_schaltflaeche02.JPG|40px]] aufgerufen. 

==== Anlegen von Gebieten ====
Bei Gebieten handelt es sich beispielsweise um Monitoring-Gebiete oder Sanierungsgebiete etc. 
* Sie werden in der Objektklasse "Gebiete" der Basis-Fachklassen gespeichert
* Sie werden als Flächenobjekt in der Karte digitalisiert und können bei Bedarf jederzeit bearbeitet/angepaßt werden

==== Zuweisung von Adressen zu Gebieten ====
Die Zuweisung von Adressen zu Gebieten erfolgt über eine Räumliche Abfrage und das "Hineinziehen" des Abfrageergebnisses in die Untertabelle "Zugeordnete Fachobjekte" in der Datenmaske "Gebiet": 

[[File:KS_adress01.JPG|500px]] 

 

==== Jahresabschluss ====

Bevor aktuelle Daten zur Einwohnern und Wanderungsbewegungen eingelesen werden, wird in der Regel ein '''Jahresabschluss''' durchgeführt. 
Dabei werden die derzeit aktuellen Daten aus folgenden Sachgruppen historisiert, d.h. die Datensätze werden jeweils in eine "Tabelle-historisch" kopiert:
* Adressstatistik --> Adressstatistikdaten (historisch)
* Gebietsstatistik --> Gebietsstatistik (historisch)
* Wanderungsbewegungen --> Gebietswanderungen (historisch), Umzüge aus anderen Gebieten (historisch)
* Prognosen --> Prognosen (historisch)
* Prozesssteuerung --> Prozesssteuerung (historisch)
 
'''Schritt 1 - Jahresabschluss in Tabelle "Adressen"''': 

[[File:KS_jahrab01.JPG|200px]] 

Die gewünschten Datensätze müssen markiert sein! 
Mit dem Start der Funktion erfolgt die Aufforderung, ein Bezugsjahr einzugeben: 

[[File:KS_jahrab04.JPG|250px]] 

Im Ergebnis werden für alle ausgewählten Adressen die aktuellen Adressstatistiken in die Tabelle Adressstatistikdaten (historisch) überführt (kopiert). 
'''Anschließend (!)''' wird das gewählte Bezugsjahr in den Datensatz in der Tabelle "Adressstatistik" eingetragen: 

[[File:KS_jahrab05a.JPG|500px]] 

'''Schritt 2 - Jahresabschluß in Tabelle "Gebiete"''': 
[[File:KS_jahrab02.JPG|200px]] 
Die gewünschten Datensätze müssen markiert sein! 
Analog zum "Jahresabschluss Adressen" erfolgt die Aufforderung, ein Bezugsjahr anzugeben. 

Im Ergebnis werden für alle ausgewählten Gebiete die aktuellen Statistiken in die Tabellen
* Gebietsstatistik (historisch)
* Gebietswanderungen (historisch)
* Umzüge aus anderen Gebieten (historisch)
* Prognosen (historisch)
* Prozesssteuerung (historisch)

überführt (kopiert). 

==== Einlesen der EWO-Daten aus CSV-Datei ====

In einem ersten Schritt ist der Inhalt der Tabelle "Einwohner" zu löschen.

Die EWO-Daten werden von den Meldeämtern im CSV-Format geliefert. Es existiert kein einheitlicher bundesweiter Standard. Eine EWO-Datei kann bespielhaft wie folgt aussehen: 
[[File:KS_ewo03.JPG|600px]]
 
Beim Import der EWO-Daten erfolgt eine Verknüpfung der Einwohner mit der jeweiligen Adresse. Diese Verknüpfung geschieht über den Straßenschlüssel. 
Hierbei ist zu '''BEACHTEN''': der Straßenschlüssel bei den Meldeämtern (EWO) ist nicht zwingend identisch mit dem Straßenschlüssel der Vermessungsämter (ALKIS). Die Aggregierung der Einwohner auf die Adresse erfolgt über den '''EWO-Straßenschlüssel'''. Der Nutzer muß hier, ggf. manuell, sicherstellen, daß die Tabelle "Adressen" den richtigen EWO-Straßenschlüssel beinhaltet. 
Der Datenbestand der EWO-Datei ist nicht immer konsistent. Zum Beispiel können Schreibfehler auftreten ("m?nnlich" statt "männlich"), welche beim Import dann nicht richtig interpretiert und deshalb übersprungen werden. Weiterhin können Adressen in den EWO-Daten (Straßenschlüssel + Hausnummer) in den Adressdaten des ALKIS nicht vorhanden sein. 

Vor dem Einlesen der EWO-Daten erfolgt deshalb eine '''Validierung''': 
In der Tabelle "Einwohner" wird über die Schaltfläche "StadtAnalyst" ein '''Testdurchlauf''' für den Import gestartet: 

[[File:KS_ewo01.JPG|200px]]

 

[[File:KS_ewo04a.JPG|600px]]
 
Das Jobfenster öffnet sich, und nach beendetem Testlauf kann über "Ergebnis" die Log-Datei gespeichert werden. 
In der Log-Datei werden alle festgestellten Inkonsistenzen gelistet. Das kann beispielhaft so aussehen: 

[[File:KS_ewo05.JPG|300px]] 
Der Nutzer hat anhand der Log-Datei die Möglichkeit, die EWO-Datei zu korrigieren. Falls keine Korrektur erfolgt, werden die betroffenen Datensätze beim Import übersprungen. 
Der Testdurchlauf kann beliebig oft wiederholt werden. 

Wenn die Konsistenz der EWO-Datei hergestellt ist, erfolgt der Import der Einwohnerdaten in die Tabelle "Einwohner": 

[[File:KS_ewo02.JPG|200px]]

 
Im '''Ergebnis''' wird die Tabelle "Einwohner" gefüllt, noch nicht vorhandene Adressen werden angelegt. 

==== Einlesen der Daten zu Wanderungsbewegungen aus CSV-Datei ====
 '''HINWEIS:''' prinzipiell erfolgt das Einlesen der Wanderungsbewegungen analog zu den EWO-Daten, siehe zuvor.
 

Wanderungsbewegungen beziehen sich jeweils auf ein Gebiet. Sie beinhalten folgende Möglichkeiten:
* Zuzug in ein Gebiet
* Weggzug aus einem Gebiet
* Umzug innerhalb eines Gebietes
* Geburt
* Tod
 
Die Wanderungsdaten-Daten werden von den Meldeämtern im CSV-Format geliefert. Es existiert kein einheitlicher bundesweiter Standard. Eine Wanderungs-Datei kann bespielhaft wie folgt aussehen: 
[[File:KS_wanderung03.JPG|600px]]
 
Beim Import der Wanderungs-Daten erfolgt eine Verknüpfung des "Ereignisses" mit der jeweiligen Adresse. Diese Verknüpfung geschieht über den '''EWO-Straßenschlüssel'''. 
Wie auch die EWO-Daten können die Wanderungsdaten Inkonsistenzen aufweisen. Deshalb erfolgt auch hier eine '''Validierung''': 

In der Tabelle "Wanderungsbewegungen" wird über die Schaltfläche "StadtAnalyst" ein '''Testdurchlauf''' für den Import gestartet: 

[[File:KS_wanderung01.JPG|200px]]

 
Das Jobfenster öffnet sich, und nach beendetem Testlauf kann über "Ergebnis" die Log-Datei gespeichert werden. 
In der Log-Datei werden alle festgestellten Inkonsistenzen gelistet. Das kann beispielhaft so aussehen: 

[[File:KS_wanderung05.JPG|300px]] 
Der Nutzer hat anhand der Log-Datei die Möglichkeit, die Wanderungs-Datei zu korrigieren. Falls keine Korrektur erfolgt, werden die betroffenen Datensätze beim Import übersprungen. 
Der Testdurchlauf kann beliebig oft wiederholt werden. 

Wenn die Konsistenz der Wanderungs-Datei hergestellt ist, erfolgt der Import der Wanderungsdaten in die Tabelle "Wanderungsbewegungen": 

[[File:KS_wanderung02.JPG|200px]]

 
Im '''Ergebnis''' wird die Tabelle "Wanderungsbewegungen" gefüllt, noch nicht vorhandene Adressen werden angelegt. 

==== Daten-Aggregierung ====
Bei der Datenaggregierung werden auf der Basis der Einwohner-Daten sowie Wanderungsbewegungen Statistiken zu den Adressen und Gebieten angelegt. 
Der Aufruf der entsprechenden Scripte erfolgt über die Schaltfläche im Kopf der Tabellen "Adressstatistik" und "Gebietsstatistik", die Ausführung erfolgt nach der nummerierten Reihenfolge: 

[[File:KS_aggreg01.JPG|200px]]

 
===== Adressstatistik =====

[[File:KS_aggreg02.JPG|400px]]
 
Die Ausführung der jeweiligen Scripte wird per Klick auf den grünen Pfeil gestartet. 
Die Jahreszahl (hier beispielhaft 2016) besagt, daß sich bestimmte Parameter der Aggregierung änden können (zum Beispiel Zusammenfassung von Altersgruppen), und dieses konkrete Script hier für die Aggregierung der Daten im Jahr 2016 gültig ist. 

===== Gebietsstatistik =====

[[File:KS_aggreg03.JPG|400px]]

 
Die Ausführung der jeweiligen Scripte wird per Klick auf den grünen Pfeil gestartet. 
Die Jahreszahl (hier beispielhaft 2016) besagt, daß sich bestimmte Parameter der Aggregierung änden können (zum Beispiel Zusammenfassung von Altersgruppen), und dieses konkrete Script hier für die Aggregierung der Daten im Jahr 2016 gültig ist. 

==== Erstellen von Auswertungen (Indikatoren etc.) ====
Die Erstellung der Indikatoren erfolgt, wie in der Abbildung zuvor ersichtlich, als Punkt 4 ebenfalls über das SQL-Script-Menü der "Gebietsstatistik"
 
 
Die Indikatoren werden in der Tabelle "Indikatorenergebnisse" gespeichert.
 
 
Hinweis: Für die Bundesländer Sachsen-Anhalt und Thüringen liegen fertige Indikatorenlisten gemäß Landesmomitoring vor.
 
 

== Datenmasken ==
=== Datenmaske ===
Beispiel für die Datenmaske der Objektklasse Adressstatistik: 
[[File:KS_maske_adr01.JPG|500px]]
 
Hinweis: Datenmasken können hinsichtlich Layout und angezeigter Datenfelder individuell vom Nutzer angepasst werden. 

=== Maskenexplorer ===
Wenn ein Datensatz geöffnet wird, dann wird links oben der sog. Maskenexplorer zum Datensatz geladen. Der Maskenexplorer bildet die Seiten der Maske zum Datensatz. 
Beispiel für den Maskenexplorer der Objektklasse Adressstatistik: 
[[File:KS_maske_adr02.JPG|250px]]
 
Hinweis: Aufbau, Anzahl, Reihenfolge und Bezeichnung der Seiten kann individuell vom Nutzer angepasst werden. 

=== Datenfeldtypen ===
{| class="wikitable" border="1"
|-
! Feld
! Typ

|-
| [[File:KS_auswahlfeld.JPG|250px]]
| Auswahlliste

|-
| [[File:KS_eingabefeld.JPG|130px]]
| Eingabefeld
|-
| [[File:KS_datumsfeld.JPG|200px]]
| Datumsfeld
|-
| [[File:Untertabelle.png|300px]]
| Untertabelle
|}

== Erfassungsregeln ==
Es ist '''zwingend notwendig''', den Datensatz zu speichern, bevor Verknüpfungen zu anderen Fachobjekten, Vorgängen, Dokumenten etc. (Stichwort: Untertabellen) angelegt werden. 
Der Nutzer hat die Möglichkeit, Datensätze "leer" anzulegen und eventuell die Lage in der Karte zu erfassen, um zu einem späteren Zeitpunkt die (restlichen) Sachinformationen einzutragen. Mögliche Pflichtfelder sind in der Maske als solche gekennzeichnet. 

== Konfigurationen ==
Zur Definition müssen die entsprechenden Editoren geöffnet werden. Grundsätzlich stehen zwei Varianten zur Verfügung, um die Konfigurationseditoren zu öffnen: 
* über die Sicht im Explorer > RMT > Kontextmenü > Konfiguration >
* über die Werkzeugleiste der geöffneten Tabelle (grünes Plus-Zeichen anklicken)
 

=== Spaltenkonfiguration ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Konfigurationen#Spaltenkonfiguration_f.C3.BCr_Tabellen Spaltenkonfiguration]
</div>
 

=== Sortierkonfiguration ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Konfigurationen#Sortierkonfiguration Sortierkonfiguration]
</div>
 

=== Filterkonfiguration ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Konfigurationen#Filterkonfiguration Filterkonfiguration]
</div>
 

== Vorbereitungsarten ==
=== Relevante Auswahllisten ===
Auswahllisten und deren Auswahleinschränkungen vor der Erfassung editieren und auf die individuellen Vorgaben anpassen. Das erleichtert sowohl die Erfassung als auch die spätere Auswertung der Daten.
 
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Auswahleinschränkung im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Fachanwendungsstruktur#Auswahleinschr.C3.A4nkungen Auswahleinschränkungen]
</div>

== Ausgewählte Funktionen ==

=== Serienbrief-Funktion ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Client-Benutzeroberfl%C3%A4che#Serienbrief Serienbrief]
</div>

StadtAnalyst

2017-11-13T14:05:32Z

Rreiss: /* Jahresabschluß */

Achtung! Diese Seite befindet sich noch in Bearbeitung!

<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; float:right; width=30px ;
border:1px solid #cccccc; background-color:#CAE1FF;
padding: 0.5em;">
[[File:KTGIS_Stempel.png|200px]] 
 
'''Erforderliche Lizenzen''' 
zur Fachanwendung '''Sta(d)tAnalyst''' 
* GMSC-K Basis-Fachklassen (Basis-Lizenz)
* GMSC-K Basis-Stammdaten (Basis-Lizenz)
* GMSC-K Stadtanalyst
</div>

== Vorwort ==
Die Fachanwendung GMSC-K Sta(d)tAnalyst wird inhaltlich durch die Firma [http://ktgis.de/ Kompetenzteam GIS] betreut 
 

== Ziel ==
GMSC-K – Sta(d)tAnalyst erlaubt die umfassende Erfassung aller erforderlichen Daten zu Kommunalverwaltung und ermöglicht dadurch das Monitoring. 
 
Statistische Abfragen und Auswertungen zu den unterschiedlichsten kommunalen Daten, Wohnungsstand oder Bevölkerung können gebietsbezogen durchgeführt werden. 

== Ausgewählte Symbole der Programmoberfläche ==
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[[Benutzeroberfläche]]
</div>
 

== Aufbau ==

 
Der Aufbau der zentralen Fachanwendungen (Basis-Fachklassen, Basis-Stammdaten) ist für alle Applikationen einheitlich. In diesem Beitrag wird nur auf die spezifische Fachanwendung und Objektklassen der Fachanwendung Sta(d)tAnalyst eingegangen. 
Die Fachanwendung Sta(d)tAnalyst beinhaltet unter anderem folgende Objektklassen: 
* Adressstatistikdaten
* Gebietsstatistikdaten
* Gebietswanderungen
* Kindereinrichtungen
* Medizinische Einrichtungen
* Prognosen
* Prozesssteuerung
* Schulen
* Wanderungsbewegungen
* u.a.
 
Für eine Reihe von Sachgruppen, z.B. Adressstatistik, Gebietsstatistik u.a. gibt es Objektklassen mit dem Zusatz "historisch". Hier werden die Daten aus früheren Erhebungen archiviert. 
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Für eine weitere detaillierte Beschreibung der Grundfunktionen nutzen Sie bitte die Online-Beschreibung unter: 
[[Fachanwendungskonzept]]
</div>
 
 

== Arbeitsschritte ==

{| class="wikitable" border="1"
|-
! Übersicht und Reihenfolge der Arbeitsschritte:
|-
| Anlegen der Projektstruktur (Einmalig)

|-
| Datenübernahme / Migration von Altdaten (Einmalig)

|-
| Anlegen bzw. Anpassen von Gebieten
|-
| Zuweisung von Adressen zu Gebieten
|-
| Historisieren des Datenbestandes (Funktion Jahresabschluß)
|-
| Einlesen der EWO-Daten aus CSV-Datei
|-
| Einlesen der Daten zu Wanderungsbewegungen aus CSV-Datei
|-
| Daten-Aggregierung
|-
| Erstellen von Auswertungen (Indikatoren etc.)
|}

=== Einmalig auszuführende Arbeitsschritte ===
==== Anlegen der Projektstruktur ====
* Einlesen der Explorer-Struktur und der Maskenkonfigurationen über ein XPMF-File

==== Datenübernahme / Migration von Altdaten ====
Bereits vorhandene (Alt-)Daten können in verschiedenen Formaten vorliegen und müssen in das Format CSV überführt werden. 
Zu diesem Arbeitsschritt nehmen Sie bitte gern Kontakt zu uns auf. Zu Projektbeginn können - zum Beispiel im Rahmen eines Workshops - die Ausgangdaten gemeinsam analysiert und der effektivste Weg besprochen werden, diese für die Verwendung in GMSC-K nutzbar zu machen. 

=== Routinemäßig auszuführende Arbeitsschritte ===

'''HINWEIS:''' Die speziellen Funktionalitäten der Fachanwendung "Sta(d)tAnalyst" werden jeweils im Kopf der zugehörigen Tabellen über die Schaltflächen [[File:KS_schaltflaeche01.JPG|40px]] bzw. [[File:KS_schaltflaeche02.JPG|40px]] aufgerufen. 

==== Anlegen von Gebieten ====
Bei Gebieten handelt es sich beispielsweise um Monitoring-Gebiete oder Sanierungsgebiete etc. 
* Sie werden in der Objektklasse "Gebiete" der Basis-Fachklassen gespeichert
* Sie werden als Flächenobjekt in der Karte digitalisiert und können bei Bedarf jederzeit bearbeitet/angepaßt werden

==== Zuweisung von Adressen zu Gebieten ====
Die Zuweisung von Adressen zu Gebieten erfolgt über eine Räumliche Abfrage und das "Hineinziehen" des Abfrageergebnisses in die Untertabelle "Zugeordnete Fachobjekte" in der Datenmaske "Gebiet": 

[[File:KS_adress01.JPG|500px]] 

 

==== Jahresabschluss ====

Bevor aktuelle Daten zur Einwohnern und Wanderungsbewegungen eingelesen werden, wird in der Regel ein '''Jahresabschluss''' durchgeführt. 
Dabei werden die derzeit aktuellen Daten aus folgenden Sachgruppen historisiert, d.h. die Datensätze werden jeweils in eine "Tabelle-historisch" kopiert:
* Adressstatistik --> Adressstatistikdaten (historisch)
* Gebietsstatistik --> Gebietsstatistik (historisch)
* Wanderungsbewegungen --> Gebietswanderungen (historisch), Umzüge aus anderen Gebieten (historisch)
* Prognosen --> Prognosen (historisch)
* Prozesssteuerung --> Prozesssteuerung (historisch)
 
'''Schritt 1 - Jahresabschluß in Tabelle "Adressen"''': 

[[File:KS_jahrab01.JPG|200px]] 

Die gewünschten Datensätze müssen markiert sein! 
Mit dem Start der Funktion erfolgt die Aufforderung, ein Bezugsjahr einzugeben: 

[[File:KS_jahrab04.JPG|250px]] 

Im Ergebnis werden für alle ausgewählten Adressen die aktuellen Adressstatistiken in die Tabelle Adressstatistikdaten (historisch) überführt (kopiert). 
'''Anschließend (!)''' wird das gewählte Bezugsjahr in den Datensatz in der Tabelle "Adressstatistik" eingetragen: 

[[File:KS_jahrab05a.JPG|500px]] 

'''Schritt 2 - Jahresabschluß in Tabelle "Gebiete"''': 
[[File:KS_jahrab02.JPG|200px]] 
Die gewünschten Datensätze müssen markiert sein! 
Analog zum "Jahresabschluss Adressen" erfolgt die Aufforderung, ein Bezugsjahr anzugeben. 

Im Ergebnis werden für alle ausgewählten Gebiete die aktuellen Statistiken in die Tabellen
* Gebietsstatistik (historisch)
* Gebietswanderungen (historisch)
* Umzüge aus anderen Gebieten (historisch)
* Prognosen (historisch)
* Prozesssteuerung (historisch)

überführt (kopiert). 

==== Einlesen der EWO-Daten aus CSV-Datei ====

In einem ersten Schritt ist der Inhalt der Tabelle "Einwohner" zu löschen.

Die EWO-Daten werden von den Meldeämtern im CSV-Format geliefert. Es existiert kein einheitlicher bundesweiter Standard. Eine EWO-Datei kann bespielhaft wie folgt aussehen: 
[[File:KS_ewo03.JPG|600px]]
 
Beim Import der EWO-Daten erfolgt eine Verknüpfung der Einwohner mit der jeweiligen Adresse. Diese Verknüpfung geschieht über den Straßenschlüssel. 
Hierbei ist zu '''BEACHTEN''': der Straßenschlüssel bei den Meldeämtern (EWO) ist nicht zwingend identisch mit dem Straßenschlüssel der Vermessungsämter (ALKIS). Die Aggregierung der Einwohner auf die Adresse erfolgt über den '''EWO-Straßenschlüssel'''. Der Nutzer muß hier, ggf. manuell, sicherstellen, daß die Tabelle "Adressen" den richtigen EWO-Straßenschlüssel beinhaltet. 
Der Datenbestand der EWO-Datei ist nicht immer konsistent. Zum Beispiel können Schreibfehler auftreten ("m?nnlich" statt "männlich"), welche beim Import dann nicht richtig interpretiert und deshalb übersprungen werden. Weiterhin können Adressen in den EWO-Daten (Straßenschlüssel + Hausnummer) in den Adressdaten des ALKIS nicht vorhanden sein. 

Vor dem Einlesen der EWO-Daten erfolgt deshalb eine '''Validierung''': 
In der Tabelle "Einwohner" wird über die Schaltfläche "StadtAnalyst" ein '''Testdurchlauf''' für den Import gestartet: 

[[File:KS_ewo01.JPG|200px]]

 

[[File:KS_ewo04a.JPG|600px]]
 
Das Jobfenster öffnet sich, und nach beendetem Testlauf kann über "Ergebnis" die Log-Datei gespeichert werden. 
In der Log-Datei werden alle festgestellten Inkonsistenzen gelistet. Das kann beispielhaft so aussehen: 

[[File:KS_ewo05.JPG|300px]] 
Der Nutzer hat anhand der Log-Datei die Möglichkeit, die EWO-Datei zu korrigieren. Falls keine Korrektur erfolgt, werden die betroffenen Datensätze beim Import übersprungen. 
Der Testdurchlauf kann beliebig oft wiederholt werden. 

Wenn die Konsistenz der EWO-Datei hergestellt ist, erfolgt der Import der Einwohnerdaten in die Tabelle "Einwohner": 

[[File:KS_ewo02.JPG|200px]]

 
Im '''Ergebnis''' wird die Tabelle "Einwohner" gefüllt, noch nicht vorhandene Adressen werden angelegt. 

==== Einlesen der Daten zu Wanderungsbewegungen aus CSV-Datei ====
 '''HINWEIS:''' prinzipiell erfolgt das Einlesen der Wanderungsbewegungen analog zu den EWO-Daten, siehe zuvor.
 

Wanderungsbewegungen beziehen sich jeweils auf ein Gebiet. Sie beinhalten folgende Möglichkeiten:
* Zuzug in ein Gebiet
* Weggzug aus einem Gebiet
* Umzug innerhalb eines Gebietes
* Geburt
* Tod
 
Die Wanderungsdaten-Daten werden von den Meldeämtern im CSV-Format geliefert. Es existiert kein einheitlicher bundesweiter Standard. Eine Wanderungs-Datei kann bespielhaft wie folgt aussehen: 
[[File:KS_wanderung03.JPG|600px]]
 
Beim Import der Wanderungs-Daten erfolgt eine Verknüpfung des "Ereignisses" mit der jeweiligen Adresse. Diese Verknüpfung geschieht über den '''EWO-Straßenschlüssel'''. 
Wie auch die EWO-Daten können die Wanderungsdaten Inkonsistenzen aufweisen. Deshalb erfolgt auch hier eine '''Validierung''': 

In der Tabelle "Wanderungsbewegungen" wird über die Schaltfläche "StadtAnalyst" ein '''Testdurchlauf''' für den Import gestartet: 

[[File:KS_wanderung01.JPG|200px]]

 
Das Jobfenster öffnet sich, und nach beendetem Testlauf kann über "Ergebnis" die Log-Datei gespeichert werden. 
In der Log-Datei werden alle festgestellten Inkonsistenzen gelistet. Das kann beispielhaft so aussehen: 

[[File:KS_wanderung05.JPG|300px]] 
Der Nutzer hat anhand der Log-Datei die Möglichkeit, die Wanderungs-Datei zu korrigieren. Falls keine Korrektur erfolgt, werden die betroffenen Datensätze beim Import übersprungen. 
Der Testdurchlauf kann beliebig oft wiederholt werden. 

Wenn die Konsistenz der Wanderungs-Datei hergestellt ist, erfolgt der Import der Wanderungsdaten in die Tabelle "Wanderungsbewegungen": 

[[File:KS_wanderung02.JPG|200px]]

 
Im '''Ergebnis''' wird die Tabelle "Wanderungsbewegungen" gefüllt, noch nicht vorhandene Adressen werden angelegt. 

==== Daten-Aggregierung ====
Bei der Datenaggregierung werden auf der Basis der Einwohner-Daten sowie Wanderungsbewegungen Statistiken zu den Adressen und Gebieten angelegt. 
Der Aufruf der entsprechenden Scripte erfolgt über die Schaltfläche im Kopf der Tabellen "Adressstatistik" und "Gebietsstatistik", die Ausführung erfolgt nach der nummerierten Reihenfolge: 

[[File:KS_aggreg01.JPG|200px]]

 
===== Adressstatistik =====

[[File:KS_aggreg02.JPG|400px]]
 
Die Ausführung der jeweiligen Scripte wird per Klick auf den grünen Pfeil gestartet. 
Die Jahreszahl (hier beispielhaft 2016) besagt, daß sich bestimmte Parameter der Aggregierung änden können (zum Beispiel Zusammenfassung von Altersgruppen), und dieses konkrete Script hier für die Aggregierung der Daten im Jahr 2016 gültig ist. 

===== Gebietsstatistik =====

[[File:KS_aggreg03.JPG|400px]]

 
Die Ausführung der jeweiligen Scripte wird per Klick auf den grünen Pfeil gestartet. 
Die Jahreszahl (hier beispielhaft 2016) besagt, daß sich bestimmte Parameter der Aggregierung änden können (zum Beispiel Zusammenfassung von Altersgruppen), und dieses konkrete Script hier für die Aggregierung der Daten im Jahr 2016 gültig ist. 

==== Erstellen von Auswertungen (Indikatoren etc.) ====
Die Erstellung der Indikatoren erfolgt, wie in der Abbildung zuvor ersichtlich, als Punkt 4 ebenfalls über das SQL-Script-Menü der "Gebietsstatistik"
 
 
Die Indikatoren werden in der Tabelle "Indikatorenergebnisse" gespeichert.
 
 
Hinweis: Für die Bundesländer Sachsen-Anhalt und Thüringen liegen fertige Indikatorenlisten gemäß Landesmomitoring vor.
 
 

== Datenmasken ==
=== Datenmaske ===
Beispiel für die Datenmaske der Objektklasse Adressstatistik: 
[[File:KS_maske_adr01.JPG|500px]]
 
Hinweis: Datenmasken können hinsichtlich Layout und angezeigter Datenfelder individuell vom Nutzer angepasst werden. 

=== Maskenexplorer ===
Wenn ein Datensatz geöffnet wird, dann wird links oben der sog. Maskenexplorer zum Datensatz geladen. Der Maskenexplorer bildet die Seiten der Maske zum Datensatz. 
Beispiel für den Maskenexplorer der Objektklasse Adressstatistik: 
[[File:KS_maske_adr02.JPG|250px]]
 
Hinweis: Aufbau, Anzahl, Reihenfolge und Bezeichnung der Seiten kann individuell vom Nutzer angepasst werden. 

=== Datenfeldtypen ===
{| class="wikitable" border="1"
|-
! Feld
! Typ

|-
| [[File:KS_auswahlfeld.JPG|250px]]
| Auswahlliste

|-
| [[File:KS_eingabefeld.JPG|130px]]
| Eingabefeld
|-
| [[File:KS_datumsfeld.JPG|200px]]
| Datumsfeld
|-
| [[File:Untertabelle.png|300px]]
| Untertabelle
|}

== Erfassungsregeln ==
Es ist '''zwingend notwendig''', den Datensatz zu speichern, bevor Verknüpfungen zu anderen Fachobjekten, Vorgängen, Dokumenten etc. (Stichwort: Untertabellen) angelegt werden. 
Der Nutzer hat die Möglichkeit, Datensätze "leer" anzulegen und eventuell die Lage in der Karte zu erfassen, um zu einem späteren Zeitpunkt die (restlichen) Sachinformationen einzutragen. Mögliche Pflichtfelder sind in der Maske als solche gekennzeichnet. 

== Konfigurationen ==
Zur Definition müssen die entsprechenden Editoren geöffnet werden. Grundsätzlich stehen zwei Varianten zur Verfügung, um die Konfigurationseditoren zu öffnen: 
* über die Sicht im Explorer > RMT > Kontextmenü > Konfiguration >
* über die Werkzeugleiste der geöffneten Tabelle (grünes Plus-Zeichen anklicken)
 

=== Spaltenkonfiguration ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Konfigurationen#Spaltenkonfiguration_f.C3.BCr_Tabellen Spaltenkonfiguration]
</div>
 

=== Sortierkonfiguration ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Konfigurationen#Sortierkonfiguration Sortierkonfiguration]
</div>
 

=== Filterkonfiguration ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Konfigurationen#Filterkonfiguration Filterkonfiguration]
</div>
 

== Vorbereitungsarten ==
=== Relevante Auswahllisten ===
Auswahllisten und deren Auswahleinschränkungen vor der Erfassung editieren und auf die individuellen Vorgaben anpassen. Das erleichtert sowohl die Erfassung als auch die spätere Auswertung der Daten.
 
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Auswahleinschränkung im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Fachanwendungsstruktur#Auswahleinschr.C3.A4nkungen Auswahleinschränkungen]
</div>

== Ausgewählte Funktionen ==

=== Serienbrief-Funktion ===
<div id="mainpage-welcome-box" style="margin:0em 0em 0.3em 0em; width=30px ;border:1px solid #cccccc; background-color:#CAE1FF; padding: 0.5em;">
Siehe Grundfunktionen im Online-Handbuch unter: 
[http://smartclient.intergraph.at/GeoMediaKommunal/Client-Benutzeroberfl%C3%A4che#Serienbrief Serienbrief]
</div>

Strom

2017-08-30T09:24:49Z

Rreiss: /* Weitere Funktionen */

Strom

2017-08-29T09:35:01Z

Rreiss: /* Datenmodell und Grundfunktionen */

Strom

2017-08-29T09:29:13Z

Rreiss: /* Ausgewählte Symbole der Programmoberfläche */

Strom

2017-08-29T09:28:27Z

Rreiss: /* Ausgewählte Symbole der Programmoberfläche */

Datei:Strom Datenmodell.png

2017-08-28T12:43:02Z

Rreiss: Rreiss lud eine neue Version von „Datei:Strom Datenmodell.png“ hoch

Datei:Strom Datenmodell.png

2017-08-28T12:38:22Z

Rreiss:

Strom

2017-08-28T12:37:32Z

Rreiss: /* Aufbau */

Strom

2017-08-28T12:35:26Z

Rreiss: /* Aufbau */

Strom

2017-08-28T12:34:36Z

Rreiss: /* Ziel */

Strom

2017-08-28T12:32:57Z

Rreiss: /* Aufbau */