Páginas Personalizadas
Una Página Personalizada es una pantalla que tú mismo construyes y conectas a AdmCloud: puede ser tu propio código HTML/JavaScript, o una URL externa que quieres mostrar incrustada dentro de la aplicación. Una vez guardada, puede aparecer como una entrada más en la navegación de AdmCloud y/o como un panel en tu Panel de Control, de modo que tu equipo llegue a ella igual que a cualquier otra pantalla nativa.
¿Qué es y para qué sirve?
Cada Página Personalizada contiene exactamente uno de estos dos tipos de contenido:
- Contenido HTML: tu propio HTML, CSS y JavaScript, escritos en un editor de código integrado. AdmCloud lo muestra tal cual al abrir la página.
- URL externa: el enlace a una página alojada en otro lugar (una herramienta interna, un tablero de BI, un formulario, un artículo de ayuda) que AdmCloud incrusta dentro de la pantalla en lugar de sacar a tus usuarios de la aplicación.
Es útil cuando necesitas un poco de interfaz a la medida —una herramienta interna rápida, un reporte incrustado de otro sistema, una página de instrucciones para tu equipo— sin necesidad de un Registro Personalizado completo ni de un Plugin, y sin pedirle a AdmCloud que construya una pantalla nativa para ello.
Pantallas del área
| Pantalla | Qué hace |
|---|---|
| Listado | Lista todas las Páginas Personalizadas de tu empresa, con su propietario, si aparece en el menú, si es pública, su módulo y si es solo del propietario. Desde aquí creas una nueva, abres el enlace "Visualizando" para verla renderizada, o entras a su detalle. |
| Crear / Editar | El formulario con el Nombre de la página, su editor de HTML o su URL, su Módulo o Menú Personalizado, sus opciones de visibilidad y la tabla de grupos de usuarios con acceso. |
| Detalles | La página ya guardada en modo de solo consulta, con un acceso directo "Visualizar" para verla renderizada, el botón "Editar", sus permisos y su bitácora de cambios. |
| Visualizando (render) | La página tal como la ven tus usuarios finales: tu HTML renderizado directamente, o la URL externa incrustada en pantalla; este es el enlace que compartes o colocas en el menú/Panel de Control. |
Cómo se usa, paso a paso
- Abre el listado de Páginas Personalizadas y pulsa Nuevo. Una página nueva viene precargada con un pequeño ejemplo (un título, un campo de texto y un botón) para que tengas un punto de partida funcional en lugar de un editor vacío.
- Escribe el Nombre que identifica la página; debe ser único entre todas tus Páginas Personalizadas.
- Elige un solo tipo de contenido: escribe tu HTML en el editor de código, o completa la URL de la página externa que quieres incrustar; solo puedes usar uno de los dos en la misma página.
- Si usaste una URL y el sitio de destino necesita saber quién inició sesión, marca Incluir Token para que AdmCloud agregue automáticamente un token de sesión al final de la URL. Esta opción solo aplica a páginas con URL.
- Decide dónde debe aparecer: marca Mostrar en Menú para que aparezca en la navegación de AdmCloud, y/o Mostrar en Panel de Control para que aparezca como un panel en el Panel de Control.
- Si aparece en el menú, agrúpala en algún lugar: asigna un Módulo existente de la aplicación (Ventas, Inventario, etc.) o una de tus propias Opciones de Menú Personalizadas; no ambos a la vez.
- Define el Propietario y si es Pública (visible para todos) o restringida; si es restringida, ve a la tabla de grupos de usuarios y agrega los grupos que deben verla.
- Si solo tú debes poder cambiar su estructura, marca la opción que restringe la edición y eliminación al propietario.
- Guarda. Usa el enlace Visualizando del listado o el botón Visualizar del detalle para confirmar que se renderiza como esperas.
Marcadores dinámicos que puedes usar en tu HTML
Cuando se renderiza una Página Personalizada de tipo HTML, AdmCloud reemplaza automáticamente los siguientes marcadores con valores reales de la sesión actual, de modo que la misma página se personaliza para cada usuario sin necesidad de código en el servidor:
| Marcador | Se reemplaza por |
|---|---|
@Model.CompanyName | El nombre de la empresa en la que el usuario inició sesión. |
@Model.DatabaseName | El nombre técnico de la base de datos de la empresa. |
@Model.LoggedUserName | El nombre completo del usuario que inició sesión. |
@Model.LoggedUserEMail | El correo electrónico del usuario que inició sesión. |
@Model.CurrentYear | El año actual, según la fecha local de la empresa. |
@Model.CurrentMonth | El mes actual. |
@Model.CurrentDay | El día actual. |
@Model.LoginID | El identificador interno de la sesión/inicio de sesión actual. |
@Model.Token | Un token de sesión nuevo, útil si tu propio HTML necesita llamar a un endpoint de la API de AdmCloud. |
Campos clave
| Campo | Para qué sirve |
|---|---|
| Nombre | El nombre identificador de la página. Es obligatorio y debe ser único entre todas tus Páginas Personalizadas. |
| HTML | Tu propio HTML/CSS/JavaScript, editado en el editor de código integrado. Es mutuamente excluyente con la URL. |
| URL | La dirección de la página externa a incrustar. Debe ser un enlace absoluto y válido, http o https. Es mutuamente excluyente con el HTML. |
| Incluir Token | Agrega un token de sesión al final de la URL, para que el sitio de destino pueda identificar al usuario que inició sesión. Solo se permite cuando hay una URL definida. |
| Módulo | El módulo existente de la aplicación bajo el cual se agrupa esta página en la navegación, si aplica. No se puede combinar con un Menú Personalizado. |
| Menú Personalizado | La Opción de Menú Personalizada bajo la cual se agrupa esta página en la navegación, si aplica. No se puede combinar con un Módulo. |
| Icono / Tipo | El icono que se muestra junto al nombre de la página en el menú de navegación. |
| Mostrar en Menú | Si está marcado, la página aparece como una entrada en la navegación propia de AdmCloud. |
| Mostrar en Panel de Control | Si está marcado, la página aparece como un panel en el Panel de Control. |
| Pública | Si está marcada, cualquier usuario de la empresa puede abrir la página. Si no, solo el propietario y los grupos de usuarios que asignes pueden verla. |
| Propietario | El usuario responsable de esta página; debe ser un usuario activo. |
| Solo el propietario puede editar la estructura (Protegida) | Si está marcada, solo el propietario puede editar o eliminar esta página. |
| Grupos de usuarios | Cuando la página no es pública, define qué grupos de usuarios pueden verla. |
Validaciones al guardar
- El Nombre y el Propietario son obligatorios, y el Propietario debe ser un usuario activo.
- Debes completar exactamente uno de los campos URL o HTML; dejar ambos vacíos, o completar ambos, bloquea el guardado.
- Incluir Token solo puede usarse en una página con URL, nunca con contenido HTML.
- La URL debe ser una dirección absoluta y válida, que empiece con
http://ohttps://. - No puedes asignar un Módulo y una Opción de Menú Personalizada al mismo tiempo; elige un solo lugar donde agrupar la página.
- El Nombre debe ser único; no puede repetirse con el de otra Página Personalizada ya existente en tu empresa.
- Una página Protegida solo puede ser editada o eliminada por su propietario; otros usuarios reciben un error de permisos.
Gestión de la página
Desde el detalle de una página ya guardada, según tus permisos, puedes:
- Visualizarla, abriendo la página renderizada exactamente como la verán tus usuarios finales.
- Editarla, para ajustar su contenido, visibilidad, agrupación o permisos.
- Transferirla a otra empresa de tu mismo grupo empresarial, si eres el propietario de la página. La página se copia a la empresa destino bajo un usuario equivalente; esta opción no está disponible en empresas de evaluación (trial).
- Revisar su bitácora de cambios, que muestra quién la creó o editó y cuándo.
- Eliminarla, siempre que no esté siendo usada actualmente como recurso de un Plugin de tu empresa; si lo está, primero debes desvincularla del Plugin.
Disponibilidad y permisos
- El acceso se controla con el permiso "Personalización" del grupo de usuarios, con niveles separados para consultar, agregar y editar.
- Una página marcada como Pública es visible para toda tu empresa; de lo contrario, solo la ven el propietario y los grupos de usuarios que asignes en la tabla de Permisos.
Consejos y errores comunes
Usa los marcadores dinámicos para personalizar tu HTML. Una sola Página Personalizada puede saludar a cada usuario por su nombre, o mostrar la empresa y el año actuales, sin escribir lógica en el servidor; AdmCloud completa esos valores por ti al renderizar la página.
Elige HTML o URL, no ambos ni ninguno. Si el guardado falla con un mensaje sobre la URL o el HTML, revisa que exactamente uno de esos dos campos tenga contenido.
Agrupa páginas relacionadas con una Opción de Menú Personalizada en vez del campo Módulo. Si ya tienes varias Páginas, Registros o Reportes Personalizados que pertenecen juntos, crea una Opción de Menú Personalizada y agrúpalos ahí, en lugar de dispersarlos entre Módulos de la aplicación sin relación entre ellos.
Prueba la página renderizada antes de compartirla. Usa el enlace "Visualizando" del listado, o el botón "Visualizar" del detalle, para confirmar que tu HTML o la URL incrustada se comporta como esperas antes de activar "Mostrar en Menú" o "Mostrar en Panel de Control" para todos.