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

В каждом выпуске 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), что не влияет на обратную совместимость.
• Требования наличия дополнительного модуля может повлиять на существующий рабочий процесс. Изменения дополнительных модулей, влияющие на рабочий процесс, встречаются редко.
• Если изменилось значение параметра по умолчанию, это может повлиять на рабочий процесс. Необходимо изучить рабочие процессы, чтобы определить эффект изменения значения по умолчанию.
• Если изменился порядок следования параметров, скрипты, использующие позиционирование аргументов, могут перестать работать.