Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

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. 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 NameDescription
    Include clonesImports mapping rules for clones if exist in the selected mapping to be applied.
    Include medium confidence mappingsSearches 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 mappingsSemantically 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 NameDescription
    MapToDisplays 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>.

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

    SelectCheck box to apply a rule to an element.
    Expand AllExpands 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.

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

    Option NameDescription
    MergeSelect this option to apply the selected new rule to the child elements except for those that do not have any mapping rule.
    OverwriteSelect this option to overwrite the existing rules applied to the child elements with the selected one.
    RetainSelect 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: 

    OperationElement NameExisting RuleNew RuleFinal Rules on Child Elements
    MergeNameR1R4R4
    SenderR2R5R5
    Address R6R6
    IdR3 R3
        
    OverwriteNameR1R4R4
    SenderR2R5R5
    Address R6R6
    IdR3  
        
    RetainNameR1R4R1
    SenderR2R5R2
    Address R6 
    IdR3 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. Select Include clones to import mapping rules for clones if exist in the selected mapping to be applied.
  12. Click Apply to return to the iMap window.
  13. 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.

...