Un add-in es una funcionalidad personalizada creada por desarrolladores o usuarios con ArcGIS Pro SDK 3.2 for .NET. Los complementos se integran sin problemas con ArcGIS Pro. En muchos casos, los complementos personalizan la interfaz de usuario, proporcionando una nueva herramienta, o conjunto de herramientas, que aparece en la pestaña de la cinta Complemento, otras pestañas o en otras áreas de la aplicación como paneles personalizados.
Nota:
ArcGIS Pro 3.0 y versiones posteriores solo cargarán add-ins que se hayan compilado con ArcGIS Pro SDK 3.0 y versiones posteriores. Consulte la Guía de migración a ProConcepts 3.0 para obtener más información.
Un complemento se empaqueta como un único archivo comprimido con la extensión .esriAddInX. Se trata de un tipo de archivo simple que se puede enviar por correo electrónico, descargar desde un portal o intercambiar de la misma manera que otros archivos ordinarios.
Los complementos se pueden instalar en una carpeta local predeterminada con una utilidad de instalación o cargarse desde una carpeta designada como carpeta conocida. Ambos métodos se describen en las secciones que aparecen a continuación. Los add-ins se visualizan y eliminan del Administrador de add-ins en la página de ArcGIS Pro Configuración.
Los complementos proporcionan una funcionalidad única, pero también pueden introducir riesgos de seguridad o dar lugar a un comportamiento de software inestable. Es importante conocer y confiar en el origen de un complemento.
Para crear sus propios complementos, necesita ArcGIS Pro SDK. El sitio de ArcGIS Developer contiene tutoriales que le ayudarán a crear su primer add-in.
Instalar un complemento con la utilidad de instalación
Al instalar un add-in con la utilidad de instalación, el add-in se copia en esta ubicación predeterminada: %System Drive%\Users\<username>\Documents\ArcGIS\AddIns\ArcGISPro. Antes de copiar el archivo, la utilidad garantiza que todavía no exista una versión más reciente del complemento en la ubicación.
- Vaya a la ubicación de la carpeta de un archivo de add-in (*.esriAddInX) en su equipo o en una unidad de red.
- Haga doble clic en el archivo para abrir la ventana Utilidad para la instalación de complementos ArcGIS de Esri.
Revise la información de la ventana Utilidad de instalación de complementos de ArcGIS de Esri.
- Para continuar, haga clic en Instalar complemento.
El complemento se copia en la ubicación predeterminada y se instala. Una copia del archivo permanece en la ubicación en la que ha navegado hasta él.
- Si ArcGIS Pro está abierto, salga y reinicie la aplicación.
El complemento está ahora disponible para su uso.
Nota:
Si el complemento se escribió para una versión 2.x de ArcGIS Pro, aparece un mensaje de advertencia. Si continúa con la instalación, el complemento se copia en la ubicación predeterminada, pero no se carga.
Cargar un complemento desde una carpeta conocida
Puede designar una carpeta local o de red como una ubicación conocida para complementos. Al iniciarse, ArcGIS Pro comprobará esta carpeta y cargará automáticamente los add-ins que encuentre en ella.
Designar una carpeta conocida en una unidad de red es una forma cómoda de que muchas personas en un lugar de trabajo utilicen los mismos complementos. Sin embargo, puede hacer que ArcGIS Pro se inicie más lentamente. Si utiliza una carpeta de red, se recomienda utilizar una subcarpeta de la carpeta raíz y que esta subcarpeta contenga solo archivos de complemento.
- Abra la página de configuración de ArcGIS Pro de las siguientes formas:
- Desde un proyecto abierto, haga clic en la pestaña Proyecto de la cinta.
- Desde la página de inicio, haga clic en la pestaña Configuración
.
- En la lista de pestañas laterales, haga clic en Administrador de complementos.
- En el Administrador de complementos, haga clic en Opciones.
- En la pestaña Opciones, haga clic en Agregar carpeta.
- En el cuadro de diálogo Examinar, vaya a la carpeta que desea designar como carpeta conocida.
- Haga clic en la carpeta para seleccionarla. Haga clic en Aceptar.
La ruta completa a la carpeta aparece en la lista de carpetas conocidas.
Nota:
De forma predeterminada, se selecciona la opción para cargar todos los complementos que se encuentran en la carpeta conocida. Puede elegir una opción diferente si desea cargar solo los add-ins proporcionados por Esri o solo aquellos firmados digitalmente por un publicador de confianza.
- Salir de ArcGIS Pro.
- Utilice File Explorer para copiar uno o más archivos .esriAddInX en la carpeta conocida en su ubicación en el disco.
- Inicie ArcGIS Pro.
Los complementos de la carpeta conocida se cargan. La carpeta se activa para los add-ins recién agregados o eliminados cada vez que se inicia ArcGIS Pro.
Sugerencia:
Para dejar de utilizar una carpeta conocida, haga clic en la carpeta en la lista de carpetas conocidas y en Quitar carpeta. Reinicie ArcGIS Pro.
Visualizar add-ins
Puede ver sus complementos disponibles en el Administrador de complementos.
- Abra la página de configuración de ArcGIS Pro de las siguientes formas:
- Desde un proyecto abierto, haga clic en la pestaña Proyecto de la cinta.
- Desde la página de inicio, haga clic en la pestaña Configuración .
- En la lista de pestañas laterales, haga clic en Administrador de complementos.
- En el Administrador de complementos, en la pestaña Complementos, haga clic en un complemento para ver información sobre él.
Eliminar un add-in
Si ya no necesita un complemento, puede eliminarlo. Al eliminar un add-in instalado, se desinstala de ArcGIS Pro y el archivo .esriAddInX se mueve a la papelera de reciclaje del sistema.
Precaución:
Si utiliza el Administrador de complementos para eliminar un complemento que se carga desde una carpeta conocida en una unidad de red, el archivo .esriAddInX se elimina permanentemente, como lo haría si utilizara File Explorer para eliminar el archivo de su ubicación en el disco.
- Abra el Administrador de add-ins y seleccione un add-in como se describe en la sección Ver add-ins que aparece arriba.
- Haga clic en Eliminar este complemento.
El add-in se marca para su eliminación, pero permanece disponible en su sesión de ArcGIS Pro actual.
- Salga y reinicie ArcGIS Pro.
El complemento se desinstala y quita del Administrador de complementos.
Nota:
No puede eliminar ningún complemento que aparezca en el encabezado Complementos compartidos del Administrador de complementos porque el administrador del software los administra. Para obtener más información, consulte la sección Realizar ajustes administrativos que aparece más adelante.
Deshabilitar complementos
Si ArcGIS Pro se comporta de formas inesperadas o deja de funcionar después de instalar add-ins, puede deshabilitar los add-ins empezando por ArcGIS Pro desde la ventana de comandos de Windows con un parámetro especial. Si el software se comporta normalmente cuando los complementos están deshabilitados, es posible que tenga que eliminar uno o varios complementos.
Para deshabilitar los add-ins, inicie ArcGIS Pro desde la línea de comandos con el siguiente comando:
"%ProgramFiles%\ArcGIS\Pro\bin\ArcGISPro.exe" /disableaddins
No aparece ningún complemento en el Administrador de complementos. Para volver a habilitar los add-ins, salga y reinicie ArcGIS Pro normalmente.
Realizar ajustes administrativos
Como administrador del software, puede realizar ediciones en el registro para bloquear el acceso del usuario a complementos, designar carpetas conocidas y establecer niveles de seguridad para complementos.
En el Editor del Registro de Windows, en HKEY_LOCAL_MACHINE > SOFTWARE > ESRI > ArcGISPro > Settings, cree una clave Carpetas de add-ins y utilice valores de cadena de caracteres para designar carpetas conocidas. Los archivos de complementos ubicados en estas carpetas aparecerán como Complementos compartidos en el Administrador de complementos. Para obtener más información sobre cómo realizar estas ediciones de registro, consulte ArcGIS Pro Claves del Registro.