Using the new development dashboard

The development-tools component must be installed before you can use this dashboard. Once the plugin is installed navigate to http://HOSTNAME:PORTNUMBER/runtime/server/dev-dashboard/. The following dashboard should appear:

Start a project via the development dashboard

To start a project

• Select the project in the branch that you are working in
• Select the flow
• Select the language
• Select the theme (default is forms)
• Optionally select a test path
• Press start
• A new tab or window should appear with the selected project

Exposed Blueriq webservices

You can view the WSDL file and endpoint of a Blueriq Webservice with this widget

• Select your repository
• Select the branch
• Select the project
• Select the service
• Press 'Copy service URL' to copy it directly to your clipboard

Exposed Blueriq functions

You can view the endpoint, input and output parameters of a function which is exposed as a webservice.

• Select your repository
• Select the branch
• Select the project
• Select the module
• Select the function
• Press 'Copy function URL' to copy it directly to your clipboard

Widgets state

Widgets can be turned on and off in the widgets state menu. 

Widgets that can be added to the development dashboard are:

• Flow starter (default on)
• Project shortcuts
• Blueriq sessions
• Exposed Blueriq webservices
• Exposed Blueriq functions
• Runtime components
• Recently started

Change settings

There are many configuration settings available for the runtime. Some settings can also be edited via the settings menu in the development dashboard, found in the bottom left corner of the dashboard. In the dashboard settings the business engineer can find the specific configuration items that are needed during applications development, which are the shortcuts and the users settings. More technical configuration items are only accessible in the property files. All the settings you make are stored in the

Reload configuration 

When the configuration of Blueriq has been changed, you will need to reload the configuration. The execution of this task has an impact for all projects and users on this server and can result in a temporary lack of server performance.

H2 Console

For development purpose you can use the H2 Console to query the database. This only works when you are using a H2 database in development. Other database connection cannot be used in the H2 Console.

The H2 Console can be opened through the link in the menu of the development dashboard. The H2 Console is disabled by default (since Blueriq 11.5), as some of its features form a security risk. 

Starting custom Runtime theme

When running application from the development dashboard it possible to select themes which are provided by the Runtime. Starting from Blueriq 14.6 is it now possible to configure external theme's which are not hosting from within the runtime. By configuring the blueriq.external.themes property you are able to select and start applications from within the development dashboard. The external theme properties consists out of a baseUrl (the location where your custom is hosted) and three templates for the main entry points (flow, shortcut, session) of a Blueriq application.

These templates follow the RFC-6570 URI template standard, each template has it own variables which are expanded when building the URL to start or continue your application.

Example

If you are hosting your custom theme on https://example.com and your application consists out of the following entry points: 

• /flow/<projectName>/<flowName>/<projectVersion>/<languageCode>
• /shortcut/<shortcutName>
• /session/<sessionId>

You would configure the blueriq.external.themes property as followed.

blueriq.external.themes.custom.baseUrl = https://example.com
blueriq.external.themes.custom.template.flow = /flow/{project}/{flow}/{version}/{languageCode}
blueriq.external.themes.custom.template.shortcut = /shortcut/{shortcut}
blueriq.external.themes.custom.template.session = /session/{sessionId}

Starting a flow for the exported application MyFirstApplication with the flow Main and the version 0.0-Trunk for the language en-GB, the URL would be expanded to: https://example.com/flow/exports-MyFirstApplication/Main/0.0-Trunk/en-GB.

Starting a shortcut for with the name MyShortcut, the URL would be expanded to: https://example.com/shortcut/MyShortcut.

Continuing a session with the id 0a2611af-ec5a-4795-82b1-3594bd571525, the URL would be expanded to: https://example.com/session/0a2611af-ec5a-4795-82b1-3594bd571525.