Preferences Related to Import/Export

Attribute Mappings

Use CATIA_apply_savemanager_map_in_import_spreadsheet to apply or not apply attribute mappings in the Import Spreadsheet.  By default, attribute mappings are not applied.  Set this preference to true to apply attribute mappings in the Import Spreadsheet when the import query does not find a corresponding item in the database.

CATIA_apply_savemanager_map_in_import_spreadsheet = true

The default value is false.

Attribute mappings are not applied when CATIA_manage_mandatory_attrs_on_import is set to false, and the mappings listed below are applied to the columns of the alternate format of the Spreadsheet.

CATIA Internal Identifier (UUID) Conflict Messages

Set CATIA_check_catia_uuid to specify the message written in the Import.log file and define SpreadSheet Editor behavior when an UUID conflict occurs during the import process.

CATIA_check_catia_uuid = NONE

The default value is NONE.

The value of this preference also affects Load and Save behavior.

Check-in after Import

Set CATIA_checkIn_option_for_import to false prevent the Integration from performing a check in after the Import process.  Set it to true (default) to perform a check in after the Import process.  

When CATIA_manage_mandatory_attrs_on_import is false, the value of CATIA_checkIn_option_for_import is ignored, and the Integration performs a check in after the Import process (true, default).

 CATIA_checkIn_option_for_import = false

The default value is true.

Check-in Status of a CATDrawing during Import

Set CATIA_import_files_in_ci_dataset to true to permit Named References of CATDrawings to be imported under a checked-in CATDrawing dataset that does not already have a Named Reference. When the CATDrawing already contains an existing Named Reference, the new Named Reference is not imported.

CATIA_import_files_in_ci_dataset = true

The default value is false. Named References of CATDrawings will not be imported under a checked-in CATDrawing dataset.

Example:

BMIDE Configuration:

Create a new custom item and item revision type called V2_ITEM and V2_ItemRevision. In IMAN_save, create a post-action for the CATProduct and CATDrawing dataset when creating the item.  

Steps:

1.      Create A1(P1).  In CATIA, create a drawing for A1(P1) and save it to the import directory.

2.      Create an import spreadsheet

3.      Edit the item type for the CATProduct and CATDrawing to V2_ITEM in the spreadsheet, then save it.  

4.      Select Import All assembly.

Results:

When this preference is false (default), the import is successful but the CATDrawing shows as Modified, Not Saved in the log file.  A Named Reference is not created in Teamcenter for the CATDrawing but the Named Reference is created for the CATProduct.

When this preference is true, the import is successful, the CATProduct and CATDrawing datasets are imported and Named References are created.

Compute Mass Properties

The Compute Mass Properties button is active/selected by default when this preference is set to true and mass properties are always computed. When false, the button is inactive/unselected and requires manual selection to compute mass properties.

CATIA_computeGeometry_option_for_import = true

The default value is false.

Compute Mass Properties for the Main Body

The Compute Geometry for Main Body button is active/selected by default when this preference is set to true and mass properties for the main body are always computed. When false, the button is inactive/unselected and requires manual selection to compute mass properties for the main body.

CATIA_compute_geometry_for_main_body_for_import = true

The default value is false.

Convert to JT

The Convert to JT button is always active/selected when this preference is set to true so that JTs are always created during the Import process. When false, the button is inactive/unselected and requires manual selection to create JTs during the import process.

CATIA_createJT_option_for_import = false

The default value is false.

Default Import Folder

Change the default import folder by modifying CATIA_default_folder_for_import.

When this preference is NONE, the items are saved in Teamcenter but are not linked to any folder. The value of this preference can be a directory name, a folder uid or NONE

When the preference is set with a directory name, the corresponding folder UID is set in the Spreadsheet Editor when CATIA_manage_mandatory_attrs_on_import is true.

• If several folders are found, then the first one is used.

• If no folders are found, then the item is saved in newstuff (default value).

• If a different folder is selected in the Save Manager, then the folder UID is set in the preference.

CATIA_default_folder_for_import = myfolder

The default value is Newstuff.

Display Additional Information Within the Title of the Spreadsheet Editor Panel

The Spreadsheet Editor panel title can display additional information related to the current Teamcenter connection (User, Group, Role) and CATIA Environment. Define the title pattern displayed on the Spreadsheet Editor panel using the string below. When this preference is empty, no additional information displays.

Export: DLNames

Set CATIA_DLName_required_on_export variable to manage DLNames during the Export process.

