UI actions are buttons, links, and context menu items on forms and lists. They allow customizing the UI to be more interactive, adjustable, and comfortable for working.
UI action inheritance and override
In SimpleOne you can inherit the UI actions and then override their logic, order, name or any other feature.
The system provides Ui Actions inheritance with the Inherits option. When a UI action has a Table specified, and the Inherits option is defined with TRUE, the system applies this UI action to all children tables of the one specified before.
To child UI actions, the reference Parent option defines an ancestor UI action which functionality options may be overriden if you need it.
Inheritance rules:
- The following UI actions are applied to forms and lists:
- Ui actions inherited and not overrided by the Overides by option on the current level of inheritance.
- The overrided on the current level functionality of the UI actions inherited.
- UI actions specified on the current level.
- A UI action inherited on the 1st level with the override functionality specified on the 2nd level cannot be applied on the 3rd level of inheritance. An inherited UI action specified on the 2nd level may be applied to the 3rd one.
- A UI action inherited on the 1st level with the override functionality specified on the 3rd level cannot be overrided on the 2nd level. In this case, the system warns of active override option and requires for its deactivation.
To inherite a UI action, complete the steps below:
- Make a UI action parent by set the Inherits checkbox active, and clicking Save.
- Make a UI action child by specifying the Parent field with the UI action you want, then customizing the record. Click Save to apply changes.
To override a UI action, complete the steps below:
- Open the child UI Action form.
- In the Overrides by field, specify a parent UI Action that should be override.
Role required: admin.
UI actions types
- Form button;
- Form header button;
- Form bottom button;
- Form context menu;
- Form link;
- List banner button;
- List bottom button;
- List context menu;
- List choice;
- Dependency map context menu.
UI actions on form
UI actions on list
UI actions customizing
You can create new or customize existing UI actions.
To do this, please complete the following steps:
- Navigate to System Definitions → UI Actions.
- Click New or select existing UI-action.
- Customize UI-action using the form provided.
- Click Save.
Embed a UI Action
UI action functionality allows creating embedded items for burger menu within forms and lists. multi-level submenu options
This option is only available for UI actions of the Form context menu and List burger menu types.
To embed a UI action, follow the steps below:
- Create a parent UI action specifying its type with the Form context menu or List burger menu checkboxes on the Position and Style tab.
- Click Save and Exit to leave the form.
- Create a child UI action of the same type specifying its Parent option with Ui action created before.
- (Optional) Set the Inherits option active.
- Click Save to apply changes.
Display condition configuration
Use logical operators &&, || for making the condition expressions.
A UI Action form description
| Field | Description |
|---|---|
| Name | UI action name. It specifies a text displayed on the button, link or as a context menu item. |
| Table | A table to display UI action on. A form or a list or a context menu should be used. |
| Comments | UI action brief description. |
| Active | Mark this checkbox to display the UI-action is displayed on form (list, context menu). |
| Inherits | When set to TRUE, this UI action is propagated to all the tables that are a child for the table specified in the table field. |
| Overrides by | This field is specifying UI action which will be overridden by current UI action. |
| Order | The displaying order. If there are over one UI-actions of the same type, then they will be arranged in ascending order. |
| Parent | Specify the context menu item to be a parent for the current UI action (applicable for the Form context menu UI action type). |
| Conditions and Actions | |
| Show insert | When set to TRUE, this UI action is displayed on a new record insert form; otherwise, it is not displayed. |
| Show update | When set to TRUE, this UI action is displayed on an existing record form; otherwise, it is not displayed. |
| Wait server response | When set to TRUE, the system will wait for the server response after clicking the button. The button will be disabled until the server responds. |
| Client | When set to TRUE, client-side API is available in the Script field; otherwise, server-side API is available. |
| Condition | A condition written using server-side API; if this condition will be met then the Script will be executed. |
| Script | The script that will be executed by clicking the UI action. |
| URL | This URL will be followed after clicking the UI action. You can use variables listed below there:
|
| Position and Style | |
| Form style | Button style on the form:
|
| Form bottom button | Button at the bottom of the form. |
| Form button | Button in the form header on the right. |
| Form context menu | Context menu item on the form. |
| Form header button | Button in the form header on the left. |
| Form link | Link on the form. |
| Form field label context menu | An item of the context menu for the fields on the form. |
| List style | List button style defining (similar to Form style). |
| List banner button | Button in the list header on the left. |
| List bottom button | Button at the bottom of the list. |
| List burger menu | A burger menu item on the list. |
| List choice | Menu item for actions applicable to list entries. |
| List header right button | Button in the list header on the right. |
| List link | Link on the bottom of the list. |
| List table header context menu | A context menu item for the elements of the list. |
| List context menu | Context menu item on the list. |
| Button context menu | A context menu item for UI actions of the button type. |
| Dependency map context menu | Menu item on the service model form. |
