Résumé
Itère des fichiers dans un dossier.
Pour en savoir plus sur le fonctionnement de l'outil Itérer les fichiers dans ModelBuilder
Utilisation
Cet outil est prévu uniquement pour une utilisation dans ModelBuilder et non dans des scripts Python.
L'option Extension de fichier vous permet d'itérer les 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 Extension de fichier sur journal.
Si le fichier apparaît en tant que jeu de données dans la fenêtre Catalogue, l'outil Itérer les fichiers ignorera le fichier. Les exemples les plus courants sont les fichiers de forme, dbf, raster (.jpg, .tif, .img, .png, .bmp), DAO (.dxf, .dwg), et cartographiques (.mxd) ainsi que les géodatabases personnelles (.mdb).
L'outil génère deux sorties : le fichier en sortie et le nom qui peut être utilisé 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 pour les utiliser comme entrée de l'outil Copier, le nom en sortie doit contenir l'extension Nom.zip ou % Nom%.zip.
Si un itérateur est ajouté à un modèle, tous les outils du modèle itèrent chaque valeur de l'itérateur. Si vous ne souhaitez pas exécuter chacun des outils que le modèle comprend pour chaque valeur itérée, créez un sous-modèle/modèle dans le modèle/modèle imbriqué qui contient uniquement l'itérateur et ajoutez-le comme un outil de modèle au modèle principal.
Syntaxe
arcpy.mb.IterateFiles(in_folder, {wildcard}, {extension}, {recursive})| Paramètre | Explication | Type de données |
in_folder | Dossier dans lequel se trouvent les fichiers en entrée. | Folder |
wildcard (Facultatif) | Combinaison du caractère générique * 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.
| Boolean |
Environnements
Cet outil n'utilise pas d’environnement de géotraitement.
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui