About 3DEXPERIENCE Import Utility Tool

You can check in documents with the NEW or MODIFIED status in 3DEXPERIENCE from the batch or silent mode using the 3DEXPERIENCE Import Utility tool.

Before any check in, the 3DEXPERIENCE Import Utility checks the status of each object in X-CAD Design Management. Any object is valid or selected for check in only if it is NEW / MODIFIED for 3DEXPERIENCE. You can only modify an object if it is unlocked, or it is locked by you. If the objects EXISTS, it is not selected for import.

In the 3DEXPERIENCE Import Utility dialog box, the Allow saving of incomplete structures check box has been provided. By selecting this check box, you can skip the invalid documents and save the rest of the design structure. This check box is not selected by default. The tooltip of the check box provides this information: child documents failing validation will be skipped. The table given below explains the two important cases:

CaseDescription
The Allow saving of incomplete structures check box is selectedThe child documents failing validations are skipped for import and the rest of the documents in an assembly are saved successfully. Status for root document appears as OK.
he Allow saving of incomplete structures check box is not selectedThe import utility works as per the current behavior (i.e. entire structure is skipped even if one of the documents fails validation.) The status for root document appears as KO on the global report.

The following table lists the check in criteria depending on the document status and lock status:

Document Status in 3DEXPERIENCE/ Selected Option Object Status "NEW" Object Status "Exists" Modified and locked by another user Modified and locked by current user or unlocked
Create New Iteration Check in allowed Nothing done/Not selected for Checkin Check in Aborted - Insufficient Rights Check in allowed
Keep Existing Iteration Check in allowed Nothing done/Not selected for Checkin Nothing done/Not selected for Checkin Nothing done/Not selected for Checkin
Overwrite the existing iteration Check in allowed Nothing done/Not selected for Checkin Check in Aborted - Insufficient Rights Check in allowed

3DEXPERIENCE Import Utility only recognizes the following file types as the root node to be imported:

  • CATProduct
  • CATPart
  • CATDrawing
  • CATIA Catalog
  • CATIA V4 model
  • CATProcess
  • CATShape
  • CATAnalysis
  • IDF model

All viewable types associated with the objects being checked in are processed based on the derived output selection in the Preferences page.

All links (pointed files) of the documents being processed are followed to preserve data consistency. It is recommended to check the data consistency and fix any broken links before the import to ensure that the correct structure is being updated in the database.

Execute import through Batch without login panel

"C:\Program Files\Dassault Systemes\Bxxxcadconnectors\win_b64\code\bin\CATSTART.exe" -run ENOV5MAOpen.exe -object "-Url=<SERVER_URL> -execute <CUSTOM_BATCH_LOCATION> -Tk=<LOGIN_TICKET>"

a.Bxx:XCADConnector installation version

b.SERVER_URL:URL of the server

c.CUSTOM_BATCH_LOCATION:

d.LOGIN_TICKET:The login ticket specific to the user, which is generated by login through web.

Experience Configuration->Manage Login Ticket->create

CUSTOM_BATCH.bat can contain:

"C:\Program Files\Dassault Systemes\Bxx\win_b64\code\bin\CATSTART.exe" -run CATBatchStarter.exe -object "-input <XML_BATH_LOCATION> -output <LOG_PATH>" -env <ENV_FILE_NAME> -direnv "<ENV_FILE_LOCATION>"

a.Bxx:CATIA installation version

b.XML_BATH_LOCATION:The location of XML file which contain checkin object.

c.LOG_PATH:Location of log file.

d.ENV_FILE_NAME:CATIA Environment file name

e.ENV_FILE_LOCATION:the location where environment file specified in variable ENV_FILE_NAME