Page Comparison

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. You can then choose from these high-, medium-, and low-confidence mapping suggestions accordingly. 

Following are the steps to enable and work with iMap:

1. Enable iMap to allow auto mapping of the fields.
2. Create a mapping using Data Mapper.
3. Load source and target schemas.  
4. Map the elements using iMap wizard.

Anchor
Enable_Auto_Map Enable_Auto_Map

Enabling iMap

 To enable iMap:

1. Go to Administer > Setup > Application Settings > Update System Properties.
2. Expand Intelligent Data Mapping (IDM). 

3. Set the value of the abpm.services.idm.enable property to yes.

   
   
   

4. Click Save.
5. Click Reload Configuration to reflect the changes.

Anchor
Create_Mapping Create_Mapping

Creating a Mapping

Access Data Mapper and create the mappingmap the source and target elements.

Anchor
Load_Schemas Load_Schemas

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:

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

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

   Value	Description
   Yesyes	Elements of the schemas will be automatically mapped if the names of the source and the target elements and metadata are similar.
   Nono	Mapping will be done using iMap wizard.
   Askask	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.

Anchor
Mapping_Elements Mapping_Elements

Mapping Elements Using iMap Wizard

To map the elements using iMap wizard:

1. Click  to open the iMap wizard.

2. iMap displays following three 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.
   Image Removed

   SuggestionDescriptionHigh ConfidenceThis category

   
   

   Image Added

    

3. Click Apply. The mapping suggestion will get applied to your loaded schemas.
   
   Image Added

   Info
   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

   .Medium ConfidenceThis 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 SemanticThis 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.

   Info
   A number corresponding to each suggestion denotes the number of source and target elements that can be mapped.

   Select from the iMap suggestions and click Apply. The selected mapping suggestion will get applied to your loaded schemas.
   Image Removed
   
4. You can also map the fields manually by clicking Explore.
   Image Removed
   Image Added
   
   

5.  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. 
   Image Removed
   Image Added

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

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

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

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

   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 correspodning 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 details, 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.

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

   info

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

   Image Modified

   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

   new rule

   one.
   Retain	Select this option to retain the existing rules applied to the child elements.

   The new rule

   Only for each will be applied

   only

   to the branch element (node).

   On choosing from any of the options, a warning may appear. Click Image Modified 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

10. Select Include Semanticsemantics 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. 
11. Click Apply.
12. Click Apply.
    Image Removed
13. Select Include clones to import mapping rules for clones if exist in the selected mapping to be applied.
14. Click Apply to return to the iMap window.
15. Click Apply to map the elements.
    
    Image Added
    
    The term 'H' in the green background indicates high confidence rules, 'M' in the yellow background indicates medium confidence rules, and 'S' in the red pink background indicates semantic rules.

...