Page History
...
- Select Settings
- Select the general tab
- Select shortcuts
- Press the add button
- A pop up window will appear
- Select the project, branch, flow, language, UI and theme
- Enter a shortcut name
- Select Add
- Select save
- You can now test your shortcut with the following URL: http://HOSTNAME:PORT/Runtime/server/start/SHORTCUTNAME
Dynamic shortcuts
When the dynamicVersion
property is set to true, the version property is ignored, and the version of the project to be used is looked up by comparing the version of the AQ_Dashboard_ProjectWidget or AQ_StartProject to the version of the project of the current session. If so, that version will be used, otherwise the version set with the version
property will be used.
Properties
You can configure a shortcut via the
Include Page | ||||
---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|
Code Block | ||||
---|---|---|---|---|
| ||||
### Shortcuts - Shortcuts can be started via the URL: http://YOURSERVER:PORT/ROOT/server/start/SHOTCUTNAME ### blueriq.production.shortcuts-only = false blueriq.shortcut.ChildSupport.flow = Start blueriq.shortcut.ChildSupport.languageCode = en-GB blueriq.shortcut.ChildSupport.project = export-Kinderbijslag blueriq.shortcut.ChildSupport.theme = forms blueriq.shortcut.ChildSupport.ui = mvc blueriq.shortcut.ChildSupport.version = 0.0-Wetwijziging blueriq.shortcut.ChildSupport.dynamicVersion = true blueriq.shortcut.ChildSupport.privateAccess = false blueriq.shortcut.ChildSupport.securityEnabled = true |
Dynamic shortcuts
When the dynamicVersion
property is set to true
, the version property is ignored, and the version of the project to be used is looked up by comparing the version of the AQ_Dashboard_ProjectWidget or AQ_StartProject to the version of the project of the current session. If so, that version will be used, otherwise the version set with the version
property will be used.
Test Paths
From Blueriq 12.8, we added the concept of Test Paths in order to be able to test multi-repository applications. These are applications that span multiple projects, by using AQ_Dashboard_ProjectWidget or AQ_StartProject to start flows from different projects. One can imagine that when testing a feature branch of a project, you wouldn't want to have that same feature branch present in all other projects, especially when nothing has changed in those projects.
When using this feature, keep the following in mind:
- Test Paths only work in development mode
- Test Paths only work when using shortcuts to indicate the entry point of the project to start
- Test Paths only work for Studio projects, not for project exports or publisher exports.
When editing shortcuts, you can define Test Paths for that shortcut:
Code Block | ||||
---|---|---|---|---|
| ||||
blueriq.shortcut.ChildSupport.testPaths.feature1 = 0.0-FeatureBranch1
blueriq.shortcut.ChildSupport.testPaths.feature2 = 0.0-FeatureBranch2 |
This indicates that when the application is started with Test Path feature1
, the project should use 0.0-FeatureBranch1
instead if the version indicated by blueriq.shortcut.ChildSupport.version
.
If any Test Paths are configured, the development dashboard will display a selector for the Test Paths:
Selecting a Test Path will have this behavior:
- When the selected Test Path is defined for the shortcut, the corresponding version of the project is started instead of the default version.
- When the selected Test Path is not defined for the shortcut, the default version of the project is started.
- When the selected Test Path is defined, but the corresponding version doesn't exist in the project, an error is returned.
The selected Test Path will be propagated through the entire application, with the exception of AQ_SoapServiceClient/AQ_WebServiceClient and AQ_ExternalFlow.
The Test Path names, e.g. feature1
in the previous example, are identifiers that can be chosen freely (but limited to alphanumeric characters and underscores). You are encouraged to use Test Path names that describe the feature you are testing.
Info |
---|
When a feature is done and the corresponding branch is merged, the Test Path is not automatically deleted. As a maintainer of the shortcuts, you should remove Test Paths for these versions manually. |
Tip |
---|
When working with shortcuts for the AQ_StartProject service, you need to think of security. On a production server you set the runtime to |
...