➢setReadOnly
Esta función recibe como parámetro la referencia a un elemento de un formulario y un valor “booleano”. Como su nombre lo indica, “setea” el estado de sólo lectura del elemento html de acuerdo al valor “booleano”.
Esta función distingue automáticamente si se trata de:
-Un campo común.
-Un campo con combo.
-Un campo con autocompletar.
-Un campo de tipo archivo.
-Un campo de tipo imagen.
Entonces, en base a cada tipo de campo se realizan las acciones necesarias para que el mismo quede en modo “read-only” o no, según se indique.
Cuando el campo queda en modo “read-only”, los valores pasan a la siguiente servlet, a diferencia de lo que ocurre con campos deshabilitados (“disabled”).
➢replaceComboWithInput
En ocasiones es necesario mostrar el valor de un combo pero este no puede ser modificable. Lo ideal sería deshabilitarlo, pero es necesario tener en cuenta que el valor del combo no persistirá a menos que se genere un campo oculto con el valor.
Para evitar este procedimiento se ofrece esta función, la cual oculta el combo dejándolo habilitado y muestra en pantalla en su lugar un campo con la descripción del valor seleccionado en dicho combo. De esta forma, se conserva la vista del valor del combo, permanece no modificable y el valor del mismo es enviado, sin necesidad de funciones adicionales.
➢getNumericInputValue
Esta función permite recuperar el valor numérico de un campo del HTML sin necesidad de conocer si el mismo tiene o no edición formateada.
Como parámetros, recibe una referencia al campo, un valor por defecto en caso que el campo no tenga valor y un “booleano” que indica si se muestra o no mensaje de error.
Si hay error al recuperar el valor (porque el dato no es válido), la función devolverá “null”.
➢setNumericInputValue
Esta función hace la inversa de la función “getNumericInputValue”, es decir, informando la referencia al campo HTML y el valor numérico a insertar, se podrá “setear” un valor numérico para verse de manera formateada en el campo de edición formateada. Además recibe otros parámetros para indicar si lanza un error en caso que ocurra y también para definir si ejecuta o no el “onChange” (en caso de haber cambio de valor).
➢processIterative
Con esta función es posible recorrer todas las instancias del HTML de un iterativo del formulario para ejecutar alguna función sobre cada uno de ellos.
Recibe dos parámetros:
•“pCdIterativeName”, de tipo String. Se corresponde con el nombre de la estructura repetitiva a recorrer.
•“pIterativeFunction” hace referencia a una función que ejecuta por cada ocurrencia del iterativo. Recibe un único parámetro con la referencia al ítem HTML iterativo.
➢processIterativeV2
Esta función permite recorrer todas las instancias del HTML de un iterativo del formulario para ejecutar alguna función sobre cada uno de ellos.
“processIterativeV2” tiene más parámetros que la versión anterior de esta función, lo cual la hace más flexible y con un uso más sencillo para manejar el procesamiento del modelo oculto que tienen todos los iterativos.
Puede recibir cuatro parámetros:
•“pCdIterativeName”, de tipo String. Se corresponde con el nombre de la estructura repetitiva a recorrer.
•“pIterativeFunction” hace referencia a una función que ejecuta por cada ocurrencia del iterativo. Recibe un único parámetro con la referencia al ítem HTML iterativo.
•“pIterativeFunctionArguments” hace referencia a los parámetros que se le pueden pasar a la función que procesa los iterativos.
•“pInProcessHiddenModel” indica que, si el valor es “true”, la función se aplica al modelo iterativo oculto.
