Dinaup DocsRoles de campo
Especializa cómo se comporta y se muestra un campo según su contenido real, sin cambiar su tipo base.
Un rol especializa cómo se comporta y se muestra un campo según lo que guarda dentro. No crea un tipo nuevo: parte del tipo base del campo (texto, número, fecha…) y le añade un comportamiento, un formato de presentación y, a veces, validaciones acordes a lo que representa.
Piensa en un campo de texto: con rol Email lo muestra como un enlace mailto:, con rol Teléfono lo prepara para llamar, con rol IBAN lo trata como una cuenta bancaria. El dato sigue siendo texto; el rol decide cómo se presenta y qué se espera de él.
Tipo vs rol. El tipo define qué clase de dato guarda el campo (texto, número, fecha). El rol afina cómo se interpreta y se enseña ese dato. Eliges primero el tipo y luego, si encaja, el rol.
Por qué usar un rol
Un mismo tipo de dato puede significar cosas muy distintas. Un número puede ser dinero, un porcentaje, un peso o una cantidad de bytes. Un texto puede ser un correo, una matrícula o un NIF. El rol cierra esa ambigüedad y te da tres ventajas:
- Presentación correcta: el valor se muestra con el símbolo, el formato o el icono que le corresponde (€, %, MB, un enlace clicable).
- Interacción adecuada: un email abre el cliente de correo, un teléfono inicia la llamada, una web abre el navegador.
- Validación coherente: roles como NIF/CIF o IBAN dan por hecho que el contenido sigue un formato concreto.
Elegir bien el rol es lo que hace que un registro se entienda sin que nadie tenga que interpretar el dato en bruto.
Presentación
Roles que cambian cómo se muestra el valor o cómo se interactúa con él. La mayoría parten de un campo de texto o número.
| Rol | Para qué sirve |
|---|---|
| Ordinario | Comportamiento estándar, sin especialización. El valor se muestra tal cual. |
| Web | Una dirección de internet. Se presenta como enlace que abre el navegador. |
| Teléfono | Un número de teléfono, preparado para llamar. |
| Skype | Un identificador de Skype. |
Un correo electrónico. Se muestra como enlace mailto:. | |
| Moneda | Un importe monetario, con su símbolo de moneda. |
| Porcentaje | Un valor expresado en tanto por ciento (%). |
| Icono | El campo representa un icono. |
| Icono Color | Un icono con color asociado. |
| Imagen | Una imagen, que se previsualiza. |
| Archivo | Un fichero adjunto. |
| Contraseña | Un valor sensible, que se oculta al mostrarlo. |
Medida y precisión
Roles para números que representan magnitudes, tiempos o tamaños. Definen la unidad y la precisión con la que se trabaja el valor.
| Rol | Para qué sirve |
|---|---|
| Preciso | Número con precisión avanzada (más decimales de los habituales). |
| Horas | Una duración expresada en horas. |
| Minutos | Una duración en minutos. |
| Segundos | Una duración en segundos. |
| Milisegundos | Una duración en milisegundos. |
| Bytes | Un tamaño de datos en bytes. |
| Megabytes | Un tamaño en megabytes. |
| Gigabytes | Un tamaño en gigabytes. |
| Gramos | Un peso en gramos. |
| Cronómetro | Un tiempo medido a modo de cronómetro. |
| Ratio | Una proporción o relación entre dos magnitudes. |
| Texto 60 | Un texto acotado a una longitud corta (60 caracteres). |
Fiscales y de legislación
Roles pensados para datos con un formato legal o contable definido. Asumen que el contenido sigue las reglas del dato que representan.
| Rol | Para qué sirve |
|---|---|
| NIF/CIF | Un identificador fiscal (NIF o CIF). |
| Tipo NIF/CIF | El tipo de identificador fiscal asociado. |
| CCC | Un código de cuenta de cliente bancaria (formato CCC). |
| IBAN | Una cuenta bancaria en formato IBAN. |
| Territorialidad - País | Un país a efectos de territorialidad fiscal. |
| Territorialidad - Provincia | Una provincia a efectos de territorialidad fiscal. |
| Clave operación intracomunitaria | La clave que identifica una operación intracomunitaria. |
| Código subcuenta | El código de una subcuenta contable. |
| Código cuenta contable | El código de una cuenta contable. |
Los roles fiscales no sustituyen a la validación oficial de un organismo: definen el formato esperado del dato. La comprobación contra registros externos depende del proceso de negocio, no del rol del campo.
Texto
Roles para campos de texto que necesitan más espacio o formato enriquecido que una línea simple.
| Rol | Para qué sirve |
|---|---|
| Multilínea | Texto en varias líneas (área de texto). |
| Texto largo | Un bloque de texto extenso. |
| HTML | Contenido en formato HTML. |
| HTML (Editor) | Contenido HTML con un editor enriquecido para redactarlo. |
Especiales
Roles para casos concretos que no encajan en las familias anteriores.
| Rol | Para qué sirve |
|---|---|
| Referencia Pistola | Un código pensado para leerse con pistola de códigos de barras. |
| Año | Un año (valor temporal acotado). |
| Color Hex | Un color en formato hexadecimal. |
| Fecha Principal | La fecha que actúa como fecha de referencia del registro. |
| Datos serializados | Un valor que guarda datos estructurados serializados. |
| Condiciones de cadena mágica | Define condiciones mediante una cadena de texto interpretada por el sistema. |
| Asistente URL | Un campo de texto que almacena una URL con ayuda para construirla. |
Cómo encaja un rol con el resto de Flex
El rol es una propiedad del campo, así que vive dentro de la definición de la sección:
- Se elige al configurar un campo, después de fijar su tipo base.
- Afecta a cómo se presenta el valor en formularios, fichas e informes, no a cómo se almacena.
- Cuando un algoritmo calcula el valor de un campo, el rol determina cómo se muestra ese resultado (un importe en €, un porcentaje, un tamaño en MB).
Cambiar el rol de un campo que ya tiene datos altera cómo se interpretan esos valores. Si el contenido no encaja con el nuevo rol (por ejemplo, pasar a IBAN un texto que no es una cuenta), la presentación dejará de tener sentido. Cambia el rol con criterio y revisa los registros existentes.
Preguntas frecuentes
→ Campos → Secciones → Algoritmos