Beschriftung | Erläuterung | Datentyp |
Eingabe-Toolbox | Die Eingabe-Toolbox (.tbx- oder .atbx-Datei), die analysiert und gespeichert wird. Die Datei wird nicht geändert. Das Format der Python-Toolbox (.pyt-Datei) wird nicht als Eingabe unterstützt. | Toolbox |
Zielversion | Gibt die Softwareversion an, die für die Analyse von Kompatibilitätsproblemen bei Toolboxes verwendet wird.
| String |
Ausgabe-Toolbox | Die Toolbox, die zur Verwendung mit der ArcGIS-Software des Parameterwertes Zielversion erstellt wird. | Toolbox |
Fehler bei fehlendem Werkzeug (optional) | Gibt an, ob ein Fehler verursacht wird, wenn ein Werkzeug verwendet wird, das in der Zielversion nicht vorhanden ist.
| Boolean |
Fehler bei fehlendem erforderlichen Parameter (optional) | Gibt an, ob ein Fehler verursacht wird, wenn ein Parameter gefunden wird, der in der Zielversion nicht vorhanden ist, und der Parameter einen Wert aufweist, der vom Standardwert abweicht.
| Boolean |
Fehler bei ungültigem Parameterwert (optional) | Gibt an, ob ein Fehler verursacht wird, wenn ein Parameterwert gefunden wird, der im entsprechenden Parameterfilter in der Zielversion nicht vorhanden ist.
| Boolean |
Zusammenfassung
Analysiert und speichert eine Toolbox zur Verwendung mit einer bestimmten ArcGIS-Softwareversion.
Mit den Analysefunktionen wird überprüft, ob beim Geoverarbeitungswerkzeug bestimmte Kompatibilitätsprobleme zwischen der installierten Version von ArcGIS Pro und einer angegebenen Zielversion vorhanden sind. Eine Liste mit Kompatibilitätsproblemen wird im Werkzeug Toolbox für Version analysieren angezeigt, bei dem diese Analyselogik verwendet wird.
Weitere Informationen zum Speichern einer Toolbox unter einer früheren Version
Mit den Analysefunktionen des Werkzeugs werden Kompatibilitätsprobleme bei ModelBuilder- und Python-basierten Werkzeugen angezeigt (nur bei Skriptwerkzeugen, bei denen eine Python-Datei als Quelle des Werkzeugs verwendet wird). Folgende Unterscheidungen gibt es bei den durchgeführten Aktionen:
- Modellwerkzeug: Bestimmte Arten von Kompatibilitätsproblemen werden im Rahmen des Vorgangs behoben.
- Skriptwerkzeug: An der Quelldatei des Werkzeugs werden keine Änderungen vorgenommen.
Verwendung
Mit diesem Werkzeug wird eine Ausgabe-Toolbox erstellt, in die das Ergebnis geschrieben wird. Dabei wird die ursprüngliche Toolbox nicht verändert. Zur Vermeidung von Datenverlusten sollten Sie die ursprüngliche Toolbox beibehalten.
Die Werkzeuge in der Ausgabe-Toolbox können zu Ergebnissen führen, die nicht mit dem Original übereinstimmen. Daher sollten Sie die Werkzeuge in der Ausgabe-Toolbox auf Übereinstimmung prüfen.
Einige Funktionalitäten in Modellen, insbesondere diejenigen, die Filter, Domänen und Auswahllisten (Dropdown-Listen mit Werten) betreffen, werden aus der Ausgabe-Toolbox entfernt. Beheben Sie dieses Problem, indem Sie die entsprechenden Werkzeuge erneut mit dem Workflow des Modells verbinden.
Bei Skriptwerkzeugen wird der Pfad zur Python-Datei des Werkzeugs in der Ausgabe-Toolbox nicht verändert. Von den Skriptwerkzeugen in der ursprünglichen Toolbox und in der Ausgabe-Toolbox wird dieselbe Datei verwendet. Wenn Änderungen erforderlich sind, erstellen Sie eine Kopie der .py-Datei, und aktualisieren Sie die Eigenschaften der Skriptdatei eines der Skriptwerkzeuge so, dass auf die zweite .py-Datei verwiesen wird. Für Skriptwerkzeuge mit einer eingebetteten Skriptdatei gilt dies nicht.
Bestimmte Kompatibilitätsprobleme können mit diesem Werkzeug nicht behoben werden. So verursachen beispielsweise in der Zielversion nicht vorhandene Datentypen einen Fehler. Beheben Sie dieses Problem, indem Sie eine Kopie der Toolbox erstellen, die betreffenden Daten manuell entfernen und diese Toolbox als Eingabe verwenden.
Parameter
arcpy.management.SaveToolboxToVersion(in_toolbox, version, out_toolbox, {missing_tool}, {missing_param}, {invalid_param_value})
Name | Erläuterung | Datentyp |
in_toolbox | Die Eingabe-Toolbox (.tbx- oder .atbx-Datei), die analysiert und gespeichert wird. Die Datei wird nicht geändert. Das Format der Python-Toolbox (.pyt-Datei) wird nicht als Eingabe unterstützt. | Toolbox |
version | Gibt die Softwareversion an, die für die Analyse von Kompatibilitätsproblemen bei Toolboxes verwendet wird.
| String |
out_toolbox | Die Toolbox, die zur Verwendung mit der ArcGIS-Software des Parameterwertes version erstellt wird. | Toolbox |
missing_tool (optional) | Gibt an, ob ein Fehler verursacht wird, wenn ein Werkzeug verwendet wird, das in der Zielversion nicht vorhanden ist.
| Boolean |
missing_param (optional) | Gibt an, ob ein Fehler verursacht wird, wenn ein Parameter gefunden wird, der in der Zielversion nicht vorhanden ist, und der Parameter einen Wert aufweist, der vom Standardwert abweicht.
| Boolean |
invalid_param_value (optional) | Gibt an, ob ein Fehler verursacht wird, wenn ein Parameterwert gefunden wird, der im entsprechenden Parameterfilter in der Zielversion nicht vorhanden ist.
| Boolean |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion SaveToolboxToVersion im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.management.SaveToolboxToVersion(r"C:\toolboxes\MyTools.atbx", "2.7", "C:\toolboxes\MyTools_27.tbx")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja