Modules

Introduction

A module defines how the application is presented to the end user when starting the application.

Normally an application contains a single module, which is automatically created when the application itself is first created. See illustration below.

It is also possible to have multiple modules in an application.

Modules dialog

In the Modules dialog, you can add new modules. You can also change the name and description of existing modules.

Follow these steps to display the Modules dialog.

Step	Action
1	Click on the logo icon in your app development environment.
2	Select Modules....

The Modules dialog is displayed. See illustration below.

The Name and Description entered in the Modules dialog are displayed on the end user’s application page. The Application Code is used in the URL for end users and developers. See illustration below.

The Code,Name,Description, and the image of a module can be changed within an application in the Modules dialog.

Important:

Changing the application code of the module has implications for releasing the app. If a code is changed, there will be no generated cache for the new application code. This means that after activating the release, it will not be accessible by end users until a new cache is generated.

Additionally, all user rights are linked to the application code and will need to be set up again.

Furthermore, changing the module code will break existing end-user Favorites.

Before making changes to the application code of a module, discuss the implications with your Application Manager.

Adding Modules

An app can contain multiple modules. These modules can be used to change the behavior of an app based on, for example, user roles such as an analyst versus a monitoring user. Dashboards with a role-specific purpose can be made visible or invisible depending on the module code of the user that is currently logged in. Alternatively, modules can be used to e.g. split data based on areas of responsibility. In this case, the module code can be used to filter data in the connection strings. Modules can be added to an app in the Modules dialog.

Use Modules in an App

The current module that is active in an app can be used in expressions.

Follow these steps to be able to use the current module in an app.

Step	Action
1	Go to the Data tab in your app development environment.
2	Right click in the Table list and select New table - System table….
3	Double click on New_Table.
4	Select Current user as the Table scope and click on OK.
5	Click on OK.
6	Click YES to refresh the data.
7	Click YES to add the new attributes.

New_Table contains an attribute ApplicationCode with the module code of the active module. This attribute can be used in e.g. join expressions to filter records, so they are only available for a specific module.