OpenCities Map CONNECT Edition Help

Batch Process Dialog

Used to create and run a script that can be performed on individual files or entire directories of files. The script is a text file that contains a series of OpenCities Map key-ins that can run commands, OpenCities Map VBA macros, or MDL applications.

You can access this dialog from the following:
  • Ribbon: File > Tools > Batch Process


Key-in: MDL SILENTLOAD BATCHPROCESS
SettingDescription
New Batch Process Job


Saves the batch process settings to a new batch process job file. This icon is available only when there are files listed in the Process Tasks list. Once you click this icon, you must verify that you want to save the settings. If you click Yes, the Save Batch Process Job File dialog opens. Enter a name for the job file and click OK.

Batch process job files use a *.bprc extension.

BATCHPROCESS NEW
Note: The controls on the Save Batch Process Job File dialog are analogous to those in the Save As dialog.
Open Batch Process Job


Opens an existing batch process job file. You can modify the settings, then rerun the batch process.

Once you click this icon, you have the option of saving the batch process settings to a batch process job file. Next, the Open Batch Process Job File dialog opens.

BATCHPROCESS OPEN
Note: The controls on the Open Batch Process Job File dialog are analogous to those in the Open dialog.
Save Batch Process Job


Saves the batch process settings to a batch process job file.
BATCHPROCESS SAVE
Add Files or Directories to Process


Opens the Select Files and Directories to Process dialog.


Select Files and Directories to Process dialog, fully expanded

Select the directories or files to be processed, then click Add. The specifications for the selected directories or files are listed in the Selected Files list box.

If you change your mind about a previously selected directory or file, select it in this list box, then click Remove.

BATCHPROCESS ADDDGN
Note: You can drag files from Windows Explorer or models from Explorer into the Process Tasks list in the Batch Process dialog. Similarly, you can drag models into the list box from the Models dialog of the current session, or another open session of OpenCities Map.
Remove Files


Removes selected files from the Process Tasks list.
BATCHPROCESS DGNREMOVE
Process Batch Process Job


Opens the Files to Process dialog, which lists all files to be processed.


Click Process to start the batch processing.

The Process button label automatically changes to "Pause," and the Status column identifies the file being processed. Click Pause to pause processing between commands. Click Continue to restart processing.

When processing is complete, the Pause button label changes to "Done."

BATCHPROCESS PROCESS
Process Selection Only If on, only selected files or directories in the Process Tasks list will be processed. If off, all files in the list will be processed.
Command File Lists the command file (script) that contains the key-in commands. This script is run on each file in the Process Tasks list.
Browse for Command File Opens the Select Command File dialog, which lets you select the command file to use for batch processing.
Edit Command File Opens the command file in a text editor window.
Create a New Command File Opens the Create Command File dialog.

Enter a name for the new file and click OK. If the command file uses the default .txt extension, it opens in a text editor window.



Enter the OpenCities Map key-ins for OpenCities Map commands, OpenCities Map , VBA macros, and MDL applications.

Initial Model Identifies the models that will be processed in each file: All Models, or Default Model Only.

After you select the files and directories to process, you can modify the Model setting for any of the files. To do this, click on and modify the Model setting in the Process Task list.

Alternatively, select the file in Process Tasks list. Choose the Initial Model setting, and click Apply to Selection.

Apply to Selection Applies the Initial Model setting to the files selected in the Process Tasks list.
Process Tasks Lists the files that will be processed using the command file. The list also identifies the models in each file that will be processed. You can modify the Process Tasks list in the following ways:
  • The order in which the tasks will be processed is indicated by the sequence number column (which has the heading "#"). The task list can be sorted by any of the columns, but the Edit menu items that modify the order are enabled only when sorting by the "#" column in ascending order.
  • In the File column, you can add the wildcard string *\ to the end of a directory to indicate that subdirectories will be included.
  • In the File column, you can designate that specific file types in the subdirectories will be included. For example, to process all files with the extension .dgn from directory c:\projects\ and its subdirectories, you would edit the entry to read c:\projects\*\*.dgn.
  • To modify the Model setting for a task, click on and modify the setting in the Process Tasks list.
File > New This command is identical to the New Batch Process Job icon.
File > Open This command is identical to the Open Batch Process Job icon.
File > Save This command is identical to the Save Batch Process Job icon.
File > Save As Opens the Save Batch Process Job File dialog, which lets you save the current batch process job file with a new name.
BATCHPROCESS SAVEAS
File > Process This command is identical to the Process Batch Process Job icon.
File > Exit Closes the Batch Process dialog. You may be prompted to save the batch process settings to a batch process job file.
BATCHPROCESS EXIT
Edit > Add Files This command is identical to the Add Files or Directories to Process icon.
Exit > Add Active File Adds the active file to the list of files and directories to process.
BATCHPROCESS ADDACTIVEDGN
Edit > Remove Files This command is identical to the Remove Files icon.
BATCHPROCESS DGNREMOVE
Edit > Log File Options Opens the Log File Options dialog, which sets options for the log file generated during batch processing.


BATCHPROCESS LOGFILEOPTS
Edit > Move Files to Top Moves selected files in the Process Tasks list to the top of the list.
BATCHPROCESS DGNTOP
Edit > Move Files Up Moves selected files in the Process Tasks list up one position in the list.
BATCHPROCESS DGNUP
Note: When files are sorted in ascending order on the # column, you can drag one or more files in the list box to the required location.
Edit > Move Files Down Moves selected files in the Process Tasks list down one position in the list.
BATCHPROCESS DGNDOWN
Note: When files are sorted in ascending order on the # column, you can drag one or more files in the list box to the required location.
Edit > Move Files to Bottom Moves selected files in the Process Tasks list to the bottom of the list.
BATCHPROCESS DGNBOTTOM