Simulator

Availability of the functionality depends on the license and may not be available in all implementations.

Thanks to the application simulator, we can open a form with parameters defined by us:

• selected environment,

• user identifier,

• specific input parameters,

• selected channel: App (RWD), Native, IB inline, IB popup, or in a new browser tab.

In the App and Native channels, it is also possible to specify a specific device for simulation. Additionally, for Native, API calls are displayed for the given application.

Launching the application simulator

To launch the application simulator, select the option Simulator.

Setting input parameters

The form at the top of the module allows you to launch the application with selected parameters.

1. Button showing/hiding the input parameters form.

2. Environment - environment on which the tested application is located.

3. Application - name of the tested application; if the value is empty, the simulator will display a list of available applications (for App, Native, New Tab channels) or the default, predefined application (for IB inline and IB popup channels).

4. User identifier - allows you to enter the user identifier for which the session key will be retrieved and added to the URL when the simulator is displayed. If the field is empty, the key will not be retrieved.

5. Parameters path (query parameters) - a field allowing you to define parameters that will be appended to the path (e.g. source=ib).

6. The App - launches the simulator in the desktop channel (app).

7. The Native - launches the simulator in the native application channel.

8. The IB inline - launches the simulator in the IB inline channel.

9. The IB popup - launches the simulator in the IB popup channel.

10. The New Tab - opens the application in the selected environment in a new browser tab.

11. Channel* - the layout in which the application is to be launched (option dependent on configuration).

Figure 1. Simulator properties

Figure 2. Simulator properties with channel selection option

Selection of the simulated device

After selecting the channel for launching the application, a button will appear in the lower-left corner of the screen allowing you to choose the simulated device (12). Changing the device adjusts the application dimensions to the dimensions of the selected device. By default, Desktop Mode is simulated for the App, IB Inline, and IB Popup channels, while for the Native channel, iPhone X is simulated by default.

Preview of API calls

After selecting a launch channel other than desktop, a panel will be displayed in the lower-right corner API calls. It presents the API methods invoked by the simulated application. The component can be collapsed by clicking the title bar. The trash can icon button on the title bar allows you to clear the component content.

Figure 3. Application screen after selecting the "Native" channel

Configuration

To configure the simulator, prepare a file in JSON format that will contain a description of the available environments, layouts, and channels in which application simulation will be possible.

In the Eximee Designer settings, there should be a path to the configuration file as the value of the parameter form-starter.configurationPath, e.g.:

form-starter.configurationPath=/etc/eximee/form-starter.json

Example configuration file:

Configuration file

{
  "showChannels": false,
  "channels": [
    {
      "name": "app",
      "formModes": [
        {
          "name": "app",
          "label": "App",
          "icon": "desktop_windows"
        },
        {
          "name": "mobile",
          "label": "Native",
          "icon": "phone_iphone"
        },
        {
          "name": "inline",
          "label": "IB inline",
          "icon": "featured_play_list_outlined"
        },
        {
          "name": "popup",
          "label": "IB popup",
          "icon": "flip_to_front"
        },
        {
          "name": "newTab",
          "label": "New tab",
          "icon": "open_in_new"
        }
      ],
      "defaultChannel": true
    },
    {
      "name": "form",
      "formModes": [
        {
          "name": "app",
          "label": "App",
          "icon": "desktop_windows"
        }
      ]
    }
  ],
  "environments": [
    {
      "displayName": "Dev bank",
      "url": "https://pl.dev.bank.eximee.consdata.local"
    },
    {
      "displayName": "Dev bank CZ",
      "url": "https://cz.dev.bank.eximee.consdata.local"
    },
    {
      "displayName": "Mandarynka",
      "url": "https://pl.mandarynka.eximee.consdata.local"
    },
    {
      "displayName": "Mandarynka RREV",
      "url": "https://pl-rrev.mandarynka.eximee.consdata.local"
    },
    {
      "displayName": "Mandarynka CZ",
      "url": "https://cz.mandarynka.eximee.consdata.local"
    },
    {
      "displayName": "Mandarynka SK",
      "url": "https://sk.mandarynka.eximee.consdata.local"
    }
  ]
}

where:

• showChannels - an attribute specifying whether the simulator should display a drop-down list with the option to choose a layout

• channels - list of available layouts

  • name - name of the layout

  • defaultChannel - whether the layout should be selected / checked by default

  • formModes - channels in which a given layout is available

    • name - channel name supported in Eximee Designer

    • label - displayed channel name

    • icon - icon representing the given channel

• environments - environments on which the application simulation can be launched

  • displayName - displayed name

  • url - environment address.