TBBM Handeingabemaske

Darstellung

Keyuser Manual ​

Backend WISKI ​

Die Konfiguration der TBBM-Handeingabemaske in WISKI (KISTERS AG, www.kisters.de) kann vollständig und einfach durch ihre Mitarbeiter erfolgen, da die Verwaltung auf WISKI-Zeitreihengruppen bzw. Parametergruppen basiert.

WISKI-Benutzer und Berechtigungen ​

Voraussetzung für die Konfiguration der Handeingabemaske (HE) ist, dass der Benutzer der Handeingabe einen WISKI-User mit den entsprechenden Rechten auf Zeitreihengruppen, bzw. auf die Messstellen der Messtouren hat:

HE - Benutzergruppe einrichten ​

Unter \\Verwaltung\Benutzerverwaltung\Benutzergruppen

  • Neue Benutzergruppe hinzufügen
  • Mitglieder der Gruppe auswählen und speichern

HE - Gruppen bzw. Messtouren einrichten ​

In den folgenden Abschnitten wird erläutert wie Gruppenzwecke und Parameter- bzw. Zeitreihengruppen in WISKI angelegt werden. Es wird beschrieben, wie die Reihenfolge der Einträge in der HE über die Parameter- bzw. Zeitreihengruppen definiert werden kann. Zudem können Einträge zweitweise deaktiviert oder auch wieder ganz aus den Gruppen entfernt werden.

HE – Konzept für Gruppenzweck und Gruppen ​

  • In der Installation der TBBM-Handeingabe wird definiert, welche WISKI-Gruppenzwecke für die Handeingabemaske verwendet werden. Dies können z. B. WISKI-Gruppenzwecke mit dem Kurznamen HE* sein:

  • \\Gruppen \Gruppenzwecke\HE Grundwasser

  • \\Gruppen \Gruppenzwecke\HE Pegel

  • Berechtigungen der WISKI-Gruppen (Benutzergruppe bzw. einzelne Benutzer) werden übernommen.

HE - Gruppenzweck einrichten ​

Zum Einrichten eines Gruppenzwecks:

  • \\Gruppen\Gruppenzweck → Rechtsklick → Hinzufügen

HE - Gruppen einrichten ​

Neue Gruppe anlegen ​

Die TBBM-Handeingabemaske kann für Zeitreihengruppen oder Parametergruppen eingerichtet werden (wird in Installation der Handeingabe festgelegt).

  • \\Gruppen \Statische Gruppen\Zeitreihengruppen oder \\Gruppen \Statische Gruppen\Parametergruppe → Rechtsklick → Hinzufügen

  • Gruppenzweck auswählen

  • »Privat« ändern auf »Gemeinsam genutzt« -> »...« -> entsprechende Benutzergruppe (HE - Benutzergruppe einrichten) auswählen und mit OK bestätigen.

Neuer Eintrag zur Gruppe hinzufügen ​

Beim Hinzufügen von Gruppeneinträgen, muss berücksichtigt werden, ob die Handeingabemaske für Zeitreihen- oder Parametergruppen konfiguriert ist:

  • Zeitreihe bzw. Parameter (je nach konfigurierter Gruppenart) markieren → Rechtsklick → Zur Gruppe hinzufügen
  • HE-Gruppe auswählen + OK

Eintrag aus Gruppe entfernen ​

Löschen von Zeitreihen oder Parameter aus den HE-Gruppen:

  • Markieren der Zeitreihen oder Parameter in der jeweiligen HE-Gruppe (Mehrfachauswahl möglich mit gedrückter Strg-Taste) → Rechtsklick → Aus Gruppe entfernen

Eintrag in Gruppe deaktivieren/aktivieren ​

Gruppeneinträge können deaktiviert werden, so verbleiben sie zwar in der HE-Gruppe, werden aber dort nicht angezeigt. Dies ist sinnvoll, wenn man die Einträge nur temporär ausblenden möchte. Ansonsten empfiehlt es sich den Eintrag zu löschen. Zum Aktivieren/Deaktivieren von Gruppeneinträgen:

  • Gruppe markieren → Rechtsklick → bearbeiten
  • Allgemein → Gruppeneinträge → bei Zeitreihe Haken entfernen (nicht aktiv) bzw. Haken setzen (aktiv) + OK

Reihenfolge der Einträge in HE definieren ​

