[español] [inglés]

Usando Magallanes.

Para empezar rápidamente a utilizar la herramienta, lo primero que debe estar instalado es una versión de Java 1.4 o superior. Sin embargo para utilizar los reportes estáticos se requiere que la versión sea JDK en lugar de JRE. (Esto se debe a que se realiza la compilación dinámica de los mismos con JasperReports y requiere tools.jar. Recomendamos instalar directamente JDK para utilizar cualquier reporte)

Para comprobar la versión de java, ejecute desde la línea de comandos:

java -version

Una vez comprobado esto, debe descargar jmagallanes. Recomendamos seleccionar la versión más reciente (este tutorial esta basado en la versión standalone, no en versiones J2EE). Por ejemplo, puede descargar la versión: jmagallanes-0.9-standalone.

Luego descomprima el archivo descargado. Se va a crear una estructura de directorios (que serán explicados luego en la documentación), y en la raíz encontrará un archivo para ejecutar según la plataforma utilizada:

Para Windows: hacer doble click sobre "startup.bat" y se iniciara automáticamente la aplicación.

Para plataformas Unix puede utilizar "startup.sh"

Lo primero que aparece es una pantalla de login. El usuario de test por default generado es: User=root, password=1. El login es utilizado para loggear la actividad del usuario y restringir el acceso a la ejecución de reportes (con un sistema basado en roles).

Finalmente aparece la aplicación. Se puede ver un "combo box" grande, situado sobre un extenso espacio blanco. Este brinda la posibilidad de elegir entre una serie de reportes cual queremos ejecutar. Debe seleccionar uno, y ejecutarlo con el botón de flecha verde que se encuentra a la derecha del combo box. Las opciones de ejecución son:

• Distribution Salary Cube: reporte de Tabla Pivot con opciones de drill down (como los que se pueden ver en screenshots)
• Distribution Salary Accumulated: reporte estático lanzado en una nueva ventana (con apariencia de PDF)
• Distribution Salary Chart: reporte gráfico basado en jfreechart (como los que se pueden ver en screenshots)

Una vez que halla ejecutado el reporte, puede empezar a utilizar el resto de las opciones. Por ejemplo, para el reporte de tipo Tabla Pivot se puede:

• Hacer drag & drop de las dimensiones para moverlas de un eje a otro, o agregarlas/eliminarlas moviéndolas desde/hasta la zona de arriba.
• Utilizar los botones para exportar a distintos formatos
• Asignar semáforos (es decir, pintar celdas de distintos colores según cumplan o no una condición dada)
• Agregar/Eliminar/Modificar perfiles (los perfiles son vistas, que pueden ser guardadas con distintos nombres para luego accederlas). Los perfiles pueden ser elegidos en el combo box pequeño que esta a la derecha del de reportes (si no se elige se realiza la vista "default").

NOTA: como se ve, esta explicación es meramente una guía para que el usuario pueda usar la aplicación. Para documentación más específica o documentación sobre la versión J2EE vea la sección Documentación.