Guide pour les non-programmeurs pour le dépannage d'ArcPy

AndrewOrtego

<\/HEAD>Je m'appelle Andrew--vous pouvez m'appeler Drew--et je suis Analyste Support Bureau chez Esri Support Services. Si vous nous avez déjà appelés pour parler d'un problème Python, vous avez probablement parlé avec moi ! Je reçois beaucoup de retours positifs des personnes avec qui je discute sur le dépannage des scripts Python, et j'aimerais partager les conseils les plus populaires que je donne. Que vous appreniez à coder pour la première fois ou que vous commenciez tout juste avec le package site ArcPy, ces astuces devraient vous aider à remettre votre script sur les rails et plus près de l'achèvement.

Comme nous recevons beaucoup d'appels liés à Python dans le Support, j'ai rassemblé les six demandes les plus courantes dans les scénarios ci-dessous. Utilisez ces scénarios pour vous aider à décider quel flux de travail s'applique à votre problème actuel.1. Vous commencez avec Python pour la première fois et ne savez pas comment commencer à l'apprendre.<\/STRONG>

Vous avez de la chance ! J'ai écrit un blog sur ce même problème il y a environ un an ! Ce blog contient des tutoriels qui aident quiconque à apprendre à coder en Python et des liens vers de nombreuses ressources en ligne gratuites--ces ressources sont organisées par styles d'apprentissage, donc il y en a pour tous les goûts.Sept façons faciles de commencer à apprendre Python et ArcPy<\/A>2. Votre script <\/STRONG>renvoie le message d'erreur : 1 ImportError: No module named arcpy.7<\/STRONG>

C'est le problème le plus fréquent rencontré par Esri Support lors du dépannage d'ArcPy. Le message d'erreur est produit lorsque le package site ArcPy est mal installé, mais c'est très facile à corriger. Plusieurs causes peuvent interagir pour produire cette erreur, il est donc préférable de se référer à l'article de la base de connaissances 43846, Problème : Impossible d'importer arcpy,<\/A> pour plus de détails lors du dépannage de ce type de problème.

Si cet article ne fournit pas de solution, je recommande de parler avec votre équipe informatique pour déterminer s'il y a une raison de penser que vous n'auriez pas des permissions complètes en lecture ou écriture sur les répertoires auxquels vous accédez. Si vous travaillez sur une machine distante, essayez de dépanner directement sur la machine où ArcGIS for Desktop est installé.3. Le script que vous avez écrit fonctionne partout sauf dans le Planificateur de tâches Windows.<\/STRONG>

Comme Esri n'a pas créé le Planificateur de tâches Windows (WTS), c'est un cas difficile à dépanner avec Esri Support. Cependant, l'article de la base de connaissances, Le Planificateur de tâches Windows ne lance pas un script Python,<\/A> vous aidera à vérifier si le problème vient du WTS, de l'installation Python ou de votre script.4. Vous voulez commencer à créer un script, ou vous avez commencé à en créer un et devez avancer, mais vous êtes bloqué.<\/STRONG>

Dans ce cas, vous avez un objectif en tête, vous pouvez le faire sans Python, mais vous devez coder. Où aller ? L'étape la plus importante est de vérifier que vous avez un résultat souhaité en tête. Avec un objectif en tête, vous pouvez décomposer votre problème en étapes logiques.

Par exemple, disons que vous voulez écrire un script qui va découper une entité par une autre. Essayez d'abord dans ArcMap. Vos données donnent-elles les résultats attendus ? Êtes-vous sûr que c'est bien ce flux de travail dont vous avez besoin ? Si oui, alors il est temps de consulter la documentation pour l'outil Clip et obtenir la syntaxe Python qui vous aide à faire cela. Consultez la page d'aide ArcGIS for Desktop pour cette information, disponible ici :Référence outil Clip<\/A>

Notez que la section Syntaxe vous indique le nom de la fonction ArcPy associée à l'outil Géotraitement ainsi que les paramètres nécessaires (plus les paramètres optionnels) pour que la fonction fonctionne correctement. Faites attention aux types de données-- ils peuvent être parfois délicats !

La section Exemple de code est très utile pour ceux d'entre nous qui aiment apprendre par l'exemple, alors jetez un œil à cette section avant de commencer à coder ; elle peut mieux démontrer comment utiliser la fonction que la section Syntaxe.5. Votre script ne produit pas les résultats attendus et/ou vous suspectez qu'une fonction ArcPy cause un problème.<\/STRONG>

Je vois ce problème tout le temps, et j'ai trouvé une solution qui ne manque jamais de le résoudre. Les étapes suivantes devraient vous aider à mieux comprendre la source du problème.a.<\/STRONG> Que vous receviez un message d'erreur ou que votre sortie soit incorrecte, il sera utile d'isoler le code qui cause un problème. Faites un script qui démontre le « plus petit cas testable ».b. <\/STRONG>Dépanner une seule fonction ArcPy est beaucoup plus facile que dépanner un script de 2 000 lignes. Mettez la fonction suspectée dans son propre fichier .py (et créez peut-être quelques petites données test), et vérifiez que vous obtenez la sortie attendue de cette fonction.c.<\/STRONG> Ajoutez du code supplémentaire si nécessaire, mais n'oubliez pas que le but de ce test est d'isoler le problème jusqu'à une seule ligne dans votre script plus large. Tout problème peut être simplifié, et prendre du recul au lieu d'avancer vous fera gagner beaucoup de temps en débogage.6. Votre code ne fonctionne pas et vous êtes à l'aise avec Python pour isoler le problème.<\/STRONG>

Voici quelques conseils plus avancés pour dépanner votre script :a.<\/STRONG> Testez la fonction dans et hors console Python d'ArcMap ou ArcCatalog. Cela indiquera si un environnement intégré (IDE) accède correctement au fichier Python.exe installé avec ArcGIS for Desktop. ArcMap et ArcCatalog doivent toujours pouvoir exécuter des fonctions ArcPy. Si ces programmes ne peuvent pas exécuter des fonctions ArcPy, une réinstallation pourrait être nécessaire.b.<\/STRONG> Testez la fonction avec différentes données. Cela indique si le problème est spécifique aux données ou non.c.<\/STRONG> Consultez la documentation en ligne spécifique à la version d'ArcGIS for Desktop que vous utilisez. À chaque nouvelle version, certaines mises à jour sont faites au package site ArcPy qui changent le comportement des fonctions ArcPy.d.<\/STRONG> Si vous suspectez qu'une fonction est mal écrite, exécutez-la dans ArcMap ou ArcCatalog et utilisez la fenêtre Résultats Géotraitement pour copier la version Python de cet outil géotraitement dans le Presse-papiers Windows. Collez les résultats dans votre IDE préféré et comparez votre code au snippet Python fait par Esri. Il pourrait être un peu plus désordonné que votre code, mais comparer les deux pourrait vous donner une piste sur où se trouve le problème.

J'espère que cela aide ! Rappelez-vous, coder est une compétence et cela peut être vraiment déroutant parfois. Soyez patient avec vous-même et bientôt toutes ces étapes de dépannage seront intégrées dans chaque session d'écriture de script que vous entreprendrez. N'hésitez pas à chercher sur internet des solutions trouvées par d'autres et bien sûr, n'hésitez pas à nous appeler ici chez Esri Support si votre maintenance est active. Bonne chance et bon codage !Andrew O. - Analyste Support Bureau<\/EM>



<\/BODY><\/HTML>

AndresCastillo

Thank you!