Sollen Zeitreihen bzw. Parameter in der HE in einer bestimmten Reihenfolge angezeigt werden, so muss man sie nummerieren:

  • Gruppe markieren → Rechtsklick → Bearbeiten → Allgemein → Gruppeneinträge

  • Es gibt mehrere Möglichkeiten:

  • Mit Pfeiltasten (links unten) Zeitreihe nach oben/unten schieben.

  • Alle Zeitreihen neu nummerieren z. B. nach Bezeichnung sortieren und Button neben den Pfeilen aktivieren + Speichern + OK

Handeingabe für Externe - Konfiguration in WISKI ​

Werden Messungen von Externen erhoben, wird die Userverwaltung in WISKI über Adressen (Beobachter) und – falls gewünscht – auch über Adresstypen (Messtrupps) abgewickelt. Folgende Schritte sind dabei durchzuführen:

Erstellen eines Adresstyps ​

  • Messtrupps werden als Adresstypen angelegt. Der Kurzname muss den String »handeingabe.at« enthalten (z. B. auenland.handeingabe.at).
  • \\Systemansicht\Systemstammdaten\Verwaltung\Typen\Adresstyp -> Rechtsklick -> Hinzufügen -> Typ und Kurzname eintragen + OK

Erstellen von Adressen ​

Für jeden Beobachter bzw. jede berechtigte Person muss eine Adresse angelegt werden. Hier wird die E-Mail-Adresse, mit der sich der Beobachter an der externen Handeingabemaske anmeldet, eingetragen. Gehört der Beobachter zu einem Messtrupp, so wird das auch in der Adresskartei hinterlegt:

  • \\Systemansicht\Systemstammdaten\Verwaltung\Typen\Adressen -> Rechtsklick -> Hinzufügen -> Eintragen der E-Mail-Adresse und ggf. aktivieren der Messtrupps im Reiter »Adresstyp« + OK

Gruppenzweck – zusätzliche Attribute für Beobachter und Messtrupps erstellen ​

Die Gruppenzwecke und Gruppen werden gemäß HE - Gruppen einrichten angelegt und am Gruppenzweck werden zusätzliche Attribute für Beobachter und Messtrupps erstellt. TBBM stellt ihnen Vorlagen für das Anlegen der zusätzlichen Attribute und der Layouts zur Verfügung. Vor dem Import muss der Name des Gruppenzwecks in die XML-Vorlagendateien eingetragen und gespeichert werden:

xml
<?xml version="1.0" encoding="UTF-8" ?>
<GROUPPURPOSEATTRIBUTE TYPE="HE-Auenland" >
…

<?xml version="1.0" encoding="UTF-8" ?>
<GROUPPURPOSELAYOUT TYPE="HE-Auenland" >
…

Anschließend:

  • Gruppenzweck markieren -> Rechtsklick -> Bearbeiten
  • Reiter Zusätzliche Attribute -> Import -> TBBM-Vorlage für zusätzliche Attribute +OK
  • Reiter Layout -> Import -> TBBM-Vorlage für Layouts +OK

Nun können Sie die Messtouren und Beobachter an den HE-Gruppen des Messorts eintragen.

Eintrag Messtrupps und Beobachter an HE-Gruppe ​

An der HE-Gruppe können nun die zuständigen Messtrupps und Beobachter eingetragen werden:

  • HE-Gruppe aktivieren -> Rechtsklick -> Bearbeiten
  • Unter »Attribute der Gruppe« können die Messtrupps und Beobachter eingetragen werden + OK

Ansicht für Messtrupps ​

Über eine WISKI-Ansicht können die Mitglieder eines Messtrupps in einer Liste angezeigt werden:

  • \\Systemansicht\Systemstammdaten\Schlüssellisten

  • Hinzufügen eines Ordners für die Messtrupplisten:

  • Rechtsklick -> Hinzufügen

  • Objekt: Aus Dropdown »<Root> - root« wählen

  • Bezeichnung: z. B. Messtrupps + OK

  • Erstellen der Ansichten für die Messtrupps

  • \\Systemansicht\Systemstammdaten\Schlüssellisten\Messtrupps

  • Rechtsklick -> Hinzufügen

  • Objekt: Aus Dropdown Messtrupp auswählen

  • Bezeichnung z. B. Messtrupp Auenland + OK

Klickt man nun auf die Ansicht, so werden alle eingetragenen Beobachter aufgelistet. Man kann neue Beobachter in die Liste eintragen (Rechtsklick -> Hinzufügen). Die neuen Beobachter werden dann auch automatisch in den Adressen angezeigt. Eine Auswahl von bereits bestehenden Beobachtern ist über die Listenansicht jedoch nicht möglich.

Userverwaltung für Mehrstufige Entscheidungsprozesse ​

Die Handeingabe bietet die Möglichkeit, eingegebene Messungen oder Beobachtungen in mehrstufigen Prozessen zu prüfen bzw. Entscheidungen zu treffen und diese abzulegen.

Es können bis zu zwei Entscheidungsebenen eingeführt werden:

Der Beobachter gibt die Messungen oder Beobachtungen in die Handeingabe ein. Der Verantwortliche der ersten Entscheidungsebene bewertet die Messtour und trifft ggf. Entscheidungen. Er kann Entscheidungen auch an die übergeordnete zweite Entscheidungsebene weitergeben.

Zum Einrichten der Entscheidungsebenen sind folgende Schritte notwendig:

  • Für die erste Entscheidungsebene wird ein Adresstyp mit Kurznamen HANDEINGABE_RESPONSIBLE1 erstellt (Erstellen eines Adresstyps), der Name kann frei gewählt werden z. B. Entscheider, Stauwärter etc. Wird eine zweite Entscheidungsebene benötigt, erstellt man einen weiteren Adresstyp, der Kurznamen lautet in diesem Fall HANDEINGABE_RESPONSIBLE2. Auch hier ist die Namensgebung beliebig, z. B. Oberentscheider, Betriebsbeauftragte.
  • Für die Verantwortlichen der Entscheidungsebenen werden Adressen angelegt (Erstellen von Adressen) und der entsprechende Adresstyp aktiviert.
  • Am Gruppenzweck der Messtouren wird – falls nicht bereits vorhanden - ein Gruppenattribut für Beobachter erstellt (Gruppenzweck – zusätzliche Attribute für Beobachter und Messtrupps erstellen) – TBBM stellt eine Vorlage für das zusätzliche Attribut und das Layout zur Verfügung.
  • Die Adressen der Beobachter und der Entscheidungsträger können aus einen Dropdown-Menü ausgewählt werden.

Userverwaltung in Stammdaten für Meteo/OWF/UWQ-Eingabe ​

Die Eingabemasken Meteo - Eingabe meteorologischer Daten in Tabellenform und Vereinfachte Eingabemaske für OWF/UWQ-Beobachter müssen nicht zwingend über HE-Gruppen verwaltet werden. Als Alternative genügt es, den Beobachter an der Station in ein zusätzliches Stammdatenattribut (Handeingabe Beobachter) einzutragen, wobei auch mehrere Beobachter angegeben werden können. Falls gewünscht können auch Messtrupps eingetragen werden.

Beobachter an Stammdaten eintragen ​

Um die Beobachter an den Stationsstammdaten eintragen zu können, sind folgende Schritte notwendig:

  • Es wird ein Adresstyp »Handeingabe Beobachter« angelegt (Erstellen eines Adresstyps) mit Kurznamen HANDEINGABE_BEOBACHTER.

  • Für die Beobachter werden Adressen angelegt (Erstellen von Adressen) und unter Adresstyp »Handeingabe Beobachter« ausgewählt.

  • An der Stationsausprägung »Allgemein« wird ein zusätzliches Attribut »Handeingabe Beobachter« hinzugefügt:

  • \\Systemansicht\Systemstammdaten\Verwaltung\Typen\Stationsausprägung\Allgemein -> Zusätzliche Attribute -> Rechtsklick -> Hinzufügen

  • Typ »Softlink«

  • Art: Liste ohne Historie

  • Kurzname »HANDEINGABE_BEOBACHTER« TBBM stellt ihnen einen Softlink zur Verfügung, den sie hier eintragen. Anschließend SQL testen + OK.

  • TBBM stellt ihnen ein Layout für die Anzeige der Handeingabe Beobachter in den Stammdaten zur Verfügung. Importieren sie dies im Reiter Layout -> Import

  • An der Station unter Reiter Allgemein -> Handeingabe Beobachter können nun die Beobachter aus einer Dropdown-Liste der Beobachter ausgewählt werden.

Messtrupps an Stammdaten eintragen ​

Zuerst erstellt man einen entsprechenden Messtrupp (Erstellen eines Adresstyps) und anschließend konfiguriert man – äquivalent zum vorhergehenden Absatz die Stationsstammdaten:

  • An der Stationsausprägung »Allgemein« wird ein zusätzliches Attribut »Handeingabe Messtrupp« hinzugefügt:

  • \\Systemansicht\Systemstammdaten\Verwaltung\Typen\Stationsausprägung\Allgemein -> Zusätzliche Attribute -> Rechtsklick -> Hinzufügen

  • Typ »Softlink«

  • Art: Liste ohne Historie

  • Kurzname »HANDEINGABE_MESSTRUPP« TBBM stellt ihnen einen Softlink zur Verfügung, den sie hier eintragen. Anschließend SQL testen + OK.

  • TBBM stellt ihnen ein Layout für die Anzeige der Handeingabe Beobachter und Messtouren in den Stammdaten zur Verfügung. Importieren sie dies im Reiter Layout -> Import

  • An der Station unter Reiter Allgemein -> Handeingabe Beobachter und Messtrupps können nun die Beobachter und Messtrupps aus Dropdown-Listen ausgewählt werden. Mehrfachangaben sind möglich.

Handeingabe für Externe – Useradministration in Keycloak ​

Die Anmeldung an der Handeingabe für Externe erfolgt über eine Keycloak-Datenbank (https://www.keycloak.org/). Ab der HE-Client-Version 2022-09-29/22dec7a1 können die Benutzer ihr Keycloak Benutzerkonto über die Handeingabemaske öffnen und hier auch Änderungen vornehmen (Passwort, Mehrfachauthentifizierung), indem sie in der Konfiguration den Button »Benutzer verwalten« verwenden.

Die Administration der Keycloak-Benutzerkonten kann durch den oder die Keyuser erfolgen. Dafür sind folgende Schritte notwendig:

  • Alle Keyuser – falls nicht bereits geschehen – registrieren sich an der HE
  • Die Liste der Usernamen bzw. E-Mail-Adressen werden TBBM mitgeteilt und TBBM weist ihnen in Keycloak die Rolle als Keycloak-Keyuser zu.

Der Keycloak-Keyuser muss sich nun einmalig am Link https://www.handeingabe.at/auth/admin/\[NameDesRealms\]/console/ anmelden. Anschließend wird die »Security Adminkonsole« in den Applikationen der Keycloak-Kontoverwaltung angezeigt.

In der Security Adminkonsole kann der Keycloak-Keyuser sich nun die Benutzer anzeigen lassen und verschiedene Aktionen durchführen.

Die Standardaktionen sind

  • Benutzer löschen (kann notwendig sein, wenn sich jemand bei der Registrierung vertippt)
  • Benutzer aktivieren
  • E-Mail des Benutzers verifizieren
  • Verlangte Benutzeraktionen (müssen beim nächsten Login des Benutzers durchgeführt werden) wie
    • Passwort ändern
    • Zweifaktorauthentifizierung einrichten
    • E-Mail verifizieren

Zusätzlich kann TBBM bei Bedarf noch das Anlegen von Benutzern und Gruppen aktivieren.

Es empfiehlt sich, für die Anmeldung des Keyusers in Keycloak eine Mehrfachauthentifizierung zu wählen.

Zusätzliche Features ​

Eingabe von visuellen Beobachtungen ​

Bei einer visuellen Überprüfung eines Bauwerks ist das Ergebnis keine Zahl, sondern eine Beobachtung. Über die TBBM-Handeingabemaske können auch solche Daten abgelegt werden.

In WISKI werden entsprechende Beobachtungsparameter und Zeitreihen angelegt. Die dabei verwendete Einheit ist skalar und für die verschiedenen Einträge wird jeweils eine definierte Zahl hinterlegt, auf die Frage ob an einem Bauwerk Schäden festgestellt wurden, gibt es z. B. die Auswahl zwischen

  • 1 -> Nein
  • 2 -> unverändert
  • 3 -> Ereignis

Für die Zeitreihen bzw. Parameter der visuellen Beobachtungen muss daher eine Skalare Einheit »Nein/unverändert/Ereignis« angelegt werden.

Auftrag an Messtrupp als gelbe Warnung in Feldversion anzeigen ​

Folgende Schritte sind dazu notwendig:

  • Zusätzliches Attribut »HWE-Auftrag an Messtrupp« für die allgemeinen Stammdaten in WISKI konfigurieren.
  • Eintrag der Arbeitsaufträge an den betreffenden Stationen.
  • Der Auftrag wird nicht mehr angezeigt, wenn man das zusätzliche Attribut wieder aus den Stammdaten entfernt.

Meteo - Eingabe meteorologischer Daten in Tabellenform ​

Die Gruppenzwecke und Gruppen werden - wie in HE - Gruppen einrichtenbeschrieben - angelegt. Der Gruppenname muss mit dem in der HE-Konfiguration (Installation Handeingabemaske) angegebenen Namensschema übereinstimmen, damit die Gruppe für die Meteo-Dateneingabe zur Verfügung stehen kann. Standard ist hier »Beobachterliste NLV [HierFolgtDerNameDerListe]«.

Alternativ kann an den Stationsstammdaten ein Beobachter eingetragen werden (Userverwaltung in Stammdaten für Meteo/OWF/UWQ-Eingabe), dann ist keine HE-Gruppe notwendig.

Über die Meteo-Eingabe können

  • tägliche Niederschlagssummen mit Niederschlagstyp (Parameterbemerkung)
  • tägliche Schnee- und Neuschneehöhe
  • Lufttemperatur
  • Stationsbemerkungen

eingegeben werden. Alle Messungen sind dem Zeitpunkt 07:00 Uhr zugeordnet, nur die Messung der Lufttemperatur kann zu einem anderen Zeitpunkt erfolgen (Default ist hier 07:00 Uhr). Die WISKI-Parameternamen für Niederschlag, Temperatur und Schneeparameter müssen in der Konfiguration der Handeingabe hinterlegt werden (Installation Handeingabemaske).

Vereinfachte Eingabemaske für OWF/UWQ-Beobachter ​

Für diese Funktionalität müssen die Gruppen müssen laut dem in der HE-Konfiguration angegebenen Namensschema benannt sein (Standard »Beobachterliste [OWF|UWF] [HierFolgtDerNameDerListe] «). Ist dort z. B. für OWF »Beobachterliste OWF« definiert, werden für die vereinfachte Eingabemaske alle Messtouren die mit »Beobachterliste OWF« beginnen angezeigt.

Auch hier kann alternativ an den Stationsstammdaten ein Beobachter eingetragen werden (Userverwaltung in Stammdaten für Meteo/OWF/UWQ-Eingabe), dann ist keine HE-Gruppe notwendig.

Datentransfer WISKI ↔ Handeingabemaske ​

Die Konfiguration der Handeingabemaske sowie die Datenextraktion und -ablage erfolgt in WISKI. Dazu werden die Dateien der Handeingabemaske in den standardisierten Formate ZRXP (www.kisters.de) und KiTsXML auf einem definierten Ordner (z. B. D:\Daten\zrxp\handeingabe) abgelegt und über den KiDSM importiert. Fehlerhafte Dateien landen im failed-Verzeichnis des KiDSM (z. B. D:\Daten\failed\handeingabe). Ist an einer Zeitreihe keine Importnummer definiert, trägt die Handeingabemaske in diesem Fall die ZeitreihenID als Importnummer in die Datei ein. Dies führt zu einem Fehler und die Datei landet im failed-Verzeichnis.

Backend MDA ​

Messrunden für die Handwerteerfassung können in der MDA (Mobile Data Acquisition), der Firma ITEG (iteg.at/mda/) einfach vom Sachbearbeiter in angelegt werden.

Durch das Klicken auf »Messrunden« erscheint Baumansicht der MDA:

  • Auswahl der Ebene in der eine Messrunde angelegt werden soll
  • Rechtsklick -> »Messrundendefinition anlegen« und Name und Intervall eintragen
  • Anlegen

Mit Klick auf die neue Messrunde wird rechts davon u. a. der Reiter »Messstellen« angezeigt. Über die Baumansicht oder über einen Filter können nun Stationen ausgewählt und der Messrunde hinzugefügt werden.

Die Stationen werden in einer Liste angezeigt und die Messrunde kann hier noch weiterbearbeitet werden. Die angezeigten Spalten sind:

  • Position bzw. Reihenfolge der Anzeige (MDA und HE)
  • Aktiv - hier können Stationen deaktiviert werden
  • Messstellencode
  • Aktion - hier kann die Reihenfolge der Stationen geändert, bzw. die Station deaktiviert ( - ) oder gelöscht ( x ) werden.

Copyright © 2012–2025 TBBM