Page Comparison

Elements of Graphical Rule

The Mapping Expression area has a floating menu that contains two options for you to switch between the Graphical and Textual rule. You can drag this floating menu anywhere in the Mapping Expression area. 

Graphical elements are components which are used to represent any source, destination, mapping function, or parameter elements visually in Mapping Expression area. The following types of annotations describe the type, behavior, and functioning of the graphical interface and their elements. 

• Floating Menu
• Inputs
• Label
• Element type
• Context Menu

Image Added

Floating Menu

Inputs

The number of inputs a mapping function or a target element can have. Also, you can drag a line from input element to this section to use that as an input in this mapping function or target element.

Label

The name of the element.

Element type

Type of element being used in the mapping rule. The following list explains the types of elements:

Context Menu options are used to perform the following actions:

Image Added

• To draw the connecting lines to map an element to another element(s).
• To remove the field/function from the Mapping.
• To go into More menu option. It contains the following action items:
  
  • Information option to know the details about the element.
  • Remove Mapping option to remove the mapping from the element.
  • Add As Local Variable option to add the element's syntax/expression as a local variable.

Applying mapping functions using Graphical Rule

Mapping Expression tab gives you two interfaces, Textual and Graphical, to perform the mapping. By default, the Graphical Rule is active.

Image Added

Note
You can switch to the Textual Rule interface by clicking the Textual Rule Image Added icon in the floating menu. A warning message is displayed asking for your confirmation, click Yes to switch to Textual Rule. To perform mapping in Textual Rule interface, refer to this document.

You can use the option, Graphical Rule, available under the Mapping Expression tab in the web mapper. 

1.  Ensure that the source and destination layouts are loaded and all their elements are listed under their respective nodes.
2. Click Mapping Expression tab from Mapping Functional Panel.

3. Select a destination element which you want to map.

4. Click the desired mapping expression. This displays a list of sub-functions associated with the selected mapping expression.
5. Select the

    

   Tip
   Until you select a destination element first, the Mapping Expression tab will remain grayed out.

   
   

6. Click Mapping Expression tab at the left bottom of the screen.
   The destination element that you have selected will be visible in the mapping expression area.

7. Double-click a source element that you want to map to the destination element. 

8. Click a mapping function that you want to use and select the desired sub-function and use it to map the source and destination elements. For example, using you can use the Concat sub-function.

   Note
   You can also add a parameter in the mapping expression area by double-clicking the parameter's name in the Parameters panel.

   
   

9. Click String mapping function and select Concat sub-function.

   The syntax for the Concat sub-function is displayed

    
   Once you have all the corresponding graphical elements (source elements, destination element, and mapping sub function) available in the mapping expression area, do the following:

   Tip
   You can drag and reposition the graphical mapping elements anywhere in the Mapping Expression

   Area.
   Image Removed
   

10. This syntax has two parameters. Double-click a source element that you want to set as the first parameter. This displays the selected source element in the syntax.

Similarly, double-click another source element as the second parameter. This is displayed in the syntax.
Image Removed
You can indent the textual rule content as per your requirement.
11. This maps elements using the concat sub-function. A line is displayed between the source and target panels showing the mapping of the source element to the target element.
12. Once you have performed the mapping activity, click Save button to save the mapping.

For details on using these mapping functions, refer to the section Using Mapping Functions. 
While mapping elements, certain suffixes are displayed next to source and destination elements in the Source and destination Panels.

(C)

destination element can be cloned to create another destination element.

(CM)

Comments have been added for the destination element.

(F)

For Each property has been applied for the destination element.

(LV)

A local variable has been declared to the destination element.

1. area.

   1. Click each of the source elements and select the Image Added icon from the Context Menu to connect the source with the respective Inputs of Concat sub-function. 

   2. Click the Concat sub-function and select the Image Added icon from the Context Menu to connect with the destination element. 
      The source elements are now mapped to the destination element using Concat sub-function and the mapping is visible in the mapping panel.
      
      Image Added
      
      

      Tip
      You can reposition the entire mapping within the Mapping Expression area by clicking anywhere and moving the cursor.

      
      

You will be notified of an error message in the Comments section if the mapping function and destination element do not have the proper mapping. 

Color coding of connecting lines

The color of the connecting lines depend upon the following three factors:

Adding a constant

You can add a Constant while mapping the source and destination elements. This option is visible only when you are applying the graphical mapping rule.

Perform the following steps to add a Constant:

1. Click Image Added button located at the bottom of the Mapping Expression window. 
   A graphical notation for the Constant will be added to the Mapping Expression area. 
2. Double-click the Constant notation. 
   Add Constant window appears.
3. Enter a constant value in the Constant Value field. 
4. Select the Add Quotes check box if the value is String type.
5. Click Ok.
6. Click the Constant notation and select the Image Added icon from the Context Menu to connect with the destination element. 

Using Lookup mapping function for a reference field in target layout

When the destination element of target layout is a reference field, the Mapping Expression feature gives you an additional option of Lookup Mapping on the floating menu. 

Lookup mapping function is used to set the dynamic value for the reference field by searching a value in the source field that matches the corresponding record of a destination field. For example, if you know the Account name at the source and do not know its respective ID, you may use the Lookup function and find it.    

The Lookup function is supported for the following business applications:

• BigCommerce
• FreshBooks
• Magento
• QuickBooks
• Salesforce
• Service Now
• Xero
• Zendesk

Perform the following steps to use the Lookup mapping function:

1. Select the reference field element for which you want to use Lookup mapping function.

2. Click Mapping Expression tab at the left bottom of the screen.
   The Lookup option will be become available on the floating menu and you get options in the mapping expression area to choose the reference account.

3. Select the Lookup option. 
   
   Image Added
   
   
4. Perform the following steps to define the criteria based on which the reference field value will be fetched:
   1. Select the destination field for which you want to match value at source from the Target Field.

   2. Select Equals operator from the Condition. 

      Note
      You will find other operators in case of Service Now application only. Depending on the selected Target Field type (integer, boolean, string, date/time, reference, and GUID) the operators will differ.

      
      

   3. Select the source field that should match the value of the selected destination field from the Source Field. 

      Note
      You can select multiple fields if you have selected is one of or is not one of operator in the Condition drop-down list. You can select two fields only if you have selected between operator in the Condition drop-down list.