setError()

La función del sistema SysLib.setError asocia un mensaje con un campo de un PageHandler o un VGUIRecord o con la totalidad de un PageHandler:
  • Si un PageHandler invoca la función, el mensaje se sitúa en la ubicación de un mensaje o de un código de mensajes en el JSP.
  • Si un programa de tipo VGWebTransaction invoca la función, el mensaje se coloca en la ubicación del código de font en el JSP.

El mensaje se visualiza cuando se visualiza la página Web relacionada.

Si una función de validación invoca SysLib.setError, la página Web vuelve a visualizarse automáticamente cuando finaliza la función.

La primera de las tres sintaxis siguientes está disponible en los PageHandler o en los programas de tipo VGWebTransaction, mientras que la segunda y la tercera solo están disponibles para los PageHandler:

  SysLib.setError(
    campoErróneo anyPageField in,
    claveMsj STRING in
    {, campoInserción sysLibFieldInsert in})
  SysLib.setError(
    this enumerationThis in,
    claveMsj STRING in
    {, campoInserción sysLibFieldInsert in})
  SysLib.setError(textoMsj STRING in)
campoErróneo
Si SysLib.setError se emite desde un PageHandler, campoErróneo es un campo del PageHandler.

Si SysLib.setError se emite desde un programa, campoErróneo es un campo del registro que se especifica en la sentencia show o converse.

this
Hace referencia al PageHandler desde el que se emite SysLib.setError. En este caso, el mensaje no es específico de un campo, sino que está asociado con la totalidad del PageHandler. Para obtener detalles acerca de this, consulte el apartado Referencias a variables y constantes.
claveMsj
Un campo o literal de carácter (tipo CHAR o MBCHAR) que proporciona la clave en el empaquetamiento de recursos de mensaje o archivo de propiedades utilizado durante la ejecución. Si la clave está en blanco, el mensaje es una concatenación de inserciones de mensaje.
campoInserción
El campo o literal de carácter incluido como inserción en el mensaje de salida. El símbolo de sustitución del texto de mensaje es un entero entre corchetes, como el de este ejemplo:
  Nombre de archivo no válido {0}
textoMsj
El campo o literal de carácter que puede especificar si no especifica otros argumentos. El texto se asocia a la totalidad de la página.

Puede asociar varios mensajes a un campo o al PageHandler. Los mensajes se pierden si se reenvía el control; específicamente, si PageHandler ejecuta una sentencia forward o si el programa VGWebTransaction ejecuta una sentencia transfer.

Consulta relacionada
Biblioteca SysLib de EGL
forward

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