Componente VGUIRecord en formato fuente EGL

Este es un ejemplo de un componente VGUIRecord:
    Record  MyUIRecord  Type  VGUIRecord 
    { commandValueItem=”buttonValue” }
	     10 formItem  char(20)
	     { uiType=uiForm, 
        @programLinkData { programName=”NewPgm”,
                           newWindow=yes,
			  uiRecordName=”NewUIR”,
			linkParms = [
			   @LinkParameter { name=”key1”,
						value=”value1” },
			   @LinkParameter { name = “key2”,
						valueRef=”refItem” }
			]
        }
	   };
El diagrama de sintaxis de un componente VGUIRecord es el siguiente:

Diagrama de sintaxis de un componente VGUIRecord
Record nombreComponenteRegistro VGUIRecord ... end
Identifica el componente como de tipo VGUIRecord y especifica el nombre del componente. Para conocer las reglas de denominación, consulte Convenios de denominación.
alias = "alias"
Una serie que se incorpora a los nombres de la salida generada. Si no establece la propiedad alias, en su lugar se utiliza el nombre del componente .
commandValueItem = "nombreCampoRegistroVGUI"
Nombre del campo de registro VGUI que contiene el valor del botón SUBMIT o del enlace de hipertexto pulsado por el usuario. El campo debe ser de tipo carácter, tal como se describe en la sección Tipos primitivos.
Independientemente de si especifica un valor para la propiedad commandValueItem, lo siguiente es cierto:
  • Si el usuario pulsa un botón SUBMIT que tenga un valor ConverseVar.eventKey ("PF1" - "PF24", "PA1" - "PA3" o "ENTER"), el valor se sitúa en ConverseVar.eventKey
  • Si el usuario pulsa un botón SUBMIT que tenga un valor distinto de un valor ConverseVar.eventKey válido, el valor "ENTER" se sitúa en ConverseVar.eventKey
  • Puede probar el valor de ConverseVar.eventKey en el código
help = "textoAyuda"
Una serie disponible durante el tiempo de ejecución, pero debe adaptar el archivo JSP del registro VGUI para que acceda a ese texto desde el bean de registro de VGUI. Puede que desee incluir un script del lado del cliente en el JSP del registro de VGUI a fin de que el usuario pueda acceder fácilmente al texto de ayuda.
runValidatorFromProgram = yes, runValidatorFromProgram=no
Atañe a la función del validador que es la función a la que se hace referencia en la propiedad validatorFunction.

Si la propiedad runValidatorFromProgram se establece en yes (Valor por omisión), la función del validador se ejecuta en el programa EGL que obtiene el control después de procesar la sentencia converse o show. De lo contrario, la función de validación se ejecuta en el servidor de aplicaciones Web.

Acepte el valor por omisión si la validación necesita acceso a variables de programa o a otros recursos que no están disponibles en el servidor de aplicaciones Web.

title =" títuloPredeterminado"
Hace referencia al título asociado al registro de VGUI en la página Web. Puede especificar el título especificando una serie entrecomillada en lugar de título; por omisión, el título se muestra en un código HTML <H1> que precede al registro VGUI. Puede alterar temporalmente y volver a formatear el título al personalizar el archivo JSP en Page Designer.
validatorFunction = "nombreComponenteFunción"
El nombre de la función del validador, que valida los datos de entrada una vez finalizada la validación específica del campo.
campoEstructura
Un campo de estructura, como se describe en la sección Campo de estructura en formato fuente EGL. Al definir esa estructura, tenga en cuenta (especialmente) las propiedades de nivel de campo primitivas siguientes:
  • @programLinkData
  • alias
  • displayName
  • help
  • numElementsItem
  • selectedIndexItem
  • uiType

Para conocer los detalles, consulte el apartado Propiedades de nivel de campo primitivas.

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.