Plugins

Un Plugin es un paquete con nombre propio que agrupa varias de tus personalizaciones (Registros Personalizados/pantallas, Reportes Personalizados, Scripts de Servidor y de Cliente, Formatos de Impresión y de Correo, Páginas HTML, Botones/Acciones Personalizadas, Listados Personalizados y Campos Personalizados de casi cualquier entidad) para moverlas juntas de un lado a otro. Sirve para dos cosas: transferir ese conjunto de personalizaciones a otra empresa que también administras, o publicarlo como una App en AdmCloud Connect para que otras empresas de la comunidad lo instalen.

Módulo: Personalización Requiere el permiso de "Personalización" de tu grupo de usuarios, con niveles separados para consultar, agregar, editar y eliminar

¿Qué es y para qué sirve?

Cuando construyes una personalización con varias piezas (por ejemplo, un campo personalizado más el reporte que lo muestra, o una pantalla personalizada con sus botones), normalmente esas piezas viven separadas entre sí. Un Plugin las agrupa bajo un solo nombre, versión, descripción y foto, de modo que puedas tratarlas como un solo paquete al moverlas.

El listado de Plugins tiene dos variantes, con las mismas columnas pero contenido distinto:

Creados Localmente: los Plugins que tú armaste en tu propia empresa, seleccionando qué personalizaciones incluir. Puedes editarlos, transferirlos o publicarlos.
Instalados: los Plugins que llegaron a tu empresa porque instalaste una App de AdmCloud Connect. Son de solo lectura: puedes consultarlos o eliminarlos (desinstalarlos), pero no editarlos.

Piensa en Plugins como el paso de "empacar" tu personalización. Una vez empacada, decides si la transfieres directamente a otra de tus empresas o si la publicas en AdmCloud Connect para compartirla con la comunidad; esta última parte del flujo (precio, texto comercial, revisión, instalación) se administra desde AdmCloud Connect (Apps y Plugins).

Cómo se usa

Entra al listado de Plugins (pestaña Creados Localmente) y pulsa Crear.
Escribe el Nombre del Plugin. AdmCloud propone como Propietario tu propia empresa/relación; normalmente no necesitas cambiarlo.
Si quieres que solo tú puedas editar la estructura de este Plugin (y de todo lo que incluya) incluso después de transferirlo, marca Protegido. Agrega Notas si quieres documentar de qué se trata.
En la tabla de Cambios a Incluir, marca la casilla de cada Registro Personalizado, Reporte, Script, Formato, Página, Acción o Campo Personalizado que quieras empacar dentro de este Plugin. La tabla lista todas tus personalizaciones existentes, agrupadas por tipo.
Opcionalmente sube una o varias Fotos que ilustren qué hace tu personalización.
Pulsa Guardar. AdmCloud crea el Plugin y te lleva a su pantalla de detalle.
Desde el detalle, usa Transferir a (elige la empresa destino en el desplegable) para copiar el Plugin y todo lo que incluye a otra empresa que administras, o Publicar a AdmCloud Connect (beta) para ofrecerlo como App a la comunidad.

ℹ️

Editar un Plugin ya guardado: vuelve a marcar o desmarcar personalizaciones en la tabla de Cambios a Incluir y guarda de nuevo; AdmCloud recuerda cuáles ya estaban seleccionadas la última vez.

Capacidades principales

Empaqueta en un solo Plugin: Registros Personalizados (pantallas), Reportes Personalizados, KPIs, Scripts de Servidor, Scripts de Cliente (JavaScript), Formatos de Impresión, Formatos de Correo, Páginas Personalizadas en HTML, Acciones/Botones Personalizados y Listados Personalizados.
Incluye también Campos Personalizados de Oportunidades, Cuentas Contables, Artículos, Proyectos, Clientes/Proveedores (Relaciones), Transacciones, Activos Fijos, Ubicaciones, Seriales, Contactos, Unidades de Medida (UOM), Subsidiarias y Listas de Materiales (BOM).
Transferir el Plugin completo (con todas sus dependencias) a otra empresa que administres, conservando nombres y vínculos entre las piezas.
Publicar el Plugin como una App en AdmCloud Connect para que otras empresas de la comunidad la instalen, gratis o de pago.
Adjunta fotos que ilustren la personalización, además de la información de sus recursos incluidos.
Consulta el Log de Seguridad del Plugin y personaliza qué columnas ver en el listado, igual que en el resto de las pantallas de AdmCloud.

