Protokoll: Unterschied zwischen den Versionen

Aktuelle Version vom 11. Oktober 2023, 15:05 Uhr

Das Protokoll ist eine Programmfunktion, die Änderungen in der Objektstruktur dokumentiert. Das Protokoll gibt Aufschluss über Zeitpunkt, Wert und Benutzer der Änderung.

Es sind nur Einträge im Protokoll sichtbar, für welche die Berechtigungen vorhanden sind.

Das Protokoll dient dem Benutzer

den zeitlichen Verlauf von Änderungen zu betrachten.
im Fehlerfall Recherche zu betreiben.
als Dokumentation.

Das Protokoll von Zeitstempel ist über das Zeitstempelprotokoll einsehbar.

Das Protokoll der Zeitstempelverarbeitung ist über den Zeitstempelverarbeitungsverlauf einsehbar.

Funktionsbeschreibung

Das Protokoll kann im Navigator unter Anpassungsansicht: Protokoll aufgerufen werden.

Abfrage	Beschreibung
Protokoll	Protokoll für alle Benutzer im gewählten Zeitbereich
Objekt	Protokoll gewähltes Objekt im gewählten Zeitbereich
Benutzer	Protokoll gewählten Benutzer im gewählten Zeitbereich

Für beliebige Objekte kann das Protokoll

mittels Kontextmenü in der Suche
mittels Kontextmenü auf den Reiter

und Auswahl von aufgerufen werden

Die Informationen die im Protokoll zur Verfügung stehen:

Spalte	Beschreibung
`Geändert um`	Zeitpunkt der durchgeführten Änderung
`Änderung auf`	geändertes Objekt
`Geänderte Eigenschaft`	geänderte Eigenschaft
`Alter Wert`	Wert vor Änderung
`Neuer Wert`	Wert nach Änderung
`Geändert von`	Protokoll für alle Benutzer im gewählten Zeitbereich
`Geändert auf Computer`	Endgerät auf dem die Änderung durchgeführt wurde. Spezielle Endgeräte: `WebAssembly Host`: Änderung über WASM Webuserinterface `Android Gerät`: Änderung über Android Smartphone `Apple Gerät`: Änderung über Apple Smartphone `Bfx.Web.UI.Daemon.dll`: Änderung über Webuserinterface ALT
`Transition`	interne Stelle der Änderung (nur für Bit Factory relevant)

Änderungen für Tag

Änderungen am Tag werden im Status Planung und Ist protokolliert.

Der Aufruf erfolgt über das Kontext-Menü am Tag und Auswahl von Änderungen für Tag.

Anzeige von Tagesänderungen

Zeitstempel wurde für den 05.06.2019 am 27.06.2019 bei Herrn Max Mustermann vom Benutzer SUPERVISOR von 12:00 Geht auf 11:00 Geht geändert.

Alle Änderungen für ein Personal pro Monat

Es können alle Änderungen für einen Mitarbeiter für ein ganzes Monat angezeigt werden:

Dazu gibt es zwei Möglichkeiten:

im Jahresplan Monats-Kontext-Menü Änderungen für Monat auswählen
im Monatsplan Personal Kontext-Menü Änderungen für Monat auswählen

Änderungen für Monat

Das Protokoll zeigt die Änderungen gruppiert nach Tagen des ausgewählten Monats:

Änderung für Mitarbeiter

Alle Änderungen für einen Dienstplan

Es können alle Änderungen für einen Dienstplan angezeigt werden:

Dazu gibt es zwei Möglichkeiten:

im Kontextmenü der Dienstplan-Suche Alle Änderungen für Monat auswählen
im Kontextmenü des Dienstplan Reiters Alle Änderungen für Monat auswählen

Änderungen für Monat" auswählen:

Das Protokoll zeigt die Änderungen gruppiert nach Tagen des ausgewählten Monats:

Protokoll für eine Planungseinheit

Änderungen am Personal

Die Änderungen der Personal-Stammdaten werden über Protokoll für Objekt

im Kontextmenü des Reiters des geöffnen Personals
im Kontextmenü in der Personalsuche

aufgerufen.

Stammdatenänderungen

Änderung bei Max Mustermann am 27.06.2019 durch den Benutzer SUPERVISOR: Zuname und Vorname

Wird das Personal über die Funktion Neues Personal im Personal-Kontextemenü direkt im Dienstplan angelegt, so ist im Protokoll die Stamm-Planungseinheit nicht sichtbar.

