Migrating Pre-R11 Drawings to Drawings Using Standard-Defined Styles

This task will show you how to migrate CATDrawing documents created with versions up to V5 R10 (which use properties "set as default"), to V5 R12 CATDrawing documents using standard-defined styles. The migration is performed using a batch utility.

For each object which uses properties "set as default" (i.e. each default object created using the Set as Default contextual command), a new style will be created in the standard file, with the same specifications as the default object. For more information on styles, refer to Setting Standard Styles and Using Standard-Defined Styles.

 

The version of a drawing that is taken into account for the migration is the version of the embedded standard. For example, if you created a drawing in V5 R7, and modified and saved it in V5 R10, the version of the embedded standard is V5 R7. On the other hand, if you created a drawing in V5 R7, and updated its standard in V5 R10 (using the Update button in the Page Setup dialog box), then the version of the embedded standard is V5 R10.

The migration is handled differently, depending on the version of the standard embedded in the CATDrawing document: up to V5 R8, or V5 R9 to V5 R10.

 

Migration process for drawings with an embedded standard up to V5 R8

If you want to keep your customized parameters, you must provide the CATDrwStandard file associated to the drawing. Otherwise, you can provide a customized XML file (from V5 R9), which will be updated and used in the updated drawing.

 
 

Migration process for drawings with a V5 R9 to V5 R10 embedded standard

Standard output values are the values of the old drawing (except for new V5R12 standard values). This is available only for V5 R9 or V5 R10 drawings, which contain standards parameters.

 

 

  1. Operate as described below, depending on whether you are on Windows or on UNIX:

  • On Windows: open an MS-DOS Window. Change to the folder in which you installed the product. The default folder is C:\Program Files\Dassault Systemes\B_XX\intel_a\code\bin where B_XX is B followed by the release number (e.g. B12 in the case of V5R12).
  • On UNIX: open a shell command window. Change to the directory in which you installed the product. The default directory is /usr/DassaultSystemes/B_xx/OS_a/code/command/ where B_XX is B followed by the release number (e.g. B12 in the case of V5R12) and where OS_a is:
    - aix_a
    - hpux_a
    - irix_a
    - solaris_a
  1. Run the following command:

CATAnnDefaultStyleMigration [-h] DrawingName.CATDrawing [-X] [-d OutputDirectory]
[-n NewName] [-STDFile StandardFile]

  • DrawingName.CATDrawing: Specifies the name of the drawing to migrate
  • -h: Displays online help
  • -d OutputDirectory: Indicates the directory where the new migrated drawing is saved. If not specified, the new migrated drawing will be saved in the DrawingName.CATDrawing directory.
  • -n NewName: Specifies the name of the migrated drawing. If not specified, the new migrated drawing will use the same name as the old drawing prefixed by STD_. Example: DrawingName.CATDrawing will become STD_DrawingName.CATDrawing.
  • -X: Generates the XML file associated to the upgraded drawing. The XML file is put in the same
    directory as the output drawing. Its name is composed of the standard name and the drawing name with the .XML extension, e.g. ISO_DrawingName.XML.
  • -STDFile StandardFile: Specifies the external standard file to use. This file can either be a CATDrwStandard or an XML file. This step is mandatory for drawings created with versions up to V5 R8 (as they contain an embedded standard); this step is optional in other cases. If a file is specified, the embedded standard will be ignored whatever the drawing version is.
  1. Wait until a message indicates that the migration process is finished and that the new CATDrawing and XML file have been generated.