Help ELMA BPM Platform
×
Menu

"Button" Element

You can place the Button element both inside different form elements (tabs, panelstext, etc.) and on an empty panel. You cannot place other elements and properties inside the Button element. To learn more about placing elements on the form, see the respective Help section.
A Button can contain a text or an icon and have various appearance styles. When you add several buttons and/or static texts to a column in the Designer, they are displayed in a column in Web Application; when you add buttons to other form elements (panel, tab, string), they are displayed in a row.
Fig. 1. Display of buttons in Web Application
When clicking a button:
When you add a Button to a form, its settings dialog box opens automatically (fig. 2):
Fig. 2. Dialog box for configuring the Button element. Common tab
This dialog box consists of four tabs – Common, Additional, System and Show.
 

Common tab

This tab is shown in fig. 2.
The Common tab includes the following fields:
Text * – name of the button that will be displayed on the form in Web Application. This field is required only if script is selected as the button action.
Icon * – add an icon that will be displayed on the form next to the button name (if there is one). You can add an icon both from ELMA server and from your computer. To select an icon, click Select icon on the server or Load Icon. This field is required only if script is selected as the button action. By default, when adding a form, the icon is displayed
Link – select the required action from the ELMA action registry or an object form. To select an action or a form, click Select Link and chose an element in the opened dialog box.
Script * – select a script. Click Add Script. The field will change (fig. 3). In the drop down list you can select an existing script, or create a new one using the Create button. This field is required only if the Link field is empty.
Fig. 3. Dialog box for configuring the Button element. Script field
You cannot specify both a link and a script in the button settings. If you select a link, you will not be able to select a script and vice versa (fig. 4).
Fig. 4. Dialog box for configuring the Button element
To create a button with a script, you also need to fill in the Text and Icon fields. For buttons with a link or a form, these fields are not required, since a link already contains a name and an icon (fig. 5) and for a form the "Open Form" text and the standard button are added.
Tooltip — the text, that will be displayed when you mouse over the button.
Show as – this parameter defines how the button will be displayed:
On the read only form (fig. 5) – this parameter defines if this button can be displayed on the Read only form (including after completing a process task).
Attention!
This feature is available only in ELMA 3.13.2 and higher.
Fig. 5. Settings of the Button element. “On the read only form” field
Fig. 6 shows different ways of how a button can be displayed on a form. The Scheduler button is Active, the Calendar button is Inactive, the Folders button is Hidden.
Fig. 6. Button display variants
Style – this parameter (fig. 7) allows you to select a color that will be used for the button in Web Application. By default, light-grey is selected (fig. 5, 6). From the drop down list, you can select one of the following colors:
Fig. 7. Button element settings. Style field
In Web Application, buttons of different colors will look like this (fig. 8):
Fig. 8. Buttons of different colors in Web Application
Minimum width – this parameter allows specifying the minimum width of the button in Web Application (in pixels). The minimum possible width is 50 pixels.
Possible options of buttons display in Web Application are shown in fig. 9.
Fig. 9. Various styles of the Button element in Web Application

Additional and System tabs

These tabs are the same as for the Column element.
Show tab
This tab contains settings of the button display in the web interface (fig. 10).
Hide on the main form – if this box is checked, the button will not be available on the main form, which you are editing at the moment.
Hide in pop-ups – if this box is checked, the button will be hidden in case the form is intended for a pop-up window.
Fig. 10. Button settings window. Show tab

Copyright © 2006–2019 ELMA