NXKnowledge

Content Migration Manager > User's Guide (CMM 1899 Series, Jan 2020) > Part V: CATIA to NX migration > 14. CMM options – CATIA V5

Configuration Options (CMM options – CATIA V5)

Choose Options from the CMM menu. The Options dialog box displays a list of all the configuration options and the current values for each. Open the folders and subfolders to access the options and change the values. The summary list of the configuration options is also displayed when you click on an option category. The options are organized into the following categories and subcategories:

  • Content Migration o Geometry o Assembly o Entity Display Status o Drawing o CATIA V4 Mixed Options o Electrical
  • Application o Migration controls o Quarantine o Remigration o Phased Migration o Actions o Cleanup Scratch o NX Part o User Data o Services o Usability Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5 Content Migration The Content Migration options define the content of the migrated item. Geometry The Geometry options define how the geometry of an item is migrated.

  • Feature Feature options determine the behavior of geometric features and their history when migrated. o Translation Mode This option determines whether features are migrated, or just the boundary representation (B-Rep). ■ Brep Mode With this option selected, the part is migrated as a boundary representation (B-Rep) without features. ■ Feature Mode With this option selected, the part is migrated with features, unless a feature failure condition is detected. The migration processing runs faster and the resulting files are smaller if the part is migrated as a B-Rep. For parts that will not be modified in NX, a B-Rep may be satisfactory. If a B-Rep part needs to be modified, either remigrate the part, or use NX Synchronous Modeling commands. o Brep for Older Revisions If this option is checked, only migrate the B-Rep is migrated for older revisions, not the features. o Save Data for Feature Edit Use this option to save extra data in the migrated part file to allow NX to roll back to an earlier feature when you edit the part in NX. Possible values are None or FastRollback. o Create final part Brep on Feature Failure With this option selected, the part is migrated as a B-Rep if there are failed features. CMM options – CATIA V5

CMM options – CATIA V5 o Geometry Healing Repairs all B-Rep geometry including B-Rep created for unsupported and failing features. This option applies to B-Reps whether features are migrated or just B-Reps are migrated. There are three possible choices, Minimum, Medium, or Maximum. You should start with Minimum, and only select a higher value if necessary. This option can cause modification of the B-Rep geometry, which may not be acceptable depending on your intended use/application of the part. o Electrical Features If this option is checked, it will migrate electrical features as NX features. If unchecked, it will migrate a B-Rep for electrical features. o Translate HarnessSys Data If this option is checked, HARNESS_TASK attributes and wireframe geometry that correspond to CATIA V5 HarnesSys data will be migrated. If unchecked, HarnessSys processing does not occur. o Fidelity Check If this option is turned on, the reconstructed feature history geometry and imported B-Rep geometry is tested for completeness and accuracy against the original geometry. The migration is considered successful when Route Stock Length Difference is within the given value for Success Criteria Route Stock Length Difference %. The value for Success Criteria Max Deviation (mm) is used to compare the shape. The shape of the migrated model must be within the original shape plus or minus this value. o Extract As Face Chain This option will translate Extract Body features as NX Extract Face features rather than Extract Body features. o Ship Attribute Map File This option maps attributes for ship plates and profiles. Specify the path and file name of the file that contains the mapping for the attribute names. To use this functionality, you need to create an XML file to identify the attributes that CMM will use to identify the ship parts. The XML file is structured as follows:

  • Options Options determine which items to include in the migration. o Translate NoShow (Brep) This option is for B-Rep migration only. The option All will translate all on the NoShow side. The option None will translate none on the NoShow side. The option WireOnly translates wire data only on the NoShow side. o Create Data Access Features for No-Op Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5 This option creates an NX data access feature for features that do not create an operation in NX. In effect, this is like a comment statement in the Model History. o Skip CATIA Technological Result during migration This option defines whether to migrate the CATIA Technological Results. o Exclude Invisible Bodies From Reference Sets The invisible bodies are not included in assembly reference sets. CMM options – CATIA V5

CMM options – CATIA V5 Assembly The Assembly options define how assemblies are migrated.

  • Constraints Migrates assembly 3D constraints into NX assembly constraints. If not checked, component positions are maintained but unconstrained.
  • Fidelity Check If this option is turned on, assembly fidelity checking is performed to verify component positioning. The migration is considered successful when the assembly components are positioned within the original position plus or minus the value entered for Position Fidelity Tolerance (m).
  • Position Fidelity Tolerance (m) The tolerance (in meters) used to verify the component position fidelity. Position fidelity tolerance is tested only when the Fidelity Check option (above) is selected.
  • Build Assembly Context Links If checked, attempt to build the assembly context links.
  • Migrate Active Configuration Only This migrates only the active assembly configuration. Entity Display Status These options determine the visibility of various geometry objects after migration. When a check box is selected, the corresponding objects are hidden in the migrated file.
  • Hide Sketches
  • Hide Reference planes
  • Hide Reference curves
  • Hide Reference axes
  • Hide Reference points
  • Hide Reference CSYS
  • Hide Surface features Parts migrated from CATIA V5 to NX will keep objects on the same layers. In NX, the visibility of objects is controlled by layer or by Show and Hide commands. Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5 Drawing These options define how drawings are migrated.

  • Options o Threshold for Thin Thickness, Threshold for Thick Thickness Line widths in CATIA are a numeric value. In NX, they are Thin, Normal, or Thick. NX line width with be set to Thin if the line width in the CATIA drawing is less than or equal to entered value for the first threshold. NX line widths are set to Thick for line widths greater than or equal to the second threshold. Line widths between the two values are set to Normal. o Font Name Map Enter a path and filename for a file that maps the CATIA text fonts to NX text fonts. o Construction Geometry Layer All construction geometry is placed on the specified layer. o Drawings ■ Associative Drawing entities (such as geometry, annotations) are migrated with associativity established. ■ Picture Drawing entities (such as geometry, annotations) are migrated as pictures created from individual line segments. No associativity is created. All scale information is also lost. o Override Color of Fallback Views Checked: Override the color of fallback views in the drawing. Unchecked: Do not override the color of fallback views in the drawing. o Store Data for Drawing Repair Assistant Store additional data in the drawing file to help with manual repair of drawings. o Move invalid source CAD annotation to specified NX layer Invalid source CAD annotation detected during migration will be moved to the specified NX layer, using the supplied layer category name. o Category for Invalid Annotation Optional: The category specified is displayed in the Layer Settings dialog box in NX. o NX Layer for Invalid Annotation Any valid NX layer. All invalid annotations are placed on this layer during migration. o Capture curve style as view dependent edits Capture the style of each 2D curve in the source drawing and apply as view dependent edits. CMM options – CATIA V5

CMM options – CATIA V5

  • Verification o Drawing Entity Fidelity The reconstructed drawing entities (geometry, annotations) are checked for content, completeness, and positional accuracy.
  • Drawing Evaluation Parameters o Drawing Evaluation Basic Parameters ■ Drawing Evaluation Method The options specify how entities in the drawings are evaluated for completeness. ◊ Basic All entities in the drawing are evaluated together regardless of their entity type using a single set of criteria. ◊ Custom Entities in the drawing are evaluated in related categories based on their type with different criteria specified for each category. ◊ None Entities in the drawing are not evaluated. CATIA V4 Mixed Options These options define how CATIA V4 parts within a CATIA V5 assembly are migrated. These limitations apply when migrating CATIA V5 assemblies containing V4 items.
  • You must have valid licenses for both CMM for CATIA V5 and CMM for CATIA V4. The migration will checkout both licenses. If both licenses are not available, the migration will fail.
  • CATIA V4 items are migrated as a B-Rep. No feature migration is supported.
  • The CATIA V4 items will be migrated to a single part. Even if the CATIA V4 model represents an assembly, CMM will migrate it as a single part. There is no option to change this behavior. The following CATIA V4 Mixed Options are the same as those from CATIA V4 migration. These options do not apply to AEC models.
  • Include Exact Solid Include the exact solid in the translation. Note that if you select solids and faces and surfaces at the same time, this may result in duplicate geometry.
  • Include Volume Include the volume in the translation.
  • Include Skin Include the skin in the translation.
  • Include Face Include faces in the translation. Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5

  • Include Surface Include surfaces in the translation.
  • Include Curve Include curves in the translation.
  • Include Point Include points in the translation.
  • Include Mock-up Solid Include the mock-up solid in the translation.
  • Filter Option Select Current Filter to translate entities in the current CATIA V4 filter. Select All Filter to translate all entities.
  • Translate NoShow Side Translate the hidden entities.
  • Ignore items on layers... The items on the layers listed will not be migrated. You may use hyphens to specify layer ranges. Electrical These options define how electrical data is migrated.
  • Build Native Routing Path With this option turned on, associative routing paths are created.
  • Native Routing Path Fit tolerance (mm) This field specifies the routing path fit tolerance.
  • Success Criteria Routing Path Length Difference % This field specifies the routing path length tolerance as a percent.
  • Success Criteria Routing Path Length Difference (mm) This field specifies the routing path length absolute tolerance in millimeters. CMM options – CATIA V5

CMM options – CATIA V5 Application The Application options provide preferences for general migration operation. Migration Controls Migration Controls options specify how you want the migration to run.

  • Source CAD System This option defines the specific installed version of CATIA V5 used for the migration.
  • Target data o Managed Lets you manage the new NX part files within the Teamcenter environment. o Filesystem The new NX part files are in an unmanaged data management environment (on the file system). This option is useful when performing a test migration because the Teamcenter database is not modified.
  • CMM Process Mode Specifies the process your site will use to control data access during and after migration. o Project Select this option if your migration process uses a Teamcenter project to lock data during migration. If Project is selected, CMM will check that users are following this process. When you perform a pre-migration scan of your data, CMM will give a warning if the data to be migrated is not assigned to a project. When you migrate your data, CMM will not perform the migration if the data is not assigned to a project. o Status Select this option if your migration process uses the method of applying a Teamcenter status to lock data during migration. If Status is selected, CMM will check that users are following this process. When you perform a pre-migration scan of your data, CMM will give a warning if the data to be migrated is not assigned a status. When you migrate your data, CMM will not perform the migration if the data is not assigned a status. o None Select this option if you have some other process in place to control access to migrated data. If this option is selected, CMM will write a message in the log file, but will not perform any checking during pre-migration scans or when migrating data. Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5

  • Status/Project for Process Mode Define the status or projects that will be allowed to migrate. Separate multiple values with a semicolon.
  • Skip Check Out Reused Review Status This option allows you to establish a process that uses the CMM Review Status of a previously migrated item to determine whether it should be checked out when reused in any future migration. You can set this option to Approved, +PendingApproval or ++PendingRepair. The status of the reused part will be compared to this setting. For example, if you set this option to +PendingApproval, and a reused part has a status of Pending Approval or Approved, the migration will continue without checking out the reused part. You must ensure that no user will modify these parts while they are being reused in a migration.
  • Generate JT from Source CAD Dataset Creates a DirectModel dataset (JT file) for the migrated part. This option is off by default.
  • Migrate Component Drawings in Same Item Revision Migrates related datasets, such as a drawing for a part, when you migrate an assembly. Only datasets contained in the item revisions for the assembly components (such as drawings) are migrated. The selection of the components is based on the Remigrate option.
  • Scratch Location Location for miscellaneous files created during migration (deleted at completion of migration) and log files. This is also the location for new NX part files if you are migrating to an unmanaged data management environment (on the file system). The default directory is: %TEMP%\CMMScratch Use an empty directory. A directory is automatically created if you specify one that does not exist. Do not make this directory the same as the temp directory. Do not use the same location for multiple users or when running concurrent sessions. You might need to allocate a lot of disk space to this directory depending upon the size and number of the migrated items.
  • Report location Directory location for migration reports.
  • Report Style Sheet Location of the XSL style sheet needed to view the migration report. CMM options – CATIA V5

CMM options – CATIA V5

  • Failed Items Folder Directory location to store all items that failed migration. You can review this single folder to see everything that failed migration. After migration passes, you need to remove it from this folder.
  • Item Type Map File Path and name of the file containing the item type map. This file is customer specific. Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5 Reuse Lookup Table The Reuse Lookup Table is used with CMMSolo to migrate data from several source folders without migrating shared data multiple times.

  • Reuse Lookup Table Lets CMMSolo use the Reuse Lookup Table.
  • Reuse Lookup Table Location Sets the directory to store the Reuse Lookup Table. This directory should be a unique location for each CMM user. It should also be a location that is not likely to be deleted or modified by anyone or any process other than CMM. CMM options – CATIA V5

