60 lines
3.4 KiB
Markdown
60 lines
3.4 KiB
Markdown
# Global history
|
|
|
|
|
|
|
|
The global history form is an event log that shows important events that took place in AyaNova including User activity. While not a formal audit log, it does provide detailed information to help track down and resolve any unusual issues that might arise related to usage of AyaNova.
|
|
|
|
From this form you can also open the object(s) in question.
|
|
|
|
## Authorization Roles required
|
|
|
|
Many roles can _select_ this object on other records where approriate. Editing or viewing this object in detail is only available to Users with the following [roles](ay-biz-admin-roles.md):
|
|
|
|
Full access
|
|
|
|
- Business administration
|
|
|
|
Read only access
|
|
|
|
- Business administration - restricted
|
|
|
|
## How to access global history
|
|
|
|
From the `Administration` [navigation drawer](ay-start-form-overview.md#navigation-drawer) select `History` navigation item.
|
|
|
|
## How global history works
|
|
|
|
When an important event takes place in AyaNova, the server logs it to the database. This includes any modifications to business objects tracked in AyaNova as well as some other key events.
|
|
|
|
### business object events
|
|
|
|
Most events are related to changes to **"business objects"** in AyaNova, that is objects that are related to the business like a Customer or Work order, not the internal workings of AyaNova such as a select list or form template.
|
|
|
|
### data that is tracked
|
|
|
|
AyaNova tracks the timestamp of the event, the type of event, the type of business object and it's id if the event is related to a particular business object and the User who triggered the event.
|
|
|
|
### events that are tracked
|
|
|
|
- `Business object created`: user created and saved a new business object
|
|
- `Business object updated`: user modified and saved an existing business object
|
|
- `Business object retrieved`: user has opened the edit form for a business object
|
|
- `Business object deleted`: user has [deleted](#what-happens-when-i-delete-an-object) an existing business object
|
|
- `Attachment created`: user has [attached](ay-start-form-attachments.md) a file to a business object
|
|
- `Attachment retrieved`: user has downloaded a file [attached](ay-start-form-attachments.md) to a business object
|
|
- `Attachment modified`: user has modified the descriptive notes or name of a file [attached](ay-start-form-attachments.md) to a business object
|
|
- `Attachment deleted`: user has removed an [attached](ay-start-form-attachments.md) file from a business object
|
|
- `License updated`: AyaNova has installed a new replacement license key
|
|
- `Server state change`: AyaNova server has been put into an [alternative state](ops-server-state.md)
|
|
- `Seed database`: user has requested that the AyaNova database be overwritten with sample data for [evaluation](ay-evaluate.md)
|
|
- `Erase all data`: user has requested that the AyaNova database be erased and all data removed
|
|
- `Backup downloaded`: user has downloaded a copy of the [AyaNova backup](ops-form-backup.md) files
|
|
|
|
### What happens when I delete an object?
|
|
|
|
When an object is deleted, AyaNova will automatically remove all previous events for that object in the event log and insert one single final `Business object deleted` entry for that object indicating the User who deleted it and the date of deletion.
|
|
|
|
### how long is data retained?
|
|
|
|
Currently AyaNova keeps the global event log perpetually, it never gets pruned or deleted. A planned upcoming feature will allow for pruning the history log by date range on demand.
|