Protokoll: Unterschied zwischen den Versionen

Aktuelle Version vom 11. Oktober 2023, 16: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: @@
-Sie finden unterschiedliche Aufzeichnungen von durchgeführten Änderungen auf unterschiedlichen Ebenen:
+Das '''Protokoll''' ist eine [[Programmfunktion]], die Änderungen in der [[Objekttyp|Objektstruktur]] dokumentiert. Das Protokoll gibt Aufschluss über Zeitpunkt, Wert und Benutzer der Änderung.
-*Änderungen für Tag bei einem MA im Dienstplan
+Es sind nur Einträge im Protokoll sichtbar, für welche die Berechtigungen vorhanden sind.
-*Protokoll für Objekt (Personal, Planungseinheit)
-==Änderungen für Tag==
+Das Protokoll dient dem Benutzer
-Änderungen am Tag werden im Status Planung und Ist protokolliert (Status Planung ab Version 2021.22).
+* den zeitlichen Verlauf von Änderungen zu betrachten.
+* im Fehlerfall Recherche zu betreiben.
+* als Dokumentation.
-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".
+Das Protokoll von Zeitstempel ist über das [[Zeitstempel Protokoll|Zeitstempelprotokoll]] einsehbar.
-Wenn Sie danach auf Ausführen klicken, sehen Sie die Änderungen für diesen Tag.
+Das Protokoll der Zeitstempelverarbeitung ist über den [[Intern:Zeitstempelverarbeitungsverlauf|Zeitstempelverarbeitungsverlauf]] einsehbar.
+== Funktionsbeschreibung ==
-Das Protokoll zeigt folgende Informationen an:
+Das Protokoll kann im '''Navigator''' unter <code>Anpassungsansicht: Protokoll</code> aufgerufen werden.
-*'''Geändert um''': das Datum der durchgeführten Änderung.
+{| class="wikitable"
-*'''Änderung auf''': bei welchem MA, an welchem Tag, in welchem Status wurde diese Änderung durchgeführt.
+! Abfrage
-*'''Geänderte Eigenschaft''': welche Eigenschaft wurde geändert (Planungscode, Tag Zeitstempel, usw.).
+[[Datei:Protokoll_Navigator.png|300px]]
-*'''Alter Wert''': der Wert vor der durchgeführten Änderung.
+! Beschreibung
-*'''Neuer Wert''': der Wert nach der durchgeführten Änderung.
+|-
-*'''Geändert von''': von welchem Alex-Benutzer wurde diese Änderung durchgeführt.
+| Protokoll || Protokoll für alle Benutzer im gewählten Zeitbereich
-*'''Geändert auf Computer''': auf welchem Computer wurde diese Änderung durchgeführt.
+|-
+| 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 [[Datei:Protokoll Objekt.png|200px]] aufgerufen werden
+Die Informationen die im Protokoll zur Verfügung stehen:
+{| class="wikitable"
+! Spalte !! Beschreibung
+|-
+| <code>Geändert um</code> || Zeitpunkt der durchgeführten Änderung
+|-
+| <code>Änderung auf</code> || geändertes Objekt
+|-
+| <code>Geänderte Eigenschaft</code> || geänderte Eigenschaft
+|-
+| <code>Alter Wert</code> || Wert vor Änderung
+|-
+| <code>Neuer Wert</code> || Wert nach Änderung
+|-
+| <code>Geändert von</code> || Protokoll für alle Benutzer im gewählten Zeitbereich
+|-
+| <code>Geändert auf Computer</code> ||
+Endgerät auf dem die Änderung durchgeführt wurde.
+Spezielle Endgeräte:
+* <code>WebAssembly Host</code>: Änderung über WASM Webuserinterface
+* <code>Android Gerät</code>: Änderung über Android Smartphone
+* <code>Apple Gerät</code>: Änderung über Apple Smartphone
+* <code>Bfx.Web.UI.Daemon.dll</code>: Änderung über Webuserinterface ALT
+|-
+| <code>Transition</code> || 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 <code>Änderungen für Tag</code>.
 {{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 1 Mitarbeiter für 1 Monat===
+====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 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:
-Dazu gibt es 2 Möglichkeiten:
+Es können alle Änderungen für einen Dienstplan angezeigt werden:
-*in der Monatsplan-Suche einen Rechte-Maus-Klick auf den jeweiligen Plan und im Kontext-Menü "alle Änderungen für Monat" auswählen
+Dazu gibt es zwei Möglichkeiten:
-*im Monatsplan einen Rechte-Maus-Klick auf den Reiter und im Kontext-Menü "alle
+*im Kontextmenü der Dienstplan-Suche <code>Alle Änderungen für Monat</code> 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 würde dann so aussehen:
+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===
+Die Änderungen der Personal-Stammdaten werden über <code>Protokoll für Objekt</code>
+* im Kontextmenü des Reiters des geöffnen Personals
+* im Kontextmenü in der Personalsuche
+aufgerufen.
-===Protokoll für Personal===
+{{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.
+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.
-{{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}}
+====Zusatzprotokollierung am Personal====
-====Abschlussbuchungen ausführen====
+Beim Protokoll für Personal gibt es folgende Protokolleinträge für spezielle Operationen:
-Beim Protokoll für Personal ist auch ersichtlich, wer die Abschlussbuchungen ausgeführt hat (Geänderte Eigenschaft = "Abschlussbuchungen ausführen")
-===Protokoll für Planungseinheit===
+{| class="wikitable"
+! 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
+|}
-*Suchfenster für Planungseinheiten öffnen
+===Änderungen auf der Planungseinheit===
-*Rechts-Klick auf eine Planungseinheit
+Die Änderungen der Plan-Stammdaten werden über <code>Protokoll für Objekt</code>
-*Auswählen der Funktion "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''':
-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}}
+====Zusatzprotokollierung auf der Planungseinheit====
-Anhand des Screenshot kann man erkennen, dass die  gesetzt worden ist.
+Beim Protokoll für die Planungseinheit gibt es folgende Protokolleinträge für spezielle Operationen:
+{| class="wikitable"
+! Geänderte Eigenschaft !! Beschreibung
+|-
+| <code>iDienstplan Benachrichtigung versendet</code> || Protokolliert den Versand von SmartPlanPrintDaemon
+|}
-===Protokoll für spezielle Monatswerte / Umbuchungen===
+===Änderungen spezieller Monatswerte / Umbuchungen===
 Aufruf über den Jahresplan des Mitarbeiters:
@@ Zeile 90: / Zeile 159: @@
 *"Protokoll für Objekt" auswählen
+<span><br /></span>
 {{AlexBild|'''Protokoll für Zeitkontoumbuchungen und spezielle Monatswerte'''
 |[[Datei:Protokoll Zeitkontoumbuchungen.png|1000px]]|}}
-<br />
+<span /><br />
 Alternativ kann dieses Protokoll auch über den Mitarbeiterstamm aufgerufen werden:
@@ Zeile 103: / 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 112: / Zeile 181: @@
 {{AlexBild|Protokoll für Sonderfunktion Shutdown|[[Datei:Protokoll Shut.png|1000px]]|}}
-==Links==
+=== Ä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.
-*[[Intern:Zeitstempelverarbeitungsverlauf]]
+=== Änderungen eines Ad-Hoc Bedarfs ===
-*[[Zeitstempel Protokoll|Zeitstempelprotokoll]]
+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]]