Los parámetros de selección:
Hasta ahora aprendimos a crear un reporte que procesa información e imprime por pantalla un determinado resultado, pero que sucede si queremos introducir algunas delimitacienes a nuestro programa, de modo que solo se ejecute para ciertos datos que el usuario introduzca en la pantalla.
Para lograr esto deberemos crear una Pantalla de selección: es un área dentro dentro de los reportes en donde se especifica los parametros de selección por los cuales se va a ejecutar el programa. se utiliza para restringir el procesamiento y la salida de los datos y por lo general se escribe despues de la declaración de datos. dentro del include de declaración de datos.
La pantalla de selección de unprograma va a estar compuesta por parámetros de entrada de datos.
Basicamente existen dos tipos de parametros:
- Los PARMETER en los cuales el usuario podrá ingresar valores individuales.
- Los SELECTIONS en donde el usuario podrá ingresar rengos de valores.
Para declarar un PARAMETER vamos a utilizar la palabra reservada PARAMETER
PARAMETER <nombre_parámetro> TYPE 0 LIKE<tipo_parámetro>.
En el siguiente ejemplo declaramos los parámetros P-FECHA y P_NOMBRE.
PARAMETERS: p_fecha LIKE sy-datum,
p_nombre(10) LIKE c.
Ahora bien a cambiar las descripciones de los parámetros que aparecen en pantalla ya que P_FECHA y P_NOMBRE son los nombres de los parametros y nosotros queremos que se visualicen descripciones y no nombres tecnicos . para ello vamos a crear textos de selección para cada uno de los parámetros de la pantalla de selección. Vamos a ir al menú / pasar a / Elementos de texto / Texto de selección.
Y luego para cada uno de los parameter introducimos las descripciones que mejor se adapten al propósito de cada parámetro.
Debemos tener presente que los textos de selección son un objeto mas dentro de los objetos de ABAP que forman parte de un programa ABAP por lo tanto, asi como los programas se activan, los textos de selección tambíen seben activarse.
Volviendo un poco a la declaración de los parémetros vamos a ver que existen algunas adiciones o agregados que podemos utilizar, los cuales son muy útiles.
- El agregado de la cláusula OBLIGATORY hace que el parametro sea obligatorio.
- El agregado de la cláusula DEFAULT asigna un valor por derecha al parámetro.
Ahora bien dentro de los PARAMETERS podemos también crea otros dos tipos de parametros de entrada y nos referimos a:
- Los CHECKBOX que permiten al usuario tildar las opciones que prefiere entro de un grupo de opciones disponibles.
- Los RADIOBUTTON en donde el usuaria selecciona una de las opciones entre todas las existentes.
Veamos como se declaran los CHECKBOX:
PARAMETERS: p_lista AS CHECKBOX, "Emitir listado
p_arch AS CHECKBOX. "Generar archivo de salida
Vamos a modificar los textos de selección para los CHECKBOX que acabamos de crear.
Veamos ahora como se declaran los radiobutton:
PARAMETER: p_arg RADIOBUTTON GROUP bot2, "Argentina
p_chi RADIOBUTTON GROUP bot2, "Chilena
p_col RADIOBUTTON GROUP bot2, "Colombiana
p_esp RADIOBUTTON GROUP bot2, "Española
p_mex RADIOBUTTON GROUP bot2, "Mejicana
p_esp RADIOBUTTON GROUP bot2, "Peruana
p_ven RADIOBUTTON GROUP bot2, "Venezolana
p_otr RADIOBUTTON GROUP bot2, "Otra Nacionalidad
Vamos a midificar los textos de selección para los radiobutton que acabamos d crear.
Veamos ahora como declarar los SELECT-OPTINS. son parámetros que nos permite ingresar rangos de valores, es desir un valor desde y valor hasta, aparte de valores individuales.
Para declarar un SELECT-OPTION vamos a usa la palabra reservada SELECT-OPTIONS seguida del nombre del parámetro y su tipo.
DATA: v_clavep TYPE landl_gp.
SELECT-OPTIONS s_clavep FOR v_clavep. "Clave de país
Vamos a modificar el texto de seleccion el select-options que acabamos de crear.
Al igual que con los PARAMETERS. con los SELECT-OPTIONS también podemos:
- Utilizar la adición OBLIGATORY para hacer obligatorio la introducción de datos en el campo de la pantalla.
- Utilizamos los puntos : para declarar más SELECT-OPTIONS, uno debajo del otro.
Por último, vamos a aprender a crear un " Frame" o "Marco" que encuadre a los parárametros de la pantalla de selección. para ello, debemos colocar a la declaración de los parametros dentro de las siguiente sentencias.
SELECTIONSCREEN BEGIN OF BLOCK b1 WITH FRAME TITLE text-001.
SELECTION-SCREEN END OF BLOCK b1.
En donde b1 es el nombre del marco y text-001 es el titulo que se visualizará en el extremo superior izquierdo del marco.
Si modificamos el código de nuestro programa de prueba con el marco o frame.
SELECTION-SCREEN BEGIN OF BLOCK b1 WITH FRAME TITLE text-001.
Si hacemos doble clic en Text-001 vamos a crear el texto que se va a visualizar en el texto superior izquierdo del marco. a continuación introducimos la decripción correspondiente para el texo y activamos el nuevo objeto ABAP.