ABAP Cursosentenciaparameters

<html>

<head>

<title>PARAMETERS</title>

</head>

⚠ PARAMETERS⚠ 

⚠ Definicin⚠ 

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>

⚠ Sintaxis:⚠ 

<pre class="gaussr3">PARAMETERS <parmetro> [ (<longitud)>].

[ TYPE <tipo> | LIKE <campo> ]

[ DECIMALS <decimales> ] [ DEFAULT <valor> ]

[ MEMORY ID <memoria>] [ MODIF ID <grupo> ]

[ MATCHCODE OBJECT <objeto> ] [ AS MATCHCODE STRUCTURE]

[ NO-DISPLAY ] [ LOWER CASE ] [ OBLIGATORY ] [ FOR TABLE <tabla> ]

[ AS CHECKBOX ] [ RADIOBUTTON GROUP <grupo> ]

[ VALUE-REQUEST ] [ HELP REQUEST ].</pre>

Con esta sentencia definimos el parmetro <parmetro>.

  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>

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>

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>