Change log definition
In this table, operations and data changes to be logged are defined, according to the settings in the Log type field.
| Property | Value | Description |
|---|---|---|
| Database | System | This table is in the system (vbsys) database. |
| SQL name | ChLogDf | The table name in the database. |
| API identifier | changeLogDefinition | The API identifier used in GraphQL. |
| Table no. | 328 | The table number in the data model. |
The following fields exist in this table:
Changelog processing
Controls the user prompt dialog.
- Prompt for comment
- The user will be prompted for a mandatory comment when the action that triggers the logging is performed.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Changelog processing | Integer |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | ChLogPr | The database field name. |
| API identifier | changeLogProcessing | The API identifier used in GraphQL. |
| Number | 16469 |
Column no.
The field you want to log changes for.
If the Table no. field has a value, you can choose a column in the table from this field. You find the same column number in the field properties below the column descriptions in the online help.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | Column no. | Integer |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | ColNo | The database field name. |
| API identifier | columnNo | The API identifier used in GraphQL. |
| Number | 12885 |
Company no.
The company you want to log changes for.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | Company no. | Integer |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | FrmNo | The database field name. |
| API identifier | companyNo | The API identifier used in GraphQL. |
| Number | 13805 |
| To table | Purpose | From columns | To columns | Comments |
|---|---|---|---|---|
| Company | Company |
|
Copy to
The copy recipient of a change log e-mail. Enter one or more e-mail addresses separated by a semicolon.
The e-mail addresses are placed in the Copy to field in Microsoft Outlook, and logged changes are sent. The Send to field must already contain an e-mail address.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | E-mail address | Text (60) |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | CopyTo | The database field name. |
| API identifier | copyTo | The API identifier used in GraphQL. |
| Number | 12889 |
From value
Restrict the values that you want to log for the selected field. The field is used together with the To value field.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | Name | Text (80) |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | FrVal | The database field name. |
| API identifier | fromValue | The API identifier used in GraphQL. |
| Number | 13718 |
Layout gr. no.
The layout group you want to log changes for.
Only changes done by users in this layout group are logged. The same user can be included in several layout groups.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | Layout gr. no. | Integer |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | LtGrNo | The database field name. |
| API identifier | userGroupNo | The API identifier used in GraphQL. |
| Number | 12887 |
| To table | Purpose | From columns | To columns | Comments |
|---|---|---|---|---|
| Layout group | UserGroup |
|
Line no.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | No. | Integer |
| Primary key | Yes | Line no. |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | LnNo | The database field name. |
| API identifier | lineNo | The API identifier used in GraphQL. |
| Number | 12882 |
Log type
The operations that you want to log changes for.
This domain is used both for defining which changes to log and to specify the log records in the change log tables.
- 1 - Insert
- Logs when a value is entered in a field on a new record.
You must select the Table no. and Column no. to log.
- 2 - Update
- Logs when a value in a field is changed on an existing record.
You must select the Table no. and Column no. to log.
- 3 - Insert or update
- Logs when a value in a field is changed on any record (new or
existing).
You must select the Table no. and Column no. to log.
In the change logs the records from this value is show with value 1 - Insert or 2 - Update respectively.
- 4 - Deleting
- Logs when a record is deleted.
You must select the Table no. to log.
This value applies to an entire table record. If you want to log when the value in one field is deleted you must use the 2 - Update or 3 - Insert or update value.
- 5 - Processing
- Logs when a processing is executed.
You must select the Table no. and Processing no. to log.
The log will only include the changing of the field values if the fields are specified on separate records with value 1 - Insert, 2 - Update or 3 - Insert or update.
- 8 - Processed row
- Logs when a row is successfully processed.
This will log the processed row's primary key.
The From value and/or To value columns may be used with a value for the first primary key column, in order to restrict the logging to only rows that meet the condition.
- 6 - Access control
- Logs changing of all access levels in the System change log
table.
No other parameters are necessary.
- 7 - Import
- Logs when records are added using the Import
command on the Company menu.
You must select the Table no. to log.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | Log type | Integer |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | LogTp | The database field name. |
| API identifier | logType | The API identifier used in GraphQL. |
| Number | 12883 |
Processing no.
The processing you want to log changes for.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | Processing no. | Integer |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | ProcNo | The database field name. |
| API identifier | processingNo | The API identifier used in GraphQL. |
| Number | 12886 |
Send to
The recipient of a change log e-mail. Enter one or more e-mail addresses separated by a semicolon.
The e-mail addresses are placed in the Send to field in Microsoft Outlook, and logged changes are sent. One e-mail is sent for each deletion/change/process. The e-mail is not saved in the Sent folder.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | E-mail address | Text (60) |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | SendTo | The database field name. |
| API identifier | sendTo | The API identifier used in GraphQL. |
| Number | 12888 |
Table no.
The table you want to log changes for.
The field must be filled in for all log types except for Access Control type.
You can select a table by looking up in this field.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | Table no. | Integer |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | TabNo | The database field name. |
| API identifier | tableNo | The API identifier used in GraphQL. |
| Number | 12884 |
To value
Restrict the values that you want to log for the selected field. The field is used together with the From value field.
| Property | Value | Description |
|---|---|---|
| Visible by default | Yes | This field is visible by default in the table display. |
| Domain | Name | Text (80) |
| Write Access | System supervisor user | Only users who are marked as System supervisor in the User table are allowed to modify the value in this field. |
| SQL name | ToVal | The database field name. |
| API identifier | toValue | The API identifier used in GraphQL. |
| Number | 13719 |
Control columns
Control columns include information about who has changed the record last and when, and which process that is currently editing the record.
Changed by provenance
The provenance for the record change.
A look-up in this field gives you the following list of possible values:
0 - None
1 - UI
10 - External API
20 - GAiA
21 - AI Connect
100 - Internal service
101 - Task automation
102 - AutoInvoice download
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Provenance | Integer |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | ChPvn | The database field name. |
| API identifier | changedByProvenance | The API identifier used in GraphQL. |
| Number | A unique column number. |
Changed by user
The name of the user that changed the record.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | User name | Text (24) |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | ChUsr | The database field name. |
| API identifier | changedByUser | The API identifier used in GraphQL. |
| Number | A unique column number. |
Changed date
The date when the record was changed.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Date | Integer |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | ChDt | The database field name. |
| API identifier | changedDate | The API identifier used in GraphQL. |
| Number | A unique column number. |
Changed time
The time when the record was changed.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Time | Integer |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | ChTm | The database field name. |
| API identifier | changedTime | The API identifier used in GraphQL. |
| Number | A unique column number. |
Changed time stamp
The date and time when the record was changed.
The field is updated with the UTC time.
This value can be used by external systems to replicate changed data. The column is indexed.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Date/time | DateTime |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | ChTs | The database field name. |
| API identifier | changedTimestamp | The API identifier used in GraphQL. |
| Number | A unique column number. |
Created by provenance
The provenance for the record creation.
A look-up in this field gives you the following list of possible values:
0 - None
1 - UI
10 - External API
20 - GAiA
21 - AI Connect
100 - Internal service
101 - Task automation
102 - AutoInvoice download
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Provenance | Integer |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | CrePvn | The database field name. |
| API identifier | createdByProvenance | The API identifier used in GraphQL. |
| Number | A unique column number. |
Created by user
The name of the user that created the record.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | User name | Text (24) |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | CreUsr | The database field name. |
| API identifier | createdByUser | The API identifier used in GraphQL. |
| Number | A unique column number. |
Created date
The date when the record was created.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Date | Integer |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | CreDt | The database field name. |
| API identifier | createdDate | The API identifier used in GraphQL. |
| Number | A unique column number. |
Created time
The time when the record was created.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Time | Integer |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | CreTm | The database field name. |
| API identifier | createdTime | The API identifier used in GraphQL. |
| Number | A unique column number. |
Created time stamp
The date and time when the record was created.
The field is updated with the UTC time.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Date/time | DateTime |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | CreTs | The database field name. |
| API identifier | createdTimestamp | The API identifier used in GraphQL. |
| Number | A unique column number. |
Edit status
The current status of the record.
A look-up in this field gives you the following list of possible values:
0 - Unchanged: The record is read, but not changed.
1 - Inserted: The record is new.
2 - Changed: The record is changed.
3 - Deleted: The record is deleted.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Edit status | Integer |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | LckSt | The database field name. |
| API identifier | editStatus | The API identifier used in GraphQL. |
| Number | A unique column number. |
Process no
The Process no. from the Active company process table which is currently using or has control of this record.
| Property | Value | Description |
|---|---|---|
| Visible by default | No | This field is not visible by default in the table display. |
| Domain | Process no. | Integer |
| Write Access | None | You are not allowed to modify the value in this field. |
| SQL name | ChPrc | The database field name. |
| API identifier | lockedByProcessNo | The API identifier used in GraphQL. |
| Number | A unique column number. |
| To table | Purpose | From columns | To columns | Comments |
|---|---|---|---|---|
| Active company process | CompanyProcess | Process no. | Process no. |