Parameters
Component parameters vary from component to component. For example, on some components they provide the opportunity to specify the source and range of task flow content; on other components they present read-only, application-generated identifiers that are used in maintaining a task flow instance's association with its customizations.
When there are no producer components on the page, the Parameters dialog displays only parameter names and values. When there is at least one producer component on the page, and the current component is a consumer component, a parameter can bind to either a specified value or to an event. When bound to an event, additional settings are required to specify event details.
Setting Component Parameters
To set the parameters for a component on a page:
- Enter parameter values, or click the
icon next to a parameter field to select and open the Expression Language (EL) Editor. The editor provides a means of entering an expression when a value is discoverable, but otherwise unknown; for example, when you want a parameter value to be the name of the current user or the current application skin.For parameter descriptions, click the link for the task flow or component you are editing:
Wiring Events to Component Parameters
An event defined on a producer component has associated payload values that can be used to set the parameter values in consumer task flow or portlet components. As soon as the event is triggered, the associated parameter values are dynamically passed to the consumer task flow or portlet and can be exposed as needed.
To wire an event (in a producer component) to a parameter in a consumer task flow or portlet:
-
If the consumer task flow or portlet is not already on the page, add it.
-
Click the View Actions menu icon on the consumer task flow or portlet, and select Parameters.
-
In the Parameters dialog, the settings you see are available only when there is a producer and consumer task flow on the page. For each parameter defined for the consumer task flow or portlet that you want to wire to an event:
-
Click the Value field icon and select Event.
-
Click the Event list, and select the event that is associated with the payload value that you want to pass to the parameter. The Event list shows all of the events that are defined for all components on the page.
-
To specify that the consumer task flow or portlet "listens" for the event from only one producer component, click the from list and select the associated producer component. Otherwise, leave from with the default value of
Any Componentto allow the parameter to be set when any producer component on the page triggers the specified event. -
Click the payload list, and select an event payload value. This selection becomes the input value for the associated parameter, passed dynamically when the event triggers.
For example, the event of selecting a row in a Data Visualization task flow (producer) triggers a
DPRowSelectionevent that updates a consumer task flow. In this case, the consumer task flow is a pie chart, which refreshes with data associated with the selected row. -
-
Click OK and Save.
-
Test your wiring by triggering the event and observing the results in the consumer task flow or portlet.
Consuming Page Parameters
You can configure a task flow component to consume page parameters.
Note:
Before you can take the steps outlined in this section, you must create a page parameter and provide it with a value.
To consume a page parameter (wiring a task flow to a page parameter):
- In the Parameters dialog, click the icon next to the property that takes the parameter value, then select Expression Builder to open the Expression Editor.