Более подробно о таблицах истории набора инструментов

В каждом выпуске Esri вносит изменения в имеющиеся инструменты и добавляет новые. Эти изменения обеспечивают решение проблем, которое было невозможно выполнить в предыдущих версиях, и делают инструменты более мощными и удобными. Документация всех стандартных наборов инструментов в ArcGIS включает раздел об истории набора, в котором сохраняются все изменения, внесенные в инструменты в каждой новой версии. Ниже вы ознакомитесь с подробной информацией по интерпретации и использованию разделов истории наборов инструментов.

В качестве примера раздела истории набора инструментов см. История набора инструментов Анализ.

Esri стремится обеспечить обратную совместимость. Однако это не всегда возможно из-за появления новых функций. Ниже приведены ситуации, когда обратная совместимость может не работать:

  • Если параметр удален, рабочий процесс, использующий его, не сможет продолжить работу.
  • Если удалена опция параметра, рабочие процессы, использующие ее, не смогут продолжить работу. Во многих случаях удаляемая опция заменяется другой, а у инструмента имеются инструкции по работе с ранее использовавшейся опцией.
  • Если у параметра удален тип данных, а в устаревшем рабочем процессе использовались данные этого типа, рабочей процесс не будет работать в новой версии.
  • На рабочий процесс может повлиять изменение лицензии. Большинство изменений лицензий являются нисходящими (например, с Desktop Advanced на Desktop Standard), что не влияет на обратную совместимость.
  • На рабочий процесс может повлиять изменение дополнительного модуля. Изменения дополнительных модулей, влияющие на рабочий процесс, встречаются редко.
  • Если изменилось значение параметра по умолчанию, это может повлиять на рабочий процесс. Необходимо изучить рабочие процессы, чтобы определить эффект изменения значения по умолчанию.
  • Если изменился порядок следования параметров, скрипты, использующие позиционирование аргументов, могут перестать работать.

Ниже приведены более подробные сведения об изменениях, сведенные в таблицы истории.

Новое в этой версии.

В последней строке каждой таблицы всегда содержится версия выпуска, в которой инструмент впервые появился в наборе.

Перенесено / Не перенесено в ArcGIS Pro

Если вы переходите с ArcMap на ArcGIS Pro, вам может потребоваться выяснить, доступен ли инструмент из ArcMap в ArcGIS Pro. Большинство инструментов, имеющихся в версии 10.3, были портированы (т.е., воспроизведены и сделаны доступными) в версию ArcGIS Pro 1.0. Информация о том, был ли инструмент портирован с ArcMap на платформу ArcGIS Pro, обычно сдержится в первой строке таблицы. Имейте в виду, что вы можете использовать инструмент Анализировать инструменты для Pro для проверки работоспособности моделей и скриптов в ArcGIS Pro.

Примечание:

Сведения об инструментах, портированных с ArcMap в ArcGIS Pro, доступны только для ArcMap версий 10.3 и 10.3.1. Например, если инструмент был портирован с ArcMap 10.4 на ArcGIS Pro, или с ArcGIS Pro на ArcMap 10.4, эти сведения не записываются в таблицы истории.

Опции параметров

Опция параметра (также называется перечислителем) является строкой, которая влияет на работу инструмента. Например, параметр join_attributes инструмента Пересечение содержит три опции: ALL, NO_FID и FID_ONLY. Периодически в новых версиях появляются новые опции, некоторые опции могут удаляться. Опция, появившаяся в новой версии (например, в 10.4) не может использоваться в предыдущей версии (такой как 10.3).

Иногда можно увидеть, что опция удалена и заменена похожей, например, Euclidean distance заменена на EUCLIDEAN_DISTANCE. В таких случаях инструмент запрограммирован на работу с обоими опциями, т.е. обратная совместимость сохраняется.

Новые и удаленные параметры

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

Удаленные параметры встречаются редко. Скрипты, которые используют удаленные параметры, должны быть изменены, но модели могут продолжать работать.

Изменение значений параметров по умолчанию

У дополнительных параметров имеются значения по умолчанию – значение, которое используется, пока вы его не изменили. Если значение параметра по умолчанию изменилось, это может повлиять на имеющиеся модели и скрипты.

Изменение типа данных параметра

Тип данных определяет разрешенные значения параметра, например, тип набора данных (объекты, таблицы, сети и так далее). Если в новой версии тип данных удален, это значит, что параметр больше не принимает набор данных в качестве входных или выходных данных. Может потребоваться изменить модели и скрипты, использующие удаленные типы данных.

Порядок следования параметров

Новые параметры почти всегда добавляются как самые последние, и не влияют на порядок имеющихся. В редких случаях порядок следования параметров может измениться, и скрипты, использующие позиционирование аргументов, могут перестать работать. Вместо использования позиционирования аргументов, можно воспользоваться аргументами ключевых слов, как показано ниже. Модели продолжат работать, т.к. они не зависят от порядка следования параметров.


# Positional arguments - skipping optional arguments using empty strings is dependent on 
#  the order of the optional parameters
#
arcpy.AddField_management("schools", "school_id", "LONG", "", "", "", "", "NON_NULLABLE")
# Keyword arguments - position doesn't matter
#
arcpy.AddField_management("schools", "school_id", "LONG", field_is_nullable="NON_NULLABLE")

Регистр названия параметра

У названия параметра может измениться регистр, например, с In_Features на in_features. Это может повлиять только на скрипты, использующие аргументы ключевого слова. В Python аргументы ключевых слов чувствительны к регистру.

Тип параметра

Тип параметра может измениться с обязательного на дополнительный и наоборот. Изменение с дополнительного на обязательный может повлиять на имеющийся рабочий процесс.

Лицензирование инструментов и дополнительных модулей

Изменение лицензии или дополнительного модуля может повлиять имеющиеся рабочие процессы.

Изменения параметров среды

Начиная с Pro 1.3, исторические таблицы записывают изменения в настройках среды геообработки, поддерживаемых каждым инструментом.

Устаревший инструмент

См. раздел Что такое исключенный инструмент? для получения более подробной информации.