Usage
This tool is intended for use in ModelBuilder, not in Python scripting.
The File Extension option allows you to iterate over files with a particular extension. For example, if you only want files with the extension of .log to be iterated, set the File Extension parameter to log.
If the file appears as a dataset in the Catalog pane, then Iterate Files will skip the file. The most common examples are shape files, .dbf files, raster files (.jpg, .tif, .img, .png, and .bmp), CAD files (.dxf and .dwg) and map files (.mxd, .aprx).
The tool has two outputs: Output File and Name which could be used as an inline variable (for example, %Name%) in other tools.
Specify the file extension in the optional parameter for extensions, such as txt, pdf, zip, and so on. For example, if the tool iterates over text files and the output is used in tools, such as ASCII To Raster tool, specify the extension txt in the optional file extension parameter.
Most tools honor the output file format from the Iterate Files tool except tools such as Copy, which requires you to define the file extension in the output name. For example, If you are using the Iterate Files tool to iterate zip files for use as input to the Copy tool, the output name must contain the extension Name.zip or %Name%.zip.
Syntax
arcpy.mb.IterateFiles(in_folder, {wildcard}, {extension}, {recursive})| Parameter | Explanation | Data Type |
in_folder | Folder in which the input files are located. | Folder |
wildcard (Optional) | A combination of * and characters that help to limit the results. The asterisk is the same as saying ALL. If no wildcard is specified, all inputs will be returned. For example, it can be used to restrict Iteration over input names starting with a certain character or word (for example, A* or Ari* or Land* and so on). | String |
extension (Optional) | The file extension, such as TXT, ZIP, and so on. Only files with the extension will be iterated. Do not use a period before the file extension. | String |
recursive (Optional) | Determines if all subfolders of the main folder will be recursively iterated through.
| Boolean |
Derived Output
| Name | Explanation | Data Type |
| file | The full path to the file. | File |
| name | The name of the dataset. | String |
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes