Copyright © Cloud Software Group, Inc. All Rights Reserved

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 Tab

The Process Data panel and the Activity Input panel have several buttons for performing various functions. There is also a popup menu when you right-click on elements in each panel. Table 11 describes the buttons and right-click menu items available in the panels of the Input tab.

 

Table 11 Input tab toolbar buttons

Button	Right-Click Menu	Description
Process Data Area
		Coercions. Allows you to specify a type for Process Data 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.
		Type Documentation. Allows you to specify or view documentation for schema elements.
	Expand	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 Activity Input area to display elements that are mapped to the currently selected element or its sub-elements.
	Delete	Deletes the selected element.
	Copy	Copies the selected element. The element can be later pasted.
Activity Input Area
		Shows/hides the mapping formulas for the input elements.
		Move Up. Moves the selected element up in the activity input tree.
		Move Down. Moves the selected element down in the activity input tree.
	Move Out	Move Out. Promotes the selected element to the next highest level in the activity input tree.
	Move In	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.
	Delete Delete All	Deletes the selected element and all of its child elements.
		Insert. Inserts a new element or XSLT statement in the activity input schema on the same level of the hierarchy as the currently selected element. You can add one element or 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. See XSLT Statements for more information about XSLT statements.
		Add Child. Adds a statement for a child element to the currently selected element.
		Mapper Check and Repair. Verifies the XSLT template you have created in the Activity Input panel against the activity’s expected input. A list of errors and warnings appear and you can choose which items you wish to fix. TIBCO ActiveMatrix BusinessWorks attempts to fix simple problems such as adding missing activity input items that are expected. See Repairing Incorrect Mappings for more information.
		Edit Statement. Allows you to modify an XSLT statement for the element. See XSLT Statements for more information about XSLT statements.
	Edit	XPath Formula Builder. Invokes the XPath formula builder. You can use this editor to create an XPath statement for this input element. See Chapter 9, XPath for more information about XPath and the XPath formula builder.
	Expand	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 currently 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 Process Data area to display elements that are mapped to the currently selected element or its sub-elements.
	Statement	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 Right-Click Menu for a description of the sub-items of this menu.
	Undo	Rolls back the last operation performed.
	Redo	Performs the last operation that was undone with the Undo menu item.
	Cut	Deletes the selected element. The element can be later pasted to a new location.
	Copy	Copies the selected element.
	Paste	Pastes the last element that was copied or cut.

Icons for Schema Element Datatypes

Schema elements also have a set of associated icons to indicate their type. Table 12 describes the icons used for schema items.

You can use the Type Documentation button to obtain any available documentation on any node in the Process Data or Activity Input schema trees.

Table 12 Icons for schema items

Icon	Description
	Complex element that is a container for other datatypes. This is also called a branch in the schema tree.
	Simple string or character value.
	Simple integer value.
	Simple decimal (floating point) number.
	Simple boolean value.
	Simple Date or Time. This can be any of the following datatypes: • Time • Date • Date & Time • Duration • Day • Month • Year • Month & Year • Day & Month
	Simple binary (base 64) or hex binary value.
	Represents a schema item that can be any datatype. Data in this schema element can be any datatype.
	Choice. Specifies that the actual schema element can be one of a specified set of datatypes.

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 Process Data schema or in a hint in the Activity Input. 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 Activity Input area.

Table 13 describes the additional qualifiers that appear next to the name of schema items.

Table 13 Additional icons for hints

Qualifier	Process Data or Hint	Statement
	No qualifier indicates the element is required.	N/A
	A question mark indicates an optional Item.	An implicit "if" statement is set for this statement. This occurs when you map an optional element from the process data to an optional element in the Activity 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.	N/A
	A plus sign indicates the item repeats one or more times.	N/A
	A null sign indicates the item may be set to null.	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.

Copyright © Cloud Software Group, Inc. All Rights Reserved