Entity Changes History
Audit log of all record changes: search changes by entity, request and type, view history cards with field differences and group by request.
The Entity Changes History is a system-wide audit log that makes every recorded change to records in X4fleet traceable. For each change, the timestamp, the type of change, the affected record, the responsible user and the triggering request are recorded. The page provides seamless traceability and helps to clarify who changed which value and when.
Note: The Entity Changes History is available exclusively to users with the Superadmin role.
1. Searching the Changes History
Search fields are available at the top of the page that allow you to specifically narrow down the audit log. The criteria can be used individually or in combination.
| Field | Description |
|---|---|
| Entity ID | Unique ID of the record whose changes are to be displayed |
| Entity type | Selection list of the record type (e.g. account, shipment, vehicle). Only traceable types are available for selection |
| Request ID | ID of the original request within which the changes were made |
To perform a search:
- Enter an Entity ID and/or select an Entity type from the selection list.
- Optionally, you can additionally specify a Request ID.
- Trigger the search.
The page then reloads and displays the changes matching the selected criteria.
Note: The names of the entity types in the selection list are displayed in the respective application language.
2. Keyword Filter for Changes
In addition to the server-side search, a keyword filter is available that allows you to immediately narrow down the change rows already displayed.
- Enter a search term in the filter field.
- As you type, all rows whose content does not contain the entered term are hidden.
The filter works without reloading the page and searches the visible text of the change rows. Capitalisation is not taken into account. To display all rows again, clear the filter field.
3. History Cards (Audit Trail)
The changes found are displayed as cards and grouped by affected record (combination of entity and entity type). Within a group, the changes are sorted in descending order by timestamp – the most recent change appears at the top.
Each card displays the following information:
| Information | Description |
|---|---|
| Entity type | Type of the changed record |
| Entity ID | Unique ID of the changed record |
| Changed by | User who made the change |
| Request ID | The triggering request (see section 5) |
| Timestamp | Date and time of the change in the standard date format |
A coloured marker on the edge of the card indicates the type of change: edits are displayed in the standard colour, all other types of change (e.g. creation) in green.
4. Field Differences (Old/New)
Within each history card, the specifically changed fields are listed in a table. This makes it easy to see at a glance which value changed and how.
| Column | Description |
|---|---|
| Field | Name of the changed field |
| Old value | Value before the change |
| New value | Value after the change |
Each row corresponds to a changed field. If several fields were adjusted within the same change, they are listed one below the other. These rows are also taken into account by the keyword filter (see section 2).
5. Request-Grouped Detail View
Individual operations frequently affect multiple records at the same time. Using the Request ID, you can trace which other changes were made within the same request.
- In a history card, click the displayed Request ID.
- A view opens in a new browser tab showing all changes made within this request.
In this way, related changes – such as an action that affects several records simultaneously – can be viewed in a bundled form.
6. Notes
- The Entity Changes History is a pure read and analysis tool; records cannot be edited here.
- Access is restricted to the Superadmin role.
- Only entity types intended for tracking changes are offered.