Máscaras


Configuración de máscaras en campos de grillas


Para configurar las máscaras debe ingresar a la configuración del Tipo de Expediente, buscar el campo del tipo grilla que queremos configurar y seleccionar el botón para cargar la lista de columnas.




Ingrese a la pantalla de configuración de la grilla, en donde podrá crear nuevas columnas o modificar las existentes.




Los atributos que se pueden definir para una columna de la grilla son los siguientes:


Nombre: corresponde la clave con la que se identifica la columna.


Etiqueta o label: es el nombre que ve el usuario al trabajar con la grilla.


Longitud: representa el espacio en pixeles que ocupa la columna.


Máscara: permite determinar los valores de ingreso por teclado aceptado para cada carácter.


Validador: permite agregar una validación posterior a la carga del valor de la columna.


Clave: determina que la columna contiene un valor que representa la clave en una relación con otro subconjunto de Expedientes. Si es correcta permite la navegabilidad hacia el Expediente relacionado.


Ordenable: permite al usuario ordenar la grilla por esa columna.


Solo lectura: no permite la interacción a través del teclado.


Fecha: determina que la columna contiene fechas del tipo día/mes/año (dd/mm/yyyy).


Importe: determina que la columna contiene números decimales.


Sumarizable: determina lo que se visualiza en todo momento (en la cabecera), la sumatoria de los valores de la columna para todas las filas de la grilla.


Es importante remarcar que se mantienen los campos de selección para definir fecha e importe aunque no son necesarios si se pueden determinar con ER. Se realiza con fines de compatibilidad con versiones anteriores. 


Al seleccionar la fecha o el importe se inactivan "Máscara" y "Validador". La opción de "Sumarizar", siempre permanece seleccionable sin importar si la columna no es numérica, ya que se activa solo si encuentra valores numéricos no afectando el funcionamiento de la grilla si no los hubiera.



Máscara 

Tanto la máscara como el validador trabajan en un formato de expresión regular (a partir de aquí ER).


La diferencia radica en que la máscara debe determinar ER por cada caracter que permita ingresar y separarlos por “/,”.


Por ejemplo, si quiere permitir solamente Id tributario (00-00000000-0), el mismo puede contener solamente 11 dígitos numéricos. Luego de los dos primeros se coloca “-”, después 8 números, nuevamente ingresamos “-" y finalizamos con un número.


/[1-9]/,/\d/,-/,/\d/,/\d/,/\d/,/\d/,/\d/,/\d/,/\d/,/\d/,-/,/\d/


Cada posición inicia con la barra “/” lo que indica que esa posición es evaluada con una ER. Siguiendo el ejemplo ingresamos “[1-9]”, indicando que se puede cargar un valor de 1 a 9 solamente. Finalmente cerramos la posición con “/,” para indicar que pasamos a la siguiente posición.


En este ejemplo las siguientes posiciones ingresan también ER del tipo “\d” lo que significa un dígito de 0 a 9.


Es importante remarcar que en la tercera y doceava posición, simplemente queremos un guion medio (“-“), por lo cual no iniciamos esa posición con la barra “/” para indicar que es una ER. Lo que determinamos con esto es que simplemente permitimos el guion medio (“-“), en estas posiciones.




Validador

La función le permite validar todo el campo al salir del mismo. Hay ocasiones en donde es muy complejo definir una máscara, pero si se puede definir una ER integral. Permite alertar al usuario una vez cargado el valor.


Siguiendo con el ejemplo del Id tributario puede tener una expresión como la siguiente:


^(20|27|23|24|25|26|30)-\d\d\d\d\d\d\d\d-\d


La ER se traduce de la siguiente manera: Solo se puede iniciar con los valores 20, 27, 23, 24, 25, 26 y 30. Luego se ingresa “-“, posteriormente 8 dígitos del 0 al 9 y finalmente un “-“, con un dígito del 0 al 9 más.


Similar a la anterior, con la diferencia de agregar mayor control al permitir ciertos números al inicio.


No hay una sola ER para determinar un valor, sino que puede haber varias y debe determinar cual. Esto lo puede realizar ayudándose con https://regex101.com/




Precarga de Máscaras y Validadores

A medida que tenga tipos de campo conocidos, puede resguardarlos en Netcontent para ser utilizados en posteriores implementaciones.

 

Puede hacerlo cargando la tabla “NC_CamposMascaras”. Solamente se pueden cargar por base de datos.


[CampoMascaraId] es un campo auto numérico para darle un id unívoco a cada entrada.

[CampoTipo] es el identificador del tipo de campo para el cual definimos la máscara. Por el momento solo ‘Id tributario’, ‘Email’, etc. 


Este valor es presentado cuando no se cumpla con el formato, permitiéndole contextualizar la falla. Por ello, cuando utilizamos el valor se concatena al inicio de la ER.


Id tributario=>/[1-9]/,/\d/,-/,/\d/,/\d/,/\d/,/\d/,/\d/,/\d/,/\d/,/\d/,-/,/\d/


[CampoMascara] es la cadena de ER separadas por “/,”, como se vio con anterioridad.

[CampoValidador] es la cadena de ER, como se vio anteriormente.


Al tener sus expresiones cargadas previamente le facilita la definición de columnas y campos del Tipo de Expediente ya que se le presentan para ser utilizadas.





Son simples atajos ya que puede definir sus propias ER o editarlas.



Creado con el Personal Edition de HelpNDoc: Revoluciona tu revisión de documentación con Project Analyzer de HelpNDoc