Ein Leitfaden für Nicht-Programmierer zur Fehlerbehebung bei ArcPy

AndrewOrtego

<\/HEAD>Mein Name ist Andrew – Sie können mich Drew nennen – und ich bin Desktop Support Analyst bei Esri Support Services. Wenn Sie uns jemals wegen eines Python-Problems angerufen haben, haben Sie wahrscheinlich mit mir gesprochen! Ich erhalte viel positives Feedback von den Leuten, mit denen ich über die Fehlerbehebung bei Python-Skripten spreche, und ich möchte den beliebtesten Rat, den ich gebe, mit Ihnen teilen. Egal, ob Sie zum ersten Mal programmieren lernen oder gerade erst mit dem ArcPy site package anfangen, diese Tipps und Tricks sollten Ihnen helfen, Ihr Skript wieder auf Kurs zu bringen und näher an die Fertigstellung zu bringen.

Da wir im Support viele verschiedene Python-bezogene Anfragen erhalten, habe ich die sechs häufigsten Anfragen in den folgenden Szenarien zusammengefasst. Nutzen Sie diese Szenarien, um zu entscheiden, welcher Arbeitsablauf auf Ihr aktuelles Problem zutrifft.1. Sie fangen zum ersten Mal mit Python an und wissen nicht, wie Sie es lernen sollen.<\/STRONG>

Sie haben Glück! Ich habe vor etwa einem Jahr einen Blog zu genau diesem Problem geschrieben! Dieser Blog enthält Tutorials, die jedem helfen, Python zu lernen, sowie Links zu vielen kostenlosen Online-Ressourcen – diese Ressourcen sind nach Lernstilen organisiert, sodass für jeden etwas dabei ist.Sieben einfache Wege, um Python und ArcPy zu lernen<\/A>2. Ihr Skript <\/STRONG>gibt die Fehlermeldung aus: ImportError: No module named arcpy.<\/STRONG>

Dies ist das häufigste Problem, auf das Esri Support bei der Fehlerbehebung von ArcPy stößt. Die Fehlermeldung tritt auf, wenn das ArcPy site package falsch installiert wurde, aber es ist sehr einfach zu beheben. Es gibt mehrere Ursachen, die zusammenwirken können, um diesen Fehler zu erzeugen. Daher ist es am besten, sich beim Troubleshooting dieses Problems auf den Knowledge Base-Artikel 43846, Problem: Unable to import arcpy,<\/A> zu beziehen.

Wenn dieser Artikel keine Lösung bietet, empfehle ich Ihnen, mit Ihrem IT-Team zu sprechen, um festzustellen, ob es einen Grund gibt anzunehmen, dass Sie keine vollständigen Lese- oder Schreibrechte für die Verzeichnisse haben, auf die Sie zugreifen. Wenn Sie an einem Remote-Rechner arbeiten, versuchen Sie direkt auf dem Rechner mit der Installation von ArcGIS for Desktop zu troubleshootieren.3. Das von Ihnen geschriebene Skript funktioniert überall außer im Windows Task Scheduler.<\/STRONG>

Da Esri den Windows Task Scheduler (WTS) nicht erstellt hat, ist dies ein schwieriges Problem für den Esri Support. Der Knowledge Base-Artikel Windows Task Scheduler will not run a Python script,<\/A> hilft Ihnen jedoch dabei zu überprüfen, ob das Problem am WTS, an der Python-Installation oder an Ihrem Skript liegt.4. Sie möchten ein Skript erstellen oder haben bereits damit begonnen und kommen nicht weiter.<\/STRONG>

In diesem Fall haben Sie ein Ziel vor Augen; Sie können es ohne Python erreichen, aber Sie müssen programmieren. Wohin wenden Sie sich? Der wichtigste Schritt ist sicherzustellen, dass Sie ein wünschenswertes Ergebnis vor Augen haben. Mit einem Ziel können Sie Ihr Problem in logische Schritte zerlegen.

Zum Beispiel wollen Sie ein Skript schreiben, das ein Feature an ein anderes zuschneidet. Versuchen Sie es zuerst in ArcMap. Liefert Ihre Daten das erwartete Ergebnis? Sind Sie sicher, dass dies der richtige Arbeitsablauf ist? Wenn ja, dann ist es Zeit, die Dokumentation zum Clip-Werkzeug durchzusehen und die Python-Syntax zu erhalten, die Ihnen dabei hilft. Schauen Sie sich die ArcGIS for Desktop-Hilfeseite dafür an – bequem hier:Clip Tool Referenz<\/A>

