Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Tasks : Working with the Mappings Tab

Working with the Mappings Tab
The Mappings tab of the Properties view provides a global view of all the bindings and computation actions related to the selected element in the Form Designer canvas or Outline view.
The term mappings used in this topic, is a generic word which covers both bindings and computation actions.
You can view, edit, and create mappings from the Mappings tab. It displays the values of the source and target fields of the existing mappings in the left and right trees respectively.
Figure 111 Mappings Tab of the Properties View
The details are as follows:
The default view of the Mappings tab is focussed on the mappings of the selected element.
A set of buttons and filters are provided in the toolbar. Each of these filters has a corresponding toolbar button and a toolbar menu item: both are associated with same filter action. The buttons control the depth to which the source and target trees are expanded. The filters help you to control the properties to be displayed in the source and target panes. The details are explained in Table 14.
 
 
Coloration Feedback
The connecting lines representing the existing mapping can be difficult to understand especially if there are many mappings between the elements of the source and target tree. The coloration feedback is very useful in such scenario as it allows you to see at a glance which mappings are defined within a given component tree. Some examples are listed below:
When you select a bindable element in the source or target tree, all mappings involving that element and its visible children are highlighted in bold. In Figure 111, when you select Customer_order_item_SKU/Value node in the target tree, the corresponding binding is highlighted in bold. This is especially helpful when the ‘show only source ancestors’ and ‘hide target descendants’ filters are disabled.
The Mappings tab’s user interface (UI) simplifies tasks such as property binding and creating computation actions. The following sections describes the operations that can be performed using the Mappings tab.
Settings Bindings
1.
2.
Go to the Mappings tab in the Properties view of the selected element.
3.
4.
5.
Adding Computation Actions
1.
2.
Go to the Mappings tab in the Properties view of the selected element.
3.
4.
Press Enter to commit the newly created computation action name and display the Rule Details page of the New Rule dialog. Follow the instructions given in the Add a Rule Using the Outline View section to create a new computation action.
5.
6.
Editing Computation Action Using the Script Editor Section
1.
Go to the Mappings tab in the Properties view.
2.
3.
Click to expand the computation action section in the Mappings tab view. You can update all the fields of the computation action from the Script Editor.
Figure 112 The Script Editor in the Mappings Tab
Common Gestures for Editing Mappings
1.
2.
Go to the Mappings tab in the Properties view of the selected element.
3.
a.
b.
c.
Select a mapping and execute Context Menu > Edit.
4.
The Edit Binding or Edit Computation Action dialog is displayed. See Working with Bindings, Actions, and Rules for details.
When you create mappings from the Mappings Tab, it prevents you from creating invalid mappings. Look for the following cursor feedback when you drag a property between trees:

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved