Разделы об истории наборов инструментов

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

Документация всех наборов инструментов в ArcGIS включает раздел об истории набора, в котором описаны подробности всех изменений, внесенных в инструменты в каждой новой версии. Например, см. История набора инструментов Анализ. Описание истории развития каждого инструмента приводится в таблице ниже. Информация включает в себя типs изменений, зафиксированных в разделах об истории.

Происхождение инструмента
- Новое в этой версии – в последней строке каждой таблицы всегда содержится версия выпуска, в которой инструмент впервые появился в наборе.
- Перенесено из ArcMap - если вы переходите с ArcMap на ArcGIS Pro, вам может потребоваться выяснить, доступен ли инструмент из ArcMap в ArcGIS Pro. Большинство инструментов, доступных в ArcMap 10.3, стали доступны в ArcGIS Pro 1.0. Если инструмент исходно появился в ArcMap, информация об этом скорее всего будет в виде строки в таблице.
Информация о параметрах
- Новые и удаленные параметры – Новые параметры почти всегда добавляются как самые последние, чтобы в скриптах сохранялась обратная совместимость.
  
  Удаление параметров встречается редко. Скрипты, которые используют удаленные параметры, должны быть изменены, но модели могут продолжать работать.
- Опции – Опция параметра - это строковое ключевое слово, которое влияет на работу инструмента. Например, параметр 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.management.AddField("schools", "school_id", "LONG", "", "", "", "", "NON_NULLABLE")

# Keyword arguments - position doesn't matter
arcpy.management.AddField("schools", "school_id", "LONG", field_is_nullable="NON_NULLABLE")
```
- Пример с Именем параметра — имена параметров могут изменяться, например, с In_Features на in_features. Это может повлиять только на скрипты, использующие аргументы ключевого слова. В Python аргументы ключевых слов чувствительны к регистру.
- Тип – Тип параметра может измениться с обязательного на дополнительный и наоборот. Изменение с дополнительного на обязательный может повлиять на имеющийся рабочий процесс.
Лицензирование и дополнительные модули
- Изменение лицензии или дополнительного модуля – Изменение лицензии или дополнительного модуля может повлиять на имеющиеся рабочие процессы.
Устаревание
- Устаревание – Устаревший инструмент геообработки — это инструмент, который был заменен другими инструментами. Инструмент остается в ArcGIS Pro, но более не поддерживается разработчиком.
  
  Более подробно об устаревших инструментах

Совместимость

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

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