Cuándo incluir elementos de navegación
Cuando se desarrolla una aplicación web (p.ej. una calculadora, un mapa...), una de las cuestiones que es necesario definir es cuál es el sitio web en el que se va a publicar. En muchos casos, la aplicación se insertará en el Portal de la Junta de Andalucía, ya sea en el portal principal o en la web orgánica de una consejería o agencia.
Todas las plantillas de página contempladas en el Sistema de diseño de la Junta de Andalucía incluyen una cabecera (con identificación del sitio y menú de navegación) y un pie de página personalizado. Por tanto, si la aplicación se presenta integrada en un sitio web que cumpla el sistema de diseño es necesario incorporar la cabecera y el pie de página apropiado.
Cómo incluir la cabecera y el pie
Hay dos alternativas sencillas para incluir la cabecera y el pie de un sitio web en tu aplicación:
Componentes web de cabecera y pie
Dentro del catálogo de componentes web de la Junta de Andalucía puedes encontrar:
- matter-header: representa la cabecera y el menú de navegación a partir de los datos disponibles en un fichero json.
- matter-footer: representa el pie de página a partir de los datos disponibles en un fichero json.
En ambos casos, para utilizar los componentes web es necesario disponer de una serie de datos en formato json (p.ej. la ruta de las imágenes, la jerarquía de la navegación). En el caso del portal principal y las webs orgánicas, estos datos se pueden obtener a través del siguiente microservicio:
- Microservicio de exportación de datos para los webcomponents de cabecera y pie (solo accesible desde RCJA).
- Documentación del servicio (con autenticación, solo accesible desde RCJA).
A través de este microservicio se puede obtener la cabecera y el pie de página del portal principal y de las webs orgánicas integradas en él.
API de apoyo a las adaptaciones gráficas
Este servicio facilita incorporar en desarrollos externos la cabecera, el pie de página y el tema bootstrap oficial de la Junta de Andalucía.
Frente a la inclusión directa de los componentes web, aporta las siguientes ventajas:
- La versión de los web components y del tema bootstrap se actualiza automáticamente, lo que garantiza que se muestra siempre la última versión sin necesidad de cambios en el desarrollo.
- La configuración de los web components se incluye automáticamente, aislando de esa complejidad al equipo de desarrollo del producto.
- Se incluyen urls absolutas en los enlaces de navegación relativos, para garantizar que no se rompen.
Toda la información sobre cómo utilizar el servicio de la API de exportación de cabecera y pie se encuentra en el siguiente proyecto de gitlab:
- Proyecto API gráfica en gitlab (con autenticación, solo accesible desde RCJA).
El alta de webs orgánicas en la API de apoyo a las exportaciones gráficas se realiza bajo demanda. Para solicitar el alta de un nuevo organismo, contacta con cau.transparenciayportal@juntadeandalucia.es.
La documentación incorpora ejemplos de integración en distintas tecnologías:
- Java
- PHP
- Python
- Ajax