Esta documentación ha sido traducida automáticamente por IA.
Validación de Campos
Para asegurar la precisión, seguridad y consistencia de los datos en sus colecciones, NocoBase ofrece la funcionalidad de validación de campos. Esta característica se divide principalmente en dos partes: la configuración de reglas y la aplicación de reglas.
Configuración de Reglas
Los campos del sistema de NocoBase integran las reglas de Joi, con el siguiente soporte:
Tipo Cadena de Texto (String)
Los tipos de cadena de texto de Joi corresponden a los siguientes tipos de campo de NocoBase: Texto de una línea, Texto largo, Número de teléfono, Correo electrónico, URL, Contraseña y UUID.
Reglas Comunes
- Longitud mínima
- Longitud máxima
- Longitud
- Patrón (Expresión regular)
- Requerido
Correo Electrónico
URL
UUID
Tipo Numérico
Los tipos numéricos de Joi corresponden a los siguientes tipos de campo de NocoBase: Entero, Número y Porcentaje.
Reglas Comunes
- Mayor que
- Menor que
- Valor máximo
- Valor mínimo
- Múltiplo
Entero
Además de las reglas comunes, los campos de tipo entero también admiten la validación de enteros y la validación de enteros no seguros.
Número y Porcentaje
Además de las reglas comunes, los campos de tipo número y porcentaje también admiten la validación de precisión.
Tipo Fecha
Los tipos de fecha de Joi corresponden a los siguientes tipos de campo de NocoBase: Fecha (con zona horaria), Fecha (sin zona horaria), Solo fecha y Marca de tiempo Unix.
Reglas de validación admitidas:
- Mayor que
- Menor que
- Valor máximo
- Valor mínimo
- Validación de formato de marca de tiempo
- Requerido
Campos de Relación
Los campos de relación solo admiten la validación de campo requerido. Tenga en cuenta que la validación de campo requerido para los campos de relación actualmente no es compatible en escenarios de subformularios o subtablas.
Aplicación de Reglas de Validación
Una vez que haya configurado las reglas para los campos, estas reglas de validación correspondientes se activarán al añadir o modificar datos.
Las reglas de validación también se aplican a los componentes de subtablas y subformularios:
Tenga en cuenta que, en escenarios de subformularios o subtablas, la validación de campo requerido para los campos de relación no surte efecto.
Diferencias con la Validación de Campos del Lado del Cliente
La validación de campos del lado del cliente y del lado del servidor se aplican en escenarios de uso distintos. Ambas presentan diferencias significativas en su implementación y en el momento en que se activan las reglas, por lo que deben gestionarse por separado.
Diferencias en el Método de Configuración
- Validación del lado del cliente: Configure las reglas en los formularios de edición (como se muestra en la siguiente figura).
- Validación de campos del lado del servidor: Establezca las reglas de campo en Fuente de datos → Configuración de la colección.
Diferencias en el Momento de Activación de la Validación
- Validación del lado del cliente: Se activa en tiempo real a medida que los usuarios completan los campos y muestra los mensajes de error de inmediato.
- Validación de campos del lado del servidor: Se realiza en el servidor después de enviar los datos y antes de que se almacenen, y los mensajes de error se devuelven a través de las respuestas de la API.
- Ámbito de aplicación: La validación de campos del lado del servidor no solo entra en vigor al enviar formularios, sino que también se activa en todos los escenarios que implican la adición o modificación de datos, como los flujos de trabajo y la importación de datos.
- Mensajes de error: La validación del lado del cliente admite mensajes de error personalizados, mientras que la validación del lado del servidor actualmente no los admite.