Buttons

Buttons trigger Actions when they are pressed.

Control properties

• Disable control? - Makes the Form Control editable (No) or read-only (Yes). Be aware that the content of read-only Form Controls is not stored by Save and Sign and Save Actions in the linked Attribute.
• Hide control? - Hides (Yes) or shows (No) the Form Control in the Form. Be aware that the content of hidden Form Controls is stored by Save and Sign and Save Actions in the linked Attribute.
• Condition type - Allows you to hide or disable the Form Control based on a Form Control Expression evaluating to true or false:
  • Display - Hides the Form Control when the Form Control Expression evaluates to false and shows it when the Form Control Expression evaluates to true. Be aware that the content of hidden Form Controls is stored by Save and Sign and Save Actions in the linked Attribute.
  • Disable - Makes the Form Control editable when the Form Control Expression evaluates to false and makes it read-only when the Form Control Expression evaluates to true. Be aware that the content of read-only Form Controls is not stored by Save and Sign and Save Actions in the linked Attribute.
  • Display condition or Disable condition - The Form Control Expression behind the condition
• Buttons - Here the Buttons are added and configured:
  • Add button - Creates a new Button
  • … - Configure the Button and its Actions:
    • Label - Name on the Button representing the Action
    • Outcome - When the Action is triggered the Outcome selected here is used to leave the Form Activity. If multiple Outcomes with the same name exist, all of them are used and the execution of the Instance continuous in parallel.
    • Action - Specifies the triggered Action type:
      • Discard - Discards all modifications of the Form Controls.
      • Save - Stores the data from the Form Controls in the Variable backing the Form Activity. The Variable is set in the Variable configuration of the Form Activity.
      • Sign - Stores only the signature in the specified Attribute.
      • Sign and Save - This is a combination of Sign and Save. It stores the signature in the specified Attribute and stores data from the Form Controls in the Variable backing the Form Activity.
    • Style - Only available, if the Action is linked to a Button. Then, this property sets the color of the Button representing the Action.
    • User attribute - Specifies in which Attribute the Id of the User triggering the Action will be stored. The Attribute has to be selected from the Variable backing the From. The Attribute needs to be of type Big Integer if only one User can complete the From or has to be an array of Big Integer, if the property Must all owners complete the task? is set for this Action and all owners are required to complete the Form.
    • User group permissions - Only Users in the User Groups specified here can trigger the Action. All Users not in the specified User Groups will not see the Button. If no User Groups are specified, all Users in any User Groups will see and can trigger the Action. User Groups can be added by pressing Add user groups and removed by pressing .
    • Return to dashboard? - When set to Yes, the User will be send back to the main Dashboard by this Action regardless if there are any further Forms to show or not. When set to No, the User will be presented with the next Form. When there are no further Forms left in the Instance, the User will be send back to the main Dashboard in any case.
    • Skip form validations? - When set to Yes, any validation rules configured at the Form Controls are ignored. This might be desirable for Discard Actions. When set to No, all validation rules configured at the Form Controls are enforced.
    • Claims ownership of task? - When set to Yes, only the User triggering the Action will remain the owner of the From and all other Users or User Groups will be relieved of their owner status. When set to No, the owner configuration is unmodified.
    • Must all owners complete the task? - Specifies if one owner can trigger the leaving of the Form by this Action (No) or if all owners have to individually trigger this Action (Yes) to leave the Form and continue the Instance. When set to Yes, the following logic applies:
      • All Users set individually by their Id as owners have to trigger the Action separately
      • One User per configured User Group has to trigger the Action
      • The triggering of the Action by Users who are in more than one User Group is counted for all User Groups simultaneously. I.e., it is not necessary for Users to trigger the Action multiple times if they are part of more than one User Groups configured as owners.
      • When Must all owners complete the task? is set to Yes, special care must be giving in the configuration of the other Actions:
        • Only one Action of a From is allowed to be set to Yes. Otherwise, deadlocks are created when individual Users choose different Actions.
        • Usually only read-only Forms require the completion by multiple owners. If the Form is not read-only, one User can complete it, then another use can modify it without the first User noticing it. However, comment fields are often an exception to this read-only rule.
        • The Attributes configured at Signature attribute and User attribute have to be arrays.
    • Reset approval of all owners - Triggering this Action resets other Actions (Yes) or leaves other Actions unchanged (No) when the Form Activity is entered again in the same Instance. This property is particular important, when Must all owners complete the task? is used:
      • In the case that some, but not all of the Owners, trigger an Action which has Must all owners complete the task? set to Yes and the remaining Owners trigger another Actions, the Instance leaves the Form Activity and continues the execution of the Instance.
      • If this continuation leads the Instance back to the same Form Activity, the Novunex Platform still remembers that some Owners already triggered the Action which has Must all owners complete the task? set to Yes.
      • If this is not desired, Reset approval of all owners needs to be set to Yes, so that the Novunex Platform resets all previously triggered Actions, when a From Activity is re-entered in the same Instance.
    • Show comment field - Shows (Yes) or hides (No) a comment field. When the filed is shown, the Users can write a free-text comment in it.
    • Signature attribute - This property is only available for Sign and Sign and Save Actions and sets in which Attribute of the Variable backing the Form the Signature is stored. The Attribute needs to be of type Signature if only one User can complete the From. It has to be an array of Signature, if the property Must all owners complete the task? is set to Yes and all Owners are required to complete the Form.
    • Require confirmation? - If set to Yes, the Users will be presented with an additional confirmation dialog when they trigger the Action. The dialog will present the message entered in the Confirmation message field that appears when you set Require confirmation? to Yes. If set to No, no confirmation dialog is shown to the Users and the field Confirmation message is also not shown.
  • - Delete Button