Recueillir des valeurs

Résumé

L'outil Recueillir des valeurs est conçu pour recueillir les valeurs en sortie d'un itérateur ou convertir une liste de valeurs multiples en une entrée unique. La sortie de l'outil Recueillir des valeurs peut être utilisée comme entrée pour des outils tels que Combiner, Ajouter, Mosaïque et Statistiques de cellule.

Pour en savoir plus sur le fonctionnement de l'outil Recueillir des valeurs dans ModelBuilder

Utilisation

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

Remarque :

Dans ArcGIS, tous les outils sont vides (sans couleur) lorsqu'ils sont ajoutés dans un modèle, à l'exception de Recueillir des valeurs et Fusionner des branches. Contrairement à d'autres outils système, Recueillir des valeurs est toujours prêt à être exécuté (coloré). Cela est dû au fait que l'entrée de l'outil Recueillir des valeurs est un type de données de valeur multiple et qu'une valeur multiple vide est considérée comme une entrée valide.

• Les sorties de l'outil avec l'option Ajouter à la carte activée sont ajoutées à l'affichage dans ArcMap à l'aide du nom de variable. Si vous utilisez un itérateur dans le modèle et souhaitez ajouter les sorties de toutes les itérations pour les afficher dans ArcMap avec le nom de sortie unique réel au lieu du nom de la variable, connectez la sortie à afficher à l'outil Recueillir les valeurs, puis cliquez avec le bouton droit sur la sortie de Recueillir les valeurs et activez l'option Ajouter à la carte. Si le modèle est destiné à être exécuté à partir de la boîte de dialogue d'outil du modèle, définissez Recueillir les valeurs comme paramètre de modèle, car seuls les paramètres de modèle en sortie sont ajoutés à la carte.

• L'outil Recueillir des valeurs peut également être utilisé pour supprimer les paramètres en sortie à partir de la boîte de dialogue de l'outil et faire en sorte que la sortie soit ajoutée à la carte. Par exemple, supposons que votre modèle utilise l'outil Zone tamponet que la sortie de l'outil Zone tampon soit un paramètre de modèle. Lorsque vous exécutez votre modèle à partir de la boîte de dialogue de son outil, cette dernière affiche ce paramètre, de sorte que l'utilisateur puisse changer l'emplacement d'écriture de la sortie de Zone tampon. Que se passe-t-il si vous ne souhaitez pas que l'utilisateur de la boîte de dialogue modifie cet emplacement ? En d'autres termes, vous voulez l'écrire dans un emplacement donné qu'il ne peut pas modifier. Vous pouvez changer la variable du modèle pour qu'elle ne soit pas un paramètre, mais les variables de modèle ne sont pas ajoutées à l'affichage si elles ne sont pas des paramètres.

  La solution consiste à changer la sortie de l'outil Zone tampon de manière qu'elle ne soit pas un paramètre et à la connecter à l'outil Recueillir des valeurs. Faites ensuite de la sortie de Recueillir des valeurs un paramètre de modèle. Lorsque vous exécutez le modèle à partir de la boîte de dialogue de l'outil, le paramètre ne s'affiche pas dans la boîte de dialogue et l'utilisateur ne peut pas le changer. Pourtant, puisqu'il s'agit d'un paramètre de sortie, il est ajouté à l'affichage. (Cela fonctionne car, techniquement, la sortie de Recueillir des valeurs est de type données dérivées d'entrée/sortie et que les données dérivées d'entrée/sortie ne sont pas ajoutées à la boîte de dialogue.)

Syntaxe

arcpy.mb.CollectValues(in_value)

Paramètre	Explication	Type de données
in_value	Valeurs d'entrée à recueillir.	Multiple Value

Environnements

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

Informations de licence

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