Подпись | Описание | Тип данных |
Входные данные | Входной набор инструментов (файл .tbx или .atbx), который будет проанализирован. Формат набора инструментов Python (файл .pyt) не поддерживается в качестве входных данных. | Toolbox |
Целевая версия | Определяет версию ПО, которая будет использоваться для анализа совместимости набора инструментов.
| String |
Выходной файл (Дополнительный) | Создаваемый текстовый файл, содержащий проблемы с совместимостью, которые были выявлены анализаторами. | File |
Краткая информация
Анализирует содержимое набора инструментов и выявляет возможные проблемы совместимости с предыдущими версиями ПО ArcGIS.
Этот инструмент оценивает набор инструментов (для инструментов и ModelBuilder, и Python) и определяет, какие инструменты геообработки ArcGIS AllSource в них входят. Затем инструмент определяет возможные проблемы совместимости между используемой версией ПО и указанной целевой версией. Ошибки совместимости будут показаны как предупреждения и их дополнительно можно записать в текстовый файл.
Подробнее о сохранении набора инструментов в предыдущей версии
Использование
Входной набор инструментов при этом не будет изменен. Чтобы обновить набор инструментов, используйте инструмент Сохранить набор инструментов в версию.
Анализаторы совместимости инструментов проходят по списку известных проблем совместимости для каждого инструмента геообработки в каждой целевой версии.
Проблемы совместимости отслеживаются только для системных наборов инструментов ArcGIS AllSource.
Анализаторы инструментов не отслеживают совместимости функций в ArcPy, не являющихся инструментами геообработки. Изменения в функциях, не являющихся геообработкой (например, изменения в arcpy.da.SearchCursor) могут вызвать проблемы с совместимостью.
Анализатор совместимости определяет и выдает отчеты по следующим проблемам с совместимостью:
- Инструменты геообработки из системных наборов инструментов отсутствуют в целевой версии. Например, инструмент PDF в TIFF недоступен в версиях ArcGIS AllSource ранее 2.9.
- Тип данных геообработки переменной модели или параметр инструмента отсутствует в целевой версии (только для моделей). Например, данные типа Слой вокселов (GPVoxelLayer) поддерживаются только, начиная с версии ArcGIS AllSource 2.6.
- Параметры инструментов, отсутствующие в целевой версии. Например, параметр Таблицы шаблона был добавлен в инструмент Добавить поля (несколько) в версии ArcGIS AllSource 2.6.
- Изменения в некоторых свойствах параметров инструментов. Изменения в следующих свойствах параметров инструментов приведут к предупреждениям в совместимости:
- Тип параметра - у параметра могут быть типы: обязательный, дополнительный или полученный.
- Направление - у параметра может быть входное или выходное направление.
- Значение - значение параметра по умолчанию.
- Множественные значения - параметр может поддерживать как одно, так и несколько значений.
- Тип данных - тип данных параметра, например, Класс объектов (DEFeatureClass).
- Список фильтров - опции и фильтры, ограничивающие значения, которые считаются допустимыми для этого параметра.
- Тип фильтра - тип фильтра, связанного с этим параметром. Например, у параметра может не быть фильтра, может быть список значений или диапазон значений (допустим, от 0 до 10). Обычно изменения типа фильтра заключаются в том, что сначала он отсутствует, а потом появляется.
Примечание:
ArcGIS AllSource поддерживает обратную совместимость инструментов геообработки. Модели и скрипты, созданные с использованием более ранней версии ПО, можно использовать в более поздних версиях. Например, модель, созданная в ArcGIS AllSource 2.9 может быть использована в ArcGIS AllSource 3.0. Основная цель использования инструмента Анализировать набор инструментов для версии заключается в выявлении любых проблем совместимости, которые вызовут проблемы при создании (из изменении) набора инструментов в более поздней версии ПО (например, ArcGIS AllSource 3.0), а затем будут использованы в более ранней версии ПО (например, ArcGIS AllSource 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")