Desarrollo > Diccionario scripts > Ventanas 

Mostrar todoOcultar todo

Esta función permite crear y modificar las pantallas del aplicativo mediante la definición de su descripción en una tabla.

Para que un proceso pueda ser ejecutado en modo cliente-servidor y en modo Web, es imprescindible agrupar en una ventana las pantallas de presentación.  

Cada ventana está constituída por una lista de pantallas, menúes, botones, barras en la parte inferior de la pantalla y browsers. Para cada menú y botón se asocia una acción, y en algunos casos, también parámetros.

Para un modelo objeto, debe crearse una ventana con un código Oxxx donde xxx es el código objeto. Esta norma se aconseja vivamente, pero no es obligatoria. Además, es posible asociar varias ventanas a un objeto para permitir los objetos à variante. Estas ventanas suplementarias también se generan automáticamente al validar una transacción de entrada de datos con un código WOxxxyyy donde xxx es el código del objeto e yyy el código de la transacción.

Es posible definir ventanas en formato VT.

 

Requisitos previos

SEEREFERTTO Consulta la documentación de Puesta en marcha

Gestión de la pantalla

Cabecera

El encabezado permite identificar la ventana.

Cabecera

Presentación

El encabezado permite identificar la ventana.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

  • Descripción (campo ZDES)

 

Cerrar

 

Pestaña Pantallas

Presentación

Botones/menús

El conjunto de botones está disponible en la parte inferior de la ventana; los menús se muestran en la parte superior. Cada menú y cada botón tienen una acción asociada, y también un posible cuadro de parámetros.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

Características

  • Ventana modelo (campo MDL)

Permite definir ventanas que no serán nunca validadas. Del mismo modo, si una ventana contiene una pantalla modelo, tampoco será validada.

  • Activo (campo ENAFLG)

Este campo permite desactivar la ventana. Si esta ventana forma parte de un conjunto de transacciones asociado al mismo objeto, ya no aparecerá en el botón transacción de la gestión del objeto.

  • Pantalla VT (campo FVT)

Esta marca indica que esta ventana está en formato VT.

Bloque Número 2

Este código de acceso permite prohibir el acceso a la ventana (transacción) para determinados usuarios.

Si se completa el campo, solamente los usuarios que tienen ese código de acceso en su perfil podrán acceder a este ventana en función de los derechos otorgados.

Se puede definir varias ventanas para un mismo objeto. En este caso, para distinguir las ventanas, se deben definir transacciones.

En la gestión de objeto, el botón transacción permite ver los títulos de las transacciones accesibles. La variable GFLAG permite definir una transacción antes de entrar en la gestión de objeto.

Se pueden definir transacciones sin que exista un objeto definido. En este caso, es necesario gestionar "manualmente" las diferentes transacciones.

  • Transacción (campo TRN)

 

  • Título transacción (campo LIBEL)

 

Este campo ha de ser descrito mediante una ventana de tipo consulta o criteros de consulta.

Bloque Número 5

Un código de actividad permite:

  • definir como opcional un elemento del diccionario si el valor asociado al código de actividad es nulo;
  • identificar elementos específicos si se marcan con un código que comienza por X, Y o Z;
  • asignar un número máximo de líneas cuando el código de actividad marca elementos desde una tabla.

Si el código de actividad está desactivado:

  • el elemento marcado no se puede utilizar;
  • el código asociado no se puede gestionar ni activar.
  • Módulo (campo MODULE)

Indicar el módulo para el que se utiliza esta ventana. Si la ventana es utilizada por varios módulos, indicar "Supervisor".

  • Tipo ventana (campo WINTYP)

  • Visualización (campo TYP)

Permite precisar el tipo de ventana:

  • Pantalla completa (inpbox)
  • Caja de diálogo (ventana independiente que no tiene que ser a página completa, que puede contener botones, menúes, listas izquierdas...)
  • Caja de mensaje (ventana independeinte sin menú, sin listas izquierdas, sin túnel)

Pantallas a abrir

Dar el nombre de la pantalla sobre la o las pestañas. Si sólo hay una pantalla, se define como pestaña.

Tabla Pestañas

Indicar el nombre de las pantallas de gestión en el orden de aparición de las páginas. Es necesaria al menos una pantalla en una ventana.

