Aviso de traducción por IA

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

20250819181342 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

20250819192011 Ver más opciones

URL

20250819192409 Ver más opciones

UUID

20250819192731 Ver más opciones

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. 20250819193758

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. 20250819193954

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. 20250819184344

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. 20250819201027

Las reglas de validación también se aplican a los componentes de subtablas y subformularios: 20250819202514

20250819202357

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. 20250819203016

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. 20250819203836

20250819203845

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.