Сохранить набор инструментов в версию (Управление данными)

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

Анализирует и сохраняет набор инструментов для использования с определенной версией программного обеспечения ArcGIS.

Анализаторы проверяют на возможные проблемы совместимости инструментов геообработки между установленной версией ArcGIS Pro и указанной целевой версией. Список проблем совместимости см. в инструменте Анализировать набор инструментов для версии, так как он использует ту же самую логику анализатора.

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

Анализатор инструмента сообщит о проблемах совместимости как с ModelBuilder, так и с Python инструментами (только для инструментов скриптов с файлом Python в качестве источника инструмента). Далее приведены различия выполняемых действий:

  • Инструмент Модель - определенные типы проблем совместимости будут найдены, как часть операции.
  • Инструмент Скрипт - никаких изменений не будет сделано в файле источника.

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

  • Этот инструмент создает выходной набор инструментов, куда записывается результат. Выходной набор инструментов при этом не будет изменен. Рекомендуется сохранить исходный набор инструментов, чтобы предотвратить потерю данных.

  • Инструменты в выходном наборе инструментов могут давать результаты, которые не согласуются с исходными. Протестируйте инструменты в выходном наборе инструментов для согласованности.

  • Некоторая функциональность в моделях, особенно связанная с фильтрами, доменами и списками выбора (ниспадающими списками значений), будет удалена из выходного набора инструментов. Чтобы исправить это, добавьте и подключите соответствующие инструменты в рабочий процесс модели.

  • Для инструментов скриптов путь к файлу Python инструмента не будет изменен в выходном наборе инструментов. Инструменты скриптов в исходном и выходном наборе инструментов будут использовать тот же файл. Если требуются изменения, сделайте копию файла .py и обновите один из двух свойств Файл скрипт инструмента скрипта, чтобы указать второй файл .py. Это не применяется к инструментам скрипта со встроенным файлом скрипта.

  • Определенные проблемы совместимости не могут быть исправлены этим инструментом. Например, типы данных, которых нет в целевой версии, будут давать ошибку. Чтобы это обнаружить, сделайте копию набора инструментов, вручную удалите проблемные данные и используйте набор инструментов как входные данные.

Параметры

ПодписьОписаниеТип данных
Входной набор инструментов

Входной набор инструментов (.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 будет использоваться для анализа ошибок совместимости набора инструментов. Выходной набор инструментов будет сохранен в этой версии.
String
Выходной набор инструментов

Набор инструментов, который будет создан для использования с программным обеспечениям ArcGIS заданного значения параметра Целевая версия.

Toolbox
Инструмент неверный или отсутствует
(Дополнительный)

Задает, будет ли появляться ошибка, если встречается инструмент, которого нет в целевой версии.

  • Отмечено – появится ошибка, и выходного набора инструментов создано не будет. Это значение по умолчанию
  • Не отмечено – появится предупреждение и будет создан выходной набор инструментов. Для инструментов модели проблемный инструмент будет удален из модели, что требует ручного редактирования.
Boolean
Обязательный параметр неверный или отсутствует
(Дополнительный)

Определяет, будет ли создана ошибка, если встречается параметр, которого нет в целевой версии и значение этого параметра не является значением по умолчанию.

  • Отмечено – появится ошибка, и выходного набора инструментов создано не будет. Это значение по умолчанию
  • Не отмечено – появится предупреждение, параметр будет удален из модели, и будет создан выходной набор инструментов.
Boolean
Значение параметра неверное или отсутствует
(Дополнительный)

Определяет, появится ли ошибка, если встретится значение параметра, которого нет в фильтре параметров в целевой версии.

  • Отмечено – появится ошибка, и выходного набора инструментов создано не будет. Это значение по умолчанию
  • Не отмечено – появится предупреждение и будет создан выходной набор инструментов. Выходной набор инструментов будет давать ошибку, если он имеет значение, которого нет в домене или которое является некорректным.
Boolean

arcpy.management.SaveToolboxToVersion(in_toolbox, version, out_toolbox, {missing_tool}, {missing_param}, {invalid_param_value})
ИмяОписаниеТип данных
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 будет использоваться для анализа ошибок совместимости набора инструментов. Выходной набор инструментов будет сохранен в этой версии.
String
out_toolbox

Набор инструментов, который будет создан для использования с программным обеспечениям ArcGIS заданного значения параметра version.

Toolbox
missing_tool
(Дополнительный)

Задает, будет ли появляться ошибка, если встречается инструмент, которого нет в целевой версии.

  • ERROR_ON_MISSING_TOOLПоявится ошибка, и выходного набора инструментов создано не будет. Это значение по умолчанию
  • WARN_ON_MISSING_TOOLПоявится предупреждение и будет создан выходной набор инструментов. Для инструментов модели проблемный инструмент будет удален из модели, что требует ручного редактирования.
Boolean
missing_param
(Дополнительный)

Определяет, будет ли создана ошибка, если встречается параметр, которого нет в целевой версии и значение этого параметра не является значением по умолчанию.

  • ERROR_ON_MISSING_REQUIRED_PARAMПоявится ошибка, и выходного набора инструментов создано не будет. Это значение по умолчанию
  • WARN_ON_MISSING_REQUIRED_PARAMПоявится предупреждение, параметр будет удален из модели, и будет создан выходной набор инструментов.
Boolean
invalid_param_value
(Дополнительный)

Определяет, появится ли ошибка, если встретится значение параметра, которого нет в фильтре параметров в целевой версии.

  • ERROR_ON_INVALID_PARAM_VALUEПоявится ошибка, и выходного набора инструментов создано не будет. Это значение по умолчанию
  • WARN_ON_INVALID_PARAM_VALUEПоявится предупреждение и будет создан выходной набор инструментов. Выходной набор инструментов будет давать ошибку со значением, которого нет в домене или является некорректным.
Boolean

Пример кода

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

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

import arcpy
arcpy.management.SaveToolboxToVersion(r"C:\toolboxes\MyTools.atbx", "2.7", "C:\toolboxes\MyTools_27.tbx")

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

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

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

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

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