In the Object location list, select
File.
Click the
button.
The File Selection dialog box lets you select the documents to be
processed and define the input/output options as well as the rename
criteria to apply to the selected documents.
The picture below
shows all the options available:
The corresponding
online documentation can be accessed from the File
Selection dialog box by clicking Help.
In the Input Options area,
use the appropriate button to select the documents.
Depending on the batch you are running, you can
search for:
-
V4 model documents (.model, .library,
.session, etc.)
-
V5 documents (assemblies, parts, drawings, etc.)
-
V6 documents.
The main application window displayed
in background is updated and shows the name and path of the
selected documents.
The File Selection dialog box is displayed in foreground
to let you select more documents if needed:
Select the appropriate
check boxes.
- For the modification date, the syntax is as follows:
YYYY.MM.DD (including the given milestone).
- For the modification version, entering SP0 or GA stands
for the General Availability level.
If no specific level is indicated, all the service packs of the
release are taken into account.
The syntax is as follows: CATIA V5RnSPx,
for instance, CATIA V5R18SP4.
However, you cannot select documents saved prior
to V5R10.
In the Rename criteria
area, select the appropriate option to rename the documents selected in
the Input Options area.
The chosen rename criterion is identified in the XML parameter
file as follows:
- <Rename_Scope>No</Rename_Scope> if
No rename has been selected.
- <Rename_Scope>Yes</Rename_Scope> if Rename has been selected.
- <Rename_Scope>ifExists</Rename_Scope> if Rename if already exists has been selected.
Optional: If you select the
Rename or
Rename if already exists option, you can then choose the
appropriate rename criteria:
- Suffix with
Enter the string to be added in the box displayed to the right.
The defined string is identified in the XML parameter file as
follows:
<Append_String>my_string</Append_String>
- Insert
Enter the string to be inserted in the first box then in the
from column box, indicate the position of the character
from which you want to add the string. The column is an integer
comprised between 1 and 80.
The defined string and column number are identified in the XML
parameter file as follows:
<Insert_string>my_string</Insert_string>
<Insert_column>my_number</Insert_column>
- Substitute
Enter the string to be modified then in the from column
box and indicate the position of the character from which you want
to insert the new string.
The defined string and column number are identified in the XML
parameter file as follows:
<Substitute_string>my_string</Substitute_string>
<Substitute_column>my_number</Substitute_column>
In the
Output Options area, select the Default target directory.
Each time a new directory is added to the Input directory list, its
target directory is the one specified in the Default
target directory box.By default, the box is initialized with the current or temporary
directory, depending on your configuration and write
access.
Optional:
To change the default path and specify another directory, click
Change Target Directory... then navigate to the desired
directory.
When the target directory has been changed, you can restore
the default directory (i.e. the directory displayed in the Target Directory box of the main application interface) by
clicking Reset.
If you leave the default path, Reset is grayed out.
The target directory is identified in the XML parameter file
as follows:
<target_dir>path_of_the_directory</target_dir>
Optional: Select the Keep directory structure
or the Keep at same location check box.
The Keep directory structure option is relevant only when:
- Extend selection to sub-directories is activated
in the Input Options area.
- the current document environment is not "DLName".
If no sub-directory exists in the target directory, you are
informed that a sub-directory will be created before writing the
documents. As a matter of fact, when directories are created,
they are created when the documents are written and not when they
are selected.
The Keep directory structure check box is
identified in the XML parameter file as follows:
<KeepfileTree>Yes/No</KeepfileTree>
("Yes" if the option has been selected).
The Keep at same location option is identified in the XML
parameter file as follows:
<KeepLocation>Yes/No</KeepLocation>
("Yes" if the option has been selected).
Define the directory
mapping by using the appropriate option.
Note that you can select multiple files from the
directory list using Ctrl and Shift.
- Change
This buttons impacts only the target directory of the lines you
select and not the default target directory.
The change is effective for the selected input directory only: if you add another directory to the directory mapping, it will be
mapped to the default target directory.
- Default
This button is relevant only if you used
Change Target
Directory... to modify the target directory. It is available when at least one line is selected in
the list and if at least one of the selected output directories
is different than the target directory.
- Reset
This button is available when at least one line is
selected in the list and if at least one of the selected output
directories is different than the target directory.
The mapping is identified in the XML parameter file as
follows:
<directory_mapping>IN=Directoryx
OUT=Directoryy
RES=Directoryz</directory_mapping>
where:
- "IN" is for the input directory
- "OUT" is for the target directory
- "RES" is for the default, i.e. the directory displayed in the
Default target directory box.
Optional: Use the check boxes
displayed at the bottom of the Output Options area.
- Replace existing documents in target directory
When a document with
the same name already exists in the target directory, this option
automatically replaces the old document by the new one.
- Save previous version of the documents
When the
Replace existing documents in target directory check box is
selected, the already existing document is not overwritten and a
backup version is kept.
This backup version is identified by the following suffix:
".DLC.date" where date is
YYYY.MM.DD_HH.MM.SS.
- Save non-modified documents
This option helps you identify more easily on which documents the
batch has been run.
It is identified in the XML parameter file as follows:
<File_SaveNonmodifiedDoc>No</File_SaveNonmodifiedDoc>
if the option is not selected.
<File_SaveNonmodifiedDoc>Yes</File_SaveNonmodifiedDoc>
if the option is selected.
- Apply rename when saving non-modified documents
This check box can be selected only when Save non-modified
documents is activated AND at least one rename criterion
has been defined.
This option is identified in the XML parameter file as follows:
<File_RenameNonmodifiedDoc>No</File_RenameNonmodifiedDoc>
if the option is not selected.
<File_RenameNonmodifiedDoc>Yes</File_RenameNonmodifiedDoc>
if the option is selected.
When finished, click OK to
validate and close the File Selection dialog box.
The documents are displayed in the main application window.