Updating data sources for batch jobs using the Update Batch Job Workspaces tool
The Update Batch Job Workspaces tool allows you to validate and update the workspaces referenced by all the batch jobs in a specified directory. This can be done using the command regardless of the version of Data Reviewer that was used to create them.
![Remarque Remarque](rsrc/note.png)
This command does not upgrade any 9.2 Reviewer batch jobs to the current version. It only repairs the path to the databases.
The tool initially searches the specified directory and, optionally, subdirectories for batch jobs. After the tool finishes searching for batch jobs, it reports the number of batch jobs that have been loaded as well as the number that have no workspace or that had errors reading the workspace information. All the workspaces referenced by the batch jobs are listed in the top portion of the dialog box, and all the batch jobs associated with the workspace are listed in the bottom portion of the dialog box. This allows you to see the relationship between the workspaces and the batch jobs that reference them. After the batch jobs are loaded, you can change the workspaces for them as needed.
![]() |
Workspaces and Reviewer batch jobs that have been loaded |
For each workspace, the following properties are displayed:
- ID—A unique number associated with a unique workspace
- Workspace—The path to the workspace a batch job is referencing
- Valid?—Indicates whether or not the workspace path is valid
- New Workspace—The path to the new workspace to be referenced by the batch job
You can choose to validate the workspaces after they are loaded. Validating the workspaces ensures that the path to the workspace is correct. If the workspace is valid, there is a check mark in the Valid? cell. If the workspace path is invalid, it appears in red text, and the Valid? cell contains a red circle with an "X" in it.
In the bottom portion of the dialog box, the batch jobs associated with the workspace are listed. For each batch job, the following properties are displayed:
- W.Id—The identification number associated with the workspace.
- Batch Job—The name of the Reviewer batch job (.rbj) file
- Version—The software version with which the batch job is associated
- Folder—The path to the directory that contains the batch job file
After the workspaces are updated, you can update the references within the batch jobs by applying the workspace to the batch jobs. This updates all the checks in the batch jobs so they reference the new workspace.
![Remarque Remarque](rsrc/note.png)
If you are updating a batch job that contains checks for database validation, topology, or z-values, the new workspace must contain the appropriate tables and feature classes. For instance, if a batch job contains the Slope Direction Change (Monotonicity) check, the workspace needs to have feature classes that are z-enabled.
- Start ArcMap.
- On the main menu, click Customize > Toolbars > Data Reviewer.
- On the Data Reviewer toolbar, click the Data Reviewer
menu, then click Update Batch Job Workspaces.
The Update Batch Job Workspaces dialog box appears.
-
Click the ellipsis (...) next to the Search the following folder for RBJs text box.
The Browse For Folder dialog box appears.
- Navigate to the directory that contains the batch jobs you want to migrate.
- Click OK.
- To include any subdirectories in the search, check the Include Subfolders check box.
-
Click Refresh.
The workspaces and associated batch jobs appear in the Update Batch Job Workspaces dialog box. The Load Batch Job Results dialog box with the message also appears and informs you of the number of batch jobs processed and the number that were omitted because there was no workspace information or there were errors reading the workspace information.
-
Click OK.
- Click Validate to validate the workspaces that have been loaded.
- Click the name of the workspace you want to update.
-
Click the ellipsis (...) at the end of the row.
The Select Workspace dialog box appears.
- Navigate to the workspace you want to use with the batch jobs.
-
Click Select.
The Update Batch Job Workspaces dialog box appears with the path to the new workspace in the New Workspace cell.
-
Click Apply.
The batch jobs that reference the selected workspace are updated with the new workspace.
- Repeat steps 11–15 for each workspace you want to update.
-
Click the Close button
when you are finished.