Beachten Sie, dass der Syntax-Abschnitt Ihnen den Namen der ArcPy-Funktion zeigt, die mit dem Geoverarbeitungswerkzeug verbunden ist sowie die benötigten (und optionalen) Parameter für eine korrekte Ausführung der Funktion. Achten Sie besonders auf die Datentypen – die können manchmal knifflig sein!

Der Code-Beispielabschnitt ist sehr nützlich für diejenigen von uns, die gerne durch Beispiele lernen; sehen Sie sich diesen Abschnitt an bevor Sie mit dem Programmieren beginnen; er kann besser zeigen wie man die Funktion verwendet als der Syntax-Abschnitt.5. Ihr Skript liefert nicht die erwarteten Ergebnisse und/oder Sie vermuten ein Problem mit einer ArcPy-Funktion.<\/STRONG>

Dieses Problem sehe ich sehr oft und ich habe eine Lösung entwickelt, die immer funktioniert. Die folgenden Schritte sollten Ihnen helfen mehr über die Ursache des Problems herauszufinden.a.<\/STRONG> Ob Sie eine Fehlermeldung erhalten oder Ihre Ausgabe falsch ist – isolieren Sie den Codeabschnitt der das Problem verursacht. Erstellen Sie ein Skript mit dem "kleinsten testbaren Fall".b. <\/STRONG>Die Fehlerbehebung einer einzelnen ArcPy-Funktion ist viel einfacher als bei einem 2.000-Zeilen-Skript. Legen Sie die verdächtige Funktion in eine eigene .py-Datei (und erstellen Sie ggf. kleine Testdaten) und prüfen Sie ob die Ausgabe dieser Funktion wie erwartet ist.c.<\/STRONG> Fügen Sie bei Bedarf weiteren Code hinzu; vergessen Sie aber nicht: Ziel dieses Tests ist es das Problem auf eine einzelne Zeile in Ihrem größeren Skript einzuschränken. Jedes Problem kann vereinfacht werden; einen Schritt zurückzugehen statt vorwärts spart viel Debugging-Zeit.6. Ihr Code funktioniert nicht und Sie fühlen sich sicher genug in Python um das Problem selbst einzugrenzen.<\/STRONG>

Hier sind einige fortgeschrittene Tipps zur Fehlerbehebung Ihres Skripts:a.<\/STRONG> Testen Sie die Funktion sowohl innerhalb als auch außerhalb der Python-Konsole von ArcMap oder ArcCatalog. Dies zeigt an ob eine integrierte Entwicklungsumgebung (IDE) korrekt auf die mit ArcGIS for Desktop installierte Python.exe-Datei zugreift. ArcMap und ArcCatalog sollten immer in der Lage sein ArcPy-Funktionen auszuführen. Falls diese Programme keine ArcPy-Funktionen ausführen können, könnte eine Neuinstallation notwendig sein.b.<\/STRONG> Testen Sie die Funktion mit unterschiedlichen Daten. Dies zeigt an ob das Problem datenabhängig ist oder nicht.c.<\/STRONG> Prüfen Sie die Online-Dokumentation speziell für Ihre Version von ArcGIS for Desktop. Mit jeder neuen Version werden Updates am ArcPy site package vorgenommen welche das Verhalten der Funktionen ändern können.d.<\/STRONG> Wenn Sie vermuten dass eine Funktion fehlerhaft geschrieben wurde: Führen Sie sie in ArcMap oder ArcCatalog aus und verwenden das Fenster Geoverarbeitungsergebnisse um die Python-Version dieses Geoverarbeitungswerkzeugs in die Windows-Zwischenablage zu kopieren. Fügen Sie das Ergebnis in Ihre bevorzugte IDE ein und vergleichen Ihren Code mit dem von Esri erstellten Python-Snippet. Es könnte etwas unordentlicher sein als Ihr Code; aber der Vergleich kann Hinweise geben wo das Problem liegt.

Ich hoffe das hilft! Denken Sie daran: Programmieren ist eine Fähigkeit und kann manchmal wirklich verwirrend sein. Seien Sie geduldig mit sich selbst und bald werden all diese Schritte zur Fehlerbehebung Teil jeder Ihrer Skripterstellungs-Sessions sein. Scheuen Sie sich nicht davor im Internet nach Lösungen zu suchen die andere gefunden haben; und natürlich können Sie uns gerne hier beim Esri Support anrufen wenn Ihre Wartung aktuell ist. Viel Erfolg und viel Spaß beim Programmieren!Andrew O. - Desktop Support Analyst<\/EM>



<\/BODY><\/HTML>

AndresCastillo

Thank you!