Propiedades de elementos de página

Las propiedades de elementos de página especifican las características que son relevantes cuando se declara un elemento o una matriz en un componente PageHandler o en un componente de registro de UI.

Las propiedades son las siguientes:

En las descripciones a continuación, una propiedad de enlace es una propiedad cuyo valor está en vigor cuando un diseñador de páginas coloca el elemento (o un registro que incluya el elemento) en la página Web. El diseñador de páginas puede alterar temporalmente el valor, que es un valor por omisión.

action

La propiedad action es una propiedad de enlace, lo que significa que el valor asignado se utiliza como valor por omisión al trabajar en Page Designer. La propiedad solamente es relevante si el valor de la propiedad de elemento displayUse es botón o hiperenlace.

El valor de action hace referencia al código que se invoca cuando el usuario pulsa el botón o el enlace hipertexto.

El formato para establecer action es el siguiente:
  action = valorAcción
valorAcción
Uno de los siguientes:
  • El nombre de una función de manejo de eventos del manejador de páginas
  • Una etiqueta que efectúa una correlación con un recurso Web (por ejemplo, un JSP) y que corresponde a un atributo from-outcome de una entrada navigation-rule del archivo de Recursos de configuración de aplicación de JSF
  • El nombre de un método de un bean Java, en cuyo caso se aplican estas normas:
    • El formato es el nombre del bean seguido de un punto y de un nombre de método
    • El nombre de bean debe estar relacionado con una de las entradas de nombre de bean gestionado del archivo de Recursos de configuración de aplicación de JSF
Si no especifica un valor para action, la pulsación del elemento por parte del usuario tiene el efecto siguiente:
  • Si el valor de la propiedad displayUse es button, se produce una validación, después de lo cual JSF vuelve a visualizar la misma página Web.
  • Si el valor de la propiedad displayUse es hyperlink, se produce ninguna validación, pero JSF vuelve a visualizar la misma página Web.
Si el entorno de ejecución EGL envía datos de elemento de página a un programa de acción, cada uno de los elementos de página que se envía se ajusta a las siguientes normas:
  • El elemento de página puede ser subordinado al elemento que está definiendo o bien puede estar al mismo nivel; y
  • El nombre del elemento de página es idéntico al nombre de un elemento en la propiedad de programa inputPageRecord, que es donde se reciben los datos de elemento de página.
Si no especifica un valor para action, la pulsación del elemento que se define por parte del usuario tiene el efecto siguiente:
  • Si la página Web se ha visualizado mediante una sentencia converse, el control vuelve al mismo programa
  • Si la página Web se ha visualizado mediante una sentencia forward con una cláusula de devolución, el control va al programa que se ha especificado en la cláusula de devolución
En los casos anteriores (cuando el programa originador especifica previamente un programa a invocar), haga lo siguiente:
  • No especifique ningún valor para action; o
  • Especifique un valor para action, pero establezca la propiedad newWindow en yes.

byPassValidation

La propiedad byPassValidation es una propiedad de enlace, lo que significa que el valor asignado se utiliza como valor por omisión al trabajar en Page Designer. La propiedad solamente tiene efecto cuando se especifica para un elemento que representa un código de mandato (botón o hiperenlace). indica que debe ignorarse la validación en el evento de mandato. Los datos de los campos de entrada no se devuelven al programa.

El formato es el siguiente:
  byPassValidation = yesOrNo
yesOrNo
Uno de estos valores:
  • No es el valor por omisión y significa que el elemento se valida y (si es válido) se somete.
  • indica que debe ignorarse la validación en el evento de mandato.

displayName

La propiedad displayName es una propiedad de enlace, lo que significa que el valor asignado se utiliza como valor por omisión al trabajar en Page Designer. La propiedad especifica la etiqueta que se visualiza junto al elemento.

El formato es el siguiente:
  displayName = "literal"
literal
Una serie entrecomillada.

displayUse

La propiedad displayUse es una propiedad de enlace, lo que significa que el valor asignado se utiliza como valor por omisión al trabajar en Page Designer. La propiedad asocia el elemento con un control de interfaz de usuario.

El formato es el siguiente:
  displayUse = displayUse
displayUse
Uno de estos valores:
  • button significa que el control tiene un código de mandato de botón.
  • secret significa que los datos no son visibles al usuario; este valor es adecuado para las contraseñas.
  • hyperlink significa que el control tiene un código de mandato de hiperenlace si la propiedad de acción es el nombre de una función de manejo de eventos; el control tiene un código de enlace si la propiedad de acción es una etiqueta. No se produce validación y no se devuelven datos de entrada cuando el usuario pulsa en el enlace.
  • input significa que el control acepta la entrada de usuario; el control también puede visualizar un valor suministrado por el programa o el manejador de páginas.
  • table significa que los datos están dentro de un código de tabla.
  • output significa que el control es un campo de salida que es visible.

help

La propiedad help es una propiedad de enlace, lo que significa que el valor asignado se utiliza como valor por omisión al trabajar en Page Designer. La propiedad especifica el texto de ayuda flotante que se visualiza cuando el usuario sitúa el cursor sobre el elemento de entrada.

El formato es el siguiente:
  help = literal
literal
Una serie entrecomillada.

Si no especifica un valor para la propiedad help específica de elemento, la propiedad help estará en vigor para el componente pageHandler o UIRecord que contiene el elemento. Para conocer detalles, consulte el apartado Componente PageHandler en formato fuente EGL.

newWindow

