Un componente pageHandler se declara en un archivo EGL, que está descrito en
Proyectos, paquetes y archivos EGL. Este componente es un componente generable, lo que
significa que debe estar en el nivel superior del archivo y debe tener el mismo nombre que el
archivo.
Este es un ejemplo de un componente pageHandler:
// Page designer requiere que todos los pageHandler
// estén en un paquete llamado "pagehandlers".
package pagehandlers ;
PageHandler ListCustomers
{onPageLoadFunction="onPageLoad"}
// Biblioteca para acceso de tabla cliente
use CustomerLib3;
// Lista de clientes
customerList Customer[] {maxSize=100};
Function onPageLoad()
// Clave inicial para recuperar clientes
startkey CustomerId;
// Resultado de llamada de biblioteca
status int;
// Recuperar hasta 100 registros de cliente
startKey = 0;
CustomerLib3.getCustomersByCustomerId(startKey,
customerList, status);
if ( status != 0 && status != 100 )
setError("Ha fallado la recuperación de clientes.");
end
end
Function returnToIntroductionClicked()
forward to "Introducción";
end
End
El diagrama de un componente pageHandler es el siguiente:
- PageHandler nombreComponenteManejadorPáginas ... end
- Identifica el componente como PageHandler y especifica el nombre del componente. Para conocer las reglas de denominación, consulte Convenios de
denominación.
- propiedadManejadorPáginas
- Una propiedad del componente PageHandler, tal como se lista en Propiedades del componente PageHandler.
- use nombreComponenteTablaDatos,
use nombreComponenteBiblioteca
- Una declaración use que simplifica el acceso de una tabla de datos o biblioteca. Para
conocer detalles, consulte Declaración de uso.
- private
- Indica que la variable, constante o función no está disponible para la JSP que
muestra la página Web. Si omite el término private, puede
enlazar la variable, constante o función a un control en la página Web.
- nombreElementoDatos
- El nombre de un elemento de datos (una variable). Para conocer las reglas, consulte
Convenios de denominación.
- tipoPrimitivo
- El tipo primitivo asignado al elemento de datos.
- longitud
- La longitud del elemento de estructura, que es un entero. El valor de un área de
memoria que se basa en el elemento de estructura incluye el número de caracteres o
dígitos especificado.
- decimales
- Para un tipo numérico (BIN, DECIMAL, NUM, NUMC o PACF), puede especificar
decimales, que es un entero que representa el número de posiciones después de la
coma decimal. El número máximo de posiciones decimales es el menor de dos números: 18 o
el número de dígitos declarado como longitud. La coma decimal no
se almacena con los datos.
- nombreComponenteElementoDatos
- El nombre de un componente dataItem que es un modelo de formato para el elemento de
datos, tal como se describe en typeDef. El componente dataItem debe ser visible al
componente pageHandler, tal como se describe en Referencias a componentes.
- propiedadElemento
- Una propiedad de elemento. Encontrará los detalles en Propiedades de elemento de
página.
- nombreRegistro
- El nombre de un registro (una variable). Para conocer las reglas, consulte
Convenios de denominación.
- nombreComponenteRegistro
- El nombre de un componente de registro que es un modelo de formato para el registro,
tal como se describe en typeDef. El componente de registro debe ser visible al
componente pageHandler, tal como se describe en Referencias a componentes.
- propiedadRegistro
- Una alteración temporal de una propiedad de registro. Para conocer detalles sobre las
propiedades de registros, consulte una de las siguientes descripciones, dependiendo del
tipo de registro indicado en nombreComponenteRegistro:
- nombreElemento
- El nombre del elemento de registro cuyas propiedades desea alterar temporalmente.
- propiedadElemento
- Una alteración temporal de una propiedad de elemento. Encontrará los detalles en
Visión general de propiedades y alteraciones temporales de EGL.
- nombreConstante literal
- El nombre y valor de una constante. Para conocer las reglas, consulte Convenios de
denominación.
- nombreMatriz
- El nombre de una matriz de registros o elementos de datos dinámica o estática. Si
utiliza esta opción, los demás símbolos a la derecha
(nombreComponenteElementoDatos, tipoPrimitivo y
demás) hacen referencia a cada elemento de la matriz.
- componenteFunción
- Una función incorporada. Para conocer detalles sobre la sintaxis, consulte
Componente de función en formato fuente EGL.