You can access the Page Settings via the ‘options wheel’ in the WebUI Menu Bar .
Currently, the following options for a page are available:
- Action Upon Load (for specifying a procedure that should be run upon opening the page)
- Action Upon Leave (for specifying a procedure that should be run before navigating to another page). The application developer can also run a procedure that can restrict page navigation based on certain conditions.
- Side Panel Settings (for configuring Side Panels via the string parameter on respective pages)
- A number of advanced options (not documented here).
Maximum Number of Columns¶
You may find that when you change your window size, the widgets re-arrange too often. A simple way to prevent this is to limit the maximum number of columns. You can do this via the ‘page settings’ icon just to the right of the page name. At the miscellaneous tab you can edit the maxcolumns setting. The maximum value that this setting can have, is 14 columns.
In the bottom right corner of the page you can find the “Page Actions” menu. It is used for the “Primary Action” and “Secondary Actions” and largely replaces buttons on the canvas. The position of the Page Actions is fixed in the bottom right and floats above all other elements of the page.
The reason behind the Page Actions is to have key actions easily available for the users and to reduce clutter on the pages.
The Primary Action is mainly used for actions that use the power of the AIMMS product. These actions are often called Optimize, Calculate or Solve and do mathematical calculations in some form. It is what separates AIMMS from your standard Business Intelligence application, and therefore features the AIMMS logo by default.
Each page can have only one Primary Action. If there is a need for more than one Primary Action, developers should first consider if this is beneficial to the user: often it is wise to focus on one key task per page. If more than one Primary Action per page is absolutely needed, only one should be considered the most important. Other Primary actions can be placed in Secondary Actions. There is no maximum to the number of Primary Action you can add, but we display the first Active (clickable) action. In case there are no Active actions, we display the first Inactive (not clickable) action as the Primary Action, with the associated style.
Besides the Primary Action, the Page Actions consist of “Secondary Action” buttons. These are buttons that serve important functions on the page, for example, “Commit Changes” or “Calculate Difference”.
Secondary Action buttons consist of a label and an icon that can be configured in the model. When there are multiple Secondary Actions on a page, they are grouped together in a button with a hamburger icon. This expands to reveal all page actions. There is no maximum to the number of Secondary Actions you can add, but we display the top 10 Active and/or Inactive ordered action buttons on a page. AIMMS advises using ideally no more than five.
Configuring Page Actions¶
The Page Actions can be configured by the application developer via the AIMMS model. In the Pages and Dialog Support section, the set PageActionSpecification is declared which is used for configuring Page Actions as illustrated in the next steps.
This set has 4 elements representing page action properties:
displayText: The Title/Label to be displayed for the action.
icon: The icon you want to associate with the respective action. You can select from a list of 1600+ icons, the reference can be found in the icon list . Custom icons can also be used if required.
procedure: The procedure to be called when the action is clicked.
state: The display state for the action, i.e. Active (displayed and clickable), Inactive (displayed and not clickable) and Hidden. By default, the state is Hidden.
Configuring the Primary Action¶
Create a string parameter indexed by PageActionSpecification. Let’s call this
MyPrimaryActions(webui::indexPageActionSpec). Right click the string parameter and click on the Data option to open the data page. Add the details for the Primary Action you would like to show for the respective page(s). For example:
The result of the illustrated example will be
By default, when the
displayText is not defined the Primary Action label will be “OPTIMIZE”. When the
icon is not defined the AIMMS logo will be displayed.
Configuring Secondary Actions¶
First, create a set for the order of actions to be displayed on the page. For illustration, let’s call this set “PageActionOrder” with index
indexPageActionOrder (as a developer, you can give this set a name and an index of your choice). This set determines the order in which the Secondary Actions will appear from top to bottom. This set must be a subset of the pre-declared set of Integers.
Create a string parameter indexed by PageActionOrder and PageActionSpecification. Let’s call this
MySecondaryActions(indexPageActionOrder,webui::indexPageActionSpec). Right click the string parameter and click on the Data option to open the data page. Add the details for the Secondary Actions you would like to show for the respective page(s). For example:
In the illustrated example, we have defined 5 Secondary Actions with different states. We display the Active and Inactive actions.
Configuring Actions on Pages¶
In the WebUI, navigate to the respective page. In the Page Settings under the WorkFlow Items you will find the Primary Action and Secondary Actions fields. Add the respective string parameters in the fields that were configured for that page.
Once you have added the string parameter, the respective page actions buttons will appear on that page.
Similarly, you can create other string parameters for other pages and configure them using the same steps.
The different combinations and possibilities with the states are illustrated below:
Default Primary Action
One Primary Action
One Secondary Action
Multiple Secondary Actions
Primary Action with one Secondary Action
Primary Action with multiple Secondary Actions
The labels for the Primary Action and single Secondary Action are shown when the user hovers the respective buttons.
Last Updated: October, 2019