Campos clave

Campo	Para qué sirve
Nombre	Identifica el Plugin en el listado y en la App publicada. Obligatorio y no se puede repetir entre Plugins.
Propietario	La relación/empresa dueña del Plugin. Obligatorio; debe corresponder a un usuario activo.
Protegido	Si lo marcas, solo tú puedes editar la estructura del Plugin y de las personalizaciones que incluye; al transferirlo, esa protección también aplica en la empresa destino.
Notas	Texto libre para documentar de qué trata el Plugin (no se muestra en el listado por defecto).
Cambios a Incluir	Tabla con todas tus personalizaciones existentes; marca las que quieres que formen parte de este Plugin.
Fotos	Imágenes ilustrativas del Plugin, visibles en su detalle y, si lo publicas, en la App.
ID del Plugin y Versión	Identificador y número de versión, asignados por AdmCloud; se muestran de solo lectura en el detalle.

Validaciones al guardar, transferir y publicar

El Nombre es obligatorio y no puede repetirse entre Plugins de tu empresa.
El Propietario es obligatorio y debe corresponder a un usuario activo.
Si el Plugin está Protegido, solo su propietario puede editarlo o volver a guardarlo.
No puedes editar un Plugin Instalado desde AdmCloud Connect (solo consultarlo o eliminarlo).
Para Transferir: debes ser el propietario, el Plugin no puede ser uno Instalado, debe tener al menos un recurso incluido, y no puedes elegir tu propia empresa como destino. Si alguno de los recursos incluidos pertenece a otro propietario distinto de ti, la transferencia se rechaza.
Para Publicar a AdmCloud Connect: debes ser el propietario, el Plugin no puede ser uno Instalado, y por ahora solo se pueden publicar Plugins compuestos exclusivamente por Reportes Personalizados; si incluye otro tipo de recurso, la publicación se rechaza (sí puedes transferirlo a otra de tus empresas).
Transferir y Publicar no están disponibles en empresas que están en período de evaluación (prueba gratuita); primero debes activar tu suscripción.

Eliminar

Puedes eliminar tanto un Plugin Creado Localmente como uno Instalado (en este último caso, equivale a desinstalar la App), siempre que tengas el permiso de eliminar y el Plugin no esté Protegido por otro propietario. Eliminar el Plugin quita el paquete, pero no elimina por sí solo las personalizaciones que contenía (Registros Personalizados, Reportes, Campos, etc.); esas se administran y eliminan cada una desde su propia pantalla.

Disponibilidad, permisos y condiciones

Esta función requiere el plan Enterprise con la función "Crear Plugins" activa para tu compañía; sin ella, la pantalla muestra un mensaje de "función no disponible en esta edición" y la opción no aparece en el menú de Personalización.
El acceso se controla con el permiso de "Personalización" del grupo de usuarios, con niveles separados para consultar, agregar, editar y eliminar.
Transferir un Plugin y publicarlo en AdmCloud Connect requieren además que tu empresa no esté en período de evaluación (prueba gratuita).
Publicar (y, del otro lado, instalar) un Plugin en AdmCloud Connect está limitado por ahora a Plugins compuestos únicamente por Reportes Personalizados; el resto del flujo de publicación, revisión e instalación se administra desde AdmCloud Connect.

Consejos y errores comunes

💡

Usa Protegido para blindar tu trabajo. Si vas a transferir o publicar un Plugin que no quieres que la empresa destino modifique, márcalo como Protegido antes de transferirlo o publicarlo.

⚠️

"No puede editar plugins instalados desde AdmCloud Connect". Aparece si intentas editar un Plugin de la pestaña Instalados. Si necesitas que se comporte distinto, pídeselo a quien publicó la App o construye tu propio Plugin local con las personalizaciones que necesitas.

⚠️

"Debe ser el propietario de un plugin para poder transferirlo". Solo el propietario del Plugin (y de cada uno de los recursos que incluye) puede transferirlo a otra empresa.

ℹ️

Si tu Plugin incluye pantallas, campos o scripts además de reportes, podrás transferirlo a otra de tus empresas sin problema, pero todavía no podrás publicarlo en AdmCloud Connect: esa vía, por ahora, solo acepta Plugins hechos exclusivamente de Reportes Personalizados.