Logbuch

Einführung

Mit dem Feature “Logbuch” (eingeführt mit Version 2.11) ist es möglich, punktuelle oder zeitlich ausgedehnte Ereignisse zum einen in Sedrix zu dokumentieren (manuell oder automatisch), und zum anderen die so dokumentierten Ereignisse auch zusammen mit den Messdaten graphisch darzustellen, was insbesondere dann relevant ist, wenn diese Ereignisse wichtig zur Interpretation der Daten sind.

Neben einem beschreibenden Text des Ereignisses ist ein Logbuch-Eintrag daher im Wesentlichen über sein Start-, und gegebenenfalls – zur Beschreibung eines Zeitraumes – über sein Ende-Datum definiert. Zur Strukturierung des Logbuchs können Logbook-Einträge einem bestimmten (Unter-) Ordner des aktuellen Projektes zugewiesen werden. Details hierzu finden Sie im Abschnitt Eigenschaften von Logbuch-Einträgen.

Beispiele für Ereignisse, die als Logbuch-Einträge dokumentiert werden können:

• Wartungszeiträume,

• Tausch von Geräten oder Sensoren,

• Zeiträume von Stromausfällen,

• Erschütterungsereignisse wie Sprengungen,

• andere (im obigen Sinn relevante) Vorkommnisse auf der Baustelle, etc.

Hinweis zur Lizenzierung: Dieses Feature erfordert eine gesonderte Lizenzierung.

Hinweis zur Rechteverwaltung: Als Benutzer benötigt man für die Verwaltung des Logbuchs entsprechende Rechte.
Diese sind als Eigenschaft der Benutzergruppe, der der Benutzer angehört, im Dropdown-Menü “Logbuch” zu definieren. Mögliche Einträge des Dropdown-Menü “Logbuch” sind “Keine”, “Nur lesen”, “Bearbeiten”, “Neu anlegen” sowie “Löschen”. Wenden Sie sich an Ihren Sedrix-Administrator, falls Ihre Rechte für Ihre Bedürfnisse nicht ausreichen. Näheres zur Rechte-Verwaltung siehe Abschnitt Eigenschaften der Benutzergruppe.

Erstellen von Logbuch-Einträgen - Auslöser 

Der normale Anwendungsfall für Benutzer von Sedrix, der in den folgenden Abschnitten hauptsächlich beschrieben wird, besteht darin, dass ein Benutzer einen Logbuch-Eintrag manuell anlegt.
Dann können Logbuch-Einträge aber auch automatisch, durch den Sedrix-Server, angelegt werden. So ist beispielsweise zukünftig vorgesehen, dass bei einem Update von Sedrix dieses Ereignis automatisch in einem entsprechenden Logbuch-Eintrag, aus dem dann auch die mit dem Update verbundene Down-Time hervorgeht, dokumentiert wird.

Da somit ein Logbuch-Eintrag durch verschiedene Akteure erzeugt werden kann, speichert Sedrix für jeden Eintrag auch den “Verursacher”, bzw. den Auslöser des Eintrages. Im normalen Anwendungsfall ist dies der Name des anlegenden Benutzers, bei automatisch generierten Einträgen die Bezeichnung “System” (oder “Extern”, was hier aber lediglich der Vollständigkeit halber erwähnt werden soll). Dieser Auslöser wird im Logbuch für jeden Eintrag, in einer eigenen Spalte, angezeigt (siehe Spalte 3 im Screenshot, Abschnitt “Logbuch einsehen und Einträge verwalten”).

Zum Normalfall des manuellen Anlegens von Logbuch-Einträgen siehe insbesondere Abschnitt Logbuch einsehen und -Einträge verwalten.

Eigenschaften von Logbuch-Einträgen 

Folgende Eigenschaften eines Logbuch-Eintrags sind festzulegen:

• START (erforderlich)
  Datum und Zeit des (Beginns) des als Logbuch-Eintrag zu dokumentierenden Ereignisses
  Default: Aktuelles Datum und Zeit.

• ENDE (optional)
  Datum und Zeit des (Beginns) des als Logbuch-Eintrag zu dokumentierenden Ereignisses. Sofern angegeben muss dieser Wert zeitlich nach dem Start-Wert liegen.

• PRIORITÄT (erforderlich)
  Dropdown-Menü zur Auswahl einer Zahl zwischen 1 und 5.
  Diese Zahl ist frei wähl- und interpretierbare (beispielsweise zur Kennzeichnung der Wichtigkeit des Ereignisses).
  Ihr ist intern eine Farbe zugeordnet, die zur Einfärbung der graphischen Darstellung des Ereignisses verwendet wird.
  1: zugeordnete Farbe: Rot (gegebenenfalls zur Kennzeichnung der höchsten Priorität) – 5: zugeordnete Farbe: Violett (gegebenenfalls zur Kennzeichnung der niedrigsten Priorität).
  Default: 1.

