Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Adeptia Connect offers you two kind of interfaces (textual and graphical) to create and use mapping rules while mapping the source and destination elements. The interfaces are known as "Textual Rule" and "Graphical Rule". The graphical interface makes it easy for you to see the graphical representation of elements and allows you to perform mapping by connecting source element to any target element or to any mapping functions.  Applying mapping rule is also very convenient as you can see the functions graphically and use the context menu options to connect to both source and target elements.

This section guides you on how to use the Graphical rule option while mapping and also introduces the different components of this option.

Table of Contents
maxLevel3

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 described type, behavior, and functioning of the graphical interface and their elements. 

  • Inputs
  • Label
  • Context Menus

Inputs: This shows 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 input in this mapping function/target element.

Label: It tells the name of the element.

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


Element typeDescription
f(x)A mapping function, variable, custom method, key function, context variable, connection variable, etc.
S A source element
D A destination element
T  An XSL Template
VM A Value Map
C A Constant value


Context Menus:  Context menus are used to perform below actions:

    • Start connecting lines to map an element to another element(s).
    • Remove an element/box from the graphical mapping workspace.
    • More Menu will have below options
      • Information about mapping element
      • Remove incoming mappings from the elements
      • Add selected graphical mapping element's syntax/expression as a local variable.




Applying mapping functions using Graphical Rule

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

 
Steps to map elements using Mapping Expression

  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 desired sub-function and use it to map the source and destination elements. For example, using Concat sub-function.

  6. Click String mapping function and select Concat sub-function. The syntax for the Concat sub-function is displayed in the Mapping Expression Area.

    Image Added

  7. 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.

  8. Similarly, double-click another source element as the second parameter. This is displayed in the syntax.

    Image Added

    You can indent the textual rule content as per your requirement.

  9. 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.
  10. 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.

These suffixes are explained in the table below.

Switching between the rule (Add as a Note)


Adding a constant


Displaying error in graphical mapping


Using Lookup Mapping for reference target field