Reverse engineering options 3 page (IDL Code Reverser)
This page allows you to specify folder to package mappings, which determine where the code files selected for reverse engineering are created in the Model. In addition, this page is used to specify compiler search paths and #include paths for dependent code files, such as external libraries.
For information about reverse engineering IDL code, click here Overview of reverse engineering IDL code (IDL code)
Specifying mappings for reverse engineering code files
Having specified code files to reverse engineer, you must now map those files to target packages in the Model. You do this by mapping a folder that contains the files selected for reverse engineering (either directly or through any of the folder's subfolders) to a Package in the Model. By default, the Root Directory you specified for your project is mapped to the Root Object you specified in the Model, even though this mapping is not listed:
• If the Root Directory owns all of the code files selected for reverse engineering (either directly or through any of the Root Directory's subfolders), all the code files will be reverse engineered because of the default Root Directory to Root Object mapping.
• If you have selected files for reverse engineering that are not owned by the root directory or any of its sub folders, you must map folders to Packages in the Model so that each code file selected for reverse engineering is a descendent of a folder that is mapped to a Package.
 |
• You cannot map any parent or subfolders of the root directory to the Model or a Package.
• Each code file you select for reverse engineering is reverse engineered only if their owning folder or one of the owning folder's parent folders is mapped to a Package (either the Model itself or a Package in the Model).
|
Specifying search paths that contain dependent files
The code files you have selected for reverse engineering may be dependent on other code files. The Reverser parser needs to know the paths in which dependent code files reside to correctly parse the code files selected for reverse engineering.
You must specify the compiler search paths and optionally map those paths to Packages in the Model:
• If you do not want to reverse engineer any code files used in a search path, do not map the search path to a Package in the Model.
• If you want to reverse engineer any code files used in a search path, map the search path to a Package in the Model.
When you specify search paths for #include files, by default the parser does not search for files in subfolders of those search paths. If you want the parser to search for #include files in subfolders of the search paths you have specified, select the Recurse #Include Folders check box on the Reverse Options Page 3 page.
|
|
You must ensure that the #INCLUDE path check box is selected for each path. If the #INCLUDE path check box is cleared and the path is not mapped to a package, the path is ignored.
|
Order of the mappings and search paths
The Reverser parser searches the paths in the order they appear in the list, so ensure that the order is correct.
To map a path to a package:
1. Click the 
Add Mapping button.
Add Mapping button.2. Select the required folder.
3. Clear the #INCLUDE Path check box.
4. Select the Map to Package check box, and then select the required Model or Package.
5. Click Insert.
To add a compiler search path without reverse engineering used files from that path:
1. Click the Add Mapping button.
Add Mapping button.2. Select the required folder.
3. Select the #INCLUDE Path check box.
4. Clear the Map to Package check box.
5. Click Insert
To add a compiler search path and reverse engineer used files from that path:
1. Click the Add Mapping button.
Add Mapping button.2. Select the required folder.
3. Select the #INCLUDE Path check box.
4. Select the Map to Package check box, and then select the required Model or Package.
5. Click Insert.
To search subfolders of the compiler search paths you have added:
Select the Recurse #Include Folderscheck box.
To move a mapping or search path up or down the list
1. Select the mapping you want to move.
2. Use the 
and 
buttons to move the mapping to the required position.
and buttons to move the mapping to the required position.To change a mapping or search path
1. Select the mapping or search path you want to change.
2. Click the 
Edit Mapping button.
Edit Mapping button.3. Make the required changes, and then click Update. Alternatively, you can double-click a mapping or search path in the list to change it.
To delete a mapping or search path
1. Select the mapping or search path you want to delete.
2. Click the 
Delete Mapping button.
Delete Mapping button.