Buttons
This section describes how buttons can be configured in Komment
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 current user has entered but not saved yet.
You have the option to add three 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
Reset:
This will reset the content of all widgets for the chosen record. i.e. as if no data had ever been entered into any of the widgets. This functionality is available in Form and Popup modes.
Below is a small GIF showing how Reset and Clear buttons work:
Settings
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
, Remove
or Reset
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.
Add/Remove
Add
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:
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:
Remove
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.
State
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.
Last updated