There are two buttons setup by default in the Komment object:
Submit
: Used to commit user inputs and trigger a saving action.
Clear
: Used to clear the input in the Komment object.
You have the option to add two additional buttons:
Add:
This will enable users to add new records to the data using Komment
Remove:
This will enable users to remove records from the Komment table
You find the button settings in the Button Settings section:
Label
: Provide your own label to be displayed to end users
Button Type
: Select Submit
, Clear
, Add
or Remove
Do Partial Reload:
Toggle Yes/No (default is Yes)
Confirm before Reload:
Toggle Yes/No (default is No). Activates a dialogue when pressing submit.
Confirmation header:
Define the header of the dialogue shown to end user.
Confirmation message:
Define the message of the dialogue shown to end user.
When you have defined the Add
button in the setup it is very easy for users to add new records to the data:
Behind the scenes Komment will generate a new record with an auto-generated ID. If you wish to let the user decide on an ID to add and show but still keep a unique ID saved each time you can use the below method:
1. Load script:
Add a new ID field to your Fact table
2. In the Komment object:
Include both ID fields as widgets
Hide the original ID field
The newly created ID field 'DriverID' should be shown
The Add form will then show the DriverID and not the original ID
After adding a record the Komment table and related audit trail will look like this:
Depending on which Mode you have Komment set to, there are different ways of how to use the Remove
button.
Table Mode:
Here you enable the remove functionality by pressing Batch Edit
=> Select the records you want to remove => press Edit
=> press Remove
Form Mode:
In Form mode the remove button is directly visible to the user.
Popup Mode: In Popup mode the remove action can be performed directly by pressing the trash can icon on the button.
When removing records the records are not actually deleted. Instead Komment handle the status of each record by introducing a _state
field. The _state
field can take three values:
modified
removed
new
This field is saved with each data entry or record removal and is available in the stored Komment table along with the CreatedBy
and CreatedAt
fields.