Zusatzprotokollierung am Personal

Beim Protokoll für Personal gibt es folgende Protokolleinträge für spezielle Operationen:

Geänderte Eigenschaft	Beschreibung
`Abschlussbuchungen ausführen`	Protokolliert, auf welchem Plan die Abschlussbuchungen für dieses Personal ausgeführt wurden
`Summen neu berechnen`	Protokolliert, wann die Berechnung ausgeführt wurde im Monatsplan im Jahresplan ab welchem Stichtag
`Jahr neu aufrollen`	Protokolliert, in welchem Zeitbereich das Personal neu aufgerollt wurde

Änderungen auf der Planungseinheit

Die Änderungen der Plan-Stammdaten werden über Protokoll für Objekt

im Kontextmenü des Reiters der geöffneten Planungseinheit
im Kontextmenü in der Planungseinheit-Suche

aufgerufen.

Das Protokoll der Planungseinheit ist hilfreich für die Nachverfolgung von Statuswechsel:

Änderung für Planungseinheit

Änderung Planungseinheit Test am 27.06.2019 um 10:00 von Benutzer SUPERVISOR auf Status Ist und anschließend um 10:09 in den Status Abgeschlossen

Zusatzprotokollierung auf der Planungseinheit

Beim Protokoll für die Planungseinheit gibt es folgende Protokolleinträge für spezielle Operationen:

Geänderte Eigenschaft	Beschreibung
`iDienstplan Benachrichtigung versendet`	Protokolliert den Versand von SmartPlanPrintDaemon

Änderungen spezieller Monatswerte / Umbuchungen

Aufruf über den Jahresplan des Mitarbeiters:

Rechte-Maus-Klick auf das Monat - "Dump Monate"
auf den entsprechenden Zeitkontostand (z. B. "Name, 01.01.2021, Status: Ist") einen Rechte-Maus-Klick
"Protokoll für Objekt" auswählen

Protokoll für Zeitkontoumbuchungen und spezielle Monatswerte

Alternativ kann dieses Protokoll auch über den Mitarbeiterstamm aufgerufen werden:

Rechte-Maus-Klick auf den Reiter "Personal: Name Vorname, x"
"Zeitkontostand für PositionOfAccountsX" auswählen
Datum eingeben und ausführen
auf den entsprechenden Zeitkontostand (z. B. "Name, 01.01.2021, Status: Ist" / Zeitkontostand Monat) einen Rechte-Maus-Klick
Protokoll für Objekt auswählen

Änderungen von Sonderfunktionen / Shutdowns

Beim Protokoll für Shutdowns ist ersichtlich, wer den Shutdown eingerichtet hat.

Mit einem Rechts-Klick auf den Reiter "Shutdowns" und das Auswählen der Funktion "Protokoll für Objekt", öffnet sich ein eigenes Fenster mit dem Namen Protokoll für dieses Objekt.

Das Protokoll würde dann so aussehen:

Protokoll für Sonderfunktion Shutdown

Änderungen am Besetzungsreport

Welche Änderungen in einem Besetzungsreport durchgeführt wurden, werden protokolliert.

Hier ist sichtbar ob Zeilen hinzugefügt oder gelöscht wurden.

Änderungen am Kombi-Projekt

Es wird protokolliert, welche Änderungen am Kombi-Projekt durchgeführt wurden. Dies umfasst sowohl die hinzugefügten oder entfernen Dienste/Planungscodes/Aufgaben als auch einen hinterlegten bzw. geänderten Bedarf.

Änderungen eines Ad-Hoc Bedarfs

Es wird protokolliert, wenn der Ad-Hoc Bedarf verändert wird. Die Protokollierung kann über den Besetzungsreport aufgerufen werden.^[1]

Protokoll für Ad-Hoc Bedarf

Fußnoten

↑ #8461

[issue854-1] #8461

[1]

@@ Zeile 1: / Zeile 1: @@
-Das '''Protokoll''' ist eine [[Programmfunktion]] die Änderungen in der [[Objekttyp|Objektstruktur]] dokumentiert. Das Protokoll gibt Aufschluss über Zeitpunkt, Wert und Benutzer der Änderung.
+Das '''Protokoll''' ist eine [[Programmfunktion]], die Änderungen in der [[Objekttyp|Objektstruktur]] dokumentiert. Das Protokoll gibt Aufschluss über Zeitpunkt, Wert und Benutzer der Änderung.
 Es sind nur Einträge im Protokoll sichtbar, für welche die Berechtigungen vorhanden sind.
 Das Protokoll dient dem Benutzer
