Using the batch grid control

For a basic description of using the batch grid, see Quick tour of batch processing.

In the batch grid, each process (a tool plus its data) is represented by a row. Within each row, each cell represents one of the tool's parameters. Since the purpose of the batch grid is to allow you to quickly and easily gather parameter values to batch multiple processes, there are a number of ways the batch grid allows you to enter parameter values:

• Click a cell and type in a value.
• Right-click a cell and click Open to open the parameter's control.
• Double-click the row header (the column containing the numbers) to open the tool dialog box containing all parameters. Alternatively, right-click the row header and click Open.
• Copy a cell's contents (right-click and click Copy, or press CTRL+C) and paste it into another cell (right-click and click Paste, or press CTRL+V).
• Right-click a cell containing a value and click Fill. The value of the clicked cell will replace the values of all cells below, using the following logic:
  • If there are selected rows, only the cells of the selected rows will be filled.
  • If no rows are selected, all cells will be filled.

  Caution:

  Don't use fill on any output dataset cells. This will cause processes to write to the same dataset.

Entering data parameters

Tool parameters can be divided into two general groups, data and values. Data parameters refer to datasets on disk, such as feature classes, tables, TINs, rasters, networks, and so forth. Values are everything else: numbers and strings.

When you encounter a parameter containing a dataset, you can, in addition to the above methods

• Right-click the cell and click Browse.
• Drag and drop a dataset from the Catalog window or a layer from the ArcMap table of contents (as long as the parameter supports the input of ArcMap layers).

Tip:

If you right-click a cell and click Browse, you can choose multiple datasets by holding the CTRL key when selecting data. A row is created for each dataset you pick. The exception to this is if the parameter expects multiple datasets, such as the Union tool. In this case, the datasets you pick go into the cell as a list of datasets.

Using the shortcut menu commands

If you right-click a cell, the following shortcut menu opens:

Open—Opens the parameter's user interface control.

Browse—Available if the parameter is a dataset, and allows you to browse to disk, bypassing the parameter's user interface control.

Clear—Empties the cell.

Fill—Fills cells below with the value of the clicked cell. Cells will be filled regardless of whether they have values or not. The value of the clicked cell will replace the values of all cells below, using the following logic:

• If there are selected rows, only the cells of the selected rows will be filled.
• If no rows are selected, all cells will be filled.

Caution:

Don't use fill on any output dataset cells. This will cause processes to write to the same dataset.

Copy—Copy the text in the cell.

Paste—Paste whatever text has been copied.

Delete—Delete the selected rows.

Operations on selected rows

You can select an entire row by clicking the row header (the column containing the numbers). The entire row is highlighted in blue. The standard selection methods work on the batch grid; you can select multiple rows by holding the CTRL key or select a region of rows by holding the SHIFT key.

When you have one or more rows selected

• Clicking the Add button adds as many rows as you have selected, duplicating the values of the selected rows.
• Right-clicking a cell and clicking Delete deletes the selected rows.
• Right-clicking a cell and clicking Copy (or pressing CTRL+C), causes all selected rows to be copied. If you then select as many new rows as you just copied, right-click, then click Paste (or CTRL+V), the multiple rows are pasted.

To unselect a row, hold down the CTRL key and click the row.

Note:

You cannot select a column of cells.

Adding, deleting, and removing rows

• Click the Add button to add a new row. If no rows are selected, a new row is created with default values for every parameter.
• Use the Delete button to remove selected rows.
• Right-click and click Delete to remove selected rows.
• Execution begins with the first row and proceeds down the grid. If you care about the order in which processes are executed, use the up and down arrows to move selected rows (processes) above or below.

After clicking OK, the first row in the grid is run first, and the process continues in order down the rows, with the last row being processed last.

Using the check values button

When you enter values in the batch grid, no error checking occurs. That is, you can enter a dataset that doesn't exist or an incorrect string. Additionally, there is no autogeneration of output dataset names. To check for errors, click the Check Values button . This will scan all rows for errors and create an output dataset name if one is needed.

If errors are found, the color of the cell will change.

Learn more about parameter status colors and messages

Error checking always occurs when you click the OK button.

Feedback on this topic?