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:

Reset and Clear buttons

Settings

You find the button settings in the Button Settings section:

Button settings

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:

Add new records

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

Add two ID fields
  • Hide the original ID field

Hide ID field
  • The newly created ID field 'DriverID' should be shown

Show DriverID
  • The Add form will then show the DriverID and not the original ID

Add form only shows one ID
  • After adding a record the Komment table and related audit trail will look like this:

Table and audit trail after addition of new record (DriverID = 0)

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

Remove in Table mode

Form Mode: In Form mode the remove button is directly visible to the user.

Remove in Form Mode

โ€‹

Popup Mode: In Popup mode the remove action can be performed directly by pressing the trash can icon on the button.

Remove in Popup Mode

State

When removing records the records are not actually deleted. Instead Komment handle the status of each record by introducing a _statefield. 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.

โ€‹