iMap (Intelligent Data Mapping)

iMap works on the principle of Artificial Intelligence and leverages a repository of mappings stored at the Adeptia-secured cloud. This repository hosts the mappings created by users of Adeptia Suite. Each of these mappings has specific keywords attached to it which a user would provide in the metadata field while creating a mapping. If you choose to use iMap while creating a mapping, it will fetch the mapping suggestions (from the repository) that match the elements of the schema. iMap uses a series of algorithms and provides mapping suggestions that are nearest to the accuracy you look for.

Following are the steps to enable and work with iMap:

Enabling iMap

To enable iMap:

Go to Administer > Setup > Application Settings > Update System Properties.
Expand Intelligent Data Mapping (IDM).
Set the value of abpm.services.idm.enable property to yes.
Click Save.
Click Reload Configuration to reflect the changes.

Creating a Mapping

Access Data Mapper and map the source and target elements.

Loading Source and Target Schema

Before loading schemas, specify the value in the abpm.services.idm.autoapply property to map the elements of the loaded schemas either automatically or manually. To specify the value:

Go to .../AdeptiaInstallFolder/ServerKernel/etc folder.
Open server-configure.properties file in the Text Editor.

Specify the value in the abpm.services.idm.autoapply property. The value can be:

Value	Description
yes	Elements of the schemas will be automatically mapped if the names of the source and the target elements and metadata are similar.
no	Mapping will be done using iMap wizard.
ask	iMap wizard appears automatically with recommended mappings after you load schemas, default selected.

After you have specified the value, now load the source and target schema in the Data Mapper. When you load the schemas, the elements of the schemas will be mapped on the basis of the value specified in the property.

Mapping Elements Using iMap Wizard

To map the elements using iMap wizard:

Click to open the iMap wizard.
iMap window appears with the recommended mapping suggestions that can be applied to your schemas based on the mapping already done by the Adeptia Suite users.
Click Apply. The mapping suggestion will get applied to your loaded schemas.

The term 'H' in the green background indicates high confidence mapping. High Confidence mapping fetches the mapping suggestions after matching the highest number of metadata and mapping rules with the elements of mapping that you have created. This type of confidence is always valid and can be imported directly.
You can also map the fields manually by clicking Explore.
iMap window appears with a list of mappings that can be applied to your loaded schemas. High confidence mapping is selected as default and is marked as Recommended. However, you can change the selected mapping from the list.

You can also view other mapping suggestions by clicking displayed at the lower left corner.

Select the mapping to apply to the loaded schemas, select option(s) from the Other Options to apply on the selected mapping, if needed, and then click Apply.

Option Name	Description
Include clones	Imports mapping rules for clones if exist in the selected mapping to be applied.
Include medium confidence mappings	Searches the map rules and applies to the elements that are not mapped by the selected mapping option. The number of suggestions is displayed in the square brackets []. This category of mapping rules contains the suggestions of those elements whose mapping is not matched in the high category. Hence, the dependency of the rules suggested in medium confidence might not be present in the current mapping. Therefore, you must validate these suggestions before using in the current mapping.
Include semantic confidence mappings	Semantically map the elements that are not mapped by the selected mapping and other mapping rules, if selected. This category of mapping rules contains the suggestions of those elements whose mapping is not covered in both High and Medium categories. This is calculated by using a semantic comparison between source and target elements. Therefore, you must validate these suggestions before using in the current mapping.

You can also view the preview of the selected mapping to be applied and also choose the mapping rule that you want to apply to the element by clicking Explore.

iMap window appears listing the target elements with mapping rule that can be applied to the elements.

Field Name	Description
MapTo	Displays all the target elements in a structured tree.
MappingRule	Displays the mapping rule to be applied to an element. By default, this field will display mapping rules only for the number of suggestions specified corresponding to the selected mapping. An element may have for each rule and mapping rule applied. For each rule will be displayed in the format - <foreachrule>::. Mapping rule will be displayed in the format - ::<mappingrule>. If an element has both mapping rule and for each then it will be displayed as <foreachrule>::<mappingrule>.
Info	Displays the mapping rule and for each applied to an element. In addition, it will also display the name and values of the following, if any, applied to an element - Global Variable, Local Variable, Ancestor Variable, Custom Methods, Global Methods, Key, Connection Variable, Context Variable, Local Template, Global Template, Group Template, Global ValueMap, Group ValueMap, Project ValueMap, and SourceXpath. No value will be displayed for Group Template, Group ValueMap, and Project ValueMap.
Select	Check box to apply a rule to an element.
Expand All	Expands all the target elements of a structured tree.

Choose the mapping rule from the drop-down list displayed corresponding to the element in the MappingRule column. This drop-down will list all the mappings applied to an element in other mappings.

If you are changing any rule on the branch node, then a dialog box will appear with the following three options.

Option Name	Description
Merge	Select this option to apply the selected new rule to the child elements except for those that do not have any mapping rule.
Overwrite	Select this option to overwrite the existing rules applied to the child elements with the selected one.
Retain	Select this option to retain the existing rules applied to the child elements. Only for each will be applied to the branch element (node).

On choosing from any of the options, a warning may appear. Click to view the warning message. This warning message may be related to the dependency or compatibility. The dependency used in the rule may not appear or rule at the node is not compatible with the rule applied at the parent node.

For instance, consider a node with child elements - name, sender, address, and id. Element Name has R1 rule, Sender has R2 rule, and Id has R3 rule. The newly selected rule has R4 rule on Name, R5 rule on Sender, and R6 rule on Address. On applying the option, the new rules on the child elements will be as follows:

Operation	Element Name	Existing Rule	New Rule	Final Rules on Child Elements
Merge	Name	R1	R4	R4
	Sender	R2	R5	R5
	Address		R6	R6
	Id	R3		R3

Overwrite	Name	R1	R4	R4
	Sender	R2	R5	R5
	Address		R6	R6
	Id	R3

Retain	Name	R1	R4	R1
	Sender	R2	R5	R2
	Address		R6
	Id	R3		R3

Select Include semantics check box to include semantic mappings to the elements. On selecting this check box, a semantic mapping rule will get applied to the elements on which no mapping rule is defined.
Select Include clones to import mapping rules for clones if exist in the selected mapping to be applied.
Click Apply to return to the iMap window.
Click Apply to map the elements.

The term 'H' in the green background indicates high confidence rules, 'M' in the yellow background indicates medium confidence rules, and 'S' in the pink background indicates semantic rules.

You can also change the mapping rule applied to a particular target element using Show Intelligent Auto Mapping Options. To change the rule:

Right-click the target element and then click Show Intelligent Auto Mapping Options.
The Mapping Options window appears listing all the mapping available for that particular target element.
Select the mapping and click Apply.
Click Yes, when prompting to overwrite the mapping for this node.
The Paste Options window appears listing the following options - Paste Mapping, Paste For Each, Paste Comments, and Paste Local Variable. Select the required options to copy with the selected mapping and click OK.

Options may be enabled or disabled if they are defined in the selected mapping.