Launching specific Perspectives or Views via URL

You have the option to open specific views in the currently selected perspective or a specified perspective via URL. The link opens the view or perspective in the Portal directly. If you are not logged in already, the login dialog appears first.

Opening a specific Perspective

To open a specific perspective, use a URL with the following syntax:

http://<hostname>:<portnumber>/<context-root>/main.html?uicommand={"type": "ChangePerspective", "data": {"perspectiveId": "<perspective>"}}

For example, use the following URL to open the Administration perspective:

http://localhost:8080/DemoProject/main.html?uicommand={"type": "ChangePerspective", "data": {"perspectiveId": "ippAdminPerspective"}}

Opening a specified View in the currently selected Perspective

In case a view is defined without a perspective, the view with the given name opens in the currently selected perspective. Define the view in the following way:

http://<hostname>:<portnumber>/<context-root>main.html?uicommand={"type": "OpenView", "data": {"viewId": "<view>"}}

For example, use the following URL to open the Model Management view:

http://localhost:8080/DemoProject/main.html?uicommand={"type": "OpenView", "data": {"viewId": "modelManagementView"}}

The view with Id modelManagementView is opened for the currently selected perspective, if such a view is defined for this perspective (in this example the Administration Perspective).

Opening a specific View in a specified Perspective

If you like to open a specific view in a specified perspective, use the following syntax:

http://<hostname>:<portnumber>/<context-root>/main.html?uicommand=[{"type": "ChangePerspective", "data": 
{"perspectiveId": "<perspective>"}},{"type": "OpenView", "data": {"viewId": "<view>"}}]

If the specific perspective is defined together with a specific view, the view opens in the specified perspective, whereby it does not matter if this perspective is currently selected or not.

For example, use the following URL to open a view with Id processSearchView of the Control Center perspective:

http://localhost:8080/DemoProject/main.html?uicommand=[{"type": "ChangePerspective", "data":
{"perspectiveId": "ippBccPerspective"}},{"type": "OpenView", "data": {"viewId": "processSearchView"}}]

This URL opens the Process Search view from the Administration perspective. It does not matter if the Administration perspective is currently selected or not.

The Process Search view can be opened for specific parameters.

Setting Parameters to search for Processes in the Process Search View

You can use the following parameters to search for processes in the Process Search view:

Param Sample URL Additional Value
oid
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "oid":"38"}}}]
 
startedFrom
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "startedFrom":"08/20/14 03:01 PM"}}}]
 
startedTo
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "startedTo":"08/20/14 03:01 PM"}}}]
 
endTimeFrom
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "endTimeFrom":"08/20/14 03:01 PM"}}}]
 
endTimeTo
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "endTimeTo":"08/20/14 03:01 PM"}}}]
 
state
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "state":"Aborted"}}}]
possible values:
  • "Alive"
  • "Completed"
  • "Aborted"
  • "Interrupted"
  • "All"
priority
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "priority":"High"}}}]
possible values:
  • "High"
  • "Normal"
  • "Low"
rootOid
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "rootOid":"38"}}}]
 
hierarchy
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "hierarchy":"PROCESS"}}}]
possible values:
  • "PROCESS"
  • "PROCESS_AND_CASE"
  • "CASE"
  • "ROOT_PROCESS"
caseOwner
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "hierarchy":"CASE","caseOwner":"motu"}}}]
Hierarchy should be 'CASE'
processFilters
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "processFilters":["AuxiliaryProcesses""]}}}]
Add filter for handling Auxiliary processes
processes
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "processes":["{EnumModel}PD1EnumModel"]"}}}]
Pass a List with process qualifierID
descriptors
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"PROC", "processes":["{EnumModel}PD1EnumModel"],
"descriptors":{"DP1":"a"}}}}]
Add processFilter and Map of descriptor in
key,value pair <descId,searchValue>

Setting Parameters to search for Activities in the Process Search View

You can use the following parameters to search for activities in the Process Search view:

Param Sample URL Additional Value
oid
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "oid":"38"}}}]
 
startedFrom
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "startedFrom":"08/20/14 03:01 PM"}}}]
 
startedTo
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "startedTo":"08/20/14 03:01 PM"}}}]
 
modifyTimeFrom
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "modifyTimeFrom":"08/20/14 03:01 PM"}}}]
 
modifyTimeTo
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "modifyTimeTo":"08/20/14 03:01 PM"}}}]
 
state
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "state":"Aborted"}}}]
possible values:
  • "Alive"
  • "Completed"
  • "Aborted"
  • "Interrupted"
  • "All"
priority
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "priority":"High"}}}]
possible values:
  • "High"
  • "Normal"
  • "Low"
criticality
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "criticality":"Medium"}}}]
possible values:
  • "Low"
  • "Medium"
  • "High"
  • "All"
  • "Undefined"
performer
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "performer":"motu"}}}]
possible values:
  • "PROCESS"
  • "PROCESS_AND_CASE"
  • "CASE","ROOT_PROCESS"
processes
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "processes":["{EnumModel}PD1EnumModel"]}}}]
Pass a List with process qualifierID
activities
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "processes":["{EnumModel}PD1EnumModel"],
"activities":["PD1EnumModel{EnumModel}ManualActivity1"]}}}]
List of activities in format
"ProcessID + activityQualifierID"
activityFilters
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT","activityFilters":["AuxiliaryActivities"]}}}]
Possible values:
  • AuxiliaryActivities - show auxiliary activities
  • InteractiveActivities - show interactive activities
  • NonInteractiveActivities - show non-interactive activities
descriptors
[{"type": "OpenView", "data": {"viewId": "processSearchView", "params":
{"searchOption":"ACT", "processes":["{EnumModel}PD1EnumModel"],
"activities":["Process1{Model1}Activity1"],"descriptors":{"DP1":"a"}}}}]
Add processFilter,activityFilter and Map of descriptor in
key,value pair <descId,searchValue>

Setting Parameters to open a specified Activity Panel

You can use the following parameter to open a specific Activity Panel view:

Param Sample URL Additional Value
oid
[{"type": "OpenView", "data": {"viewId": "activityPanel", "params": {"oid":"25"}}}]