-- den zeitlichen Verlauf von Änderungen zu betrachten.
-- im Fehlerfall Recherche zu betreiben.
+* den zeitlichen Verlauf von Änderungen zu betrachten.
-- als Dokumentation.
+* im Fehlerfall Recherche zu betreiben.
+* als Dokumentation.
 Das Protokoll von Zeitstempel ist über das [[Zeitstempel Protokoll|Zeitstempelprotokoll]] einsehbar.
@@ Zeile 14: / Zeile 15: @@
 == Funktionsbeschreibung ==
-Das Protokoll kann im Navigator unter <code>Anpassungsansicht: Protokoll</code> aufgerufen werden.
+Das Protokoll kann im '''Navigator''' unter <code>Anpassungsansicht: Protokoll</code> aufgerufen werden.
-Es gibt verschiedene Abfragemöglichkeiten:
 {| class="wikitable"
 ! Abfrage
-[[Datei:Protokoll_Navigator.png|200px]]
+[[Datei:Protokoll_Navigator.png|300px]]
-!! Beschreibung
+! Beschreibung
 |-
 | Protokoll || Protokoll für alle Benutzer im gewählten Zeitbereich
+|-
+| Objekt || Protokoll gewähltes Objekt im gewählten Zeitbereich
 |-
 | Benutzer || Protokoll gewählten Benutzer im gewählten Zeitbereich
-|-
-| Objekt || Protokoll gewähltes Objekt im gewählten Zeitbereich
 |}
+Für '''beliebige Objekte''' kann das Protokoll
+* mittels Kontextmenü in der Suche
+* mittels Kontextmenü auf den Reiter
+und Auswahl von [[Datei:Protokoll Objekt.png|200px]] aufgerufen werden
 Die Informationen die im Protokoll zur Verfügung stehen:
@@ Zeile 58: / Zeile 62: @@
 |}
-==Änderungen für Tag==
+===Änderungen für Tag===
-Änderungen am Tag werden im Status Planung und Ist protokolliert (Status Planung ab Version 2021.22).
+Änderungen am Tag werden im Status Planung und Ist protokolliert.
-Mit einem Rechts-Klick auf den Tag und dem Auswählen der Funktion "Änderungen für Tag" öffnet sich ein eigenes Fenster mit dem Namen "Protokoll für Objekt".
+Der Aufruf erfolgt über das Kontext-Menü am Tag und Auswahl von <code>Änderungen für Tag</code>.
-Wenn Sie danach auf Ausführen klicken, sehen Sie die Änderungen für diesen Tag.
+{{AlexBild|'''Anzeige von Tagesänderungen'''|[[Datei:Änderungen für Tag.png|1000px]]|Zeitstempel wurde für den 05.06.2019 am 27.06.2019 bei Herrn Max Mustermann vom Benutzer SUPERVISOR von 12:00 Geht auf 11:00 Geht geändert.}}
-{{AlexBild|'''Anzeige von Tagesänderungen'''|[[Datei:Änderungen für Tag.png|1000px]]|Zeitstempel wurde für den 05.06.2019 am 27.06.2019 bei Herrn Max Mustermann vom Benutzer SUPERVISOR von 12:00 Geht auf 11:00 Geht geändert.}}
+====Alle Änderungen für ein Personal pro Monat====
-===Alle Änderungen für 1 Mitarbeiter für 1 Monat===
 Es können alle Änderungen für einen Mitarbeiter für ein ganzes Monat angezeigt werden:
-Dazu gibt es 2 Möglichkeiten:
+Dazu gibt es zwei Möglichkeiten:
-*im Jahresplan des Mitarbeiters einen Rechte-Maus-Klick auf das Monat und im Kontext-Menü "Änderungen für Monat" auswählen
+*im Jahresplan Monats-Kontext-Menü <code>Änderungen für Monat</code> auswählen
-*im Monatsplan einen Rechte-Maus-Klick auf den Namen des Mitarbeiters und im Kontext-Menü "Änderungen für Monat" auswählen:
+*im Monatsplan Personal Kontext-Menü <code>Änderungen für Monat</code> auswählen
-{{AlexBild|'''Änderungen für Monat'''|[[Datei:Änderungen für Monat Personal.png]]|}}
+{{AlexBild|'''Änderungen für Monat'''|[[Datei:Protokoll_Monat.png]]|}}
-Das Protokoll würde dann so aussehen:
+Das Protokoll zeigt die Änderungen '''gruppiert nach Tagen''' des ausgewählten Monats:
 {{AlexBild|Änderung für Mitarbeiter|[[Datei:Protokoll 1 Monat 1 Mitarbeiter.png|1000px]]|}}
