Dialog Pages

This section describes various tasks related to WebUI Dialog Pages.

Important

Dialog pages are available from AIMMS 4.65 onwards. Note that starting from AIMMS 4.80, dialog grid pages are available as well, so please also check the section Dialog Grid Pages.

Dialog Pages are used for intermediate actions or steps in your workflow. You can create model interaction by calling dialog pages for the user to perform a specific action such as setting SLA’s or adjusting inventory etc. In addition, you can use Dialog pages to display information about a selected item without breaking the flow by calling the OpenDialogPage function. For example, to show the detailed properties of a scheduled batch.

Dialog pages appear as an overlay on top of content on other pages. They provide mainly two functions:

  1. Preventing users from continuing until some required action is performed. For example, a user has to fill in sales forecast data before being able to continue to forecast analysis. The main content is disabled until the interaction is done.

  2. Navigating along the “z-axis” i.e. diving deeper into the data. In this use case, a user clicks on a job in a Gantt Chart to view a dialog page with more information displayed about that job.

Especially in the first use case, the dialog page disrupts the user’s workflow and might cause them to lose track. Dialog pages should therefore be used for essential information only.

A dialog page has one of three predefined sizes: Small, Medium and Large. Dialog pages can have up to three buttons, two of which are shown by default, typically “Cancel” and “OK”. The text and callback procedures for these buttons can be controlled via the OpenDialogPage procedure.

When a dialog box is open, the user can interact with the dialog only. The dialog box can only be closed by clicking on one of the actions.

Adding a Dialog Page

Adding a dialog page is similar to adding a page or a side panel.

Click on the Insert Dialog page icon dialog and give it any name you desire. You cannot give a name that you have already used for other pages, side panels or dialog pages.

../_images/dialogpage_add.png

Dialog pages can be added at any level in the page tree, just like a normal page. Unlike Pages, Dialog pages do not appear in the Menu (navigation) and can only be accessed via the page manager. Dialog pages have the same options as a page or side panel, like Rename, Delete, etc. You can also move the dialog pages in the same way as regular pages can be moved.

Note

Avoid adding pages under dialog pages as such pages will not be shown in the navigation menu.

You can choose a size for the dialog page, the dimensions for which are:

  1. Small: Width = 3 Columns, Height = 2 Rows. Here you can fit widgets with dimensions that add up to 3 columns and 2 rows, e.g. 1 widget with a width of 3 columns or less and a height of 2 rows or less OR 2 widgets with a width of 3 columns or less and a height of 1 row.

    ../_images/dialog_diffsizes_small.png
  2. Medium: Width = 6 Columns, Height = 3 Rows. Here you can fit widgets with dimensions that add up to 6 columns and 3 rows.

    ../_images/dialog_diffsizes_medium.png
  3. Large: Width = 8 Columns, Height = 3 Rows . Here you can fit widgets with dimensions that add up to 8 columns and 3 rows.

    ../_images/dialog_diffsizes_large.png

The title and action buttons on the dialog page can be configured via the model. These are placeholders to depict how the actual dialog page will look. This also gives an idea of the usable area for adding widgets in the dialog page.

../_images/dialog_placeholders.png

Adding widgets to a Dialog Page

Adding widgets works the same for dialog pages as for regular pages or side panels.

Select a desired size by clicking on the respective button in the top right corner of the dialog page. Open the widget manager and add the widgets that you need.

../_images/dialogapge_selectsize.png

When the height of a widget exceeds the height of the dialog page, the widget will be clipped, as Dialog pages do not have a scroll bar. Pick a suitable size for the dialog page and the widgets you want to have on it. You can change the size of the dialog page any time in developer mode. The Small, Medium and Large buttons are not available to end users, so the sizes cannot be changed once the application is published.

../_images/dialogapge_widgetclipped.png ../_images/dialogapge_goodfit.png

Configuring Dialog Pages

You can use the procedure OpenDialogPage(pageId,title,actions,onDone) to invoke dialog pages on the desired page.

An example of the procedure with declarations would result in:

MyActions:= data { Decline, Accept };
pageId := 'dialog_page';
webui::OpenDialogPage(pageId, "Dialog Page Title", MyActions, 'Procedure_Actions');
../_images/dialog_procedurecall.png

The button names are assigned from left to right from the defined set. If the set has only one element, only one button will be displayed. A maximum of three buttons can be displayed. In case three buttons are shown, the style of the first two buttons are the same and the third is different.

../_images/dialog_1n3buttons.png

Interacting With Dialog Pages

When a Dialog page is open, the user can only interact with the widgets on the dialog page and with the dialog page itself. The dialog page can be closed only by clicking on one of the actions. The user can move/drag the dialog page around the page.

When one dialog page is open, another dialog page cannot be invoked from the open dialog.