Simulator

The availability of features depends on the license and may not be available in all deployments.

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

• the selected environment,

• user identifier,

• specific input parameters,

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

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

Launching the application simulator

To launch the application simulator, select the option from the Eximee Designer navigation bar Simulator.

Setting input parameters

The form located at the top of the module allows launching the application with selected parameters.

1. Button to show/hide the input parameters form.

2. Environment - the environment where the tested application is located.

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

4. User identifier - allows entering the user identifier for which the session key will be fetched and added to the URL when showing the simulator. If the field is empty, the key will not be fetched.

5. Parameters paths (query parameters) - a field allowing definition of 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 Other technical channels: - opens the application on the selected environment in a new browser tab.

11. Channel* - the theme in which the application should be launched (option dependent on configuration).

Illustration 1. Simulator properties

Illustration 2. Simulator properties with the ability to choose a channel

Selection of the simulated device

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

API calls preview

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

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

Configuration

To configure the simulator operation you should prepare a file in JSON format that will contain a description of the available environments, themes 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

Sample 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 present a drop-down list with the option to choose a theme

• channels - list of available themes

  • name - theme name

  • defaultChannel - whether the theme should be selected/marked by default

  • formModes - channels in which the given theme is available

    • name - the channel name supported in Eximee Designer

    • Each component should have a label ( - the displayed name of the channel

    • icon - the icon representing the given channel

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

  • displayName - displayed name

  • url - the environment address.