Acciones Personalizadas

¿Qué es y para qué sirve?

Una Acción Personalizada es un botón que agregas a una pantalla determinada (una transacción, una tarjeta, o un Registro Personalizado) para que ejecute el código JavaScript que tú escribas. Al crearla, indicas:

• El Objeto (la pantalla del sistema) donde debe aparecer el botón — por ejemplo una factura, un artículo o cualquier otra tarjeta o transacción — o, si la creas desde un Registro Personalizado, queda vinculada automáticamente a ese tipo de registro.
• El Modo: si el botón debe aparecer cuando esa pantalla está en modo Agregar, Editar o Ver.
• La Etiqueta del botón y el código JavaScript que se ejecuta al hacer clic en él, usando la misma API de JavaScript que AdmCloud expone para los Scripts de Cliente.

Esta función está pensada para negocios que necesitan un botón con un comportamiento muy específico que AdmCloud no ofrece de forma nativa, y que cuentan con alguien (interno o un Partner) capaz de escribir JavaScript.

Cómo se usa

1. Entra a la lista de Acciones Personalizadas. Verás todas las acciones existentes con su etiqueta, el objeto (pantalla) al que aplican, su propietario y si están marcadas como protegidas.
2. Haz clic en "Nuevo". Si estás creando la acción desde el detalle de un Registro Personalizado, el campo Objeto se oculta porque la acción queda ligada automáticamente a ese tipo de registro.
3. Elige el Objeto (la pantalla del sistema) donde quieres que aparezca el botón, y el Modo: Agregar, Editar o Ver.
4. Escribe la Etiqueta que se mostrará en el botón, y el código JavaScript que se ejecutará cada vez que un usuario haga clic en él.
5. Define quién es el Propietario de la acción, y si debe quedar Protegida (para que solo el propietario pueda editarla o eliminarla).
6. Guarda. AdmCloud valida la información (ver más abajo) y, si todo está correcto, el botón aparece de inmediato en la pantalla elegida, en el modo indicado — siempre que el código no esté vacío.
7. Consulta, edita o elimina una acción existente desde su detalle. Si eres el propietario y tu plan lo permite, también puedes transferirla a otra empresa del mismo Partner.

Capacidades principales

• Botones propios, con código JavaScript, agregados a las pantallas Agregar, Editar y Ver de cualquier tarjeta, transacción o Registro Personalizado, sin tocar el producto.
• Un botón por cada combinación de Objeto y Modo que necesites; puedes tener varios botones en la misma pantalla.
• Una acción "Protegida" solo puede editarla o eliminarla su propietario, útil cuando la instaló un Partner o un técnico.
• El botón solo aparece en pantalla cuando tiene código escrito; una acción sin código guardado queda registrada pero no se muestra.
• Transferencia de una acción a otra empresa del mismo Partner, para reutilizar una misma personalización en varios clientes.

Campos clave

Validaciones al guardar

• El Objeto debe existir dentro de las pantallas soportadas por AdmCloud, o corresponder a un Registro Personalizado válido cuando la acción se crea desde ahí.
• El Propietario es obligatorio y debe corresponder a un usuario activo del sistema.
• No puedes repetir la misma Etiqueta para el mismo Objeto. AdmCloud rechaza el guardado si ya existe otra acción con esa combinación.
• Una acción Protegida solo puede ser editada o eliminada por su propietario; otros usuarios recibirán un mensaje de que no tienen permiso.
• No se puede eliminar una acción si está siendo utilizada dentro de un Plugin; primero debes desvincularla del Plugin.

Disponibilidad y permisos

• Las Acciones Personalizadas están disponibles únicamente en el plan Enterprise, y la función debe estar habilitada para tu cuenta.
• Crear, ver, editar y eliminar acciones requiere el permiso Personalización dentro de tu grupo de usuarios.
• Transferir una acción a otra empresa requiere además el permiso para crear Plugins.

Consejos y errores comunes