CMM options – CATIA V5 Quarantine The Quarantine operation keeps parts with certain issues from being migrated, or migrates them as B-Rep parts. The Quarantine options specify the action taken if a quarantine is used and what is checked during the quarantine operation.

  • Quarantine Action o Disabled Using this option, the quarantine check is not performed. o Info only Using this option, CMM performs the quarantine check, but only provides information. CMM does not apply the quarantine results to the migration of the item. If the quarantine check does not pass, the term Migration is orange in the Migration Status window. o B-Rep Using this option, if there is an error during the quarantine check, CMM creates a B-Rep part for the item. It does not check for locked or suppressed nodes. If the quarantine check does not pass, the term Migration is orange in the Migration Status window. o Failed Using this option, if there is an error during the quarantine check, CMM identifies the item as failed and does not migrate any dependent items. For example, if a part fails the quarantine check, CMM does not process the assembly that contains the part. If the quarantine check does not pass, the term Migration is red in the Migration Status window.
  • Replay Errors Checks for red (failure) or yellow (warning) nodes in the history tree indicating there was a problem during the replay operation. Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5 Remigration The Remigration options specify the parameters for migration of previously migrated items. When you remigrate a part, all of the parent items should be remigrated. Otherwise, the dependents (assemblies and drawings) will not be updated. Remigration is not an update. Any changes made to the part after the previous migration are not kept. If an item is remigrated, the existing NX dataset and the newly created one are given version numbers.

  • Remigrate o Disabled With this option selected, CMM does not remigrate any items. o Selected Remigrates the items that have been selected. o All Remigrates selected items and children of those items.
  • Remigrate Native NX The purpose of this option is to allow you to use a process where JT files (Direct Model datasets) from the original CAD system are used as NX parts (B-Rep only) before the parts are migrated using CMM. This is especially true if the NX Refile utility is used. The NX Refile utility converts these datasets to NX datasets, which look the same as datasets migrated using CMM, even though they do not contain feature history migrated using CMM. With this Remigrate Native NX option turned off, CMM will not override these NX datasets. If you want to migrate the original models to create fully-featured NX datasets, turn this option on. CMM will force the remigration of the original models and replace the existing NX datasets. This is enabled even if Remigration is turned off. CMM options – CATIA V5

CMM options – CATIA V5

  • CMM Version Conditional Remigrates items relative to a CMM version. For example, < indicates that items that have already been migrated prior to a specific CMM version (indicated below) are remigrated. The conditions available are: o < o <= o

    o

= o

  • CMM Version Version of CMM used with the version condition (above). The syntax is N.N.N.NNN. You can also use partial strings, for example, 4.0.
  • Item Type Remigrates specific item types. o All Remigrates all item types. o Assemblies&Drawings Remigrates assemblies and drawings only.
  • Migration Date Conditional Remigrates items relative to a date and time. For example, < indicates that items that have already been migrated prior to a specific date (indicated below) are remigrated. The conditions available are: o < o <= o

    o

= o

  • Migration Date Date used with migration date condition (above). The syntax is YYYY-MM-DD HH:MM:SS. You can also use partial strings, for example, 2006-02. Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5

  • Report Status Remigrates items based on the Report Status field on the CMM Attributes form. o All Remigrates all items regardless of whether they passed or not. o Failure Remigrates items that failed migration. o +Warnings Remigrates items that failed migration and had warnings during migration.
  • Review Status Remigrates items based on their review status. The review status is identified in the ReviewStatus field on the CMM attributes form. Phased migration uses this option. o Rejected Remigrates only those items that have a rejected status. o +Not checked Remigrates items that have status of rejected or not checked. o ++pendingRepair Remigrates items that have a status of rejected, not checked, or pending repair. o +++pendingApproval Remigrates items that have a status of rejected, not checked, pending repair, or pending approval. CMM options – CATIA V5

CMM options – CATIA V5 Phased Migration Phased migration migrates the parent if the child components meet the status criteria defined in the options.

  • Check Review Status Use the following review status for child components to determine whether the parent item is migrated. The review status is identified in the ReviewStatus field in the CMM attributes form for child components. The review status is also checked during remigration. Items with Approved status are not remigrated. o Approved Migrates the parent item if the child components have only an approved status. o +PendingApproval Migrates the parent item if the child components have an approved or pending approval status. o ++PendingRepair Migrates the parent item if the child components have an approved, pending approval, or pending repair status. Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5 Actions These options specify how you want the migration to proceed when items fail to migrate or do not migrate as expected.

  • Migrate action o NeverStop Migration does not stop even though failures have occurred. Failures are defined by the Success Criteria category described above. o StopAfter Stops migration after a specified number of failures. Failures are defined by the Success Criteria category described above. Number of failures is defined in Error limit described below.
  • Error limit Stops the migration process after a specified number of failures.
  • Migration Timeout [mins] Maximum amount of time that CMM will try to migrate an item before it aborts the migration process. The time is specified in minutes.
  • Item fail action o SeedItem If the migration process does not produce an NX part, then use a seed (empty) part. This allows dependent hierarchies to be migrated. o SkipItem If the migration process does not produce an NX part, then skip the item. Dependent hierarchies are also skipped (not migrated).
  • Restart services after items Restarts the CATIA migration and NX migration services after migrating a certain number of items. This option and the next option are set at these default values for performance reasons.
  • Restart services after total file size (MB) Restarts the CATIA migration and NX migration services after migrating a specified total file size.
  • Create CMM Attribute Creates a form that contains CMM migration attributes. The form is placed in the item revision for the migrated item. You can perform a search in My Teamcenter on any of the fields in the form to find items with similar migration attributes. To enable this functionality, you may need to update the Teamcenter schema. For information on updating the schema, see the Configuration Guide chapter.
  • Allow item selection after load Pauses the migration process after loading items so that you can select or deselect individual items. Migration or other commands can then be performed on the currently selected items. If not checked, migration is started immediately on all loaded items after the items are loaded. CMM options – CATIA V5