• ORDNER
  Dropdown-Menü, mit dem ein Ordner oder Unterordner des aktuellen Projektes ausgewählt werden kann, um die Sichtbarkeit des Eintrages auf die Messtellen bzw. deren Auswertungen einzuschränken, die dem ausgewählten Ordner und aller seiner Unterordner zugewiesen sind.
  Default: -. Damit wird der Logeintrag in den Auswertungen aller Messstellen des Projektes angezeigt – sofern der Schalter “Sichtbar in Auswertungen” (siehe unten) auf “Ja” steht (die Auswahl - entspricht also der Auswahl des Projektordners selbst).

• KURZTEXT (erforderlich)
  Freitext zur knappen Beschreibung des Ereignisses, der als Label des Eintrages verwendet wird. Maximallänge: 20 Zeichen.
  Empfehlung: Möglichst kurz halten, um Überlappungen in der graphischen Darstellung möglichst gering zu halten.

• TEXT (erforderlich)
  Freitext zur genaueren Beschreibung des Ereignisses.

• Schalter Sichtbar in Auswertungen
  Bestimmt, ob der Eintrag in den Auswertungen von Messstellen prinzipiell eingeblendet wird oder nicht. Zur genaueren Festlegen, in den Auswertungen welcher Messstellen siehe
  Default: Nein.

Logbuch einsehen und -Einträge verwalten 

Das Logbuch des aktuellen Projekts öffnen Sie, indem Sie auf das “Klemmbrett”-Icon (“Clipboard”-Icon) im Menü klicken. Es wird eine Ansicht geöffnet, in der alle Logbuch-Einträge des Projektes, deren Startzeit von den gewählten SmartFilter-Einstellungen erfasst wird, mit ihren wesentlichen Eigenschaften in tabellarischer Form dargestellt werden (siehe Screenshot unten).

Zusätzlich wird in der Spalte “AUSLÖSER” der Name des Benutzers (sofern manuell, durch einen Benutzer, erstellt) ausgegeben, der den jeweiligen Eintrag erstellt hat (zum Begriff “Auslöser” siehe hier).

Wichtig: Wenn Sie bestimmte Einträge vermissen, liegt dies wahrscheinlich daran, dass sie durch die aktuellen Einstellungen des SmartFilters nicht erfasst werden! Ändern Sie dann Ihre Filter-Einstellungen geeignet.

1. Wechseln Sie zuvor gegebenenfalls zu dem Projekt, dessen Logbuch Sie einsehen/verwalten möchten.

2. Klicken Sie dann auf das “Klemmbrett”-Icon (“Clickboard”-Icon), um das Logbuch des Projektes zu öffnen.

3. Um einen neuen Logbuch-Eintrag zu erstellen:

   1. Klicken Sie oben rechts auf das “+”-Icon.

   2. Legen Sie nun die Eigenschaften des neuen Eintrages fest.

   3. Klicken Sie auf „Speichern“, um den Eintrag anzulegen.​

4. Um einen vorhandenen Logbuch-Eintrag zu editieren:

   1. Klicken Sie rechts neben dem Eintrag auf das “Editieren”-Icon.

   2. Ändern Sie nun nach Wunsch die Eigenschaften des Eintrages.

   3. Klicken Sie auf „Speichern“, um Ihre Änderungen zu speichern.​

5. Um einen vorhandenen Logbuch-Eintrag zu löschen:

   1. Klicken Sie ganz rechts neben dem zu löschenden Eintrag auf das “Mülleimer”-Icon.

   2. Klicken Sie im sich öffnenden Fenster auf “Löschen”, wenn Sie den Eintrag wirklich löschen wollen. Klicken Sie auf “Abbrechen”, um den Vorgang abzubrechen.

Grafische Darstellung von Logbuch-Einträgen aus-/einblenden 

Logbuch-Einträge, die in Diagrammen durch einen Marker mit Label (punktuelles Ereignis) bzw. ein farbig hinterlegtes Rechteck (zeitlich ausgedehnte Ereignisse) dargestellt werden, können Sie bei Bedarf jederzeit aus- und wieder einblenden.

• Um für ein Diagramm die Logbucheinträge temporär auszublenden, klicken Sie auf den Schalter “Logbucheinträge” links über dem Diagramm (unterhalb des Namens der Auswertung, vergleiche den Screenshot zu Beginn des Artikels).

• Um die Logbucheinträge wieder einzublenden, klicken Sie erneut auf diesen Schalter.