-===Alle Änderungen für 1 Planungseinheit für 1 Monat===
+====Alle Änderungen für einen Dienstplan====
-Es können auch alle Änderungen für eine ganze Planungseinheit für ein ganzes Monat angezeigt werden:
+Es können alle Änderungen für einen Dienstplan angezeigt werden:
-Dazu gibt es 2 Möglichkeiten:
+Dazu gibt es zwei Möglichkeiten:
-*in der Dienstplan-Suche einen Rechte-Maus-Klick auf den jeweiligen Plan und im Kontext-Menü "Alle Änderungen für Monat" auswählen
+*im Kontextmenü der Dienstplan-Suche <code>Alle Änderungen für Monat</code> auswählen
-*im Dienstplan einen Rechte-Maus-Klick auf den Reiter und im Kontext-Menü "Alle Änderungen für Monat" auswählen
+*im Kontextmenü des Dienstplan Reiters <code>Alle Änderungen für Monat</code> auswählen
 <span><br /></span>
 {{AlexBild|Änderungen für Monat" auswählen:|[[Datei:Änderungen für Monat Planungseinheit.png]]|}}
-Das Protokoll wird grafisch wie folgt dargestellt:
+Das Protokoll zeigt die Änderungen '''gruppiert nach Tagen''' des ausgewählten Monats:
 {{AlexBild|Protokoll für eine Planungseinheit|[[Datei:Protokoll Planungseinheit Monat.png|1000px]]|}}
-==Protokoll für Objekt==
+===Änderungen am Personal===
-<span><br /></span>
+Die Änderungen der Personal-Stammdaten werden über <code>Protokoll für Objekt</code>
-===Protokoll für Personal===
+* im Kontextmenü des Reiters des geöffnen Personals
+* im Kontextmenü in der Personalsuche
+aufgerufen.
-<span><br /></span>
+{{AlexBild|'''Stammdatenänderungen'''|[[Datei:Protokoll für Objekt Personal.png|1000px]]|Änderung bei Max Mustermann am 27.06.2019 durch den Benutzer SUPERVISOR: Zuname und Vorname}}
-Um durchgeführte Änderungen bei den Stammdaten eines MA zu sehen, muss man in den Stammdaten des Mitarbeiters auf den Reiter "Personal: Max Mustermann" einen Rechts-Klick durchführen und anschließend auf "Protokoll für Objekt" klicken.
-{{AlexBild|'''Stammdatenänderungen'''|[[Datei:Protokoll für Objekt Personal.png|1000px]]|Änderung bei Max Mustermann am 27.06.2019 durch den Benutzer SUPERVISOR: Zuname und Vorname}}
+Wird das Personal über die Funktion <code>Neues Personal</code> im Personal-Kontextemenü direkt im Dienstplan angelegt, so ist im Protokoll die '''Stamm-Planungseinheit''' nicht sichtbar.
-<span><br /></span>
+====Zusatzprotokollierung am Personal====
-'''Spezielle Anlage:'''
-Wurde der Mitarbeiter mittels "Neues Personal" direkt im Dienstplan angelegt, so ist im Protokoll die Zuweisung der Stamm-Planungseinheit nicht sichtbar.
+Beim Protokoll für Personal gibt es folgende Protokolleinträge für spezielle Operationen:
-====Abschlussbuchungen ausführen====
+{| class="wikitable"
-Beim Protokoll für Personal ist auch ersichtlich, wer die Abschlussbuchungen ausgeführt hat (Geänderte Eigenschaft = "Abschlussbuchungen ausführen").
+! Geänderte Eigenschaft !! Beschreibung
+|-
+| <code>Abschlussbuchungen ausführen</code> || Protokolliert, auf welchem Plan die Abschlussbuchungen für dieses Personal ausgeführt wurden
+|-
+| <code>Summen neu berechnen</code> || Protokolliert, wann die Berechnung ausgeführt wurde
+* im Monatsplan
+* im Jahresplan
+ab welchem Stichtag
+|-
+| <code>Jahr neu aufrollen</code> || Protokolliert, in welchem Zeitbereich das Personal neu aufgerollt wurde
+|}
-===Protokoll für Planungseinheit===
+===Änderungen auf der Planungseinheit===
+Die Änderungen der Plan-Stammdaten werden über <code>Protokoll für Objekt</code>
+* im Kontextmenü des Reiters der geöffneten Planungseinheit
+* im Kontextmenü in der Planungseinheit-Suche
+aufgerufen.
-*Suchfenster für Planungseinheiten öffnen
+Das Protokoll der Planungseinheit ist hilfreich für die '''Nachverfolgung von Statuswechsel''':
-*Rechts-Klick auf eine Planungseinheit
-*Auswählen der Funktion "Protokoll für Objekt"
-<span><br /></span>
-Es öffnet sich ein eigenes Fenster mit dem Namen "Protokoll für Objekt", die Planungseinheit ist beim Feld "Änderung auf" bereits ausgewählt:
 {{AlexBild|'''Änderung für Planungseinheit'''
 |[[Datei:Protokoll für Planungseinheit.png|1000px]]
 |Änderung Planungseinheit Test am 27.06.2019 um 10:00 von Benutzer SUPERVISOR auf Status Ist und anschließend um 10:09 in den Status Abgeschlossen}}
-<span><br /></span>
+====Zusatzprotokollierung auf der Planungseinheit====
-Anhand des Screenshot kann man erkennen, dass der Status der Planungseinheit zuerst auf Ist und dann auf Abgeschlossen gesetzt worden ist.
+Beim Protokoll für die Planungseinheit gibt es folgende Protokolleinträge für spezielle Operationen:
-Im Protokoll der Planungseinheit kann der Eintrag "<span class="js-issue-title markdown-title">CurrentRequestGeneration" vorkommen.</span>
+{| class="wikitable"
+! Geänderte Eigenschaft !! Beschreibung
+|-
+| <code>iDienstplan Benachrichtigung versendet</code> || Protokolliert den Versand von SmartPlanPrintDaemon
+|}
-Dieser Eintrag ist ein internes Feld zum Verwalten des Besetzungsreports und wird z.B. bei der Aktion "Besetzungen neu aufbauen" oder beim Umsortieren von Mitarbeitern gesetzt.
+===Änderungen spezieller Monatswerte / Umbuchungen===
-===Protokoll für spezielle Monatswerte / Umbuchungen===
 Aufruf über den Jahresplan des Mitarbeiters:
@@ Zeile 154: / Zeile 172: @@
 *Protokoll für Objekt auswählen
-===Protokoll für Sonderfunktionen / Shutdowns===
+===Änderungen von Sonderfunktionen / Shutdowns===
 Beim Protokoll für Shutdowns ist ersichtlich, wer den Shutdown eingerichtet hat.
@@ Zeile 163: / Zeile 181: @@
 {{AlexBild|Protokoll für Sonderfunktion Shutdown|[[Datei:Protokoll Shut.png|1000px]]|}}
-=== Protokoll für Besetzungsreport ===
+=== Änderungen am Besetzungsreport ===
 Welche Änderungen in einem Besetzungsreport durchgeführt wurden, werden protokolliert.
 Hier ist sichtbar ob Zeilen hinzugefügt oder gelöscht wurden.
-=== Protokoll für Kombi-Projekt ===
+=== Änderungen am Kombi-Projekt ===
 Es wird protokolliert, welche Änderungen am Kombi-Projekt durchgeführt wurden. Dies umfasst sowohl die hinzugefügten oder entfernen Dienste/Planungscodes/Aufgaben als auch einen hinterlegten bzw. geänderten Bedarf.
-=== Protokoll für Ad-Hoc Bedarf ===
+=== Änderungen eines Ad-Hoc Bedarfs ===
-Es wird protokolliert, wenn der Ad-Hoc Bedarf verändert wird. Die Protokollierung kann über den Besetzungsreport aufgerufen werden.
+Es wird protokolliert, wenn der Ad-Hoc Bedarf verändert wird. Die Protokollierung kann über den Besetzungsreport aufgerufen werden.<ref name="issue854">{{githubissue|8461}}</ref>
 {{AlexBild|Protokoll für Ad-Hoc Bedarf|[[Datei:Protokoll 1697014223903.png|500px]]}}
+==Fußnoten==
 [[Kategorie:Funktionsübersicht]]
 [[Kategorie:Auswertungsmöglichkeiten]]