Configuring Interfaces in ELMA Designer

Attention!

This feature is available in ELMA 3.8.0 and higher.

Usually, pages and portlets are created in Web Application. However, if you need to implement a more complex logic for pages and portlets, use the Interface tab in ELMA Designer. This feature also allows adding pages and portlets to BPM Apps (you cannot add pages and portlets, created in Web Application).

You can work with user portlets and pages on the Interface tab in ELMA Designer (fig. 1).

ELMA page is the central part of the ELMA window. It usually includes portlets.

Portlet is a plug-in component of the user interface in ELMA Web Application.

By default, this tab has no portlets and pages (fig. 1).

Fig. 1. ELMA Designer. Interface tab

The work pane displays all the information on the Interface tab (fig. 2).

Fig. 2. ELMA Designer. Interface tab. Work pane

By default, this tab displays two empty folders: Portlets and Pages, with the

icon. The portlets and pages you create are automatically added to these folders. Portlets have the

icon, and pages have the

icon. You can create sub-folders in each folder, which allows grouping portlets and pages.

If a group is collapsed, it has the

icon, if expanded, it has the

icon. To collapse/expand a group, click the icon to the left of the group.

The list of user portlets and pages is also displayed on the Forms List panel. By default the panel is collapsed (fig. 1). To expand it, place the mouse cursor over it (fig 3).

Fig. 3. ELMA Designer. Interface tab. Left panel

The panel includes two units: Pages and Portlets.

Double click a page or a portlet, to open the modeling form.

Toolbar

	Click Add or to open a drop down menu, which allows creating: a new page; a new portlet; a new group.
	Click Edit to open the modeling form of the selected page or portlet.
	Click Delete to delete a page or a portlet and confirm deleting in the opened dialog box.

If the Pages and Portlets folders are empty, the Edit and Delete buttons are not available. You cannot delete these folders.

Creating a page/portlet

To create a page or a portlet, click Add or

and select one of the drop down menu items. Fill in the required fields in the opened window (fig. 4) and click OK. The dialog box for creating a page is similar (fig. 5).

Fig. 4 ELMA Designer. Portlet creation window

Fig. 5 ELMA Designer. Page creation window

Displayed Name * - portlet/page name, which will be displayed in the list. The field is required.

ID * - portlet/page unique identifier. It is generated automatically, when you fill in the Displayed Name* field. This field is required.

Icon - add an icon to the portlet. You can select an icon from ELMA server or from the local PC.

Group – folder, which will store the created portlet/page.

Description – brief information on the created page/portlet.

Click ОК to open the modeling form of the portlet/page. Modeling a portlet/page is similar to modeling forms in the Form Builder. To learn more, see the respective Help section.

Fig. 6 ELMA Designer. Configuring a page

Attention!

To apply changes and be able to work with the created portlet/page in Web Application, publish the created portlet/page and restart the server.

You can add the portlets and pages, created in ELMA Designer, to ELMA Web Application. You can change the set and location of portlets in the page settings, and select the information they display in the portlet settings. You can also add the created portlets and pages to BPM App at step 8 of creating a BPM App.

You can configure pages in Administration – Portal Settings – Pages. To learn more, see the respective Help section.

Searching in the list of pages and portlets

You can search in the list of reports on the Interface tab of ELMA Designer. The search in this section is similar to the search in the process list.