launchNewFlowWithMapping

Development tools : Global functions : Engine.getInstance category : 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.

containerId

Defines the container to contain the flow context.

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.

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