Mapping and Transforming Data : Buttons, Menus, and Icons

Buttons, Menus, and Icons
The Input tab contains several toolbar buttons, popup menus, and icons. This section describes the various graphical elements of the Input tab.
Toolbar and Right-Click Menu on the Input Section
The Scope Variables panel and the Function panel have several buttons for performing various functions. There is also a popup menu when you right-click on elements in each panel. Table 34 describes the buttons and right-click menu items available in the panels of the Input tab.
 
Coercions. Allows you to specify a type for Scope Variables elements that are not a specific datatype. For example, a choice element can be coerced into one of the possible datatypes for the element, or an element of datatype any can be coerced into a specific datatype.
This menu item has two sub-menus: Content and All. Expand > Content expands the current element so that all elements that are currently used in a mapping are visible. Expand > All expands all sub-elements of the currently selected element.
Show Connected
Expands the elements in the Function area to display elements that are mapped to the currently selected element or its sub-elements.
Moves the currently selected element into a new statement. This displays the Move Into New Statement dialog that allows you to choose the statement you wish to move the element into. See XSLT Statements for more information about XPath statements.
Deletes the mapping for the selected element. If no mapping is defined, the element itself is deleted (along with all child elements).
Note  Elements are predefined. Do not delete elements. Deletion of an element causes mapper validation errors due to the mismatch of the right panel’s content with its schema.
Insert. Click Insert to pop-up a New XSLT Statement dialog where you can define an XSLT statement. The statement is inserted in the function input schema on the same level of the hierarchy as the currently selected element.
You can add one XSLT statement at a time with this button. The right-click menu item Statement provides a shortcut for multi-line statements, such as Choice or If. See the description of the Statement menu item below for more information.
Note  Elements are predefined. Do not add new elements. Doing so causes a mismatch of the right panel’s contents with its schema.
See XSLT Statements for more information about XSLT statements.
Mapper Check and Repair. Verifies the XSLT template you have created in the Function panel against the expected input. A list of errors and warnings appear and you can choose which items you wish to fix. TIBCO BusinessEvents attempts to fix simple problems such as adding missing items that are expected.
See Repairing Incorrect Mappings for more information.
See XSLT Statements for more information about XSLT statements.
XPath Formula Builder. Invokes the XPath formula builder. You can use this editor to create an XPath statement for this input element. See Chapter 20, XPath Formula Builder for more information about XPath and the XPath formula builder.
This menu item has three sub-menus: Content, Errors, and All. Expand > Content expands the current element so that all sub-elements that have a mapping or expression are visible. Expand > Errors expands the current element so that all sub-elements that have an error in their expression are visible. Expand > All expands all sub-elements of the currently selected element.
Show Connected
Expands the elements in the Scope Variables panel to display elements that are mapped to the currently selected element or its sub-elements.
This menu item contains shortcuts that allow you to easily add the desired XSLT statement(s) with one menu item instead of adding the statement(s) with the Insert button. See Statement Menu Options for a description of the sub-items of this menu.
Undo operation
Redo operation
Icons for Schema Element Datatypes
Schema elements also have a set of associated icons to indicate their type. Table 35 describes the icons used for schema items.
You can use the Type Documentation button to obtain any available documentation on any node in the Scope Variables or function input schema trees.
Complex element that is a container for other datatypes. This is also called a branch in the schema tree.
Represents a schema item that can be any datatype. Data in this schema element can be any datatype.
Qualifier Icons
Schema elements can have additional icons that specify qualifications. The qualifier icons have different meanings depending upon where they appear. For example, a question mark icon signifies an element is optional in the Scope Variables schema or in a hint in the Function panel. However, in an XSLT statement, the question mark signifies the statement is "collapsed" and an implicit "if" statement is set, but not displayed in the Function panel.
Table 36 describes the additional qualifiers that appear next to the name of schema items.
No qualifier indicates the element is required.
An implicit "if" statement is set for this statement. This occurs when you map an optional element from the Scope Variables to an optional element in the function input schema or if you specify Surround element with if test on the Content tab of the Edit Statement dialog.
An asterisk indicates the item repeats zero or more times.
A plus sign indicates the item repeats one or more times.
A null sign indicates the item is explicitly set to null.
You can set an element explicitly to null by clicking the Edit Statement button for the element, then checking the Set Explicit Nil field on the Content tab of the Edit Statement dialog.