<html>
<head> <title>PARAMETERS</title> </head> <BODY BGCOLOR="#000000" TEXT="#FFFFFF" LINK="#0099FF" VLINK="#AA0000"> <p align="left">⚠ <b><span class="titulo">PARAMETERS</span>⚠ </b></p>
<p align="left" class="gaussr3">⚠ <b>Definicin⚠ </b></p>
<p align="left" class="gaussr3">Si queremos dar la posibilidad al usuario de introducir
valores en variables en la pantalla de seleccin, debemos definir dichas variables con la sentencia PARAMETERS. La declaracin de variables con la sentencia PARAMETERS es muy parecida a la sentencia⚠ <a href="data.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/data.htm">DATA⚠ </a>.</p>
<p align="left" class="gaussr3">⚠ <b>Sintaxis:⚠ </b></p>
Las clusulas <longitud>, <tipo> y <decimales> sin iguales a las de la sentencia⚠ <a href="data.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/data.htm">DATA⚠ </a>.</p>
<p class="gaussr3">Cuando el usuario arranque el programa aparece una pantalla
de seleccin con el parmetro <parmetro>, con longitud la especificada en <longitud>, o la longitud por defecto del campo si la clusula no se define. Por defecto la descripcin que aparece a la izquierda del campo es el nombre del campo. El objeto parcial de programa⚠ <i>Elementos de texto⚠ </i>, la opcin⚠ <i>Textos de seleccin⚠ </i>nos permite asociar al parmetro un texto significativo. Otra posibilidad es la utilizacin de la sentencia⚠ <a href="selection_screen.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/selection_screen.htm">SELECTION-SCREEN⚠ </a>como veremos en el apartado correspondiente a esta sentencia.</p>
<p class="gaussr3">Se puede utilizar los parmetros de seleccin, por ejemplo,
para que el usuario limite los valores desde y hasta para una posterior lectura de la base de datos. Si las condiciones de seleccin son ms complejas que indicar un valor desde y hasta, es preferible utilizar la sentencia⚠ <a href="select_options.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/select_options.htm">SELECT-OPTIONS⚠ </a>.</p>
<ul>
<li class="gaussr3">DEFAULT -> <valor> puede ser un literal o el nombre
de un campo. Si especificamos el nombre de un campo el valor por defecto en
el parmetro ser el valor del campo en el momento de presentar la pantalla
de seleccin. Recordemos que el evento ⚠ <a href="initialization.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/initialization.htm">INITIALIZATION⚠ </a>
se ejecuta antes de la presentacin de la pantalla de seleccin, en l se
puede actualizar el valor del campo especificado. El usuario puede modificar
el valor que aparece por defecto. </li>
<li class="gaussr3">NO-DISPLAY -> El parmetro no aparece en la pantalla
de seleccin. Se le puede dar un valor con la clusula DEFAULT, en el evento
INITILIZATION, o con una llamada al programa con la sentencia ⚠ <a href="submit.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/submit.htm">SUBMIT⚠ </a>.
Si queremos mostrar el parmetro bajo ciertas circunstancias no se debe utilizar
la clusula NO-DISPLAY ya que con ella no se podr hacer visible el parmetro.
Se debe definir visible y si no queremos que aparezca el campo utilizamos
la sentencia ⚠ <a href="modify_screen.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/modify_screen.htm">MODIFY SCREEN⚠ </a>.</li>
<li class="gaussr3">LOWER-CASE -> El sistema no convierte el valor del parmetro
a maysculas, es decir, respeta la entrada del usuario, sea con caracteres
en maysculas y/o minsculas. Si definimos el tipo de parmetro con la opcin
LIKE y referenciamos un campo del diccionario de datos, la clusula LOWER
CASE no se puede utilizar.</li>
<li class="gaussr3">OBLIGATORY -> Obliga a introducir un valor al usuario
en el parmetro. Para significar el hecho de la obligatoriedad, el sistema
presenta el campo con el signo de interrogacin (?).</li>
<li class="gaussr3">AS CHECKBOX -> Un checkbox es un campo de entrada de
longitud 1 sobre el que se puede activar o desactivar un ⚠ <i>vise⚠ </i>. Para
definirlo utiliza la clusula AS CHECKBOX. El valor interno del parmetro
ser "X" o " " si est activo o desactivo respectivamente.
El usuario para activar o desactivar el parmetro debe hacer un click sobre
el parmetro. Si utilizamos la opcin LIKE en la sentencia PARAMETERS haciendo
referencia a un campo del diccionario de tipo C, longitud 1 y valores permitidos
"X" y " " ( a travs del dominio), el parmetro aparece
automticamente como checkbox.</li>
<li class="gaussr3">RADIOBUTTON -> Es un conjunto de campo de entrada de
longitud 1 sobre el que se puede activar o desactivar uno y slo uno de ellos.
Para definir un grupo de campos con el formato de radiobutton se utiliza la
clusula RADIOBUTTON GROUP. Cada parmetro definido como radiobutton es de
tipo C y longitud 1, y se asigna al grupo <grupo>. La mxima longitud
del campo <grupo> es de 4. La clusula LIKE se puede utilizar pero debe
referenciar un campo de tipo C y longitud 1. Se deben asignar al menos dos
parmetros por cada grupo. Slo un parmetro por grupo podr tener un valor
por defecto con la clusula DEFAULT, y este valor slo podr ser "X".
Cuando el usuario hace un click sobre el radiobutton, el sistema activa dicho
parmetro (valor interno: "X") y desactiva (valor interno: "
") el parmetro del grupo que estuviera activo. Siempre un parmetro
del grupo est activo. Si ningn parmetro se activa por definicin, o en
el evento INITIALIZATION, el sistema activa el primer parmetro del grupo.</li>
<li class="gaussr3">MEMORY ID -> El sistema presentar en el parmetro de
la pantalla el valor almacenado en un parmetro de memoria SPA/GPA. <memoria>
identifica el nombre del parmetro y debe tener hasta tres caracteres de longitud.</li>
<li class="gaussr3">MODIF ID -> Se utiliza para asignar un parmetro a un
grupo de modificacin. Ese grupo de modificacin podr ser utilizada por la
sentencia MODIFY SCREEN para modificar los atributos de la pantalla de seleccin.
<grupo> es el nombre del grupo de modificacin y debe ser un string
de tres caracteres sin las comillas ( ' ). <grupo> se asigna a la columna
SCREEN-GROUP1 de la tabla interna SCREEN. En el evento ⚠ <a href="at_selection_screen.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/at_selection_screen.htm">AT
SELECTION-SCREEN⚠ </a> se puede manipular la pantalla de seleccin gracias a
las sentencias ⚠ <a href="loop_endloop.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/loop_endloop.htm">LOOP AT SCREEN⚠ </a> y ⚠ <a href="modify_screen.htm" tppabs="http://www.gaussr3.com/abap4/sentencias/modify_screen.htm">MODIFY
SCREEN⚠ </a>.</li>
<li class="gaussr3">FOR TABLE y AS MATCHCODE STRUCTURE -> Asignamos el parmetro
a la tabla de la base de datos <tabla>. Esto slo tiene sentido en programas
de acceso a bases de datos lgicas. A diferencia de un campo de un programa
de dilogo (transaccin), el istema no valida si el valor introducido existe
en el matchcode.</li>
<li class="gaussr3">Las opciones VALUE-REQUEST y HELP-REQUEST -> Slo se
pueden ser utilizadas en programas de definicin de bases de datos.</li>
</ul>
</body>
</html>