Para las ventanas vinculadas al objeto pero obtenidas de las transacciones (código de transacción indicado) estos datos se obtienen de la transacción. Importante: no tienen ningún sentido modificar los códigos pestaña ya que estas informaciones se volverán a generar al validar la transacción.

  • Títulos pestañas (campo ZINTONG)

 

  • Orden (campo ROWMSK)

El rango permite ordenar las pestañas en la ventana. Se inicia de 5 en 5. Al añadir una pestaña específica, debe hacerse al final del cuadro; es el rango el que permitirá colocarla en el lugar deseado dentro de la ventana.

  • Visible (campo FLGMSK)

Si este campo no está marcado, la pestaña y sus campos serán invisibles. Esta opción permite utilizar una misma gestión de objeto ya sea para una introducción completa (ventana con todas las pestañas) o para una consulta rápida ocultando determinadas pestañas.

Al marcar una pestaña invisible, la clase [M] de la pestaña es visible.

Al desactivar una pestaña mediante un código actividad inactivo, la clase [M] de la pantalla no es visible.   

Cerrar

 

Pestaña Botones/menús

Presentación

El conjunto de botones está disponible en la parte inferior de la ventana; los menúes se muestran en la parte superior. Cada menú y cada botón tienen una acción asociada, y también un posible cuadro de parámetros.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

Tabla Tipo

  • Tipo (campo TYPBOUT)

Memú local que permite distinguir el botón del menú o de la línea del menú. El botón se posiciona en la parte inferior de la pantalla; el menú se coloca en la parte superior tras Fichero/Edición/…

  • Código (campo CODBOUT)

Es el código del botón que se utiliza en programación en las acciones VANT_BOUT, EXEBOUT, etc... Del mismo modos, se identifican los menúes, que pueden ser definidos en 2 niveles, y después las líneas de menúes. El código del nivel inferior retoma como primer caracter el del nivel superior. Ejemplo, el menú A está recortado en menúes AB y AC, que a su vez están divididos en AB1 y AB2, y después en AC3 y AC4.

Los caracteres autorizados para el específico son todas las letras minúsculas.

Los caracteres autorizados para el estándar son las letras mayúsculas y las cifras. Hay que tener en cuenta la restricción que se define a continuación para las ventanas ligadas a un objeto o a una consulta. Sólo se pueden utilizar los códigos ya empleados para los botones del supervisor.

Los códigos disponibles para los botones de las ventanas objeto son: BGOUVYZ0123456789

Los códigos disponibles para los botones de las ventanas principales de consulta son: ABHIJKMNOPQSTUVWXYZ12345678

  • Gestión (campo VALBOUT)

  • No validadas: los controles sobre el campo no se ejecutan sin activar el botón o el menú.
  • Validada: se precisa a continuación que el botón se ejecuta si todos los controles del campo son válidos.

  • Texto botón (campo ZTXTBOUT)

 

El código acción se refiere al diccionario de acciones, que contiene a la vez el código proceso y la lista de parámetros. En la gestión de ventanas, el valor para estos parámetros ha de ser descrito en el segundo cuadro y para cada acción.

Si al desencadenar el proceso mediante el botón, no se abre ninguna ventana, y tan sólo en este caso, es posible referenciar STD o SPE en el código acción. Para una ventana objeto, por ejemplo, el sub programa EXEBOUT o STATUT del tratamiento SUBxxx, SPExxx o SPVxxx se ejecutará entonces (xxx es el código objeto).

Un código de actividad permite:

  • definir como opcional un elemento del diccionario si el valor asociado al código de actividad es nulo;
  • identificar elementos específicos si se marcan con un código que comienza por X, Y o Z;
  • asignar un número máximo de líneas cuando el código de actividad marca elementos desde una tabla.

Si el código de actividad está desactivado:

  • el elemento marcado no se puede utilizar;
  • el código asociado no se puede gestionar ni activar.

Tabla Parámetros

 

  • Valor (campo VALEUR)

Al posicionarnos sobre una línea del cuadro de acciones, los parámetros de esta acción (obtenidos del diccionario de acciones) se visualizan para poder introducir una expresión que da el valor del parámetro cuando se ejecuta. Esta expresión puede incorporar constantes, funciones y variables en línea en el momento de la ejecución.

Cerrar

 

Pestaña Botones predefinidos

Presentación

También hay un conjunto de botones establecidos. Es una lista fija de botones. Se trata de indicar si los botones aparecen o no en la ventana.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

Tabla Botones

  • Botones (campo LIBSTD)

 

  • Código (campo CODE)

 

  • Gestión (campo VSTD)

 

  • S/N (campo BSTD)