CMM options – CATIA V5

  • Confirm Selection Pauses the migration process to allow you to confirm your selection before migrating. Click the OK button on the Migration Status dialog box to proceed with migration. If not checked, starts the migration process immediately for the items selected.
  • Store CMM Log File in Teamcenter If selected, stores the CMM Log File in Teamcenter. If not selected, stores the CMM Log File in the scratch location folder.
  • Submit to Dispatcher Translation Priority Values of 1,2, and 3 correspond to low, medium, and high priority.
  • Submit to Dispatcher Translator Name Select the name of the CMM migration translator to use for the migration. Cleanup Scratch Use these options to clean up the CMM scratch folder after the migration.
  • Delete Report Files Select this option to clean up the report files.
  • Delete Associated Files Select this option to delete associated files including Maps, PSDs, and History files.
  • Delete Scratch Files Select this option to clean up the scratch files.
  • Delete Translation Files Select this option to clean up the translation files, including EPF and XPK files.
  • Delete SourceCAD Select this option to clean up the original CATIA source CAD files. NX Part The NX Part options specify the configuration for a migrated item.
  • Model Template Item ID This is the item ID for the part seed template.
  • Model Template Item Revision This is the item revision for the part seed template.
  • Assembly Template Item ID This is the item ID for the assembly seed template.
  • Assembly Template Item Revision This is the item revision for the assembly seed template.
  • Drawing Template Item ID This is the item ID for the part drawing seed template.
  • Drawing Template Item Revision This is the item revision for the drawing seed template. Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5

  • Non-Master Part Type o Specification The migrated item is created with specification type relations. These relations are detailed methods, designs, processes and procedures used to satisfy requirements. o Manifestation The migrated item is created with manifestation type relations. These relations are non-defining snapshots of a particular aspect of an item at a specific moment in time. The information is only accurate as long as the item revision does not change. For additional information on these relation types, see the Teamcenter Online Help Documentation.
  • Model Template File Path and name of the file that contains the seed part.
  • Assembly Template File Path and name of the file that contains the seed part for assemblies.
  • Drawing Template File Path and name of the file that contains the seed part for drawings.
  • Default Target Units Default units used when creating NX parts. This is not used when the template file is provided.
  • Asymmetric Mirrored Component Action This option determines the action taken when asymmetric left-handed parts or assemblies are migrated. o Stop CMM will stop processing if asymmetric left-handed parts or assemblies are encountered. o Mirror CMM will mirror the part or assembly and fix the problem.
  • Left Handed Instance Suffix Supply a string to be appended to the NX filename created for the left-handed instance of an item. User Data The User Data fields allow you to enter data applicable to your site.
  • Set CMM Attributes Field User_Field_1 Enter data specific to the migration or to the set of data you are migrating, such as Migration Test 1, or Customer XYZ Data. User Data fields User_Field_2, User_Field_3, User_Field_4 provide the same functionality. CMM options – CATIA V5

CMM options – CATIA V5 Services The Services options provide required entries to set up the migration.

  • Stop Services Determines how you want to stop the CATIA migration and NX migration services during migration. Stopping the services also effectively halts migration. o End of Session Stops the services at the end of the migration session. o On Failure Stops the services and restarts after an item fails to migrate. This is repeated for each migration failure. o After Each Item Stops the services and restarts after each item has been migrated. Usability Use the Usability options to change the color of messages displayed in the CMM Message window for users with different types of color perception issues. These options allow you to change the colors for each type of warning and status listed in the migration status results to allow someone with various kinds and severity of colorblindness to tailor to colors for your needs. Chapter 14: CMM options – CATIA V5

CMM options – CATIA V5

Source: CMM 1921 download (Support Center PL20201112075217794, CMM1921.7z), NXMigration/Documentation/cmm_1921.pdf, page 159 · retrieved 2026-10-02