Versions Compared

Old Version 3

changes.mady.by.user Randy Anft

Saved on

compared with

New Version Current

changes.mady.by.user Tijmen Daatselaar

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Name
Direction
Description
Type
Occurrences
Required
ShortcutNameInput

An expression to determine the shortcut to start. This shortcut must be added to the application.properties file.

Expression - StringSingle valued

Either the ShortcutName or ShortcutAttribute are required.

You can not use both in the same service call. An error occurs at runtime when unknown is submitted in these parameters.

ShortcutAttributeInput

Select a string attribute that holds the name of the shortcut to be taken. This shortcut must be added to the application.properties file.

Module Element - AttributeSingle valued
ActionInputIndicate the action taken when the other application is triggered.

Domain

  • Start as new tab
  • Start in same tab
  • Start without user interface
Single valuedtrueYes
DataInput
Data of the current application that you want to transfer to the triggered application. This is done using key value pairs.
Expression - Any; Key-value pair; Multivalued resultMulti valuedfalseNo
UI Text Box
type
Tip

When using this Service, the shortcut property dynamicVersion is considered. for more information about this see see shortcut information

ui-text-box
Info
UI Text Box
typenote

If you choose an attribute that has a value list for the ShortcutAttribute parameter, then the runtime validates each value of this list with the shortcuts defined in the

Include Page
_PropertiesFileJava
_PropertiesFileJava
file. 

type
Warning

When opening the started application in a new tab, your browser might block the new pop-up. This message is quite visible in Firefox, but rather small in chrome.The behavior and message may differ between different browsers.

UI Text Box
type
Warning

You should never send empty data fields. This results in an error.

Info
titleLanguage

In order to to deliver a good experience to the end user, the language that is defined in the shortcut is ignored, and replaced with the current language of the application that calls the AQ_StartProject service. In this manner the current language setting is preserved when switching between projects. This of course implies that the defined languages of the projects have to match.

...

Unauthorized - This exit event is taken when the user has not a role that is required for the started flow. No login is shown to the user. If this event is not mapped, the exception exit is taken.

...

type
Warning

When using the setting Start in same tab, then we advice to lead the event to a dummy page after the AQ_StartProject service. If you do not connect the event, a warning triggers in the runtime and a rollback happens, which might not be what you want. If you connect that event to the exit event of the flow that ends the session, then the new project is not started.

...

On a production server you set the runtime to blueriq.production.shortcuts-only=true so that end users can not start any flow themselves. As you need to create a shortcut for the application to be called, you do not want that end users could guess the shortcut name and start the flow themselves. For this reason, you should set the property blueriq.shortcut.[name].privateAccess=true for the shortcuts that are only used for the AQ_StartProject service, and which are not started by end users.

Example

Image AddedImage Removed

The above service uses an attribute with a value list of possibly case types. Depending on the type of subsidy, a different application is opened that is responsible for handling that type of subsidy cases. The application is opened as new tab, and important information is passed to the other application. This information is the subsidy ID and a string to indicate what dashboard page to open. The flow in the other application has a split node in the flow, which uses this string to determine to what page to flow.

...