Las propiedades de validación limitan lo aceptable cuando el usuario especifica datos en un formulario de texto.
La propiedad fill indica si es necesario que el usuario especifique datos en cada posición de campo. Los valores válidos son no (el valor por omisión) y sí.
La propiedad inputRequired indica si es necesario que el usuario especifique datos en el campo. Los valores válidos son no (el valor por omisión) y sí.
Si el usuario no coloca datos en el campo cuando el valor de propiedad es sí, el entorno de ejecución de EGL visualiza un mensaje, como se describe en relación con la propiedad de campo inputRequiredMsgKey.
La propiedad inputRequiredMsgKey identifica el mensaje que se visualiza si la propiedad de campo inputRequired se establece como sí y el usuario no coloca datos en el campo.
La tabla de mensajes (la tabla de datos que contiene el mensaje) está identificada en la propiedad del programa msgTablePrefix. Encontrará los detalles sobre el nombre de tabla de datos en el apartado Componente DataTable en formato fuente EGL.
El valor de inputRequiredMsgKey es una serie o literal que coincide con una entrada de la primera columna de la tabla de mensajes.
Si se utiliza una clave numérica con una tabla de mensajes que espera una clave de caracteres, el número se convierte a una serie de caracteres. Si se utiliza un literal de serie con una tabla de mensajes que espera una clave numérica, el valor de la serie debe ser un entero con firma o sin firma.
0123456789
Los valores válidos son no (el valor por omisión) y sí.
Esta propiedad solamente es aplicable a campos de caracteres.
0123456789abcdefABCDEF
Los valores válidos son no (el valor por omisión) y sí.
Esta propiedad solamente es aplicable a campos de caracteres.
La propiedad minimumInput indica el número mínimo de caracteres que el usuario debe especificar en el campo, si el usuario especifica datos en el campo. El valor por omisión es 0.
Si el usuario especifica menos caracteres que el número mínimo, el entorno de ejecución de EGL visualiza un mensaje, como se describe en relación con la propiedad de campo minimumInputMsgKey.
La tabla de mensajes, la tabla que contiene el mensaje, está identificada en la propiedad del programa msgTablePrefix. Encontrará los detalles sobre el nombre de tabla en Componente DataTable en formato fuente EGL.
El valor de minimumInputMsgKey es una serie o literal que coincide con una entrada de la primera columna de la tabla de mensajes.
Si se utiliza una clave numérica con una tabla de mensajes que espera una clave de caracteres, el número se convierte a una serie de caracteres. Si se utiliza un literal de serie con una tabla de mensajes que espera una clave numérica, el valor de la serie debe ser un entero con firma o sin firma.
La propiedad needsSOSI sólo se utiliza para un campo multibyte (un campo de tipo MBCHAR) e indica si EGL realiza una comprobación especial cuando el usuario especifica datos de tipo MBCHAR en un dispositivo ASCII. Los valores válidos son yes (el valor por omisión) y no. La comprobación determina si la entrada puede convertirse adecuadamente al formato SO/SI.
La propiedad resulta útil ya que, durante la conversión, se suprimen los blancos de cola del final de una serie multibyte para permitir la inserción de delimitadores SO/SI en cada subserie de caracteres de doble byte. Para una correcta conversión, el campo de formulario debe tener al menos dos blancos para cada serie de doble byte en el valor multibyte.
Si se establece needsSOSI en no, el usuario puede rellenar el campo de entrada, en cuyo caso la conversión trunca los datos sin aviso.
Establezca needsSOSI en yes si la entrada ASCII de datos multibyte del usuario puede utilizarse en un sistema z/OS o iSeries.
La propiedad typeChkMsgKey identifica el mensaje que se visualiza si los datos de entrada no son adecuados para el tipo de campo.
La tabla de mensajes, la tabla que contiene el mensaje, está identificada en la propiedad del programa msgTablePrefix. Encontrará los detalles sobre el nombre de tabla en Componente DataTable en formato fuente EGL.
El valor de typeChkMsgKey es una serie o literal que coincide con una entrada de la primera columna de la tabla de mensajes.
Si se utiliza una clave numérica con una tabla de mensajes que espera una clave de caracteres, el número se convierte a una serie de caracteres. Si se utiliza un literal de serie con una tabla de mensajes que espera una clave numérica, el valor de la serie debe ser un entero con firma o sin firma.
Todas las comprobaciones preceden al uso de la propiedad validatorFunction, que especifica una función de validación que realice validación entre valores.
Si la validación falla, el mensaje visualizado se basa en el valor de la propiedad validatorDataTableMsgKey.
La propiedad validatorDataTableMsgKey (antes la propiedad validatorTableMsgKey) identifica el mensaje que se visualiza si el usuario proporciona datos que no corresponden a los requisitos de la tabla de validadores, que es la tabla especificada en la propiedad validatorDataTable.
La tabla de mensajes, la tabla que contiene el mensaje, está identificada en la propiedad del programa msgTablePrefix. Encontrará los detalles sobre el nombre de tabla de mensajes en Componente DataTable en formato fuente EGL.
El valor de validatorDataTableMsgKey es una serie o literal que coincide con una entrada de la primera columna de la tabla de mensajes.
Si se utiliza una clave numérica con una tabla de mensajes que espera una clave de caracteres, el número se convierte a una serie de caracteres. Si se utiliza un literal de serie con una tabla de mensajes que espera una clave numérica, el valor de la serie debe ser un entero con firma o sin firma.
Las comprobaciones elementales preceden al uso de la tabla de validadores (como se describe en relación con la propiedad validatorDataTable) y todas las comprobaciones preceden al uso de la propiedad validatorFunction. Este orden de eventos es importante ya que la función de validador puede realizar la comprobación entre campos y dicha comprobación requiere a menudo valores de campo válidos.
El valor de validatorFunction es una función de validación escrita por el usuario. Esta función se codifica sin parámetros y de modo que, si detecta un error, solicita la revisualización del formulario invocando la función ConverseLib.validationFailed.
Si la validación falla al especificar una de las dos funciones del sistema, el mensaje visualizado se basa en el valor de la propiedad validatorFunctionMsgKey. Si, no obstante, la validación falla al especificar una función de validador propia, la función no utiliza validatorFunctionMsgKey, sino que visualiza un mensaje invocando ConverseLib.validationFailed.
La tabla de mensajes, la tabla que contiene el mensaje, está identificada en la propiedad del programa msgTablePrefix. Encontrará los detalles sobre el nombre de tabla en Componente DataTable en formato fuente EGL.
El valor de validatorFunctionMsgKey es una serie o literal que coincide con una entrada de la primera columna de la tabla de mensajes.
Si se utiliza una clave numérica con una tabla de mensajes que espera una clave de caracteres, el número se convierte a una serie de caracteres. Si se utiliza un literal de serie con una tabla de mensajes que espera una clave numérica, el valor de la serie debe ser un entero con firma o sin firma.
validValues = literalMatriz
validValues = [ [1,3], 5, 12 ] validValues = [ "a", ["bbb", "i"]]
// los valores válidos son 1, 2, 3, 5, 7, 9 y 11 validValues = [[1, 3], 5, 7, 11] // los valores válidos son las letras "a" y "z" validValues = ["a", "z"] // los valores válidos son las series que empiezan por "a" validValues = [["a", "a"]] // los valores válidos son cualquier serie // que empiece por una letra minúscula validValues = [["a", "z"]]
Si la entrada del usuario no está dentro del rango especificado, el entorno de ejecución de EGL visualiza un mensaje, como se describe en relación con la propiedad de campo validValuesMsgKey.
La propiedad validValuesMsgKey (antes la propiedad rangeMsgKey) identifica el mensaje que se visualiza si se ha establecido la propiedad de campo validValues y el usuario especifica datos fuera de rango en el campo.
La tabla de mensajes, la tabla que contiene el mensaje, está identificada en la propiedad del programa msgTablePrefix. Encontrará los detalles sobre el nombre de tabla en Componente DataTable en formato fuente EGL.
El valor de validValuesMsgKey es una serie o literal que coincide con una entrada de la primera columna de la tabla de mensajes.
Si se utiliza una clave numérica con una tabla de mensajes que espera una clave de caracteres, el número se convierte a una serie de caracteres. Si se utiliza un literal de serie con una tabla de mensajes que espera una clave numérica, el valor de la serie debe ser un entero con firma o sin firma.
Esta propiedad solamente es aplicable a campos numéricos.
Conceptos relacionados
Formularios de texto