Attribute Mappings
CATIA Internal Identifier (UUID) Conflict Messages
Check-in after Import
Check-in Status of a CATDrawing during Import
Compute Mass Properties
Compute Mass Properties for the Main Body
Only
Convert to JT
Default Import Folder
Display Additional Information
Within the Title of the Spreadsheet Editor Panel
End of Process Message
Export: DLNames
Hide/Show During the Import Process
Import Form
Import Spreadsheet
Item Revision Rule
Linked CATDrawings
Mandatory Attributes on the Import Spreadsheet
Modify the Item Revision During Import
OEM Forms Creation Option
OEM Prefix
Silenced Import
Stop Import if Bad Status
Teamcenter must be restarted after modifying preferences.
View these preferences in
an .xls
file.
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.
Preference Value Mapped to the Spreadsheet Column | Column Mapped with the TcIC Preference Value |
---|---|
CATIA_savemanager_map_ds_object_desc | DATASET_DESC |
CATIA_savemanager_map_ds_object_name | DATASET_NAME |
CATIA_savemanager_map_ds_object_type | DATASET_TYPE. |
CATIA_savemanager_map_ds_pubr_object_id | DATASET_ID |
CATIA_savemanager_map_ds_rev | DATASET_REV |
CATIA_savemanager_map_ir_item_id | ITEM_ID |
CATIA_savemanager_map_ir_item_revision_id | ITEM_REV_ID |
CATIA_savemanager_map_ir_object_desc | ITEM_REV_DESC |
CATIA_savemanager_map_ir_object_name | ITEM_REV_NAME |
CATIA_savemanager_map_ir_object_type | ITEM_TYPE |
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.
Value of CATIA_check_catia_uuid | Result |
---|---|
ERROR or WARNING | The item having the conflict and its parents display as False
in the SpreadSheet Editor.
An Unable to import Itemxx : uuid conflict detected … error message is written to the Import.log file and the item and its parents are not imported. |
NONE (default) or not defined | UUID conflict management is not managed; the import process continues and the item is imported. |
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.
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.
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.
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.
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.
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.
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.
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.
{0} = user
{1} = group
{2} = role
{3} = name of the current CATIA environment
{4} = current project name
CATIA_ui_title_format = ({0}–{1}/{2} [{4}] [{3}])
The default value is ({0} – {1} / {2} [{4}] [{3}]) which displays as user-group / role [current project name] [name of current CATIA environment].
This preference is used for the title of the Save Manager panel, Spreadsheet Editor panel and the State Details panel.
Use CATIA_display_export_end_of_command to display an end of process message during the non-silent mode of the Export, Export as Reference and Create Export SpreadSheet processes. This preference is false, by default, indicating an end of process message does not display. When true, an end of process message displays.
CATIA_display_export_end_of_command = false
Set CATIA_DLName_required_on_export variable to manage DLNames during the Export process.
Value | Result |
---|---|
NO (default) | Do not require DLNames to export an assembly |
VALIDATE | Do not require DLNames to export an assembly, but validate during the Export Spreadsheet Creation process. |
YES | Require DLNames to export an assembly and validate. |
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.
Set CATIA_savemanager_hideshow_option_on_import to true to toggle on the Hide/Show button in the Spreadsheet Editor so that Hide/Show attributes are automatically saved during Import process.
Set it to false (default) so that the Hide/Show button in the Spreadsheet Editor is not automatically toggled. In this case, the Hide/Show button on the Spreadsheet Editor must be manually toggled.
CATIA_savemanager_hideshow_option_on_import = true
The default value is false.
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.
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.
The content of the Import Spreadsheet depends on the value of CATIA_ifs_qry_last_item_rev_for_dataset.
Value | Result |
---|---|
false (default) | List all item revisions in the spreadsheet that contain datasets available for Import. |
true | List only the last revisions of an item in the spreadsheet that contain datasets available for Import. |
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.
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.
Value | Result |
---|---|
NONE (default) | No Filter is applied; All revisions are returned by the import query in the spreadsheet file. |
LATEST | Keep only the latest revision in the Import Spreadsheet when many revisions are returned by the import query regardless of the revision status. |
LATEST_WORKING | Keep only the latest revision with no status in the Import Spreadsheet when many revisions are returned by the import query. If all the returned revisions have no status, keep only the latest one in the Import Spreadsheet, regardless of the revision status. |
LATEST_STATUS | Keep only the latest revision with a status in the Import Spreadsheet when many revisions are returned by the Import Query. If all the returned revisions have a status, keep only the latest one in the Import Spreadsheet. |
Rev_rule_name | Do not apply a filter in the Import Spreadsheet when the revision rule returns an item revision which is not in the list of revisions returned by the import query. |
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.
Value | Result |
---|---|
creation_date (default) | Creation date. This value is not case-sensitive. |
alphanum | Alphanumeric order |
numeric | Numeric order |
CATDrawing documents linked to the document to export are listed in the Export SpreadSheet and exported when this preference is set to YES. When NO, CATDrawing documents linked to the document to export are not listed in the Export SpreadSheet and are not exported.
CATIA_export_assy_with_linked_drawings = YES
The default value is YES.
Value of CATIA_export_assy_with_linked_drawings | Behavior |
---|---|
YES | CATDrawing documents linked to the document to export are listed in the Export SpreadSheet and exported |
NO | CATDrawing documents linked to the document to export are not listed in the Export SpreadSheet and are not exported |
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.
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.
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.
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.
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.
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.
At least one status in the spreadsheet is false, and the value of CATIA_stop_import_if_bad_status is | Result |
---|---|
YES | the import process stops |
MSG | prompt to continue |
NO | nothing |
This preference corresponds to the previous com.ebsolutions.catia.BadStatus property defined in the catiaV5properties.properties file, now obsolete.