Itérer dans des fichiers (ModelBuilder)

Utilisation

  • Cet outil est prévu pour une utilisation dans ModelBuilder, et non dans des scripts Python.

  • L'option Extension de fichier vous permet d'itérer des fichiers dotés d'une extension particulière. Par exemple, si vous souhaitez que seuls les fichiers avec l’extension .log soient itérés, définissez le paramètre File Extension (Extension de fichier) sur log.

  • Si le fichier apparaît en tant que jeu de données dans la fenêtre Catalogue, l'outil Itérer les fichiers ignore le fichier. Les exemples les plus courants sont les fichiers de forme, les fichiers .dbf, les fichiers raster (.jpg, .tif, .img, .png et .bmp), les fichiers DAO (.dxf et .dwg) et les fichiers cartographiques (.mxd, .aprx).

  • L'outil génère deux sorties : Fichier en sortie et Nom qui peuvent être utilisées en tant que variable en ligne (par exemple, %Nom%) dans d'autres outils.

  • Spécifiez l'extension de fichier dans le paramètre optionnel pour extensions, telles que txt, pdf, zip, et ainsi de suite. Par exemple, si l'outil itère des fichiers texte et que la sortie est utilisée dans les outils, tels que ASCII vers raster, spécifiez l'extension txt dans le paramètre facultatif d'extension de fichier.

  • La plupart des outils respectent le format de fichier en sortie de l'outil Itérer les fichiers à l'exception des outils, tels que Copier, qui nécessite que vous définissiez l'extension de fichier dans le nom en sortie. Par exemple, si vous utilisez l'outil Itérer les fichiers pour itérer des fichiers zip en vue de les utiliser comme entrée de l'outil Copier, le nom en sortie doit contenir l'extension Name.zip ou %Nom%.zip.

Syntaxe

arcpy.mb.IterateFiles(in_folder, {wildcard}, {extension}, {recursive})
ParamètreExplicationType de données
in_folder

Dossier dans lequel se trouvent les fichiers en entrée.

Folder
wildcard
(Facultatif)

Combinaison de * et d’autres caractères pour limiter les résultats. L'astérisque revient au même que d'indiquer ALL. Si aucun caractère générique n'est spécifié, toutes les entrées sont renvoyées. Par exemple, il peut permettre de restreindre l’itération de noms en entrée qui commencent par un caractère ou un mot donné (par exemple, A* ou Ari* ou Land* et ainsi de suite).

String
extension
(Facultatif)

Extension de fichier, telle que TXT, ZIP, etc. Seuls les fichiers dotés de l'extension spécifiée seront itérés. Entrez l'extension de fichier sans point.

String
recursive
(Facultatif)

Détermine si tous les sous-dossiers du dossier principal seront itérés de manière récursive.

  • Activé - Tous les sous-dossiers seront itérés.
  • Désactivé - Les sous-dossiers ne seront pas itérés.
Boolean

Sortie dérivée

NomExplicationType de données
file

Chemin d’accès complet au fichier.

Fichier
name

Le nom du jeu de données.

Chaîne

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui