Temas de historial de caja de herramientas

En cada versión, Esri introduce herramientas nuevas y mejora las actuales. Estos cambios proporcionan soluciones a problemas difíciles de solucionar en versiones anteriores, mejoran las herramientas y las hacen más fáciles de usar.

La documentación de cada caja de herramientas de ArcGIS incluye un tema de historial de cajas de herramientas en el que se detallan los cambios realizados en las herramientas en cada versión. Para ver un ejemplo, consulte Historial de la caja de herramientas Análisis. Se proporciona una tabla de cada herramienta que ofrece información sobre el desarrollo de la herramienta a lo largo del tiempo. A continuación se incluye información sobre los tipos de cambios catalogados en los temas del historial.

• Orígenes de las herramientas
  • Novedad en esta versión: la fila inferior de cada tabla de herramientas suele contener la versión en la que se introdujo la herramienta por primera vez.
  • Basado en ArcMap: si está cambiando de ArcMap a ArcGIS Pro, puede que necesite saber si una herramienta de ArcMap está también disponible en ArcGIS Pro. La mayoría de las herramientas de ArcMap 10.3 estaban disponibles en ArcGIS Pro 1.0. Si la herramienta apareció en ArcMap, esta información se encontrará en la fila inferior de la tabla por regla general.

• Información de parámetros
  • Parámetros nuevos y eliminados: los parámetros nuevos casi siempre se agregan al final de los parámetros de una herramienta para garantizar el mantenimiento de la compatibilidad retroactiva en scripts.

    La eliminación de parámetros es excepcional. Los scripts que utilizan el parámetro eliminado tendrán que actualizarse, pero los modelos deberían seguir funcionando.

  • Opciones: una opción de parámetro es una palabra cable de cadena de caracteres que afecta a la forma en que funciona una herramienta. Por ejemplo, el parámetro join_attributes de la herramienta Intersecar tiene tres opciones: ALL, NO_FID y FID_ONLY. De vez en cuando se introducen opciones nuevas entre versiones y algunas opciones pueden eliminarse. Una opción introducida en una versión posterior (como la 10.4) no se puede utilizar en una versión anterior (como la 10.3).

    En casos excepcionales, la palabra clave se eliminará y se sustituirá por una opción similar, como la opción Euclidean distance sustituida por EUCLIDEAN_DISTANCE. En este tipo de casos, la herramientas está programada para aceptar cualquiera de las opciones y la compatibilidad con versiones anteriores no se ve afectada.

  • Cambios de valores predetermiandos: los parámetros opcionales a menudo tienen un valor predeterminado, que es el que se utilizará a menos que lo cambie. Si se produce un cambio en el valor predeterminado de un parámetro, puede afectar a sus modelos y secuencias de comandos existentes.
  • Cambios de tipo: el tipo de datos de un parámetro define los valores permitidos que el parámetro aceptará, como el tipo de datasets (entidades, tablas, redes, etcétera). Si un tipo de datos se elimina en una versión, significa que el parámetro ya no acepta el tipo de datos. Podría tener que cambiar sus modelos y secuencias de comandos en el caso de que utilicen el tipo de datos eliminado.
  • Anterior: los parámetros nuevos casi siempre se agregan como el parámetro más reciente y no afectan al orden de los parámetros existentes. En contadas ocasiones, el orden de los parámetros existentes puede cambiar y las secuencias de comandos que utilizan argumentos de posición podrían dañarse. En lugar de utilizar argumentos de posición, puede utilizar argumentos de palabra clave tal y como se muestra abajo. Los modelos se seguirán ejecutando, dado que no dependen del orden de los parámetros.
    # 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")

  • Letra de nombre: las mayúsculas y minúsculas del nombre de un parámetro podrían cambiar, por ejemplo, de In_Features a in_features. Este cambio solo afecta a las secuencias de comandos que utilizan argumentos de palabra clave. En Python, los argumentos de palabra clave distinguen entre mayúsculas y minúsculas.
  • Tipo: el tipo de un parámetro puede cambiar de requerido a opcional o viceversa. Cambiar el tipo de opcional a obligatorio puede afectar a los flujos de trabajo existentes.
• Licencias y extensiones
  • Licencias y extensiones de herramientas: un cambio en las licencias o extensión puede afectar a los flujos de trabajo existentes.
• Obsolescencia
  • Obsolescencia: una herramienta de geoprocesamiento obsoleta es una herramienta que ha sido sustituida por otras herramientas. La herramienta sigue estando en ArcGIS Pro, pero no se aplican más mejoras a la misma.

    Más información sobre las herramientas obsoletas

Compatibilidad

Esri hace todo lo posible por mantener la compatibilidad con versiones anteriores. Esto significa que los modelos y scripts creados en una versión anterior deberían seguir funcionando en la mayoría de los casos. En casos excepcionales pueden producirse cambios de compatibilidad debido a las nuevas funcionalidades que se introducen. A continuación se incluyen casos en los que la compatibilidad con versiones anteriores podría no funcionar:

• Si se eliminó un parámetro, los flujos de trabajo que utilizaban el parámetro dejarán de funcionar.
• Si se eliminó una opción del parámetro, los flujos de trabajo que utilizaban esa opción dejarán de funcionar. En muchos casos, la opción eliminada se sustituyó por otra opción y la herramienta sabe lo que tiene que hacer si se especificó la opción anterior.d.
• Si un parámetro tenía un tipo de datos que se eliminó y su flujo de trabajo utilizaba entradas de ese tipo de datos, el flujo de trabajo antiguo no funcionará en la versión nueva.
• Un cambio en la licencia puede afectar a su flujo de trabajo. La mayoría de cambios en las licencias son descendentes (por ejemplo, de Desktop Advanced a Desktop Standard), lo que no afectaría a la compatibilidad con versiones anteriores.
• Un cambio en el requisito de extensión podría afectar a su flujo de trabajo. Los cambios en la extensión que afectan a los flujos de trabajo existentes son excepcionales.
• Si se cambió el valor predeterminado de un parámetro, puede afectar a su flujo de trabajo. Deberá examinar los flujos de trabajo existentes para determinar el efecto del cambio del valor predeterminado.
• Si se cambió el orden de los parámetros, las secuencias de comandos que utilizan argumentos de posición podrían romperse.