Work with Iterate Tables


The Iterate Tables tool iterates over tables in a workspace.

Final model using Iterate Tables iterator

In this workflow, you'll create a model to iterate over each sheet in the Excel file (five sheets) and convert the sheets to file geodatabase tables with the same name as the Excel sheet. The iterator output parameter, Name, will be used as an inline variable in the Output Name parameter of the Table To Table tool. The output of the Table To Table tool is connected to the Collect Values tool, which collects the output of each iteration and outputs a multivalue output.

Open the project

Download the project to use in this workflow. The project includes input data, an output geodatabase, and a completed model.

  1. Open the Work with Iterate Tables overview page.
  2. Click Download on the right side of the page.
  3. Right-click the downloaded file and extract it to a convenient location, such as C:\Temp.
  4. In the extracted folder, IterateTables, double-click the ArcGIS Pro project file, IterateTables.aprx.
  5. Explore the data in the Catalog pane, and click the Project tab if necessary. Browse to Folders > IterateTables.

    The IterateTables folder contains an Excel file that will be used as the input for the model.

    The outputs of the model will be written to the ScratchTable.gdb geodatabase.

Add tools

To create a model and add tools to the model, complete the following steps:

  1. In the Catalog pane, browse to Folders > IterateTables > MyProjectTools.
  2. Right-click MyProjectTools and click New. Select Model to create and open a model.
  3. Add the Iterate Tables tool.
    1. On the ribbon, click the ModelBuilder tab.
    2. In the Insert group, click Iterators Iterators.
    3. In the Iterators list, click Iterate Tables.

    Adding the Iterate Tables tool

    The Iterate Tables iterator is added to the model. The iterator is gray since no parameter values have been provided.

  4. Add the Collect Values tool.
    1. On the ribbon, click the ModelBuilder tab.
    2. In the Insert group, click Utilities Utilities.
    3. In the Utilities list, click the Collect Values tool.

    Adding the Collect Values tool

    The Collect Values tool is added to the model.

  5. Add the Table To Table tool.
    1. Click inside the model and type Table To Table to open the Add Tools To Model dialog box.
    2. Search for the Table To Table tool.
    3. Double-click the Table To Table tool and add it to the model.

Specify the tool parameters and connect the tools

After adding tools to the model, you need to specify the parameters for each tool.

  1. Double-click the Iterate Tables tool to open the iterator's dialog box.
    1. In the Catalog pane, browse to Folders > IterateTables.
    2. Drag the DataSheets.xlsx file to the Workspace parameter.
    3. Leave the remaining parameters blank and click OK.

    Iterate Tables tool dialog box

    The workspace is added as a model variable to the model (dark blue oval) and changes the color of the iterator, indicating that the required parameters have been supplied and it is ready to run.

  2. Right-click the DataSheets.xlsx variable (dark blue oval) and click Rename. Type Excel Sheets for a new name.

    It is recommended that you rename the input and output variable names to more meaningful names instead of the default variable name.

  3. Double-click the Table To Table tool to open the tool's dialog box. For the Input Rows parameter, click the drop-down arrow and select Table. For the Output Name parameter, type %Name%. Leave the remaining parameter default settings and click OK to close the dialog box.

    Table To Table tool dialog box

    When the model is run, %Name%, which is the name of the output parameter of the iterator (light blue oval), is replaced by the value of the variable, for example, the sheet name Birds2007, Birds2008, and so on.

  4. Hover over the Table To Table tool output variable (green oval). Click and drag to draw a connector line to the Collect Values tool. Release the mouse and click Input Value on the pop-up menu.
  5. Rename all the model variables as shown in the finished model.
  6. To arrange the model elements, click the Auto Layout button Auto Layout on the ModelBuilder tab and click the Fit To Window button Fit To Window to maximize the layout to the size of your model window.

Run the model

  1. Right-click the output of the Collect Values tool, and click Add To Display.

    The outputs will be added to the map after the model is run.

  2. Click the Save button Save on the ModelBuilder tab to save the model.
  3. Click the Run button Run on the ModelBuilder tab to run the model.

    The model iterates over the five sheets in the Excel file and creates five tables in the ScratchTable.gdb geodatabase.

    Output from Iterate Tables model
  4. Close the model and ArcGIS Pro.