Development tools : Global functions : Engine.getInstance category : launchNewFlowWithMapping
  
launchNewFlowWithMapping
Description
Use this function to launch a flow with flowId, load the context of the first page in the flow to the container with containerId, and map the current page context to the new flow context.
This graphic is described in the surrounding text.
Usage
Client side: Y
Server side: N
Syntax
launchNewFlowWithMapping(String flowId, String containerId, String mapping)
Arguments
flowId
Defines the flow to be launched.
This graphic is described in the surrounding text.
containerId
Defines the container to contain the flow context.
This graphic is described in the surrounding text.
mapping
Defines what data on the page is mapped to the new flow context. The following widget values can be mapped to the new flow context:
The value of the dataName property that is bound to a widget.
If a dataName property is bound to different widgets, only the dataName value of the first widget is mapped to the new flow context.
The value that is defined in kColl
The value that is defined in lazy kColl
The value that is defined in iColl
As shown below, the widget that is bound to the dataName property is displayed in the Mapping Source list. You can select the mapping source and target and define the mapping relationship. If you do not have any widgets that are bound to the dataName property, your Mapping Source list is blank.
This graphic is described in the surrounding text.
Example
Engine.getInstance().launchNewFlowWithMapping('BN007_launch_newFlow_for_retitivepane_Flow', 'BN007_function_test_index_contentPane01', [{
'widget' :'BN007_function_test_index_label_${index}','dataName' :'BN007_launch_newFlow_for_retitivepane_Field'
},{
'widget' :'BN007_function_test_index_label_copy_copy','dataName' :'BN007_launch_newFlow_for_retitivepane_Field01'
}])
Limitation
This function does not support for the following widgets:
DataGrid
MultiSelect
CheckedMultiSelect
EnhancedMultiSelect
Go up to
Engine.getInstance category