Cómo crear una Ventana
Visión general
El objetivo de esta sección es mostrar cómo puede crear una nueva ventana desde cero.
Info
Esta sección se basa en dos secciones anteriores que explican Cómo crear un Módulo y Cómo crear una Tabla.
Módulo y tabla
Como se mencionó anteriormente, este tutorial se basa en dos tutoriales previos y asume que los siguientes objetivos ya se han completado:
- Creación de un nuevo módulo
- Creación + registro en el AD de una nueva tabla
Creación de la nueva Ventana
Usando el rol System Administrator navegue a Application Dictionary > Windows, Tabs and Fields.
Cree un nuevo registro tal y como se indica en la captura de pantalla siguiente:
Los campos principales de esta ventana son:
- Módulo: define el módulo al que pertenecerá este elemento.
- Nombre: define el nombre que Etendo utiliza para reconocer esta ventana.
- Descripción: proporciona una breve descripción de la tabla.
- Ayuda/Comentario: define el texto que se muestra en la ventana de Ayuda.
- Tipo de ventana: define algunas particularidades de la interfaz de usuario para una ventana:
- Mantener : se utiliza para ventanas con pocas entradas.
- Transacción : para ventanas transaccionales. Es el tipo de ventana que se utiliza para mostrar la información de tablas con un gran volumen de datos. Por defecto, esta ventana filtra documentos antiguos (n días – configuración de la ventana
General Setup>Application>Session Preferences) y documentos procesados. La tabla subyacente de la solapa de cabecera debe contener las columnas PROCESSED y UPDATED (para que funcionen los filtros de datos). - Solo consulta : para ventanas de sólo lectura que únicamente permiten visualizar datos.
Guarde este registro y vaya a la solapa Solapa. Cree un nuevo registro como se muestra a continuación, creando la primera solapa:
Los campos principales de esta ventana son:
- Módulo: define el módulo al que pertenecerá este elemento.
- Nombre: define el nombre que Etendo utiliza para reconocer esta solapa.
- Descripción: proporciona una breve descripción de la tabla.
- Ayuda/Comentario: define el texto que se muestra en la ventana de Ayuda.
- Tabla: especifica la tabla de la que la solapa mostrará los datos.
- Nivel de tabla: define la jerarquía de solapas, siendo 0 el nivel más alto.
- Patrón de UI Este desplegable ofrece las siguientes opciones:
- Estándar - interfaz estándar donde se pueden añadir, ver y editar múltiples registros
- Sólo lectura - esta opción deshabilita cualquier capacidad de edición/creación para cualquier usuario dentro de esta solapa
- Registro único - esta opción fuerza una relación uno a uno entre una solapa padre y una solapa hija, permitiendo al usuario introducir como máximo un registro en la solapa
- Cláusula Where HQL: usando este filtro HQL, el usuario nunca podrá ver datos que no cumplan los criterios. Al referirse a propiedades de la entidad mostrada en la solapa, utilice el prefijo e. En nuestro caso, utilizamos este campo para mostrar únicamente terceros que sean nuestros empleados (usando la propiedad employee).
- Cláusula Where SQL Igual que la cláusula Where HQL pero usando sintaxis SQL y utilizada para filtrar en ventanas clásicas.
El botón Copiar campos de una solapa puede utilizarse para copiar campos desde una solapa existente a la nueva.
El botón Crear campos puede utilizarse para crear campos para la nueva solapa basándose en su tabla asociada.
Vaya a la solapa Campo para ver los campos creados.
Si fuese necesario, se podrían realizar cambios en estos campos o añadir nuevos manualmente.
Note
Para las solapas que no son de cabecera, es muy importante no eliminar el campo que apunta al campo ID de su solapa padre, ya que haría imposible crear registros en esta solapa usando la vista de rejilla.
Ahora, vuelva a la solapa Solapa y cree un nuevo registro que representará la solapa hija de la solapa Operarios donde se gestionarán los salarios:
Lo más importante es asegurarse de seleccionar:
- Tabla =
HT_Salary - Nivel de tabla = 1
Al hacer clic y confirmar el diálogo Crear campos, la aplicación insertará automáticamente las columnas de la tabla seleccionada en la solapa de campos de la solapa Salario.
Para ordenar las columnas de acuerdo con el aspecto habitual de otras ventanas, ahora cambiamos las propiedades de algunos campos de vista, tal y como se puede ver en la siguiente captura de pantalla.
- Ocultar el campo c_bpartner_id
- Reordenar campos (usando la secuencia), para que isactive quede después de todos los demás campos
- Marcar amount e isactive como Iniciar en nueva línea
Para que Etendo cree enlaces (etiquetas que aparecen en azul) a elementos de tabla, el sistema necesita saber qué ventana representa la tabla donde reside un determinado elemento.
Para indicarlo, vaya a la ventana Application Dictionary > Tables and Columns, busque la tabla correspondiente y establezca la Ventana como se indica a continuación:
Creación del elemento de menú
Se requiere un elemento de menú para que el usuario pueda abrir la nueva ventana. Usando el rol System Administrator navegue a General Setup > Application > Menu y cree un nuevo registro:
Los campos principales de esta ventana son:
- Módulo: define el módulo al que pertenecerá este elemento.
- Nombre: define el nombre que Etendo utiliza para reconocer este elemento de menú.
- Descripción: proporciona una breve descripción de la tabla.
- Nivel resumen: define una carpeta que contiene elementos de menú (ventanas, procesos, informes, etc.).
- Acción: define el tipo de elemento de menú.
- URL Si Acción es Enlace externo o Enlace interno, define la URL a enlazar.
- Formulario especial: Si Acción es Formulario, define el formulario a enlazar.
- Proceso: Si Acción es Proceso, define el proceso a ejecutar.
- Informe: Si Acción es Informe, define el informe a enlazar.
- Ventana: Si Acción es Ventana, define la ventana a enlazar.
Guarde este registro y luego haga clic en el icono Árbol 
Aquí puede arrastrar y soltar el nuevo elemento de menú en cualquiera de los otros grupos de menú.
Compilación de la aplicación con la nueva Ventana
Finalmente, la aplicación necesita recompilarse para generar el código de la nueva ventana y desplegarlo en Tomcat.
El resultado
Usando el rol F&B International Group Admin, seleccione el enlace a la nueva ventana desde el menú.
Success
Ahora ha creado correctamente su propia ventana nueva y ha visto cómo cobra vida dentro de Etendo.
Este trabajo es una obra derivada de Cómo crear una ventana de Openbravo Wiki, utilizada bajo CC BY-SA 2.5 ES. Esta obra está licenciada bajo CC BY-SA 2.5 por Etendo.