Application Management

Important

The application management features described in this section are available starting from AIMMS version 4.78 as part of Experimental Features. Please visit the Experimental Features page on how to enable the feature.

With the introduction of application management features, the Page Manager not only renders the page tree structure of your WebUI, but it also renders beneath each page the list of widgets belonging to that page. This allows the WebUI developer to manage the application contents by moving things around in this extended tree structure offered now by the Page Manager.

The various operations for application management available to the WebUI developer are described below using illustrations based on the TransNet appplication example, see our WebUI Tutorial section.

The list of available pages in the WebUI is shown when pressing the ‘hamburger’ icon page-manager on the top left position of your browser window. The Page Manager will open rendering the page tree structure. You can expand a subtree by clicking on the ‘arrow’ “>” in front of a parent page and you can collapse it by clicking on the “v” in front of a parent page. In our example, we start with a single Home page with a number of widgets on it:

../_images/AppManag_PageManager_1.png

Note that, unlike pages or sub-pages, the widgets listed underneath a page do not have an icon at the left of their names.

Next, we will create a new page, say Input Data, on the same level as the Home page in the tree. We can do this by using the options for adding new pages from the menu at the right of the Main Project node situated at the top of the tree:

../_images/AppManag_AddingPage_1.png

Suppose we would like to place all the widgets related to input data on the newly created Input Data page. Starting with the InputLabel widget, one can simply drag-and-drop this widget in the tree from the initial location underneath the Home page to its new location underneath the Input Data page:

../_images/AppManag_DragAndDrop_2.png

Note

Note that the drop location during the drag-and-drop operation is marked by a coloured line in the tree. The starting poing of such a line (at its left side) indicates the intended location in the tree structure. A red line (see above) indicates that the intended drop location is not applicable, whereas a blue line (see above) indicates that the location is allowed and the node may be dropped there.

With the introduction of application management features, this way of working not only applies to widget nodes in the tree, but also to page nodes in the tree and it complements the drag-and-drop feature described in the section Moving a Page.

Note

Note that a parent page which has its subtree expanded may not be moved by using drag-and-drop. So, its subtree must be collapsed first, before moving the parent page (including its subtree) to a different location in the overall tree.

Clearly, the drag-and-drop operation in our example at hand will have the effect that the InputLabel widget won’t be rendered any more on the Home page, but it will become present on the Input Data page, instead.

Next, one can copy the SupplyData widget using the menu at its right and paste it on the Input data page by using the menu at the right of this page:

../_images/AppManag_CopyPaste_1.png

At this point, it can be noticed that, besides the Paste Widget option (and the options for adding a sub-page), the menu at the right of a page also offers options to rename the page, to change visibility of the page, or to delete the page from the tree.

The copy-pasted widget is named automatically as SupplyData(1). By using the option to rename from the menu at the right of this widget, the name may be changed, for example into Supply_Data:

../_images/AppManag_RenamingWidget_1.png

When a widget is no longer needed on a page, it may be removed by using the option to delete from the menu at the right of the widget, as is the case with the SupplyData widget on the Home page:

../_images/AppManag_DeletingWidget_1.png

The deletion must be confirmed in the corresponding pop-up dialog which appears before the operation is completed (as shown above).

Of course, it is equally possible to cut-and-paste a widget in one go as illustrated below for the DemandData widget:

../_images/AppManag_CutAndPaste_1.png

The cut-and-paste operation can be repeated for each widget which should be moved to a different page in the tree. In our example, after performing cut-and-paste also for the widgets UnitCostData, InitializeInput, and ModifyUnitCost (and maybe renaming the pasted widgets), the page tree would like in the following picture:

../_images/AppManag_PM_30.jpg

When we additionally move the Page Actions from the Home Page to the Input Data page (using the Page Settings on either page), the newly created Input Data page in the WebUI will look as follows:

../_images/AppManag_InputDataPage_1.jpg

Note

Note that the order or the positioning of the widgets on a page is determined as follows:

In this example at hand, we can use similar actions as those illustrated above in order to create two new page, say Optimization and Output Data, and move the correspoding widgets from the Home page to these newly created pages, such that the page tree looks like in the following picture:

../_images/AppManag_PM_40.jpg

In this case, the Optimization and Output Data pages will look as follows in the WebUI:

../_images/AppManag_OptimizationPage_1.jpg ../_images/AppManag_OutputPage_1.jpg

To summarize, this section illustrated how the application management features facilitate the (re-)structuring of the page tree in the WebUI and allow for moving widgets around between the various WebUI pages.