Permiter que un botón banalizado esté presente o no.

El código acción se refiere al diccionario de acciones, que contiene a la vez el código proceso y la lista de parámetros. En la gestión de ventanas, el valor para estos parámetros ha de ser descrito en el segundo cuadro y para cada acción.

Si al desencadenar el proceso mediante el botón, no se abre ninguna ventana, y tan sólo en este caso, es posible referenciar STD o SPE en el código acción. Para una ventana objeto, por ejemplo, el sub programa EXEBOUT o STATUT del tratamiento SUBxxx, SPExxx o SPVxxx se ejecutará entonces (xxx es el código objeto).

Tabla Parámetros

 

  • Valor (campo VALEUR)

Al posicionarnos sobre una línea del cuadro de acciones, los parámetros de esta acción (obtenidos del diccionario de acciones) se visualizan para poder introducir una expresión que da el valor del parámetro cuando se ejecuta. Esta expresión puede incorporar constantes, funciones y variables en línea en el momento de la ejecución.

Cerrar

 

Pestaña Browser

Presentación

La informacion puede localizarse con el conjunto de browsers definidos en la ventana.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

Últimos leídos

  • Visualización (campo DERLU)

Este campo permite activar/desactivar la lista izquierda Últimos leídos.

  • En primera posición (campo FIRLIS)

Este campo permite colocar en primera posición la lista izquierda de 'Últimos leídos'.

Tabla Objetos

Este campo corresponde a un objeto.

Este objeto puede ser un objeto de tipo 'Browser', especialmente dedicado a una lista izquierda.

  • Descripción (campo ZINTLIS)

 

  • Índice (campo CLELIS)

Este campo permite definir un indice de barrido del fichero principal para su visualización en la lista izquierda y la de las ventanas de selección. Si el campo está vacío, se utiliza el primer índice de la tabla.

  • Sentido (campo ORDLIS)

Este campo permite definir un sentido de barrido de la tabla principal para su visualización en la lista izquierda y la de las ventanas de selección.

  • Tipo lista (campo TRELIS)

  • simple
  • jerarquizado: Cuando la clave de barrido escogida para la lista izquierda está compuesta de varias partes, la lista se realiza presentando únicamente la primera parte de la clave. Un doble clic, en uno de los valores de las claves, permite explorar los subvalores de la clave en el número de niveles de las subclaves existentes. Una vez exporados todos los niveles de las claves se puede seleccionar un registro de la tabla.
  • picking simple : es posible seleccionar uno o varios elementos
  • picking: picking sobre una lista jerarquizada
  • Recurrente: elemento madre con elementos hija a los elementos madre de los elementos hija siguientes

  • Browser (campo BROLIS)

Si este campo está en Sí, el doble clic en esta listazquierda permitirá que aparezca en pantalla el registro seleccionado en la parte derecha de la pantalla.

 

  • Precarga (campo CHGLIS)

Este campo permite gestionar la previa carga automática del listado a la izquierda al arranque.

  • No: sin previa carga automática
  • Parcial: carga previa en función del número de elementos previstos en los parámetros (GNBGAUCHE)
  • Total: toda la tabla está cargada previamente.
  • Abr. (campo ABRLIS)

La abreviación de la tabla será explotada por la lista izquierda. De esta forma existe la posibilidad de tener dos browsers que se apoyan sobre la misma tabla. Observación: hay que indicar en este browser (diccionario objeto / pestaña selección) la abreviatura seguida del campo en las expresiones de los elementos listados. Ejemplo: objeto ORD.

  • Orden (campo ROWLIS)

El rango permite ordenar las listas izquierdas en la ventana. Se inicia de 5 en 5. Al añadir una lista izquierda específica, debe hacerse al final del cuadro; es el rango el que permitirá colocarla en el lugar deseado dentro de la ventana.

Un código de actividad permite:

  • definir como opcional un elemento del diccionario si el valor asociado al código de actividad es nulo;
  • identificar elementos específicos si se marcan con un código que comienza por X, Y o Z;
  • asignar un número máximo de líneas cuando el código de actividad marca elementos desde una tabla.

Si el código de actividad está desactivado:

  • el elemento marcado no se puede utilizar;
  • el código asociado no se puede gestionar ni activar.
  • Flechas (campo FLELIS)

Aparece en "sí" por defecto. En este caso, las flechas aparecen en la cabecera de la lista izquierda y permiten la paginación. Existe la posibilidad de prohibir la paginación, por ejemplo, para las paginaciones complejas no desarrolladas o que demaden demasiados recursos del sistema.

  • Expresión de vínculo (campo EXPLIS)

Expresión necesaria para las listas recurrentes para realizar el vínculo entre madre e hija.

Cerrar

 

Informes

Por defecto, los informes siguientes están asociados a la función :

 AWINDOW : Diccionario de ventanas

Pero esto se puede modificar por parametrización.

Botones específicos

La validación permite generar el tratamiento automático ligado a la ventana (WGxxx, donde xxx es el código ventana)

Los campos siguientes están en la ventana abierta por el botón :

Bloque Número 1

  • campo OBJET

 

  • campo CLES

 

Bloque Número 2

  • Desde el dossier (campo DOSORG)

Indica el dossier desde el que se va a copiar la ficha. Las posibles sintaxis se describen en el anexo dedicado.

  • Todos los dossieres (campo TOUDOS)

Esta opción permite copiar la ficha en todos los dossieres definidos en el diccionario (tabla ADOSSIER de la solución en curso).

  • Hacia el dossier (campo DOSDES)

Indica el dossier en el que se va a copiar la ficha. Las posibles sintaxis se describen en el anexo dedicado.

Cerrar

Esta función permite volver a copiar la definición de la ventanaa otro dossier Atención, hay que validar la ventana en el dosier de destino.

Este botón permite visualizar el resultado. La pantalla debe haberse validado.

Este botón permite visualizar el resultado en modo Web. La pantalla debe haberse validado.

Barra de menú

Aceptación forzada / Validación global

Esta validación global ejecuta la validación del conjunto de pantallas asociadas a esta ventana actual, la validación del objeto si se ha indicado, y la validación de la ventana y los objetos que estan asociados.

Mensajes de error

Además de los mensajes genéricos, los mensajes siguientes de error pueden aparecer durante la captura :

Mascara referenciada en las pestañas

La pantalla que se intenta capturar en la cabecera está presente en la lista de pestañas.

No es una pantalla de cabecera

La pantalla de referencia en la cabecera no es de tipo cabecera.

Pantalla modelo \ Las pantallas modelo sólo pueden definirse sobre ventanas modelo

Una pantalla modelo no puede ejecutarse, así que no puede unirse más que a una ventana modelo.

Mascara referenciada en cabecera

La pantalla que se intenta capturar en una pestaña está ya presente en la cabecera.

Campo obligatorio

Si la ventana es de tipo objeto, el código objeto es obligatorio.
Si la ventana es de consulta o de criterios de consulta, el código de consulta es obligatorio.

" Carácter no permitido

Por razones técnicas, el caracter ' » ' no está permitido en los títulos: título de la transacción.

Código ya introducido en líneann

Los códigos botón y líneas de menú deben ser únicos para la ventana.

Menú existente

El código de una línea de menú se constituye de un caracter para identificar el menú, y de su propio caracter de identificación. El caracter de identificación del menú no se conoce.

Código incorrecto

Los códigos autorizados para los botones y las líneas de menú son las letras mayúsculas y minúsculas, así como las cifras. Los caracteres siguientes son igualmente autorizados para las líneas del menú :
 " , ' , < , >.

Código reservado

Para los botones de ventanas, objetos y consultas, no hayqque tomar los códigos resevados a los botoes de supervisor. Los códigos reservados para una ventana objeto son lo siguientes: ACDEFHJKLMRTW09@+=<>
Los códigos reservados para una ventana objeto son lo siguientes : CDEFGLR09<>=+ -

Lista izquierda imposible con este objeto

No es posible insertar la lista izquierda definida para un objeto de tipo cuadro.

El número de zonas de selección es cero.

Se intenta relacionar un browser que no tiene zona definida para la lista izquierda.

Campos de selección incompatibles con el índice

En una lista jerarquizada (simple o picking), el número de elementos declarados para la lista izquierda debe ser igual o superior al número de elementos del índice utilizado.

Debe haber una pantalla de cabecera

Cuando hay varias pestañas definidas, se debe indidar una pantalla de cabecera.

Debe existir una pestaña

Debe indicarse al menos una pestaña si la pantalla de cabecera está definida para esta ventana.

Tablas utilizadas

SEEREFERTTO Consulta la documentación de Puesta en marcha