Tipos de campo y ajustes
Qué tipos de campos personalizados hay, qué ajustes tiene cada tipo y qué límites se aplican
Última actualización el
Al crear un campo eliges un tipo. Después ya no puedes cambiarlo. Bajo 2. Ajustes están las opciones de ese tipo. Todas las opciones son opcionales, salvo que se indique otra cosa más abajo.
En casi todos los tipos también puedes rellenar un Mensaje de error. Sustituye al mensaje estándar cuando un valor no es correcto. Con Texto de ejemplo decides qué aparece en el campo de entrada vacío.
Texto y Texto largo
Texto es una línea, Texto largo varias líneas.
| Ajuste | Qué hace |
|---|---|
| Longitud mínima y Longitud máxima | El número de caracteres. Sin máximo se aplican 1.000 caracteres en Texto y 10.000 en Texto largo |
| Formato | Texto libre, Correo electrónico, Número de teléfono, Dirección web, IBAN, Código postal, Solo dígitos o Patrón personalizado |
| Patrón (expresión regular) | Con Patrón personalizado. Todo el valor debe coincidir. Tillor rechaza los patrones con repeticiones anidadas o referencias hacia atrás y los patrones de más de 200 caracteres |
Número e Importe
Importe usa la moneda de tu organización.
| Ajuste | Se aplica a | Qué hace |
|---|---|---|
| Mínimo y Máximo | Número, Importe | Límite inferior y límite superior |
| Solo números enteros | Número | No se permiten decimales |
| Visualización | Número, solo con números enteros | Campo de entrada o Contador (− / +) con botones |
| Incremento | Número | El valor debe ser el mínimo (o 0) más un número entero de incrementos |
| Decimales máximos | Número | Limita los decimales |
Sí / no
Un interruptor de activado/desactivado. Con Debe estar marcada, el registro solo se puede guardar con la casilla activada. Útil para un consentimiento.
Fecha
| Ajuste | Qué hace |
|---|---|
| Fecha más temprana y Fecha más tardía | Límites fijos |
| No en el pasado y No en el futuro | Se comparan con hoy en la zona horaria de tu organización |
| A menos de días de hoy | Como máximo tantos días antes o después de hoy |
Opción y Opción múltiple
Eliges una lista de opciones. Opción guarda una opción, Opción múltiple varias. En Opción múltiple configuras Mínimo seleccionado y Máximo seleccionado. Una lista tiene un máximo de 200 opciones.
Enlace a registro
El campo apunta a otro registro de Tillor.
| Ajuste | Qué hace |
|---|---|
| Enlaza con | Cliente, Parcela, Ocupación, Contador, Tarea, Factura, Reserva, Informe de pago, Llamada telefónica, Persona de contacto, Producto, Armario de contadores, Pago, Documento, Etiqueta NFC o Método de acceso |
| Varios registros | Permite más de un registro vinculado. Entonces también puedes configurar un mínimo y un máximo |
| Visualización | Lista de opciones o Desplegable (una lista única con búsqueda) |
| Solo los registros de este cliente | Limita las opciones a los registros del cliente que estás editando. Solo en Persona de contacto, Factura, Reserva, Ocupación, Pago, Documento, Etiqueta NFC y Método de acceso |
| Solo registros de la parcela | Limita las opciones a los contadores de la parcela: en una ocupación, la parcela de esa ocupación; en una parcela, la propia parcela. Solo en Contador. No puedes guardar un contador de otra parcela |
| Filtrar opciones | TypeScript opcional que decide, para cada opción, si aparece en la lista, consulta Filtrar opciones. En Persona de contacto, Producto, Armario de contadores, Pago, Documento, Etiqueta NFC, Método de acceso, Factura, Reserva, Ocupación, Contador y Parcela |
Si un registro vinculado se elimina más tarde, el campo muestra Eliminado.
Si hay al menos 50 registros entre los que elegir, primero escribes 2 caracteres para buscar. Si son menos, como los contadores de una sola parcela, los ves todos de inmediato.
Filtrar opciones
Con Filtrar opciones decides tú qué registros ofrece el campo. Escribes TypeScript, como en la fórmula de tarifa, que Tillor ejecuta para cada opción. Si devuelve true, la opción aparece en la lista; si no, no.
En el filtro lees campos con llaves. El menú Variable muestra lo que hay, incluidos los campos personalizados:
| Variable | Qué es |
|---|---|
{option.…} | El registro que podrías elegir, por ejemplo {option.type} o {option.terrainId} en un contador |
{occupation.…}, {terrain.…}, … | El registro que estás editando, con el nombre de su tipo, con customFields para sus campos propios |
Ejemplo: solo contadores de electricidad de la parcela de la ocupación.
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};Etiquetas propias
El mismo filtro también puede decidir cómo se llama una opción en la lista. Lo que devuelvas determina el resultado:
| Devuelves | Resultado |
|---|---|
true | La opción está en la lista con su propio nombre |
false, null o un texto vacío | La opción no está en la lista |
| Un texto | La opción está en la lista con ese texto |
{ label, group } | La opción recibe esa etiqueta y se coloca bajo el encabezado group. Ambos son opcionales |
Ejemplo: solo contadores de ICY e Hydrodigit, con el tipo incluido y agrupados por proveedor.
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };La etiqueta vale en la lista de opciones y en los chips elegidos del formulario. En los lugares que solo muestran el valor, como la página de detalle o una exportación, aparece el nombre propio del registro.
Insertar ejemplo bajo el campo da un punto de partida. Un filtro que no compila no se puede guardar; el mensaje bajo el campo dice qué falla.
El filtro no solo limita la lista. Si eliges mediante la API o un formulario antiguo un registro que el filtro omite, Tillor rechaza el guardado indicando el nombre del campo. Las automatizaciones y las importaciones no se comprueban, igual que pueden rellenar campos ocultos.
Grupo de campos
Un conjunto fijo de subcampos que aparecen juntos en el formulario, como Perros y Otros animales bajo Animales.
| Ajuste | Qué hace |
|---|---|
| Añadir subcampo | Cada subcampo tiene una etiqueta, un tipo y ajustes propios. Haz clic en Más para la clave, el ancho y las condiciones. Un grupo puede tener un máximo de 30 subcampos |
| Visualización | Marco (con borde) o En línea (los campos continúan en el formulario) |
| Columnas | De 1 a 4 |
| Ancho en el grupo | Cuántas columnas ocupa cada subcampo |
Filas repetidas
Una tabla a la que añades filas con Añadir fila, por ejemplo varios vehículos. Configuras los subcampos como en un grupo. Con Filas mínimas y Filas máximas limitas la lista. Sin máximo se aplican 100 filas, y no puede haber más de 500.
Un grupo o unas filas repetidas pueden contener, un nivel más abajo, otro grupo u otras filas repetidas, pero no más allá.
Archivos
Para documentos y fotos. Un archivo que subes solo lo puede abrir quien puede ver el campo.
| Ajuste | Qué hace |
|---|---|
| Varios archivos | Permite más de un archivo |
| Archivos mínimos y Archivos máximos | Sin máximo se aplican 20 archivos, y no puede haber más de 50 |
| Tamaño máximo por archivo (MB) | Un máximo de 50 MB por archivo, aunque quieras un valor más alto |
| Tipos de archivo permitidos | Cualquier archivo, Imágenes, PDF, Documentos de Office, o una extensión propia como .dwg o un tipo MIME como application/zip |
Tillor comprueba el tipo según el contenido del archivo, no solo según el nombre.
JSON
Pensado para datos estructurados que aporta una integración con otro sistema. Tus compañeros rara vez lo rellenan en el formulario. Con Tamaño máximo (KB) configuras un límite, por defecto 64 KB y como máximo 256 KB.
Ajustes para cada tipo
| Ajuste | Qué hace |
|---|---|
| Cifrar este valor | Guarda el valor cifrado. Un campo cifrado no se puede buscar, filtrar ni ordenar y no está disponible como variable en las automatizaciones. Solo para campos de nivel superior, es decir, no para subcampos. Todos los campos personalizados se guardan cifrados de todos modos, actives esto o no |
| Solo API | Oculta el campo en los formularios y en las vistas de detalle. Una integración lo rellena mediante la API. Un campo así no puede ser obligatorio |
| Solo API, solo lectura | Muestra el campo, pero desactivado, para que tus compañeros vean el valor pero no lo cambien |
| Reglas de validación | Compara una fecha, un número o un importe con otro campo (Antes, En o antes de, Después, En o después de, con un desplazamiento en días, semanas o meses), o comprueba el valor con una expresión. Un máximo de 10 reglas por campo |
Un límite modificado no se aplica con carácter retroactivo. Un valor que no cambias no impide guardar el registro, aunque ya no cumpla la nueva regla.