Подпись | Описание | Тип данных |
Входные данные | Входной набор инструментов (.tbx или .atbx), который будет проанализирован. Формат набора инструментов Python (.pyt) не поддерживается в качестве входных данных. | Toolbox |
Целевая версия | Определяет версию ПО, которая будет использоваться для анализа совместимости набора инструментов.
| String |
Выходной файл (Дополнительный) | Создаваемый текстовый файл, содержащий проблемы с совместимостью, которые были выявлены анализаторами. | File |
Краткая информация
Анализирует содержимое набора инструментов и выявляет возможные проблемы совместимости с предыдущими версиями ПО ArcGIS.
Этот инструмент оценивает набор инструментов (для инструментов и ModelBuilder, и Python) и определяет, какие инструменты геообработки ArcGIS Pro в них входят. Затем инструмент определяет возможные проблемы совместимости между используемой версией ПО и указанной целевой версией. Ошибки совместимости будут показаны как предупреждения и их дополнительно можно записать в текстовый файл.
Подробнее о сохранении набора инструментов в предыдущей версии
Использование
Входной набор инструментов при этом не будет изменен. Чтобы обновить набор инструментов, используйте инструмент Сохранить набор инструментов в версию.
Анализаторы совместимости инструментов проходят по списку известных проблем совместимости для каждого инструмента геообработки в каждой целевой версии.
Проблемы совместимости отслеживаются только для системных наборов инструментов ArcGIS Pro.
Анализаторы инструментов не отслеживают совместимости функций в ArcPy, не являющихся инструментами геообработки. Изменения в функциях, не являющихся геообработкой (например, изменения в arcpy.da.SearchCursor) могут вызвать проблемы с совместимостью.
Анализатор совместимости определяет и выдает отчеты по следующим проблемам с совместимостью:
- Инструменты геообработки из системных наборов инструментов отсутствуют в целевой версии. Например, инструмент PDF в TIFF недоступен в версиях ArcGIS Pro ранее 2.9.
- Тип данных геообработки переменной модели или параметр инструмента отсутствует в целевой версии (только для моделей). Например, данные типа Слой вокселов (GPVoxelLayer) поддерживаются только, начиная с версии ArcGIS Pro 2.6.
- Параметры инструментов, отсутствующие в целевой версии. Например, параметр Таблицы шаблона был добавлен в инструмент Добавить поля (несколько) в версии ArcGIS Pro 2.6.
- Изменения в некоторых свойствах параметров инструментов. Изменения в следующих свойствах параметров инструментов приведут к предупреждениям в совместимости:
- Тип параметра - у параметра могут быть типы: обязательный, дополнительный или полученный.
- Направление - у параметра может быть входное или выходное направление.
- Значение - значение параметра по умолчанию.
- Множественные значения - параметр может поддерживать как одно, так и несколько значений.
- Тип данных - тип данных параметра, например, Класс объектов (DEFeatureClass).
- Список фильтров - опции и фильтры, ограничивающие значения, которые считаются допустимыми для этого параметра.
- Тип фильтра - тип фильтра, связанного с этим параметром. Например, у параметра может не быть фильтра, может быть список значений или диапазон значений (допустим, от 0 до 10). Обычно изменения типа фильтра заключаются в том, что сначала он отсутствует, а потом появляется.
Примечание:
ArcGIS Pro поддерживает обратную совместимость инструментов геообработки. Модели и скрипты, созданные с использованием более ранней версии ПО, можно использовать в более поздних версиях. Например, модель, созданная в ArcGIS Pro 2.9 может быть использована в ArcGIS Pro 3.0. Основная цель использования инструмента Анализировать набор инструментов для версии заключается в выявлении любых проблем совместимости, которые вызовут проблемы при создании (из изменении) набора инструментов в более поздней версии ПО (например, ArcGIS Pro 3.0), а затем будут использованы в более ранней версии ПО (например, ArcGIS Pro 2.9).
Параметры
arcpy.management.AnalyzeToolboxForVersion(in_toolbox, version, {report})
Имя | Описание | Тип данных |
in_toolbox | Входной набор инструментов (.tbx или .atbx), который будет проанализирован. Формат набора инструментов Python (.pyt) не поддерживается в качестве входных данных. | Toolbox |
version | Определяет версию ПО, которая будет использоваться для анализа совместимости набора инструментов.
| String |
report (Дополнительный) | Создаваемый текстовый файл, содержащий проблемы с совместимостью, которые были выявлены анализаторами. | File |
Пример кода
В следующем скрипте окна Python показано, как используется функция AnalyzeToolboxForVersion в режиме прямого запуска.
import arcpy
arcpy.management.AnalyzeToolboxForVersion(r"C:\toolboxes\MyTools.atbx", "2.7")
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да