Widgets communicate with each other using wires. A wire has a source widget and a target widget.
Each widget has a list of events that it can send and a list of events that it can receive. A wire connects an event that the source widget sends to an event that the target widget receives. Based on the payload information in the source event and the target event, the target widget does something. The exact actions that the target widget performs is defined within the widget. For example, you return a task in your My Tasks widget. The My Tasks sends a TaskReleased event to the Available Tasks widget through a wire. The payload for the event includes the ID of the task. The Available Tasks performs its own TaskReleased event, which in this case adds the task to its list. In the example, the names of the source event and the target event match. They do not have to match.
Wires are only visible in the Widget Wiring window, which you use to add or remove wires.
The Widget Wiring highlights the in focus widget and displays all of the wires that it has. On the left are the widgets that are sending events to the in focus widget. On the right are the widgets that are receiving events from the in focus widget. There are one or more wires between the in focus widget and each of the other widgets. The wires in the Widget Wiring also display the events being sent and received by the widgets.
If the in focus widget sends and receives events from another widget, the Widget Wiring window displays that widget on both sides of in focus widget. For example, in the screen capture, the in focus widget (My Tasks) receives a TaskClaimed event from the Available Tasks widget and sends a TaskReleased event to it. Even though the Widget Wiring window displays "Available Tasks" twice, it is the same widget.
If there is a widget already on the page that can send an event that matches an event that the dropped widget can receive, Business Space automatically creates a wire between the two widgets. The dropped widget is the target of the wire. For example, a page has a My Tasks widget and you drop a Team List widget onto the page. The My Tasks widget sends a FocusChanged event when you select a task in the widget. The Team List widget can receive FocusChanged events. Business Space automatically creates a wire between the two widgets. When the Team List widget receives this event, it updates to display the people who can own the task.
Similarly, when the widget you dropped can send a specific event that another widget can receive, Business Space automatically creates a wire between the two. The dropped widget is the source of the wire.