PANTALLA DE SELECCION.
Es un área dentro de los reportes en dde se especifican los parámetros de selección por los cuales se va a ejecutar el programa.
Se utiliza para restringir el procesamiento y la salida de los datos. Por lo general se coloca después de la declaración de datos.
Dentro de una pantalla de selección se pueden declarar dos tipos de objetos:
- PARAMETER: en los cuales los usuarios podrá ingresar valores individuales.
si ingresamos un solo parámetro utilizamos la palabra reservada PARAMETER.
si deseamos declarar más de un parámetro utilizamos la palabra reservada PARAMETERS:
Podemos utilizar too PARAMETERS y declarar un solo parámetro, el programa compilara igualmente
o también declarar varios parámetros en la pantalla de selcción y para cada uno de ellos escribir en la
izquierda la palabra reservada PARAMETER.
- SELECT-OPTIONS: dde el usuario podrá ingresar rangos de valores.
Ej: Declaramos los parámetros P_FECHA y P_NOMBRE
* Pantalla de selección
PARAMETERS: p_fecha LIKE sy-datum OBLIGATORY DEFAULT sy-datum,
p_nombre(10) TYPE c OBLIGATORY.
La long max que puede tener el nombre de un parámetro es de 8 posiciones.
dde: la cláusula OBLIGATORY hace q el parámetro sea obligatorio.
la cláusula DEFAULT asigna un valor por defecto al parámetro.
Salida del ej es la siguiente:
P_FECHA 19.03.2009 al lado hay un icono, si presionamos nos sale calendario o F4
P_NOMBRE
Podemos cambiar estos nombres P_FECHA y P_NOMBRE, vamos a:
Pasar a --> Elementos de texto --> texto de seleccion
y en la pantalla q nos sale en la pestaña texto de selección cambiamos los nombres.
Previamente tenemos q tener activo el programa.
- Parámetros tipo CHECKBOX: dde el usuario puede tildar las opciones que prefiera.
- RADIOBUTTON: dde el usuario selecciona una de las opciones entre todas las existentes.
Ejemplo de Declaración de estos parámetros:
PARAMETERS: p_list AS CHECKBOX. "Emitir listado
PARAMETER: p_arg RADIOBUTTON GROUP bot2, "Argentino
p_col RADIOBUTTON GROUP bot2, "Colombiano
p_mex RADIOBUTTON GROUP bot2, "Mejicano
p_esp RADIOBUTTON GROUP bot2, "Español
p_otr RADIOBUTTON GROUP bot2, "Otra Nacionalidad
Se visualizará de la siguiente manera en pantalla:
icono cuadrado Emitir Listado
icono redondo Argentino
Colombiano
Mejicano
Español
Otra Nacionalidad
- SELECT-OPTIONS: son iguales a los PARAMETER, salvo q ellos se puede ingresar rangos de valores, es decir
un valor desde y un valor hasta, a parte de valores individuales.
Ej: Declaramos el SELECT-OPTIONS S_CLAVEP
DATA: v_clavep TYPE land1_gp.
SELECT-OPTIONS s_clavep FOR v_clavep. 'Clave de País
de nuevo si ejecutamos el reporte, a la derecha del campo Clave del país nos aparece el icono , si lo presionamos vemos la ayuda de búsqueda correspondiente al tipo LAND1_GP q es un tipo de la tabla KNA1.
Tabla KNA1
La tabla de BD estándar KNA1 corresponde al Maestro de Clientes.
De cada cliente se guarda en SAP información tal como el número de cliente, el país, el nombre, el código postal y muchos otros datos más.
Podemos crear un "MARCO" que encuadre a los parámetros de la pantalla de selección. Para ello, debemos colocar a la declaración de los parámetros dentro de la sgte sentencias:
SELECTION-SCREEN BEGIN OF BLOCK b1 WITH FRAME TITLE text-001.
....
......
SELECTION-SCREEN END OF BLOCK b1.
Donde: b1 es el nombre del marco
text-001 es el titulo q se visualizará en el extremo superior izq del marco.
CLASES DE MENSAJES
- AT SELECTION-SCREEN: Para analizar el contenido de los parámetros. se validan los valores ingresados en la
pantalla de selección.
Si queremos q la fecha ingresada por pantalla sea >= a la fecha actual y q si no es así se emita un msj en la pantalla advirtiendo q el valor introducido es incorrecto. Para esto, creamos una clase de mensajes a través de la transacción SE91, tal como veremos:
Se pone SE91 y sale la pantalla: Actualización de mensajes: Imagen inicial y se de Crear, una vez q se haya puesto el nombre en el campo Clase de mensajes y marcar en Objetos parciales el Mensaje.
SE91: Se utiliza para la creación, modificación y visualización de las clases de mensajes en SAP, las cuales nos
permiten agrupar los mensajes que utilizaremos en una aplicación.
Luego nos sale la pantalla: Actualización de mensajes: Modificar clase de mensajes. y asignamos un mensaje breve en el campo Texto breve: Clase de Mensajes de Prueba. en la pestaña Propiedades.
y creamos nuestro primer mensaje, en la pestaña de Mensajes., como La fecha debe ser mayor o igual a la fecha inicial
Luego en nuestro programa, escribiremos el código correspondiente en el evento AT SELECTION-SCREEN para hacer cumplir esta validación.
Ej: AT SELECTION-SCREEN.
IF p_fecha < sy-datum.
MESSAGE e000 (z_prueba). " La Fecha debe ser mayor o igual a la fecha actual
ENDIF.
Ejecutamos nuestro reporte con una fecha anterior a la fecha actual y vemos el sgte mensaje en el extremo inferior izquierdo de la pantalla: La fecha debe ser mayor o igual a la fecha actual.
El mensaje q mostramos es un mensaje de error. Esto está determinado por la letra e q se antecede al número del mensaje y la clase de mensaje entre parántesis.
Los tipos de mensajes existente son:
Tipo Significado mensaje Comportamiento El mensaje aparece en
S Status El programa continua sin interrupción La línea de status
I Información El programa continua después de la interrup Una ventana de diálogo
W Warning Depende del contexto del mensaje Barra de status
E Error Depende del contexto del mensaje (puede Barra de status
causar la cancelación del programa)
A Terminación El programa termina después de un cuadro de Una ventana de diálogo
diálogo
X Dump Error en tiempo de ejecución tipo X Un dump
-