1 | Los parámetros de selección
En esta lección ya vamos a manejar la entrada de datos. Esto lo haremos desde la pantalla de selección, la cual es una sección del reporte que existe para que el usuario especifique parámetros de selección para la ejecución del programa.
Tenemos 2 tipos de parámetros:
1.1 | PARAMETER/S
Los cuales son utilizados para ingresar valores individuales. Necesitan un nombre (Los nombres no pueden superar los 8 caracteres de longitud) y un tipo de datos. Emplean la siguiente sintaxis:
PARAMETERS foo TYPE bar.
Donde foo es el nombre del parámetro y bar es el tipo de dato. Nótese que se puede usar TYPE, o LIKE. Es importante tener en cuenta de que PARAMETER y PARAMETERS tienen la misma función pero la primera maneja la declaración de un solo parámetro por sentencia, mientras que PARAMETERS puede manejar una o más declaraciones de parámetros.
Algo que tendremos que hacer es darles a estos parámetros un texto de selección. Esto es porque cuando en la pantalla de selección se muestre el campo para introducir el dato de un parámetro se pedirá a través del nombre real del parámetro, el cual más que estar hecho para la comprensión del usuario está hecho para la comprensión del desarrollador. Por lo tanto, hay que crearles un texto de selección, el cual es un texto que reemplaza el nombre real del parámetro en la pantalla de selección.
Para crear el texto de selección accedemos al menú "Pasar a" -> "Elementos de texto" -> "Textos de selección". Esto abrirá una ventana en la que entre otras cosas veremos una lista con los nombres de nuestros parámetros y un campo para asignarles el texto, le damos el texto que deseemos y activamos el elemento como si fuese un programa.
Otra cosa a destacar es de que esta sentencia permite dos cláusulas:
- OBLIGATORY: Es una cláusula sin parámetros que indica que la entrada de un valor para el parámetro es obligatoria.
- DEFAULT: Es una cláusula con un parámetro que permite asignar un valor por defecto. Emplea la sintaxis: DEFAULT foo. Donde foo puede ser un valor o una variable.
Y también tenemos 2 formatos adicionales:
Checkbox
Con esto le permitimos al usuario la selección de una o varias opciones pre-definidas pre-definido. Empleamos la sintaxis:
PARAMETERS: foo AS CHECKBOX.
Radiobutton
Estos son los botones tachables circulares de los que solo se puede seleccionar uno a la vez de un grupo. Estos usan la siguiente sintaxis:
PARAMETER: p_foo RADIOBUTTON GROUP bar.
Donde p_foo es el nombre del parámetro (usamos "p_" por convención) y bar es el grupo al que el botón pertenece.
Por supuesto, cada uno de estos elementos requiere un mensaje personalizado en el menú de texto de selección (y requerirá su subsecuente activación).
1.2 | SELECT-OPTIONS
Este tipo de parámetro sirve para elegir un rango de valores (podemos elegir intervalos, conjuntos de valores individuales, etc.). Emplea la siguiente sintaxis:
SELECT-OPTIONS foo FOR bar.
Donde foo es el nombre del select-options y bar es el tipo de datos. Hay ciertos detalles a tener en cuenta sobre lo que va exactamente en bar, estos pueden ser vistos en la sección de ayuda de SAP GUI sobre la palabra clave. Luego de crear el SELECT-OPTIONS "foo" tendremos que asignarle un nombre como estuvimos haciendo.
Cabe destacar que SELECT-OPTIONS puede...
- Usar dos puntos (":") para declarar más de un SELECT-OPTIONS, uno debajo del otro.
- Usar la cláusula OBLIGATORY.
2 | Frames/Marcos
Podemos crear una "sección" dentro de nuestra pantalla de selección para encuadrar los parámetros, estas secciones las llamamos frames o marcos. Para esto tendremos que crear la siguiente sentencia:
SELECTION-SCREEN BEGIN OF BLOCK foo WITH FRAME TITLE bar.
...
SELECTION-SCREEN END OF BLOCK foo.
Donde foo es el nombre de nuestro frame/marco y bar es el símbolo de texto (es decir, que en realidad tiene el formato text-nnn) que definirá el título que tendrá el marco cuando sea mostrado en la pantalla de selección.
El símbolo de texto tiene que ser definido de la forma de siempre y el objeto (el símbolo) tiene que ser activado.