Dinaup DocsRoles de campo
El catálogo del enum RoleFieldE: qué máscara pone cada rol sobre un formato de campo y cuáles se crean desde FlexHub con un tipo preparado.
Un rol es la máscara de un campo: sobre un formato físico (texto, decimal, fecha) define qué es ese dato, cómo se valida, cómo se muestra y, en un texto, cuánto mide la columna. Es el enum RoleFieldE del SDK. El valor Genérico (Ordinario, 0) es un campo sin máscara.
Antes de empezar
- El rol se elige al crear el campo y no se cambia después: junto con el formato determina el tipo de la columna. Ver Campos.
- Desde FlexHub, el rol se elige con un tipo preparado en la ventana ¿Qué tipo de campo?, que abre cada fila de Nuevos campos en Diseñando la ficha. Desde el SDK, con el número del enum en el patch de
Flex_CreateObjectAsync.
Los tipos preparados de FlexHub
FlexHub ofrece 22 combinaciones de formato y rol:
| Tipo preparado | Formato | Rol (RoleFieldE) |
|---|---|---|
| Texto | Texto | Ordinario |
| Multilínea | Texto | TextoLargo |
| Entero | Entero | Ordinario |
| Decimal | Decimal | Ordinario |
| Moneda | Decimal | Moneda |
| Sí/No | Sí/No | Ordinario |
| Fecha | Fecha | Ordinario |
| Fecha y hora | Fecha y hora | SinSegundos |
| Hora | Hora | SinSegundos |
| Relación | Relación | Ordinario |
| Texto | CorreoElectronico (la columna se queda en 60 caracteres) | |
| Web | Texto | Web (100 caracteres) |
| Teléfono | Texto | Telefono |
| NIF/CIF | Texto | NifCif |
| Contraseña | Texto | Pass |
| Texto con formato | Texto | HTML_Editor |
| Porcentaje | Decimal | Porcentaje |
| Horas | Decimal | Horas |
| Minutos | Decimal | Minutos |
| Segundos | Decimal | Segundos |
| Contenedor | Botón | Ordinario, con renderizado Contenedor |
| Botón | Botón | Ordinario |
Los demás roles del catálogo existen en el servidor y en los módulos Ready To Go, y se leen igual desde FlexHub; para crearlos hace falta el SDK.
Presentación e interacción
| Rol | Valor | Rótulo | Qué hace |
|---|---|---|---|
Ordinario | 0 | Genérico | Sin máscara. |
Web | 1 | Web | Una dirección de internet. Se abre en el navegador. |
Telefono | 2 | Teléfono | Un número de teléfono. |
CorreoElectronico | 4 | Un correo electrónico. | |
Moneda | 5 | Moneda | Un importe con su símbolo. |
Porcentaje | 6 | Porcentaje | Un tanto por ciento. |
Icono | 7 | Icono | Un icono. |
Icono_Color | 19 | Icono Color | Un icono con color. |
Imagen | 17 | Imagen | Una imagen, con vista previa. |
Archivo | 8 | Archivo | Un fichero adjunto. |
Pass | 10 | Contraseña | El texto se oculta al escribirlo. |
ColorHex | 29 | Color | Un color en hexadecimal. |
AsistenteURL | 149 | Asistente URL | Un texto que guarda una URL con ayuda para construirla. |
ReferenciaPistola | 12 | Referencia Pistola | Un código para leer con un lector de códigos de barras. |
keyword | 100 | KeyWord | Una palabra clave. |
Texto
| Rol | Valor | Rótulo | Qué hace |
|---|---|---|---|
Texto60 | 13 | Texto 60 | Texto acotado a 60 caracteres. |
TextoLargo | 9 | Multilinea (512) | Área de varias líneas, 512 caracteres. Es el rol del tipo preparado Multilínea. |
TextoLargo2048 | 50 | Multilinea (2048) | 2.048 caracteres. |
TextoLargo4096 | 51 | Multilinea (4096) | 4.096 caracteres. |
Varchar8000 | 16 | Texto 8.000 | 8.000 caracteres. |
HTML | 65 | HTML | Contenido HTML. |
HTML_Editor | 140 | HTML (Editor) | HTML con editor de negritas, listas y enlaces. |
Número, tiempo y medida
| Rol | Valor | Rótulo | Qué hace |
|---|---|---|---|
Preciso | 11 | Precisión Avanzada | Más decimales de los habituales. |
Año | 25 | Año | Un año. En un entero, el control se crea pequeño. |
Horas | 15 | Horas | Una duración en horas. |
Minutos | 14 | Minutos | Una duración en minutos. |
Segundos | 33 | Segundos | Una duración cuya unidad es el segundo. |
Milisegundos | 34 | Milisegundos | Una duración cuya unidad es el milisegundo. |
ConSegundos | 21 | Con segundos | Una fecha y hora o una hora que muestra los segundos. |
SinSegundos | 22 | Sin segundos | Una fecha y hora o una hora sin segundos. Es el rol de los tipos preparados Fecha y hora y Hora. |
Cronometro | 150 | Cronometro | Un tiempo medido a modo de cronómetro. |
Byesx | 26 | Bytes | Un tamaño en bytes. |
Megabytesx | 27 | Megabytes | Un tamaño en megabytes. |
Gigabytex | 28 | Gigabytes | Un tamaño en gigabytes. |
Fiscales y contables
| Rol | Valor | Rótulo | Qué hace |
|---|---|---|---|
NifCif | 79 | NIF/CIF | Un identificador fiscal. |
TipoNIFCif | 87 | Tipo NIF/CIF | El tipo de identificador fiscal. |
CodigoDeCuentaBancaria | 76 | Código de cuenta (CCC) | Una cuenta bancaria en formato CCC. |
CodigoDeCuentaIBAN | 119 | Código de cuenta IBAN | Una cuenta bancaria en formato IBAN. |
CCC_SeguridadSocial | 122 | CCC SeguridadSocial | Un código de cuenta de cotización de la Seguridad Social. |
Territorialidad_Pais_Texto | 83 | Territorialidad - Pais Texto | El país, como texto. |
Territorialidad_Provincia_Texto | 84 | Territorialidad - Provincia Texto | La provincia, como texto. |
Territorialidad_CodigoPais | 85 | Territorialidad - Cod. País | El código del país. |
Territorialidad_CodProvincia | 86 | Territorialidad - Cod. Provincia | El código de la provincia. |
ClaveOperacionIntraComunitaria | 89 | Clave operación intracomunitaria | La clave de una operación intracomunitaria. |
CodigoSubcuenta | 54 | Código Subcuenta | El código de una subcuenta contable. |
CodigoCuenta | 59 | Código Cuenta contable | El código de una cuenta contable. |
Los roles fiscales definen el formato esperado del dato. La comprobación contra un registro oficial la hace el proceso que lo usa, no el rol.
Fechas del registro y especiales
| Rol | Valor | Rótulo | Qué hace |
|---|---|---|---|
FechaPrincipal | 69 | Fecha Principal | La fecha que actúa como fecha de referencia del registro. |
FechaPrincipalRegulador | 103 | Regular manual Fecha Principal | Regula a mano la fecha principal. |
DatosSerializados | 77 | Datos serializados | Datos estructurados serializados. |
CondicionesCM | 30 | Condiciones CM | Condiciones escritas como cadena mágica, que interpreta el motor. |
Enumeraciones
Los valores Enum_* de RoleFieldE (del 23 al 158, no consecutivos) convierten un campo Entero en un desplegable cerrado cuyas opciones publica el servidor. Algunos: Enum - Mes (24), Enum - Día de la semana (23), Enum - Género (45), Enum - Tramitación (48), Enum - Régimen de IVA (94) y Enum - Tipo de Nómina (129). El resto son los estados de los módulos Ready To Go.
Los valores de cada enum se piden con Flex_GetFieldEnumAsync(fieldId) o Flex_GetEnumAsync(enumName). El nombre del enum de una columna viaja en FlexEditableDTO.EnumName.
Siguiente: Algoritmos.