Toolbox in Version speichern (Data Management)

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

BeschriftungErläuterungDatentyp
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.

  • 10.6.0ArcGIS Desktop 10.6.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 10.7.0ArcGIS Desktop 10.7.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 10.8.0ArcGIS Desktop 10.8.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 10.8.2ArcGIS Desktop 10.8.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.2ArcGIS Pro 2.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.3ArcGIS Pro 2.3 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.4ArcGIS Pro 2.4 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.5ArcGIS Pro 2.5 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.6ArcGIS Pro 2.6 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.7ArcGIS Pro 2.7 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.8ArcGIS Pro 2.8 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.9ArcGIS Pro 2.9 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 3.0ArcGIS Pro 3.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 3.1ArcGIS Pro 3.1 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
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.

  • Aktiviert: Ein Fehler wird verursacht, und die Ausgabe-Toolbox wird nicht erstellt. Dies ist die Standardeinstellung.
  • Deaktiviert: Eine Warnmeldung wird ausgegeben, und die Ausgabe-Toolbox wird erstellt. Bei Modellwerkzeugen wird das entsprechende Werkzeug aus dem Modell entfernt, was eine manuelle Bearbeitung erfordert.
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.

  • Aktiviert: Ein Fehler wird verursacht, und die Ausgabe-Toolbox wird nicht erstellt. Dies ist die Standardeinstellung.
  • Deaktiviert: Eine Warnmeldung wird erzeugt, der Parameter wird aus dem Modell entfernt, und die Ausgabe-Toolbox wird erstellt.
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.

  • Aktiviert: Ein Fehler wird verursacht, und die Ausgabe-Toolbox wird nicht erstellt. Dies ist die Standardeinstellung.
  • Deaktiviert: Eine Warnmeldung wird ausgegeben, und die Ausgabe-Toolbox wird erstellt. Wenn die Ausgabe-Toolbox einen Wert enthält, der nicht in der Domäne liegt oder der ungültig ist, wird ein Fehler verursacht.
Boolean

arcpy.management.SaveToolboxToVersion(in_toolbox, version, out_toolbox, {missing_tool}, {missing_param}, {invalid_param_value})
NameErläuterungDatentyp
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.

  • 10.6.0ArcGIS Desktop 10.6.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 10.7.0ArcGIS Desktop 10.7.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 10.8.0ArcGIS Desktop 10.8.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 10.8.2ArcGIS Desktop 10.8.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.2ArcGIS Pro 2.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.3ArcGIS Pro 2.3 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.4ArcGIS Pro 2.4 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.5ArcGIS Pro 2.5 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.6ArcGIS Pro 2.6 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.7ArcGIS Pro 2.7 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.8ArcGIS Pro 2.8 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 2.9ArcGIS Pro 2.9 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 3.0ArcGIS Pro 3.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
  • 3.1ArcGIS Pro 3.1 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet. Die Ausgabe-Toolbox wird in dieser Version gespeichert.
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.

  • ERROR_ON_MISSING_TOOLEin Fehler wird verursacht, und die Ausgabe-Toolbox wird nicht erstellt. Dies ist die Standardeinstellung.
  • WARN_ON_MISSING_TOOLEine Warnmeldung wird ausgegeben, und die Ausgabe-Toolbox wird erstellt. Bei Modellwerkzeugen wird das entsprechende Werkzeug aus dem Modell entfernt, was eine manuelle Bearbeitung erfordert.
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.

  • ERROR_ON_MISSING_REQUIRED_PARAMEin Fehler wird verursacht, und die Ausgabe-Toolbox wird nicht erstellt. Dies ist die Standardeinstellung.
  • WARN_ON_MISSING_REQUIRED_PARAMEine Warnmeldung wird erzeugt, der Parameter wird aus dem Modell entfernt, und die Ausgabe-Toolbox wird erstellt.
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.

  • ERROR_ON_INVALID_PARAM_VALUEEin Fehler wird verursacht, und die Ausgabe-Toolbox wird nicht erstellt. Dies ist die Standardeinstellung.
  • WARN_ON_INVALID_PARAM_VALUEEine Warnmeldung wird ausgegeben, und die Ausgabe-Toolbox wird erstellt. Wenn die Ausgabe-Toolbox einen Wert enthält, der nicht in der Domäne liegt oder der ungültig ist, wird ein Fehler verursacht.
Boolean

Codebeispiel

SaveToolboxToVersion: Beispiel 1 (Python-Fenster)

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

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen