Toolbox für Version analysieren (Data Management)

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 AllSource-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

    Hinweis:

    ArcGIS AllSource 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 AllSource 2.9 erstelltes Modell in ArcGIS AllSource 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 AllSource 3.0) Probleme verursachen. Danach kann das Werkzeug mit einer früheren Softwareversion (z. B. ArcGIS AllSource 2.9) verwendet werden.

  • 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 AllSource-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 AllSource-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 AllSource 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 AllSource 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.

Parameter

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

  • ArcGIS Desktop 10.6.0ArcGIS Desktop 10.6.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS Desktop 10.7.0ArcGIS Desktop 10.7.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS Desktop 10.8.0ArcGIS Desktop 10.8.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS Desktop 10.8.2ArcGIS Desktop 10.8.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS AllSource 2.2ArcGIS AllSource 2.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS AllSource 2.3ArcGIS AllSource 2.3 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS AllSource 2.4ArcGIS AllSource 2.4 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS AllSource 2.5ArcGIS AllSource 2.5 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS AllSource 2.6ArcGIS AllSource 2.6 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS AllSource 2.7ArcGIS AllSource 2.7 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS AllSource 2.8ArcGIS AllSource 2.8 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS AllSource 2.9ArcGIS AllSource 2.9 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • ArcGIS AllSource 3.0ArcGIS AllSource 3.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 3.1ArcGIS AllSource 3.1 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 3.2ArcGIS AllSource 3.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
String
Ausgabedatei
(optional)

Die Textdatei, die erstellt wird und die die von den Analysefunktionen erkannten Kompatibilitätsprobleme enthält.

File

arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})
NameErläuterungDatentyp
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.

  • 10.6.0ArcGIS Desktop 10.6.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 10.7.0ArcGIS Desktop 10.7.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 10.8.0ArcGIS Desktop 10.8.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 10.8.2ArcGIS Desktop 10.8.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 2.2ArcGIS AllSource 2.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 2.3ArcGIS AllSource 2.3 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 2.4ArcGIS AllSource 2.4 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 2.5ArcGIS AllSource 2.5 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 2.6ArcGIS AllSource 2.6 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 2.7ArcGIS AllSource 2.7 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 2.8ArcGIS AllSource 2.8 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 2.9ArcGIS AllSource 2.9 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 3.0ArcGIS AllSource 3.0 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 3.1ArcGIS AllSource 3.1 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
  • 3.2ArcGIS AllSource 3.2 wird für die Analyse von Toolbox-Kompatibilitätsproblemen verwendet.
String
report
(optional)

Die Textdatei, die erstellt wird und die die von den Analysefunktionen erkannten Kompatibilitätsprobleme enthält.

File

Codebeispiel

AnalyzeToolboxForVersion: Beispiel 1 (Python-Fenster)

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

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Verwandte Themen