Verfolgen Sie Änderungen und den Verlauf Ihrer Vertec Objekte mithilfe von AuditTrail.
Cloud Abo
On-Premises
Ab Vertec Version 6.8.0.19 gibt es die Möglichkeit, den Verlauf der Daten – also von der Erzeugung bis hin zur Löschung – zu verfolgen. Das Änderungsprotokoll, der sogenannte AuditTrail, wird automatisch geschrieben und ist in Vertec via Python Funktionen des Moduls vtcapp abrufbar.
So werden Änderungen an Objekten in Vertec transparent aufgezeichnet und es wird nachvollziehbar, wer wann welche Änderungen vorgenommen hat.
Unter Systemeinstellungen > Allgemein gibt es mit diesem Feature die Option Vollständiges Änderungsprotokoll führen. Wenn die Einstellung aktiv ist, wird ein vollständiges Änderungsprotokoll ausgegeben, das unter anderem Benutzerdaten sowie detaillierte Änderungen an Objekten enthält. Ist die Einstellung deaktiviert, wird eine gekürzte Form des Änderungsprotokolls ausgegeben, bei der weder konkrete Änderungen noch Benutzerdaten gespeichert werden. Es wird lediglich festgehalten, dass ein Objekt angelegt, geändert oder gelöscht wurde.
Die Daten werden via Python abgefragt. Bitte beachten Sie, dass jede Person, die eine der Python Funktionen aufrufen kann, mit dieser Einstellung die vollständigen Daten als Rückgabewert erhält. Es gibt also keine zusätzlichen Einschränkungen. Daher sollten Sie diese Einstellung entsprechend Ihren Datenschutzanforderungen bewusst vornehmen.
Im AuditTrail werden grundsätzlich alle Änderungen an Objekten in Vertec geloggt, je nach Systemeinstellung in unterschiedlichem Detaillierungsgrad.
Nicht berücksichtigt werden Änderungen an Objekten der Klassen:
Auch folgende Members werden nicht extra geschrieben, da diese jeweils identisch sind mit dem Zeitpunkt des AuditTrail Eintrags:
Der AuditTrail kann auch dazu verwendet werden, Notizen zu schreiben. So könnte beispielsweise eine Notiz geschrieben werden, wenn ein User eine bestimmte Funktion aufruft.
Dafür gibt es folgende Python Funktionen:
| Funktion | Beschreibung | Beispiel |
|---|---|---|
vtcapp.createauditnote(obj, text: String) |
Erzeugt eine Notiz mit dem angegebenen Text auf dem übergebenen Objekt. |
vtcapp.createauditnote(argobject, "Meine Notiz")
|
vtcapp.getauditnotes(objid: int): list of notes |
Mit dieser Methode werden die Notizen ausgegeben, die auf dem übergebenen Objekt angelegt wurden. Zudem erscheinen die Notizen auch bei der Abfrage des AuditTrails via |
notes = vtcapp.getauditnotes(argobject.objid)
|
Der AuditTrail kann mit folgenden Vertec Python Funktionen abgefragt werden:
| Funktion | Beschreibung | Beispiel |
|---|---|---|
vtcapp.getchangelogforobject(objid: int[, changesSince: datetime]): dict of changelogs |
Mit dieser Methode werden Changelog Einträge für ein bestimmtes Objekt ausgegeben. Dazu wird die Interne ID des Objekts und optional der Zeitpunkt zum Filtern übergeben. |
vtcapp.getchangelogforobject(argobject.objid))
|
vtcapp.getchangelogsince(changesSince: datetime[, classfilter: stringlist]): dict of changelogs |
Mit dieser Methode werden alle Changelog Einträge ausgegeben, die seit dem übergebenen Zeitpunkt angelegt wurden. Optional kann ein Filter der Klassen in Form einer durch Komma separierten Liste übergeben werden. Die Klassennamen können auf Englisch oder Deutsch angegeben werden. Basisklassen werden unterstützt (z.B. werden bei der Angabe von Leistung sowohl OffeneLeistung als auch VerrechneteLeistung berücksichtigt). |
import datetime vtcapp.getchangelogsince(datetime.datetime(2026, 4, 27), ["Project"]) |
Die Python Funktionen liefern eine Liste von Python Dictionaries zurück. Jeder Dictionary enthält eine einzelne Änderung mit folgenden Angaben:
[{'Id': 7017, 'BoldId': 2771, 'UserId': 515, 'BoldType': 18,
'AuditType': 'Modified', 'Member': 'type', 'TimeStamp': datetime.datetime(2026, 4, 27, 20, 14, 37),
'NewValue': '183'}]
| Spalte | Beschreibung |
|---|---|
Id |
Die Identifikationsnummer des Vertec Objekts. |
BoldId |
Die eindeutige Interne Identifikationsnummer (Interne ID) des Vertec Objekts (siehe auch KB Artikel Der Eigenschaften-Dialog). |
UserId |
Die Identifikationsnummer des Benutzers, der die Änderung ausgeführt hat. |
BoldType |
Die Identifikationsnummer des Typs des Vertec Objekts. |
AuditType |
Die Änderungen an Vertec Objekten werden durch folgende Auditeinträge vermerkt:
*Hinweis: Der Status Note wird nur vergeben, wenn die Notiz über die Python Funktion vtcapp.createauditnote() geschrieben wird. |
Member |
Der Name des geänderten Attributs, also ein Datenfeld des Objekts oder eine Verknüpfung. |
TimeStamp |
Datums- und Zeitangabe der Änderung. |
NewValue |
Der geänderte bzw. neue Wert. Beim Datentyptyp Blob werden maximal 4000 Zeichen ausgegeben. |
Bei einem gekürzten Änderungprotokoll werden die Informationen UserId, Member und NewValue nicht gespeichert.