Итерировать файлы (ModelBuilder)

Использование

  • Этот инструмент предназначен для использования в ModelBuilder, а не в скриптах Python.

  • Опция Расширение файла позволяет вам выполнять итерации над файлами с определенным расширением. Например, если вы хотите выполнять итерации только над файлами с расширением .log, установите для параметра Расширение файла значение log.

  • Если файл отображается как набор данных на панели Каталог, тогда инструмент Итерировать файлы пропустит файл. Наиболее распространенные примеры - это шейп-файлы, .dbf растровые файлы (.jpg, .tif, .img, .png и .bmp), файлы САПР (.dxf и .dwg) и файлы карт (.mxd, .aprx).

  • У инструмента два элемента выходных данных: Выходной файл и Имя, которые можно использовать как встроенную переменную (Например, %Имя%) в других инструментах.

  • Укажите расширение файла в дополнительном параметре расширений, например, txt, pdf, zip. Так, если инструмент производит итерацию над текстовыми файлами и результат его работы будет использоваться в инструментах, например, в инструменте ASCII в растр, то в дополнительном параметре расширений необходимо указать расширение txt.

  • Большинство инструментов принимают формат выходного файла инструмента Итерировать файлы, кроме таких инструментов как, Копировать, для которых расширение файла необходимо указывать в выходном имени Пример: Если вы используете инструмент Итерировать файлы, чтобы выполнять итерации с zip файлами, чтобы использовать их в качестве входных объектов для инструмента Копировать, выходное имя файла должно содержать расширение Name.zip или %Name%.zip.

Синтаксис

arcpy.mb.IterateFiles(in_folder, {wildcard}, {extension}, {recursive})
ParameterОбъяснениеТип данных
in_folder

Папка, в которой расположены входные файлы.

Folder
wildcard
(Дополнительный)

Комбинация звездочки * и других символов поможет вам ограничить результаты. Символ звездочки означает ВСЕ. Если групповой символ не задан, то будут обрабатываться все входные данные. Например, его можно использовать для того, чтобы ограничить итерирование только входными именами, начинающимися с определенного символа или слова (например, A*, или Ari*, или Land* и т.д.).

String
extension
(Дополнительный)

Расширение файла, такое как TXT, ZIP и т. д. Только файлы с расширением будут итерироваться. Не используйте пробел перед расширением файла.

String
recursive
(Дополнительный)

Определяет, будут ли все вложенные папки в основной обрабатываться рекурсивно.

  • Отмечено – будут обрабатываться все вложенные папки.
  • Не отмечено – вложенные папки не будут обрабатываться.
Boolean

Производные выходные данные

NameОбъяснениеТип данных
file

Полный путь к файлу.

Файл
name

Название набора данных.

Строковое

Environments

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да