UDM — 10.3 Änderungsprotokoll — Datenänderungen nachverfolgen

1

Überblick

Das Änderungsprotokoll (Entity Change Log) protokolliert automatisch alle Änderungen an Datensätzen: Wer hat wann welches Feld von welchem Wert auf welchen neuen Wert geändert. Damit lassen sich nachträgliche Änderungen lückenlos nachvollziehen — eine zentrale Anforderung für Audit-Zwecke, Qualitätssicherung und Revisionssicherheit.

Das Protokoll erfasst pro Änderung folgende Informationen:

Datenobjekt — welches Datenobjekt (Entity) betroffen ist
Art der Änderung — ob ein Datensatz erstellt, geändert oder gelöscht wurde
Geänderte Felder — Feldname, alter Wert und neuer Wert je geändertem Feld
Benutzer und Zeitpunkt — wer die Änderung wann durchgeführt hat
Primärschlüssel — welcher konkrete Datensatz betroffen ist

Praxisszenario

Nachvollziehen, wer den Kundenstatus geändert hat

Ein Kunde wurde unerwartet gesperrt. Im Änderungsprotokoll prüfen Sie den Change-Log-Eintrag für das betroffene Datenobjekt und sehen auf einen Blick, wer den Status von „Aktiv“ auf „Gesperrt“ gesetzt hat — inklusive Zeitpunkt und gegebenenfalls hinterlegtem Kommentar.

2

Schritt 1: Change Log für ein Datenobjekt aktivieren

Das Änderungsprotokoll ist nicht für alle Datenobjekte automatisch aktiv. Sie müssen es gezielt pro Datenobjekt (Entity) einschalten:

Datenobjekt-Verwaltung öffnen
Navigieren Sie im UDM Admin Client zu „Subsysteme & Datenobjekte“ und wählen Sie das gewünschte Datenobjekt aus.
Eigenschaft ChangeLogActive aktivieren
Setzen Sie im Detail des Datenobjekts die Eigenschaft ChangeLogActive auf aktiv. Ab diesem Zeitpunkt werden alle Änderungen an Datensätzen dieses Datenobjekts protokolliert.

Hinweis: Keine rückwirkende Protokollierung Das Änderungsprotokoll erfasst nur Änderungen, die nach der Aktivierung vorgenommen werden. Bereits bestehende Datenänderungen werden nicht nachträglich protokolliert.

3

Schritt 2: Protokollierte Felder konfigurieren

Standardmäßig werden alle Felder eines Datenobjekts protokolliert, sobald das Change Log aktiv ist. Sie können die Protokollierung jedoch pro Feld gezielt steuern:

Feld-Konfiguration öffnen
Öffnen Sie die Felddefinitionen des Datenobjekts im Admin Client.
Change-Log-Einstellung pro Feld festlegen
Für jedes Feld können Sie individuell bestimmen, ob Änderungen an diesem Feld protokolliert werden sollen. So vermeiden Sie unnötige Einträge bei häufig geänderten, aber unkritischen Feldern.

4

Schritt 3: Änderungen einsehen und filtern

Alle protokollierten Änderungen sind zentral einsehbar:

Änderungsprotokoll aufrufen
Navigieren Sie im Admin Client zum Bereich „Objektänderungsprotokoll“. Dort sehen Sie eine tabellarische Übersicht aller protokollierten Änderungen.
Einträge filtern
Die Liste zeigt folgende Spalten, nach denen Sie filtern und sortieren können:

Spalte	Beschreibung
Objekt	Name des betroffenen Datenobjekts (Entity)
Art	Änderungstyp: Erstellt, Geändert oder Gelöscht (`DataModificationType`)
PK Feldname	Name des Primärschlüsselfeldes zur Identifikation des Datensatzes
PK Wert	Wert des Primärschlüssels des betroffenen Datensatzes
Erstellt von	Benutzername der Person, die die Änderung durchgeführt hat
Erstellt Am	Zeitpunkt der Änderung (Datum und Uhrzeit)

Detail-Ansicht öffnen
Klicken Sie auf einen Eintrag, um die vollständigen Änderungsdetails einzusehen. In der Detail-Ansicht sehen Sie für jedes geänderte Feld den Feldnamen, den alten Wert und den neuen Wert.

Tipp: Gezielt nach Benutzer filtern Nutzen Sie den Spaltenfilter in „Erstellt von“, um alle Änderungen eines bestimmten Benutzers auf einen Blick zu sehen. In Kombination mit dem Zeitfilter lassen sich Änderungen präzise eingrenzen.

UserClient → Änderungsprotokoll: Filterleiste + Eintragsliste

Datum/Zeit	Benutzer	Datensatz	Feld	Alt → Neu
04.05.2026 09:42	mueller	Kunde Acme GmbH	Status	prospekt → aktiv
04.05.2026 08:15	schmidt	Teile A-1042	Preis	11,50 → 12,90 €
03.05.2026 17:03	weber	Kunde Beta AG	Branche	Logistik → Spedition
03.05.2026 14:21	mueller	Auftrag 2026-0411	Lieferdatum	15.05. → 22.05.
03.05.2026 11:08	system	Kunde Gamma KG	(neu angelegt)	— → erstellt

Detail-Popup: vollstaendiger Eintrag mit Pflicht-Kommentar

5

Schritt 4: Pflicht-Kommentare konfigurieren

Für besonders sensible Datenobjekte können Sie erzwingen, dass bei jeder Änderung ein Kommentar angegeben werden muss:

Eigenschaft ChangeLogMandatory aktivieren
Setzen Sie im Datenobjekt-Detail die Eigenschaft ChangeLogMandatory auf aktiv. Anwender müssen dann bei jeder Änderung einen Kommentar hinterlegen, bevor sie speichern können.

Dies ist besonders empfehlenswert für:

Vertrags- und Finanzdaten, bei denen jede Änderung begründet werden muss
Statusfelder mit Auswirkungen auf nachgelagerte Prozesse
Datenobjekte, die einer Revisionspflicht unterliegen

6

Einstellungen im Überblick

Einstellung	Ebene	Beschreibung
`ChangeLogActive`	Datenobjekt	Aktiviert die Protokollierung aller Änderungen für dieses Datenobjekt. Ohne diese Einstellung werden keine Änderungen erfasst.
`ChangeLogMandatory`	Datenobjekt	Erzwingt einen Pflicht-Kommentar bei jeder Änderung. Der Anwender kann ohne Begründung nicht speichern.
Feld-Protokollierung	Einzelnes Feld	Steuert pro Feld, ob Änderungen an diesem Feld im Protokoll erfasst werden. Ermöglicht die gezielte Reduktion des Protokollumfangs.

Achtung: Speichervolumen beachten Das Änderungsprotokoll wird dauerhaft in der Datenbank gespeichert. Bei Datenobjekten mit sehr vielen Datensätzen und häufigen Änderungen kann das Protokoll erheblich wachsen. Aktivieren Sie die Protokollierung daher gezielt nur für Datenobjekte, bei denen die Nachvollziehbarkeit tatsächlich erforderlich ist, und schränken Sie die protokollierten Felder sinnvoll ein.

Pflicht-Kommentare und Anwender-Akzeptanz Aktivieren Sie ChangeLogMandatory nur für Datenobjekte, bei denen eine Begründungspflicht fachlich gefordert ist. Bei Datenobjekten mit sehr häufigen, routinemäßigen Änderungen kann der Pflicht-Kommentar den Arbeitsfluss erheblich verlangsamen. Wägen Sie den Nutzen gegen die Auswirkung auf die Benutzerfreundlichkeit ab.

7

Häufige Fragen

Frage	Antwort
Wo finde ich das Änderungsprotokoll?	Im UDM Admin Client unter „Objektänderungsprotokoll“. Die Liste zeigt alle erfassten Änderungen mit Filter- und Sortieroptionen.
Werden Änderungen rückwirkend erfasst?	Nein. Das Protokoll erfasst nur Änderungen, die nach der Aktivierung von `ChangeLogActive` vorgenommen werden. Bereits bestehende Daten werden nicht nachträglich protokolliert.
Kann ich das Protokoll für einzelne Felder deaktivieren?	Ja. In der Felddefinition des Datenobjekts können Sie pro Feld steuern, ob Änderungen protokolliert werden. So reduzieren Sie den Umfang gezielt.
Was passiert, wenn `ChangeLogMandatory` aktiv ist?	Der Anwender wird beim Speichern aufgefordert, einen Kommentar zur Änderung einzugeben. Ohne Kommentar kann der Datensatz nicht gespeichert werden.
Kann ich Protokolleinträge löschen?	Nein. Protokolleinträge sind revisionssicher und können nicht manuell gelöscht werden. Dies gewährleistet die Nachvollziehbarkeit aller Änderungen.
Welche Änderungstypen werden erfasst?	Das Protokoll unterscheidet zwischen Erstellen, Ändern und Löschen von Datensätzen. Bei Änderungen werden die konkreten Feldwerte (alt und neu) mitprotokolliert.
Können Endanwender das Protokoll einsehen?	Das Objektänderungsprotokoll im Admin Client ist nur für Administratoren zugänglich. Endanwender sehen die Protokolldaten nicht, es sei denn, dies wird über eine eigene Ansicht konfiguriert.

8

Infotext-Feld

Beim Speichern eines Datensatzes kann jetzt ein erklärender Text zur Änderung hinterlegt werden. Dieser Kommentar erscheint später in der Änderungshistorie und hilft bei der Nachvollziehbarkeit — z. B. „Preis angepasst gemäß Vertragsverhandlung vom 15.03.“

Das Infotext-Feld ist optional und wird nur angezeigt, wenn die Funktion für das jeweilige Datenobjekt aktiviert ist.