You can add a wire between two widgets to trigger an event
in the target widget whenever the source widget sends a specific event.
Before you begin, if you have two or more instances of
the same widget, change the name of each instance so that you can
identify it in the Widget Wiring window.
Tip: If you want to do all of you widget connections one after
another, add all of the widgets that you want to wire onto the page
before you start wiring. While you are wiring, you cannot add widgets
to the page.
You would want to add a wire between two widgets:
- When different parties have developed the widgets and neither
party was aware of the event names used by the other party's
widget. You are using a wire to map a source event to the appropriate
target event.
- When there are multiple instances of the same widget and you want
to specify which instance is participating in the wire. For example,
if you have two widgets on a page and you want each widget have its
own comment widget, you would wire the first widget to one comment
widget instance and wire the second widget to a different comment
widget instance.
- When you want to transform the data sent by one widget into a
format understood by another widget. In this case, you need two wires.
The first wire sends the data to an adapter widget such as the Script Adapter widget.
The second wire sends the transformed data to the other widget.
To wire a widget to another widget:
- From the action menu of the source widget, select Wire
Widget. The Widget Wiring window
opens with focus on the widget and the wiring it has with other widgets
on the page.
- Click the outgoing arrow for the widget and then select
the target widget from the presented list. The list displays all of
the widgets contained by the page. If you do not see the outgoing arrow,
hover over the widget until it displays.
- From the list, click the target widget. The Widget
Wiring window adds the target widget to its display and
draws a wire between the source and target widgets. The source end
of the wire displays the event being sent by the source widget while
the target end of the wire displays the event that the target widget
will receive.
- To change the source or target event, click the wire menu
icon and then select an event from the list that opens. To learn more about an event, hover over its name.
- Optional: You can add additional wires (inbound
and outbound) to the widget in focus. To change the focus to another
widget, select it in the diagram or from the Show wires
for list.
- When you have completed your wiring, click OK.