La propiedad newWindow indica si debe utilizarse una ventana de navegador nueva cuando el entorno de ejecución EGL presenta una página Web en respuesta a la actividad identificada en la propiedad action.

El formato es el siguiente:
  newWindow = yesOrNo
yesOrNo
Uno de estos valores:
  • No es el valor por omisión y significa que se utiliza la ventana de navegador actual para visualizar la página.
  • Yes significa que se utiliza una ventana de navegador nueva.

La propiedad newWindow sólo es relevante cuando se especifica la propiedad action; de lo contrario, se utiliza la ventana de navegador actual para visualizar la página siguiente.

numElementsItem

La propiedad numElementsItem se especifica en una variable de matriz estática o elemento de registro e identifica el nombre de otro elemento en el registro UI o manejador de páginas. Durante la ejecución, el código de programa o manejador de páginas define ese elemento para indicar a la JSP cuántos elementos de matriz deben visualizarse. Esta propiedad se utiliza solamente para salida.

En registros de UI, la propiedad es relevante para elementos de estructura que tienen un valor de apariciones mayor que 1. En manejadores de páginas, La propiedad es relevante para cualquiera de estos elementos:
  • Matrices estáticas de registros o elementos de datos
  • Elementos de estructura que tienen un valor de apariciones superior a 1
El formato es el siguiente:
  numElementsItem = "nombreElemento"
nombreElemento
Nombre del elemento de manejador de páginas o registro de UI que contiene el número de elementos de matriz que deben visualizarse.

La propiedad numElementsItem no es válida para matrices dinámicas ya que cada matriz dinámica incluye un indicador de cuántos elementos hay en uso. Encontrará los detalles en Matrices.

runValidatorFromProgram

La propiedad runValidatorFromProgram tiene relevancia solamente si el elemento está en un registro UI. La propiedad indica si la función referenciada en la propiedad validatorFunction se ejecuta en el servidor de aplicaciones Web (en el bean de registro UI) o se ejecuta en el programa que recibe datos del usuario.

El formato es el siguiente:
  runValidatorFromProgram = yesOrNo
yesOrNo
Uno de estos valores:
  • No es el valor por omisión y significa que la función se ejecuta en el servidor de aplicaciones Web.
  • Yes significa que la función se ejecuta en el programa.

Realice la validación en el programa solamente 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.

selectFromListItem

La propiedad selectFromListItem (antes la propiedad selectFromList) es una propiedad de enlace, lo que significa que el valor asignado se utiliza como valor por omisión al trabajar en Page Designer.

La propiedad hace referencia a una columna de tabla o matriz desde la que el usuario selecciona uno o varios valores; y la propiedad indica que la matriz o elemento que se declara recibirá datos como respuesta a la selección que realice el usuario en esa lista.

Si se permite que el usuario seleccione múltiples valores, se especifica la propiedad para una matriz. De lo contrario, se especifica la propiedad para un elemento.

Los valores recibidos del usuario deben corresponder a uno de estos tipos:
  • El contenido del elemento de matriz o columna de tabla que ha seleccionado el usuario; o bien
  • Un índice de tabla o matriz, que es un entero que identifica qué elemento o columna se ha seleccionado. El índice puede estar entre 1 y el número de elementos disponibles.

La propiedad selectType indica el tipo de valor a recibir, ya haya seleccionado el contenido el usuario o un índice de una matriz o columna.

El formato de selectFromListItem es el siguiente:
  selectFromListItem = "nombreLista"
nombreLista
Uno de estos valores, que debe estar calificado como necesario para resolver la referencia totalmente:
  • Una matriz de cualquier tipo; o bien
  • Una columna de tabla como, por ejemplo, myTable.myColumn.

Encontrará los detalles sobre la resolución de nombres en Referencias a componentes.

selectType

La propiedad selectType es una propiedad de enlace, lo que significa que el valor asignado se utiliza como valor por omisión al trabajar en Page Designer.

La propiedad indica la clase de valor que se recupera en el elemento que se declara.

El formato es el siguiente:
  selectType = selectType
selectType
Uno de estos valores:
  • index es el valor por omisión y significa que la matriz o elemento que se declara recibirá índices como respuesta a una selección de usuario. En este caso, el elemento debe ser de tipo numérico.
  • value significa que la matriz o elemento que se declara recibirá el valor de selección del usuario como respuesta a una selección de usuario. En este caso, el elemento puede ser de cualquier tipo.

Para obtener información preparatoria, consulte la propiedad selectFromListItem.

validationOrder

El valor de la propiedad validationOrder es un entero que indica cuándo se ejecuta la función de validador del elemento en relación con la función de validador de cualquier otro elemento. La propiedad es importante si la validación de un elemento depende de la validación previa de otro.

La validación se produce primero para los elementos para los que haya especificado un valor para la propiedad validationOrder y los elementos con los valores de numeración inferior se validan primero. La validación se produce entonces para los elementos para los que no haya especificado un valor para validationOrder, y, en este caso, el orden de validación es el orden en que se definen los elementos en el manejador de páginas.

El formato de la propiedad es el siguiente:
  validationOrder = entero
entero
Un entero literal que indica cuándo se valida el elemento en relación con los demás elementos.

value

La propiedad value es una propiedad de enlace, lo que significa que el valor asignado se utiliza como valor por omisión al trabajar en Page Designer. La propiedad especifica una serie de caracteres que se visualiza como contenido de elemento cuando se visualiza una página Web, antes de que el usuario cambie el valor.

El formato es el siguiente:
  value = "literal"
literal
Una serie entrecomillada.

Consulta relacionada
Matrices

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.