Esta documentación está en fase de desarrollo y puede contener errores.

Campos

Las columnas de una sección de Flex. Elige un tipo base, afínalo con un rol, y añade validaciones, valores por defecto y cálculos.

Un campo es una columna de una sección. Define qué dato guarda cada registro y cómo se comporta: su tipo, sus validaciones, su valor por defecto, sus cálculos automáticos y sus relaciones con otras secciones.

Para configurar un campo eliges dos cosas: un tipo base (qué clase de dato es) y, encima, un rol opcional que lo afina (cómo se valida, se formatea y se muestra). Es la diferencia entre decir "esto es texto" y decir "esto es texto, y además es un email".


Tipos base

El tipo base es la decisión de fondo: qué naturaleza tiene el dato. Hay 8 tipos base y cada campo es exactamente uno de ellos.

Tipo basePara qué sirveEjemplos
TextoUna línea de texto libreNombre, referencia, email, NIF
Texto MultilíneaTexto largo en varias líneasDescripción, observaciones, notas
Número decimalNúmero con decimalesImporte, precio, peso, porcentaje
Número enteroNúmero sin decimalesCantidad, unidades, contador
Sí/NoUn valor de dos estadosActivo, pagado, enviado
FechaUn día concreto, sin horaFecha de vencimiento, de nacimiento
Fecha y HoraUn instante con día y horaMomento de un evento, de una firma
HoraUna hora del día, sin fechaHora de apertura, de un fichaje

Los campos Fecha y Hora se guardan siempre en UTC. Al mostrarlos en pantalla, Dinaup los convierte a la zona horaria de cada usuario.

Además de estos 8, existe un tipo especial de Relación, que enlaza un registro con otro de otra sección (lo tienes más abajo, en Relaciones entre secciones).


Tipo base frente a rol

El tipo base dice qué es el dato. El rol dice cómo se comporta dentro de ese tipo: qué formato muestra, qué valida y con qué control lo editas. Un mismo tipo base admite muchos roles.

Piénsalo en dos capas:

Eliges el tipo base

Decides la naturaleza del dato. Por ejemplo, Texto.

Le pones un rol encima

Afinas ese texto. Con el rol Email validas que tenga forma de correo; con Teléfono lo formateas y lo haces pulsable; con Web validas y enlazas la URL.

Algunos roles típicos para que veas el patrón:

Tipo baseRoles de ejemploQué aportan
TextoEmail, Teléfono, Web, NIF/CIF, Color, IBANValidan el formato y lo presentan de forma adecuada
Número enteroPorcentaje, Moneda, Año, unidades de tiempoCambian cómo se muestra y se interpreta el número
Número decimalPorcentaje, Moneda, Latitud/LongitudFormato monetario, porcentual o de coordenadas

El catálogo completo de roles de cada tipo base (con su validación y su forma de presentación) vive en la referencia técnica de Flex. Consúltala en doc-flex.dinaup.com.


Atributos de un campo

Más allá del tipo y el rol, cada campo tiene atributos que controlan si es obligatorio, editable o visible:

AtributoQué hace
ObligatorioEl registro no se puede guardar si el campo está vacío
BloqueadoSolo lectura. Su valor lo pone el sistema o un cálculo, no el usuario
OcultoNo aparece en la interfaz por defecto
Auto-calculadoSu valor se obtiene de un algoritmo, no se escribe a mano

Valores por defecto

Un campo puede arrancar con un valor predefinido cuando se crea un registro nuevo:

  • Valor fijo: un texto, número o fecha concreto siempre igual.
  • Valor dinámico: se calcula en el momento del alta a partir del usuario actual, la fecha de hoy u otros campos del propio registro.

Autorrellenado

Los campos de Relación pueden completar otros campos al elegir un registro relacionado. Por ejemplo, al seleccionar un cliente en una factura, su NIF, su dirección fiscal y sus condiciones de pago se rellenan solos.

Así reduces tecleo y evitas que el mismo dato se introduzca de dos formas distintas.


Relaciones entre secciones

Un campo de Relación enlaza un registro con otro de otra sección. Es lo que conecta tu modelo de datos. Con relaciones puedes:

  • Navegar de una factura al cliente asociado.
  • Sumar las líneas de una factura con un algoritmo cruzado.
  • Cruzar datos de varias secciones en un mismo informe.

Cuando una Relación no apunta a nada, se guarda como cadena vacía, no como ausencia de valor. Tenlo en cuenta al filtrar "relaciones vacías" en informes o algoritmos.


Preguntas frecuentes


SeccionesAlgoritmosInformesReferencia técnica de campos (doc-flex.dinaup.com)

On this page