CATIA_DLName_required_on_export =  YES

This preference corresponds to the previous com.ebsolutions.catiman.exportDLNameRequired property defined in the catiaV5properties.properties file, now obsolete.

Import Form

Link Type

Define the type of relation between a dataset and the Import Form.

CATIA_importform_link_type = catia_importform_link

The default value is catia_importform_link.

Form Name

Change the form name used by Teamcenter Integration for CATIA by defining a new name within Teamcenter Preferences.

CATIA_catImport_form = newFormName

The default value is catImport_attributes.

The Import Form is attached as a Named Reference to CATPart, CATProduct and CATDrawing datasets. Therefore, a catimportform Named Reference must be specified in the CATPart dataset type definition.

Import Spreadsheet

The content of the Import Spreadsheet depends on the value of  CATIA_ifs_qry_last_item_rev_for_dataset.

For example, a dataset may be linked to several different item revisions of different items; the dataset may be under the same item.   

Refer to the illustration below. Assume a part can be imported in Dataset Revision B (Dst Rev B) and Dataset Revision A (Dst Rev A):



When CATIA_ifs_qry_last_item_rev_for_dataset is set to false, four item revisions (A,B,C,D) are listed in the spreadsheet.

When CATIA_ifs_qry_last_item_rev_for_dataset is set to true, only the last revisions of an item using the dataset (A and B) are listed in the spreadsheet.

Item Revision Rule

Filtering Revision Rule

Define the revision rule to apply to the import query and  filter the returned item revision in the Import Spreadsheet file.

CATIA_ifs_qry_revision_rule_for_item = LATEST_WORKING

The default value is NONE.

Modifying Latest Revision Rule

Define the criteria used to determine the latest revision of an item in the Integration.

CATIA_latest_revision_set_type = creation_date

The default value is creation_date.

Mandatory Attributes for the Import Spreadsheet

Set CATIA_manage_mandatory_attrs_on_import to true (default) to manage mandatory attributes on the import spreadsheet. The import spreadsheet displays in the default format, even when mandatory attributes have not been defined.  

Set it to false to display the import spreadsheet in the alternate format.

The alternate format of the import spreadsheet is the format used in pre-9.0.0 versions of the Integration.

When CATIA_manage_mandatory_attrs_on_import is false, the value of CATIA_checkIn_option_for_import is ignored, and Integration performs a check in after the Import process (CATIA_checkIn_option_for_import = true, default).

CATIA_manage_mandatory_attrs_on_import = true

The default value is true.

Modify the Item Revision During Import

Set CATIA_change_ItemRevName_on_import to true to permit the item revision name to be modified during the import process.

CATIA_change_ItemRevName_on_import =  true

The default value is false.

OEM Forms Creation Option

Set CATIA_create_OEMForms_option to specify whether an OEM form should be created and attached to any type of dataset when an item revision is created.  The default value is false, indicating an OEM form is not created.

Set CATIA_apply_post_action_on_import_form and CATIA_create_OEMForms_option to the same value so that the Save As/Revise behavior from CATIA and Teamcenter is consistent.

CATIA_create_OEMForms_option = true

This setting is ignored when the Import feature is used, and OEM forms will still be created for each dataset type.

OEM Prefix

CATIA_oem_prefix is only used by CATIA.

Modify CATIA_oem_prefix to indicate the prefix used to create OEM properties in CATIA, i.e., prefix_originalPropertyName.

CATIA_oem_prefix = OEM_PERSO

The default value is OEM.

This preference corresponds to the previous com.ebsolutions.catia.OEMPrefix property defined in the catiaV5properties.properties file, now obsolete.

Silenced Import

Set CATIA_silenced_import to true to write messages normally displayed during the Import process to the SilencedImport.Log file.

Set CATIA_silenced_import to false to display messages during the Import process.

CATIA_silenced_import = false

The default value is false.

This preference corresponds to the previous com.ebsolutions.catiman.silencedImport property defined in the catiaV5properties.properties file, now obsolete.

Stop Import if Bad Status

CATIA_stop_import_if_bad_status is only used by CATIA.

Set CATIA_stop_import_if_bad_status to YES to stop the Import process when the status is false in the Import Spreadsheet.

CATIA_stop_import_if_bad_status = YES

The default value is NO.

This preference corresponds to the previous com.ebsolutions.catia.BadStatus property defined in the catiaV5properties.properties file, now obsolete.