Анализировать набор инструментов для версии (Управление данными)

Краткая информация

Анализирует содержимое набора инструментов и выявляет возможные проблемы совместимости с предыдущими версиями ПО ArcGIS.

Этот инструмент оценивает набор инструментов (для инструментов и ModelBuilder, и Python) и определяет, какие инструменты геообработки ArcGIS Pro в них входят. Он определяет возможные проблемы совместимости между используемой версией ПО и указанной целевой версией. Ошибки совместимости будут показаны как предупреждения и их можно записать в текстовый файл.

Подробнее о сохранении набора инструментов в предыдущей версии

Использование

    Примечание:

    ArcGIS Pro поддерживает обратную совместимость инструментов геообработки. Модели и скрипты, созданные с использованием более ранней версии ПО, можно использовать в более поздних версиях. Например, модель, созданная в ArcGIS Pro 2.9 может быть использована в ArcGIS Pro 3.0. Основная цель использования инструмента Анализировать набор инструментов для версии заключается в выявлении любых проблем совместимости, которые вызовут проблемы при создании (из изменении) набора инструментов в более поздней версии ПО (например, ArcGIS Pro 3.0), а затем будут использованы в более ранней версии ПО (например, ArcGIS Pro 2.9).

  • Входной набор инструментов при этом не будет изменен. Чтобы обновить набор инструментов, используйте инструмент Сохранить набор инструментов в версию.

  • Анализаторы совместимости инструментов проходят по списку известных проблем совместимости для каждого инструмента геообработки в каждой целевой версии.

  • Проблемы совместимости отслеживаются только для системных наборов инструментов ArcGIS Pro.

  • Анализаторы инструментов не отслеживают совместимости функций в ArcPy, не являющихся инструментами геообработки. Изменения в функциях, не являющихся геообработкой (например, изменения в arcpy.da.SearchCursor) могут вызвать проблемы с совместимостью.

  • Анализатор совместимости определяет и выдает отчеты по следующим проблемам с совместимостью:

    • Инструменты геообработки из системных наборов инструментов отсутствуют в целевой версии. Например, инструмент PDF в TIFF недоступен в версиях ArcGIS Pro ранее 2.9.
    • Тип данных геообработки переменной модели или параметр инструмента отсутствует в целевой версии (только для моделей). Например, данные типа Слой вокселов (GPVoxelLayer) поддерживаются только, начиная с версии ArcGIS Pro 2.6.
    • Параметры инструментов, отсутствующие в целевой версии. Например, параметр Таблицы шаблона был добавлен в инструмент Добавить поля (несколько) в версии ArcGIS Pro 2.6.
    • Изменения в некоторых свойствах параметров инструментов. Изменения в следующих свойствах параметров инструментов приведут к предупреждениям в совместимости:
      • Тип параметра - у параметра могут быть типы: обязательный, дополнительный или полученный.
      • Направление - у параметра может быть входное или выходное направление.
      • Значение - значение параметра по умолчанию.
      • Множественные значения - параметр может поддерживать как одно, так и несколько значений.
      • Тип данных - тип данных параметра, например, Класс объектов (DEFeatureClass).
      • Список фильтров - опции и фильтры, ограничивающие значения, которые считаются допустимыми для этого параметра.
      • Тип фильтра - тип фильтра, связанного с этим параметром. Например, у параметра может не быть фильтра, может быть список значений или диапазон значений (допустим, от 0 до 10). Обычно изменения типа фильтра заключаются в том, что сначала он отсутствует, а потом появляется.

Параметры

ПодписьОписаниеТип данных
Входные данные

Входной набор инструментов (файл .tbx или .atbx), который будет проанализирован.

Формат набора инструментов Python (файл .pyt) не поддерживается в качестве входных данных.

Toolbox
Целевая версия

Определяет версию ПО, которая будет использоваться для анализа совместимости набора инструментов.

  • ArcGIS Desktop 10.6.0ArcGIS Desktop 10.6.0 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Desktop 10.7.0ArcGIS Desktop 10.7.0 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Desktop 10.8.0ArcGIS Desktop 10.8.0 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Desktop 10.8.2ArcGIS Desktop 10.8.2 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 2.2ArcGIS Pro 2.2 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 2.3ArcGIS Pro 2.3 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 2.4ArcGIS Pro 2.4 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 2.5ArcGIS Pro 2.5 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 2.6ArcGIS Pro 2.6 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 2.7ArcGIS Pro 2.7 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 2.8ArcGIS Pro 2.8 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 2.9ArcGIS Pro 2.9 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 3.0ArcGIS Pro 3.0 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • ArcGIS Pro 3.1ArcGIS Pro 3.1 будет использоваться для анализа проблем совместимости наборов инструментов.
  • ArcGIS Pro 3.2ArcGIS Pro 3.2 будет использоваться для анализа ошибок совместимости набора инструментов.
  • ArcGIS Pro 3.3ArcGIS Pro 3.3 будет использоваться для анализа ошибок в совместимости набора инструментов.
String
Выходной файл
(Дополнительный)

Создаваемый текстовый файл, содержащий проблемы с совместимостью, которые были выявлены анализаторами.

File

arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})
ИмяОписаниеТип данных
in_toolbox

Входной набор инструментов (файл .tbx или .atbx), который будет проанализирован.

Формат набора инструментов Python (файл .pyt) не поддерживается в качестве входных данных.

Toolbox
version

Определяет версию ПО, которая будет использоваться для анализа совместимости набора инструментов.

  • 10.6.0ArcGIS Desktop 10.6.0 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 10.7.0ArcGIS Desktop 10.7.0 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 10.8.0ArcGIS Desktop 10.8.0 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 10.8.2ArcGIS Desktop 10.8.2 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 2.2ArcGIS Pro 2.2 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 2.3ArcGIS Pro 2.3 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 2.4ArcGIS Pro 2.4 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 2.5ArcGIS Pro 2.5 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 2.6ArcGIS Pro 2.6 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 2.7ArcGIS Pro 2.7 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 2.8ArcGIS Pro 2.8 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 2.9ArcGIS Pro 2.9 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 3.0ArcGIS Pro 3.0 будет использоваться для анализа ошибок в совместимости набора инструментов.
  • 3.1ArcGIS Pro 3.1 будет использоваться для анализа проблем совместимости наборов инструментов.
  • 3.2ArcGIS Pro 3.2 будет использоваться для анализа ошибок совместимости набора инструментов.
  • 3.3ArcGIS Pro 3.3 будет использоваться для анализа ошибок в совместимости набора инструментов.
String
report
(Дополнительный)

Создаваемый текстовый файл, содержащий проблемы с совместимостью, которые были выявлены анализаторами.

File

Пример кода

AnalyzeToolboxForVersion, пример 1 (окно Python)

Пример скрипта окна Python для использования функции AnalyzeToolboxForVersion в режиме прямого запуска.

import arcpy
arcpy.management.AnalyzeToolboxForVersion(r"C:\toolboxes\MyTools.atbx", "3.0")

Параметры среды

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы