blob: af63e6d55bbe16d2c60d1b864b4e5644e5e0a009 [file] [log] [blame]
////
*******************************************************************************
* Copyright (c) 2019 Contributors to the Eclipse Foundation
*
* See the NOTICE file(s) distributed with this work for additional
* information regarding copyright ownership.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0 which is available at
* http://www.eclipse.org/legal/epl-2.0.
*
* SPDX-License-Identifier: EPL-2.0
*******************************************************************************
////
= Benutzerhandbuch: openKONSEQUENZ Störungsinformationstool
<<<
* Version: 0.2
* Datum: 03.07.2020
* Status: In Bearbeitung
<<<
:Author: Dr. Michel Alessandrini
:Email: michel.alessandrini@pta.de
:Date: 2020-07-03
:Revision: 0.2
:icons:
:source-highlighter: highlightjs
:highlightjs-theme: solarized_dark
:lang: de
:encoding: utf-8
:imagesdir: ../img
:iconsdir: ../img/icons
:toc:
:toclevels: 3
:toc-title: Inhaltsverzeichnis
:toc-placement:
:sectanchors:
:numbered:
:sectnumlevels: 5
toc::[]
<<<
== Sinn und Zweck des Moduls Störungsinformationstool
Das Modul Störungsinformationstool ist ein User-Modul der openKONSEQUENZ.
Mit diesem Modul hat ein Netzbetreiber jederzeit alle Störungsmeldungen
inklusive der aktuellen Status im Überblick.
Dabei wird jede Störungsmeldung durch einen
vordefinierten Prozess von der manuellen Erfassung oder dem automatischen Import
über die Veröffentlichung bis zur Beseitigung der Störung unterstützt.
Die Zuständigkeiten im Prozess sind durch verschiedene Benutzerrollen klar
geregelt.
<<<
== Übersicht
[[uebersicht-benutzerrollen]]
=== Benutzerrollen
Zur Bearbeitung von Störungsmeldungen sind verschiedene Benutzerrollen
definiert, deren Aufgaben (Berechtigungen) in den folgenden Unterabschnitten
aufgelistet sind:
TODO: Frage: Wer darf Verteilergruppen anlegen und bearbeiten?
==== Erfasser
* <<uebersicht-aller-stoer,Darf alle Störungsmeldungen sehen>>
* <<stoerungsmeldung-erstellen,Darf Störungsmeldungen anlegen>>
* <<stoerung-ansicht-bearbeitung,Darf Störungsmeldungen im internen Bearbeitungsstatus "neu" und "geplant" bearbeiten>>
* <<stoerung-ansicht-bearbeitung,Darf Störungsmeldungen im internen Bearbeitungsstatus "qualifiziert" bearbeiten>>
* <<statuswechsel-allgemein,Darf den Wechsel des internen Bearbeitungsstatus von "neu" nach "angelegt" durchführen>>
* <<statuswechsel-allgemein,Darf den Wechsel des internen Bearbeitungsstatus von "geplant" nach "angelegt" durchführen>>
* <<stoerungsmeldung-loeschen,Darf Störungsmeldungen im Status "neu" und "geplant" löschen>>
==== Qualifizierer
* <<uebersicht-aller-stoer,Darf alle Störungsmeldungen sehen>>
* <<stoerung-ansicht-bearbeitung,Darf Störungsmeldungen im internen Bearbeitungsstatus "angelegt" und "aktualisiert" bearbeiten>>
* <<stoerung-ansicht-bearbeitung,Darf Störungsmeldungen im internen Bearbeitungsstatus "qualifiziert" bearbeiten>>
* <<allg-funktionen-uebersicht-aller-sm-verdichten,Darf Störungsmeldungen verdichten>>
* <<statuswechsel-allgemein,Darf den Wechsel des internen Bearbeitungsstatus von "angelegt" nach "qualifiziert" durchführen>>
* <<statuswechsel-allgemein,Darf den Wechsel des internen Bearbeitungsstatus von "qualifiziert" nach "aktualisiert" durchführen>>
* <<statuswechsel-allgemein,Darf den Wechsel des internen Bearbeitungsstatus von "aktualisiert" nach "qualifiziert" durchführen>>
* <<statuswechsel-allgemein,Darf Störungsmeldungen abschließen (Wechsel des internen Bearbeitungsstatus auf "beendet")>>
* <<statuswechsel-stornieren,Darf Störungsmeldungen stornieren (Wechsel des internen Bearbeitungsstatus auf "storniert")>>
==== Veröffentlicher
* <<uebersicht-aller-stoer,Darf alle Störungsmeldungen sehen>>
* <<stoerung-ansicht-bearbeitung,Darf Störungsmeldungen im internen Bearbeitungsstatus "qualifiziert" bearbeiten>>
* <<allg-funktionen-uebersicht-aller-sm-verdichten,Darf Störungsmeldungen verdichten>>
* <<statuswechsel-veroffentlichung,Darf Störungsmeldungen veröffentlichen (Veröffentlichungsstatus ändern)>>
* Darf Verteilgruppen anlegen
* Darf Email-Vorlagen bearbeiten
==== Gast
* <<uebersicht-aller-stoer,Darf alle Störungsmeldungen sehen>>
==== Administrator
* Darf alles
* Darf zusätzlich Konfigurationen vornehmen (Details sind in technischer Dokumentation beschrieben)
** TODO prüfen: Mailvorlagen für Benachrichtigungen (bei Ziel-Status "Genehmigt", "Storniert", "Zurückgewiesen")
** TODO prüfen: Basis eMail-Verteilerlisten
TODO: ergänzen
=== Status
[[uebersicht-bearbeitungsstatus-intern]]
==== Bearbeitungsstatus (intern)
Zur Bearbeitung von Störungsmeldungen sind folgende (internen) Bearbeitungsstatus
definiert:
===== Neu
* Die Störungsmeldung befindet sich in der manuellen Erst-Erfassung.
* Die Störungsmeldung enthält u.U. noch nicht alle erforderlichen Informationen.
===== Geplant
* Die Störungsmeldung ist automatisch über eine Schnittstelle erzeugt worden.
* Der Störungsbeginn liegt in der Zukunft (geplante Maßnahme).
* Eine manuelle Bearbeitung der Störungsmeldung ist notwendig.
===== Angelegt
* Der Erfassungsvorgang ist vollständig abgeschlossen.
* Die Störungsmeldung enthält alle erforderlichen Informationen.
===== Qualifiziert
* Die Störungsmeldung ist im Vier-Augen-Prinzip geprüft.
* Die Störungsmeldung ist ggf. um weitere Informationen ergänzt.
* Die Störungsmeldung ist ggf. verdichtet.
===== Aktualisiert
* Die Störungsmeldung wurde nachträglich bearbeitet/verändert.
.Hinweis:
* Die Störungsmeldung befand sich zum Zeitpunkt der Bearbeitung im Status "qualifiziert".
===== Abgeschlossen
* Die Störung ist behoben.
* Die Störungsmeldung ist nur noch im Lesemodus verfügbar.
===== Storniert
* Die Störungsmeldung ist storniert.
* Die Störungsmeldung ist nur noch im Lesemodus verfügbar.
[[uebersicht-veroeffentlichungsstatus]]
==== Veröffentlichungsstatus
Für die Veröffentlichung von Störungsmeldungen sind folgende Veröffentlichungsstatus
definiert:
===== Nicht gesetzt
* Initialer Status einer (manuell oder automatisch) neu-angelegten Störungsmeldung
===== Nicht öffentlich
* Die Störungsmeldung ist nicht für die Öffentlichkeit sichtbar.
.Hinweis:
* Die Störungsmeldung war zu keinem Zeitpunkt für die Öffentlichkeit sichtbar.
===== Öffentlich
* Die Störungsmeldung ist für die Öffentlichkeit sichtbar.
* Die Veröffentlichung erfolgt über ausgewählte Kanäle
===== Zurückgezogen
* Die Störungsmeldung ist nicht mehr für die Öffentlichkeit sichtbar.
.Hinweis:
* Die Störungsmeldung war eine gewisse Zeit für die Öffentlichkeit sichtbar.
[[uebersicht-bearbeitungsstatus-extern]]
==== Bearbeitungsstatus (extern)
Der externe Bearbeitungsstatus ist nur bei veröffentlichten Störungsmeldungen
(d.h. Veröffentlichungsstatus = öffentlich) relevant.
Der externe Bearbeitungsstatus leitet sich vom internen Bearbeitungsstatus
in Kombination mit den Werten aus Störungsbeginn und -ende ab. Konkret bedeutet das
für die einzelnen Statuszustände einer Störungsmeldung folgendes:
===== Geplant
* Status (intern) = "qualifiziert"
* Störungsbeginn = noch nicht erreicht (liegt in der Zukunft)
===== In Bearbeitung
* Status (intern) = "qualifiziert"
* Störungsbeginn = ist erreicht (liegt in der Vergangenheit)
===== Beendet
* Status (intern) = "qualifiziert" oder veröffentlicht
* Störungsende = ist erreicht (liegt in der Vergangenheit)
oder
* Status (intern) = "storniert" oder abgeschlossen
=== Prozessablauf
Der gesamte Prozessablauf zur Bearbeitung einer Störung
ist im folgenden Prozessdiagramm dargestellt.
.Prozessübersicht
image::20200421_Status und Rollen_v7.png[]
<<<
== Benutzerdialoge
Die Anwendung ist für folgende Endgeräte optimiert:
* Desktop-PC
* Tablet
Es sind folgende Browser unterstützt:
* Google Chrome
Die Bildschirmauflösung bzw. die Fenstergröße des Browsers sollte folgende Werte nicht unterschreiten:
* 1.024 x 768 Pixel
[[uebersicht-aller-stoer]]
=== Übersicht der Störungsmeldungen
Die Übersichtsseite stellt standardmäßig alle Störungsmeldungen in einer Liste dar.
Bei Bedarf können die Störungsmeldungen aber auch in einer Kartenansicht angezeigt werden.
.Schaltfläche zum Umschalten zwischen Listen- und Kartenansicht
image::Liste-Karte.png[]
==== Listen-Ansicht
Das Modul startet immer in der Listenansicht:
bersicht aller Störungsmeldungen in der Listenansicht
image::Listenansicht.png[]
Die Übersicht zeigt zu jeder Störungsmeldung folgende Informationen an.
Die Bedeutung der Felder ist im Abschnitt <<stoerung-ansicht-bearbeitung>> beschrieben.
.Felder in der Listenansicht
[options="header"]
|=========================================================
|Feld
|Klassifikation
|Zuständigkeit
|Beschreibung
|Status (intern)
|Status (extern)
|Veröffentlichungsstatus
|Sparte
|Spannungsebene
|Druckstufe
|Störungsbeginn (gemeldet)
|Störungsende (geplant)
|Störungsende (wiederversorgt)
|Voraussichtlicher Grund
|Interne Bemerkungen
|Postleitzahl
|Ort (betroffene Orte)
|Ortsteil
|Straße (betroffene Straße)
|Hausnummer
|Radius in m
|Station(en)
|=========================================================
Jede Störungsmeldung kann abhängig von der Benutzerrolle und dem internen Bearbeitungsstatus
direkt aus der Liste angezeigt oder bearbeitet werden. In diesem Fällen öffnet
sich die <<stoerung-ansicht-bearbeitung, Detailansicht einer Störungsmeldung>>.
.Auge-Symbol zum Anzeigen einer Störungsmeldung
image::auge-symbol.png[]
.Stift-Symbol zum Bearbeiten einer Störungsmeldung
image::stift-symbol.png[]
Ferner können Störungsmeldungen - ebenfalls abhängig von der Benutzerrolle
und dem internen Bearbeitungsstatus -
auch <<statuswechsel-stornieren,storniert>> oder <<stoerungsmeldung-loeschen,gelöscht>> werden.
Mit den vordefinierten Filtern "TODO...", "TODO..." und "TODO...",
sowie über die Filter der Liste selbst, können beliebige individuelle
Filterkombinationen erstellt werden. Details dazu sind im Abschnitt
<<allg-funktionen-uebersicht-aller-sm-filter>> beschrieben.
Sollten mehrere Störungsmeldungen zu einer Störung gehören, so können diese
über die Funktion "Verdichten" zusammengeführt werden. Details dazu sind
im Abschnitt <<allg-funktionen-uebersicht-aller-sm-verdichten>> beschrieben.
==== Karten-Ansicht
Die Karte startet i.d.R. der Anzeige des Versorgungsgebiets.
.Darstellung der Störungsmeldungen im entsprechenden Kartenausschnitt
image::kartenansicht.png[]
Einzelne Störungen sind jeweils mit einem Marker dargestellt:
.Kennzeichnung einer Störung
image::kartenansicht-pin.png[]
Die Details einer Störung werden angezeigt, sobald sich der Mauszeiger
über dem Marker befindet:
.Anzeige von Details in Karte
image::kartenansicht-mouseover.png[]
Bei einem Klick auf den Marker öffnet sich die Detailansicht der
zugehörigen Störungsmeldung, siehe Abschnitt <<stoerung-ansicht-bearbeitung>>.
Der angezeigte Kartenausschnitt kann mittels der Maus individuell
angepasst werden:
* Linke Maustaste und ziehen: Verschieben des Kartenausschnitts
* Drehen am Mausrad: Veränderung des Zoom-Faktors
* Doppelklick linke Maustaste: Hineinzoomen
[[stoerungsmeldung-erstellen]]
==== Anlegen einer Störungsmeldung
Ist ein Benutzer mit der Benutzerrolle "Erfasser" angemeldet,
so besteht die Möglichkeit über die Schaltfläche "Neue Störungsmeldung anlegen"
eine neue Störungsmeldung anzulegen.
.Schaltfläche zum Anlegen einer Störungsmeldung
image::stoerung-erstellen.png[]
Weitere Details zur Bearbeitung (oder Anlage) einer Störungsmeldung,
siehe Abschnitt <<stoerung-ansicht-bearbeitung>>
[[stoerungsmeldung-loeschen]]
==== Löschen einer Störungsmeldung
TODO: Diesen Abschnitt nach Umsetzung validieren
TIP: Das Löschen einer Störungsmeldung ist nur in den internen Bearbeitungsstatus
"neu" und "geplant" möglich.
TODO: Ggf. Bild anpassen
.Schaltfläche zum Löschen einer Störungsmeldung
image::loeschen.png[]
WARNING: Beim Löschen werden alle Informationen einer Störungsmeldung
unwiederbringlich entfernt.
Befindet sich die Störungsmeldung in einem anderen internen Bearbeitungsstatus,
so ist die Funktion <<statuswechsel-stornieren,Stornieren>> zu verwenden.
[[stoerung-ansicht-bearbeitung]]
=== Ansicht und Bearbeitung einer Störungsmeldung
Die Störungsmeldung teilt sich in mehrere Bereiche auf:
. Störungsinformation
. Störungsdetails
. Störungsort
==== Störungsinformation
Die allgemeinen Informationen zu einer Störungsmeldung befinden sich im oberen Teil der Detailansicht.
.Ansicht der Informationen zu einer Störungsmeldung
image::stoerung-uebersicht.png[]
Die Störungsinformation enthält folgende Attribute:
.Attribute einer Störungsmeldung (Teil: Störungsinformation)
[options="header"]
|=========================================================
|Attribut |Pflichtfeld(*) |Inhaltsart |Beschreibung
|Klassifikation |nein |Auswahlfeld
a|
* Störung
* geplante Maßnahme
|Sparte |ja |Auswahlfeld
a|
* Strom
* Gas
* Wasser
* Fernwärme
* Telekommunikation
* Sekundärtechnik
* ohne Sparte
|Status (intern) |- |Automatisch |siehe <<uebersicht-bearbeitungsstatus-intern>>
|Status (extern) |- |Automatisch |siehe <<uebersicht-bearbeitungsstatus-extern>>
|Veröffentlichungsstatus |- |Automatisch |siehe <<uebersicht-veroeffentlichungsstatus>>
|=========================================================
(*) Pflichtfeld um einen Statuswechsel durchführen zu können.
==== Störungsdetails
Die Details zu einer Störungsmeldung befinden sich im mittleren Teil der Detailansicht.
.Ansicht der Details zu einer Störungsmeldung
image::stoerung-detail.png[]
Die Störungsdetails enthalten folgende Attribute:
.Attribute einer Störungsmeldung (Teil: Störungsdetails)
[options="header"]
|=========================================================
|Attribut |Pflichtfeld(*) |Inhaltsart |Beschreibung
|Zuständigkeit |nein |Freitext |Zuständiger Mitarbeiter, Bereich, etc.
|Spannungsebene |ja |Auswahlfeld
a|
Nur bei Sparte = Strom:
* Hochspannung
* Mittelspannung
* Niederspannung
|Druckstufe |nein |Auswahlfeld
a|
Nur bei Sparte = Gas:
* Hochdruck
* Mitteldruck
* Niederdruck
|Störungsbeginn (gemeldet) |ja |Datum/Uhrzeit |Startzeitpunkt der Störung
|Störungsende (wiederversorgt) |nein |Datum/Uhrzeit |Behebungszeitpunkt der Störung
|Voraussichtlicher Grund |ja |Auswahlfeld
a|
* Defekt technische Anlage
* Leitung beschädigt
* noch nicht bekannt
* Überregionale Störung
* Kabelfehler Mittelspannung (nur bei Strom)
* Kabelfehler Niederspannung (nur bei Strom)
|Beschreibung |nein |Freitext |Beschreibung der Störung
|Interne Bemerkungen |nein |Freitext |Zusätzliche Hinweise der Bearbeiter
|=========================================================
(*) Pflichtfeld um einen Statuswechsel durchführen zu können.
==== Störungsort
Der Ort einer Störungsmeldung ist im unteren Teil der Detailansicht zu erfassen.
Das kann auf drei unterschiedliche Arten erfolgen, wobei jeweils nur eine Art Anwendung finden darf:
. Adresse
. Karte
. Stationsattribute (nur bei Sparte = Strom und Spannungsebene = Mittelspannung ODER Sparte = Telekommunikation)
Über die folgende Schaltfläche kann zwischen den Arten der Orterfassung gewechselt werden:
.Schaltfläche zur Auswahl der Ortserfassung
image::ortserfassung.png[]
WARNING: Beim Wechsel der Erfassungsart gehen alle bisherigen Eingaben zum Störungsort ohne Hinweis zurückgesetzt.
===== Adresse
Die Erfassung über die Adresse kommt immer dann zum Einsatz, wenn ein
entsprechender Anschluss vorhanden ist, der der Störung eindeutig zugeordnet werden kann.
.Ansicht der Ortserfassung über Adresse
image::ort-adresse.png[]
Zur Adresse gehören folgende Attribute:
.Attribute einer Störungsmeldung (Teil: Störungsort über Adresse)
[options="header"]
|=========================================================
|Attribut |Pflichtfeld(*) |Inhaltsart |Beschreibung
|Postleitzahl |ja |Zahl |Postleitzahl des Störungsortes
|Ort (betroffene Orte) |ja |Auswahlfeld |Auswahllisteneinträge abhängig von der ausgewählten Postleitzahl
|Ortsteil |ja |Auswahlfeld |Auswahllisteneinträge abhängig vom ausgewählten Ort
|Straße (betroffene Straße) |ja |Auswahlfeld |Auswahllisteneinträge abhängig vom ausgewählten Ortsteil
|Hausnummer |ja |Auswahlfeld |Auswahllisteneinträge abhängig von der ausgewählten Straße
|Radius in Meter |ja |Auswahlfeld
a|
Darstellung eines Kreises um den Störungsort mit dem ausgewählten Radius in Meter:
* 0
* 50
* 100
* 250
* 500
* 1.000
* 1.500
* 2.000
|=========================================================
(*) Pflichtfeld um einen Statuswechsel durchführen zu können.
Während der Erfassung des Ortes erscheint nach Eingabe des zweiten Buchstabens eine Liste von Orten.
Es dürfen ausschließlich - in der Liste vorhandene - Orte eingetragen werden.
TIP: Bei der Eingabe des Ortes werden nur gültige Orte und Postleitzahlen vorgeschlagen.
D.h. bei vorheriger Auswahl der Sparte Strom sind nur Orte und Postleitzahlen für Stromanschlüsse sichtbar.
Das Gleiche gilt auch für alle anderen Sparten.
===== Karte
Die Erfassung über die Karte kommt immer dann zum Einsatz, wenn Störungen keiner
Adresse zugeordnet werden können, z.B. weil die Störung auf einer Grünfläche zwischen
zwei Orten aufgetreten ist.
.Ansicht der Ortserfassung über Karte
image::ort-karte.png[]
Mit einem Mausklick auf die entsprechende Stelle auf der Karte wird eine Markierung
für den Störungsort gesetzt. Dies kann beliebig oft durchgeführt werden, bis der
Punkt genau getroffen wurde.
Die Darstellung des Störungsortes erfolgt mit dem gleichen Marker, wie in allen anderen
Kartendarstellung auch.
===== Stationsattribute
TIP: Die Stationsattribute stehen nur zur Verfügung, wenn Sparte = Strom und
Spannungsebene = Mittelspannung ODER Sparte = Telekommunikation ausgewählt ist.
Die Erfassung über die Stationsattribute kommt dann zum Einsatz, wenn
es sich um Mittelspannungsstörungen handelt. Hierbei sind die relevanten
Stationen zu erfassen.
.Ansicht der Ortserfassung über Stationsattribute
image::ort-station.png[]
Während der Erfassung der Station (Straßenname oder Stationsnummer) erscheint
nach Eingabe der zweiten Zahl bzw. des zweiten Buchstabens eine Liste mit Stationen.
Es können ausschließlich in der Liste vorhandene Stationen ausgewählt werden.
Nach Auswahl einer Station wird diese in der Karte dargestellt. Zusätzlich wird
das Gebiet mit den zugeordneten Hausanschlüssen in Form eines Polygons umrahmt.
Bei der Auswahl mehrerer Stationen wird die zugrundeliegenden Bereiche miteinander
vereint, sofern diese geographisch nebeneinander liegen.
TIP: Das Gebiet wird nur umrandet, wenn der/den ausgewählten Station(en) entsprechende
Hausanschlüsse zugeordnet sind.
[[veroeffentlichung]]
==== Veröffentlichung
TODO
TODO: Folgenden Hinweis einarbeiten
Man könnte den Hinweis unterbringen, dass eine Veröffentlichung über einen Kanal
wie E-Mail nur dann Sinn macht, wenn auch mindestens eine Verteilergruppe ausgewählt
ist, die einen Kontakt mit einer E Mailadresse beinhaltet, sodass mindestens eine
E Mailadresse gibt, an die eine Benachrichtigung geschickt werden kann.
[[uebersicht-verteilergruppen]]
=== Übersicht der Verteilergruppen
TODO
[[anlegen-verteilergruppe]]
==== Anlegen einer Verteilergruppe
TODO
[[löschen-verteilergruppe]]
==== Löschen einer Verteilergruppe
TODO
TODO: Hinweis von Frau Salbeck einarbeiten
Es können einzelne Verteiler aus dem Veröffentlichungsprozess herausgenommen werden,
ohne dass diese eine Nachricht darüber erhalten.
[[bearbeitung-verteilergruppen]]
=== Ansicht und Bearbeiten einer Verteilergruppe
TODO
<<<
== Weitere Funktionen
[[allg-funktionen-uebersicht-aller-sm]]
=== Zur: Übersicht der Störungsmeldungen
[[allg-funktionen-uebersicht-aller-sm-filter]]
==== Vordefinierte Filter (Kennzahlen)
TODO
[[allg-funktionen-uebersicht-aller-sm-verdichten]]
==== Verdichten von Störungsmeldungen
Sofern mehrere Störungsmeldungen auf dieselbe Störung zurückzuführen sind,
können diese über die Verdichten-Funktion zusammengeführt werden.
TIP: Es können nur Störungsmeldungen der gleichen Sparte verdichtet werden.
Dazu ist in der Übersicht der Störungsmeldungen die Schaltfläche "Verdichtung"
zu betätigen.
bersicht der Störungsmeldungen
image::verdichten-1.png[]
Anschließend öffnet sich unter der Schaltfläche "Verdichtung" der Bereich
mit den ausgewählten bzw. verdichteten Störungsmeldungen.
Des Weiteren werden alle - noch nicht verdichteten - Störungsmeldungen
in der Listenansicht mit einem "+" angezeigt.
[[verdichten-2]]
.Auswahl von Störungsmeldungen zum Verdichten
image::verdichten-2.png[]
Nun sind die entsprechenden Störungsmeldungen über das "+"-Symbol auszuwählen.
Diese erscheinen dann unmittelbar in der obigen Tabelle mit den zu verdichtenden
Störungsmeldungen. Bereits Hinzugeführte können über das "-"-Symbol wieder
entfernt werden:
[[verdichten-3]]
.Selektierte Störungsmeldungen zum Verdichten
image::verdichten-3.png[]
Mit einem Klick auf die Schaltfläche "Ausgewählte Meldungen verdichten" wird
eine neue Störungsmeldung erzeugt (rot umrandet in folgender Abbildung). Die
blau hinterlegte Zahl zeigt die Anzahl der verdichteten Störungsmeldungen an:
.Neue erstellte Störungsmeldung (nach Verdichtung)
image::verdichten-4.png[]
Bei der Erstellung der neuen Störungsmeldungen werden initial die Grunddaten der
verdichteten Störungsmeldungen übernommen:
* Sparte
* Spannungsebene bzw. Druckstufe: Wenn bei allen verdichten Meldungen gleich, sonst leer
* Störungsbeginn (gemeldet): Das frühste Datum der verdichteten Meldungen
* Störungsende (geplant): Das späteste Datum der verdichteten Meldungen
Zudem wird der interne Bearbeitungsstatus auf "neu" gesetzt.
Alle Anpassungen und Aktualisierungen bzgl. dieser Störung sind fortan nur
noch an dieser neuen Störungsmeldung vorzunehmen.
INFO: Die verdichteten Meldungen werden nach Aktualisierung der übergeordneten
Störungsmeldung nicht synchronisiert. Die einzige Ausnahme ist, wenn der
interne Bearbeitungsstatus auf "beendet" wird. Dann werden auch die untergeordneten
Störungsmeldungen auf "beendet" gesetzt.
Nach der Verdichtung und Erzeugung der übergeordneten Störungsmeldung müssen die
Informationen zur Störung manuell ergänzt werden. Dies erfolgt genauso, wie die
Bearbeitung aller anderen Störungsmeldungen auch, siehe Abschnitt
<<stoerung-ansicht-bearbeitung>>.
Um die verdichteten Störungsmeldungen nachträglich anzupassen, nämlich
* Weitere Störungsmeldungen hinzufügen,
* Ausgewählte Störungsmeldungen entfernen,
ist ein Klick auf die blau hinterlegte Zahl notwendig. Anschließend öffnet sich
der Bereich mit den ausgewählten Störungsmeldungen. Hier können die einzelnen
Meldungen über die bekannten Symbole bearbeitet werden.
.Verdichtete Störungsmeldungen bearbeiten
image::verdichten-5.png[]
Nach einem Klick auf "Verdichtung bearbeiten" erscheint wieder die Ansicht
zum Hinzufügen und Entfernen von Störungsmeldungen, siehe Abbildung <<verdichten-3>>
=== Zur: Ansicht und Bearbeitung einer Störungsmeldung
==== Ansichts- und Bearbeitungsmodus
Je nach Benutzerrolle ist eine Störungsmeldung zur Ansicht oder zur Bearbeitung
geöffnet.
===== Ansichtsmodus
Im Ansichtsmodus können keine Daten verändert werden. Deshalb ist lediglich die Schaltfläche
Abbrechen sichtbar.
.Schaltfläche Abbrechen
image::abbrechen.png[]
===== Bearbeitungsmodus
Wird im Bearbeitungsmodus die Schaltfläche "Abbrechen" betätigt, nachdem Änderungen
vorgenommen wurden, erscheint eine zusätzliche Abfrage:
.Meldung bei geänderten Daten nach Klick auf Abbrechen
image::meldung-nach-abbrechen.png[]
Im Bearbeitungsmodus steht zusätzlich die Schaltfläche Speichern zur Verfügung.
.Schaltfläche Speichern
image::speichern.png[]
Des Weiteren existieren zusätzlich Schaltflächen, um den internen
Bearbeitungsstatus zu ändern. Details dazu befinden sich im
Abschnitt <<statuswechsel>>.
[[statuswechsel]]
==== Statuswechsel durchführen
[[statuswechsel-allgemein]]
===== Allgemeine Statuswechsel des internen Bearbeitungsstatus
Statuswechsel ist abhängig von der Benutzerrolle und dem aktuellen internen
Bearbeitungsstatus. Als Beispiel ist im Folgenden die Schaltfläche für den
Statuswechsel nach "angelegt" dargestellt. Die weiteren internen Bearbeitungsstatus
sind im Abschnitt <<uebersicht-bearbeitungsstatus-intern>> ersichtlich.
.Schaltfläche zum Wechsel des internen Bearbeitungsstatus auf "anlegen"
image::anlegen.png[]
[[statuswechsel-stornieren]]
===== Stornieren von Störungsmeldungen
Das Stornieren eines Störungsmeldung erfolgt ebenfalls in der Detailansicht
über die Schaltfläche "Stornieren".
TODO: Bild einfügen
.Schaltfläche zum Stornieren einer Störungsmeldung
image::stornieren.png[]
Durch das Stornieren erhält die Störungsmeldung den internen Bearbeitungstatus
"storniert". Gleichzeitig wird der Veröffentlichungsstatus auf "zurückgezogen"
gesetzt.
[[statuswechsel-ext-Status]]
===== Statuswechsel des externen Bearbeitungsstatus
Die Statuswechsel des externen Bearbeitungsstatus erfolgen automatisch gemäß
den Vorgaben aus Abschnitt <<uebersicht-bearbeitungsstatus-extern>>.
[[statuswechsel-veroffentlichung]]
===== Statuswechsel des Veröffentlichungsstatus
TODO
[[versionierung]]
==== Versionierung
Jede gespeicherte Änderung an einer Störungsmeldung wird in einer
neuen Version, unter Angabe des Bearbeiters und Datum/Uhrzeit, abgelegt.
Auswählbar sind die einzelnen Versionen in der Detailansicht einer Störungsmeldung:
.Anzeige der Version einer Störungsmeldung
image::versionierung-1.png[]
Standardmäßig ist die aktuellste Version ausgewählt. Je nach
Bearbeitungsstatus und Benutzerrolle kann die Störungsmeldung
bearbeitbar sein.
Zur Ansicht einer älteren Version muss lediglich die Versionsnummer
in der Auswahlliste angeklickt werden. Anschließend werden die
entsprechenden Einträge schreibgeschützt angezeigt:
.Anzeige einer älteren Version einer Störungsmeldung (schreibgeschützt)
image::versionierung-2.png[]
<<<
== Schnittstellen
=== Import von Störungsmeldungen
TODO
=== Export von Störungsmeldungen
[[Mail]]
==== Mail
TODO
[[stoerungsauskunft]]
==== Störungsauskunft.de
TODO
<<<
== Benachrichtigungen und Erinnerungen
[[email-benachrichtigung-statuswechsel]]
=== eMail-Benachrichtigung bei Statuswechsel
TODO
[[meldungen-hinweise]]
=== Hinweise und Meldungen nach Benutzeraktionen
Nach Benutzeraktionen erscheinen in bestimmten Fällen Meldungen des Systems,
um den Benutzer:
* Handlungsanweisungen zu geben,
* über Fehler des Systems zu informieren.
==== Erfolg einer Aktion
Ist eine Benutzeraktion erfolgreich, so erscheint keine Meldung.
==== Handlungsanweisung
In einigen Situationen muss der Benutzer weitere Aktionen ausführen, damit die
Handlung erfolgreich abgeschlossen werden kann. Diese gelb hinterlegten Hinweise
erscheinen im folgenden Fall:
* Fehlenden Informationen (Pflichtfelder füllen)
.Hinweis Pflichtfelder
image::meldung-hinweis.png[]
Diese Meldungen bleiben für einige Sekunden sichtbar und verschwinden dann wieder
automatisch.
==== Fehlermeldungen
Wenn Aktionen aufgrund technischer Gegebenheiten nicht erfolgreich durchgeführt
werden können, erscheinen rot hinterlegte Fehlermeldungen. Das kann u.a. in
folgenden Situationen passieren:
* Speichern fehlgeschlagen
* Web Services nicht verfügbar
.Fehlermeldung
image::meldung-fehler.png[]
Diese Meldungen bleiben solange sichtbar bis sie durch den Benutzer durch einfaches
Anklicken geschlossen werden. In diesen Fällen ist der Administrator zu
informieren.
== An- und Abmeldung
=== Modul "Störungsinformationstool" aus Portal starten
Nach erfolgreicher Anmeldung am openKONSEQUENZ-Portal und mit entsprechender
Berechtigung für das Modul "Störungsinformationstool" ist die Kachel für das Modul
sichtbar. Mit einem Klick auf die Kachel startet das Modul "Störungsinformationstool"
in einem neuen Fenster bzw. in einem neuen Tab des selben Browserfensters (je nach
Browsereinstellung).
.Kachel zum Starten des Moduls "Störungsinformationstool"
image::oeffnen-modul.png[]
=== Abmelden
Die Schaltfläche zum Abmelden befindet sich hinter dem Benutzernamen.
.Abmelden vom openKONSEQUENZ-System
image::abmelden.png[]
CAUTION: Beim Klick auf "Abmelden" erfolgt nicht nur die Abmeldung vom Modul
Störungsinformationstool, sondern die Abmeldung vom Portal. D.h. alle parallel
geöffneten openKONSEQUENZ-Module (wie z.B. Betriebstagebuch, Geplante
Netzmaßnahme) werden automatisch mit abgemeldet.
Um die parallel geöffneten openKONSEQUENZ-Module nicht mit abzumelden, ist
lediglich das Browserfenster mit dem Modul Störungsinformationstool zu schließen.