Guidelines for Building Rules

Use the following guidelines to assist you when defining rules as a text string or a tree.  For procedures on defining rules, see Building a Business Rule or Building a Transformation Rule.

Display

Action

Goal

String

Type a period [.] at the beginning of the string

To display the Select a known symbol assist box. Scroll through the list and double-click an item to place it in the rule.
 

String

Type the first letter of an operation

To limit your display to the operations beginning with that letter. Scroll through the list and double-click an item to place it in the rule.

Example: Type S to display operations, such as starts-with, string, string-length, and so on.

 

String

Type the prefix "syexts"

To display a list of XSLT extension functions provided in the Map Editor. See Building a Transformation Rule.

 

String

Type the prefix "java_lang"

To display a list of the Java methods that are enabled in the Map Editor. See Building a Transformation Rule.

 

String

Drag and drop any icons from the tools palette into the text box

To add a function or operator to your rule.

String

Double-click the text string

To parse your rule and graphically display the rule method and arguments as a tree.

String

Use single quotes

To enclose all hexadecimal constants and constant strings. Do not use double quotes.

Examples: '0x53321' and 'PROD:835A'

 

String

Do not use quotes for numbers and XPath expressions

To enter values. You must include a 0 place holder for decimal values < 1.

Examples: 185, 100.50, and 0.2345

 

String

Use the prefix \

To embed all single quotes.

Example: 'Monday, June 3:834\'BLUE\':...

Note: This is important when constructing Date/Time format strings.

 

String

Use whitespace and carriage returns

To organize a rule.

Example: a/b/c > 100

                   and

              /a/b/d < 200

Tree

Double-click the root node of a rule tree

To display the rule as a text string.

Tree

Double-click a parent node in a rule tree

To collapse its sub-tree.

Tree

Right-click and select Orientation and a direction from the short-cut menu

To change the orientation of your rule tree or to alleviate the condition of overlapping nodes.

Example: Select North to place the root of the tree at the top to bottom, and select West to place it to the left.

 

Tree

Right-click on your rule and select Icon Spacing>Larger from the shortcut menu

To proportionally increase the size of your rule tree display. Changes are incremental and may require multiple applications.

Tree

Right-click on your rule and select Icon Spacing>
Smaller from the shortcut menu

To proportionally decrease the size of your rule tree display. Changes are incremental and may require multiple applications.

Both

Press the spacebar

To parse your rule and display the Select a known symbol assist box to help you in completing your rule or viewing the current status of a rule. This action is useful if you are unsure as to how to proceed.

 

Both

Press Esc

To close the Select a known symbol assist box.

 

Both

View the status bar

To review the current status of a rule.

Example: If the rule is ./a=, the resulting status is

Unexpected end of expression.

 

Both

Click

To close the builder and return to the active editor.

 

Both

Select text in your string, right-click and select Copy from the shortcut menu

To copy items contained in your rule definition.

 

Both

Select text in your string, right-click and select Paste from the shortcut menu

To paste items into your rule definition.