Back to Top

Work with Iterate Tables

In this topic

  1. Summary
  2. Open the project
  3. Add tools
  4. Specify the tool parameters and connect the tools
  5. Run the model

Summary

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 Table parameter of the Export Table tool. The output of the Export Table tool is connected to the Collect Values tool, which collects the output of each iteration and creates 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 IterateTables.zip 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. 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. 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 Export Table tool.
    1. Click inside the model and type Export Table to open the Add Tools To Model dialog box.
    2. Search for the Export Table tool.
    3. Double-click the Export Table tool and add it to the model.

    Adding the Export Table tool

    Tip:

    Learn more ways to add tools to a model

Specify the tool parameters and connect the tools

After adding tools to the model, you must 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.

    Tip:

    Learn more about model elements

  2. Right-click the DataSheets.xlsx variable (dark blue oval) and click Rename. Type Excel Sheets for a new name. Using the same steps, rename the iterator table output (green oval) to Table.

    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 Export Table tool to open the tool's dialog box. For the Input Table parameter, click the drop-down arrow and select the Table model variable. For the Output Table parameter, type %Name%. Leave the remaining parameter default settings and click OK to close the dialog box.

    Export 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.

    Tip:

    Learn more about inline variable substitution

  4. Hover over the Export 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

Complete the following steps to 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.

Feedback on this topic?

In this topic
  1. Summary
  2. Open the project
  3. Add tools
  4. Specify the tool parameters and connect the tools
  5. Run the model