awe-105 Módulo developer
El módulo developer ofrece herramientas de ayuda para las tareas de mantenimiento habituales de AWE. En la práctica, el flujo más visible es la gestión de literales: se define una vez la raíz de los XML y después se pueden añadir, modificar, traducir o eliminar literales sin editar a mano cada fichero.
Ruta rápida
- Añade la dependencia del starter developer.
- Activa el módulo en
application.properties. - Añade las opciones de menú de developer.
- Configura la ruta raíz de los XML.
- Usa el gestor de literales para crear, modificar, traducir y eliminar.
Antes de empezar
Este módulo es más útil cuando ya tienes una estructura de aplicación funcionando y algunos ficheros de literales que gestionar.
Si todavía no has creado pantallas ni claves de literales, revisa primero awe-102.
Paso 1: Activar el módulo developer
Añade la dependencia en pom.xml:
<dependency>
<groupId>com.almis.awe</groupId>
<artifactId>awe-developer-spring-boot-starter</artifactId>
</dependency>
Activa el módulo en application.properties añadiendo awe-developer a tu lista de módulos actual:
# Keep your current application-specific modules.
# Add awe-developer alongside the modules you already use.
awe.application.module-list=<your-existing-modules>,awe-developer
Expónlo a través del menú:
<option name="developer" label="MENU_DEVELOPER" icon="paint-brush">
<option name="path-manager" label="MENU_PATH" screen="path-manager" icon="terminal"/>
<option name="local-manager" label="MENU_LANGUAGES" screen="local-manager" icon="language"/>
</option>
Paso 2: Configurar la ruta raíz de los XML
Antes de poder editar los descriptores de tu aplicación, las herramientas necesitan la ruta raíz donde están los ficheros XML de la aplicación.
Indica al módulo la raíz que contiene las carpetas de la aplicación:
Es decir, la ruta configurada debe ser la ubicación padre de carpetas como global/, locale/, menu/ y screen/.
Paso 3: Usar el gestor de literales
El gestor de literales es el flujo más habitual del módulo developer. Ayuda a añadir, modificar, traducir y eliminar literales en toda la aplicación.
Los cambios afectan tanto al estado en memoria como a los ficheros XML subyacentes, por lo que en muchos casos basta con recargar la página, sin reiniciar el servidor de aplicaciones, tras un cambio que solo afecte a literales.
El gestor también se integra con una API de traducción para ofrecer un borrador inicial de traducción en los idiomas configurados. Considera ese resultado un punto de partida y revísalo antes de conservarlo.
La zona de búsqueda normalmente permite:
- elegir el idioma con el que trabajas
- buscar entre las claves de literales existentes
Añadir un literal
Pulsa New en la lista de literales:
Después indica:
- el código del literal (identificador único)
- el texto en el idioma seleccionado actualmente en el gestor
Al añadir un literal, el módulo lo crea para todos los idiomas definidos en la aplicación. Revisa las traducciones generadas antes de darlas por definitivas.
Modificar un literal
Al seleccionar un literal se muestran las traducciones existentes de esa clave.
Después puedes actualizar el valor del idioma seleccionado:
Si lo necesitas, cambia a la pestaña Markdown para editar el valor como Markdown en lugar de texto plano:
Para solicitar una traducción automática, elige los idiomas de origen y destino y pulsa Translate. Guarda el resultado final con Update.
Eliminar un literal
Selecciona el literal y pulsa Delete para eliminarlo de los idiomas disponibles.