Beschriftung | Erläuterung | Datentyp |
Eingabe | Die Eingabe-Toolbox (.tbx- oder .atbx-Datei), die analysiert wird. Das Format der Python-Toolbox (.pyt-Datei) wird nicht als Eingabe unterstützt. | Toolbox |
Zielversion | Gibt die Softwareversion an, die für die Toolbox-Kompatibilitätsanalyse verwendet wird.
| String |
Ausgabedatei (optional) | Die Textdatei, die erstellt wird und die die von den Analysefunktionen erkannten Kompatibilitätsprobleme enthält. | File |
Zusammenfassung
Zum Analysieren der Inhalte einer Toolbox und zum Erkennen von Kompatibilitätsproblemen mit früheren ArcGIS-Softwareversionen.
Mit dem Werkzeug werden Toolboxes ausgewertet (im Hinblick auf ModelBuilder- und Python-basierte Werkzeuge) und die darin enthaltenen ArcGIS Pro-Geoverarbeitungswerkzeuge ermittelt. Anschließend werden mit dem Werkzeug Kompatibilitätsprobleme zwischen der verwendeten Softwareversion und einer angegebenen Zielversion ermittelt. Kompatibilitätsprobleme werden als Warnmeldungen angezeigt und können optional in eine Textdatei geschrieben werden.
Weitere Informationen zum Speichern einer Toolbox unter einer früheren Version
Verwendung
Dabei wird die Eingabe-Toolbox nicht verändert. Verwenden Sie zum Aktualisieren der Toolbox das Werkzeug Toolbox in Version speichern.
Mit den Funktionen des Werkzeugs zur Kompatibilitätsanalyse wird für jedes Geoverarbeitungswerkzeug eine Liste mit bekannten Kompatibilitätsproblemen bei den einzelnen Zielversionen nachverfolgt.
Kompatibilitätsprobleme werden nur für ArcGIS Pro-System-Toolboxes nachverfolgt.
Die Kompatibilität von Funktionen von Nicht-Geoverarbeitungswerkzeugen in ArcPy wird mit den Funktionen des Werkzeugs zur Kompatibilitätsanalyse nicht nachverfolgt. Änderungen an Funktionen von Nicht-Geoverarbeitungswerkzeugen (z. B. Änderungen an arcpy.da.SearchCursor) können Kompatibilitätsprobleme verursachen.
Mit der Funktion des Werkzeugs zur Kompatibilitätsanalyse werden die folgenden Kompatibilitätsprobleme erkannt und angezeigt:
- Geoverarbeitungswerkzeuge aus den System-Toolboxes, die in der Zielversion nicht vorhanden sind. Das Werkzeug PDF in TIFF war beispielsweise in ArcGIS Pro-Versionen vor Version 2.9 nicht verfügbar.
- Der Geoverarbeitungsdatentyp einer Modellvariablen oder eines Werkzeugparameters ist in der Zielversion nicht vorhanden (nur Modelle). Der Datentyp Voxel-Layer (GPVoxelLayer) wird beispielsweise erst seit ArcGIS Pro 2.6 unterstützt.
- Werkzeugparameter, die in der Zielversion nicht vorhanden sind. Der Parameter Vorlagentabellen wurde beispielsweise dem Werkzeug Felder hinzufügen (mehrere) in ArcGIS Pro 2.6 hinzugefügt.
- Änderungen an bestimmten Eigenschaften eines Werkzeugparameters. Durch Änderungen an den folgenden Parametereigenschaften werden Kompatibilitätswarnungen erzeugt:
- Parametertyp: Ein Parameter kann den Typ "Erforderlich", "Optional" oder "Abgeleitet" aufweisen.
- Richtung: Ein Parameter kann die Richtung "Eingabe" oder "Ausgabe" aufweisen.
- Wert: Der Standardwert des Parameters.
- Mehrere Werte: Ein Parameter kann einzelne oder mehrere Werte unterstützen.
- Datentyp: Der Datentyp eines Parameters, z. B. Feature-Class (DEFeatureClass).
- Filterliste: Die Optionen und Filter, mit denen die Werte begrenzt werden, die für einen Parameter als gültig gelten.
- Filter-Typ: Der mit dem Parameter verknüpfte Filter-Typ. Ein Parameter kann beispielsweise keinen Filter, eine Werteliste oder einen Wertebereich (z. B. 0 bis 10) enthalten. In der Regel wird der Filter-Typ von "kein Filter" in "Filter" geändert.
Hinweis:
ArcGIS Pro unterstützt die Abwärtskompatibilität von Geoverarbeitungswerkzeugen. Mit einer früheren Softwareversion erstellte Modelle und Skripte können von späteren Softwareversionen verwendet werden. So kann beispielsweise ein in ArcGIS Pro 2.9 erstelltes Modell in ArcGIS Pro 3.0 verwendet werden. Mit dem Werkzeug Toolbox auf Version analysieren werden Kompatibilitätsprobleme analysiert, die beim Erstellen (oder Bearbeiten) einer Toolbox in einer späteren Softwareversion (z. B. ArcGIS Pro 3.0) Probleme verursachen. Danach kann das Werkzeug mit einer früheren Softwareversion (z. B. ArcGIS Pro 2.9) verwendet werden.
Parameter
arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})
Name | Erläuterung | Datentyp |
in_toolbox | Die Eingabe-Toolbox (.tbx- oder .atbx-Datei), die analysiert wird. Das Format der Python-Toolbox (.pyt-Datei) wird nicht als Eingabe unterstützt. | Toolbox |
version | Gibt die Softwareversion an, die für die Toolbox-Kompatibilitätsanalyse verwendet wird.
| String |
report (optional) | Die Textdatei, die erstellt wird und die die von den Analysefunktionen erkannten Kompatibilitätsprobleme enthält. | File |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion AnalyzeToolboxForVersion im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.management.AnalyzeToolboxForVersion(r"C:\toolboxes\MyTools.atbx", "2.7")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja