Reglas de validación

​

¿Qué son las reglas de validación?

Una regla de validación es una condición que debe cumplirse antes de poder crear o actualizar un registro. Si la condición es falsa, Twenty bloquea el guardado y muestra un mensaje que explica qué debe cambiarse. Usa reglas para exigir información en el momento adecuado, como un importe antes de que una oportunidad se convierta en cliente, o para evitar valores incoherentes, como una fecha de finalización anterior a una fecha de inicio.

​

Crear una regla de validación

1. Ve a Ajustes → Modelo de datos y selecciona el objeto que quieres configurar.
2. Abre la pestaña Ajustes, busca Reglas de validación y haz clic en Añadir regla.
3. Asigna un nombre a la regla y, opcionalmente, una descripción para explicar su propósito.
4. Escribe una Condición. Empieza a escribir un nombre de campo o una función y selecciona sugerencias en el panel de ayuda.
5. En Error, introduce un Mensaje que indique a las personas cómo corregir el registro. Usa Mostrar en para asociarla a un campo específico o selecciona Registro completo.
6. Consulta la Vista previa para ver cómo se comporta la condición en los registros existentes.
7. Haz clic en Activar para empezar a aplicar la regla.

Las nuevas reglas permanecen inactivas hasta que las actives. Una regla necesita un nombre, una condición válida y un mensaje de error antes de poder activarse.

​

Obtener una vista previa de la regla

La vista previa usa hasta tres registros recientes del objeto seleccionado. Usa las flechas para desplazarte entre ellos e inspeccionar los valores utilizados por la condición. Obtener una vista previa de una regla no modifica ningún registro. Si el objeto todavía no tiene registros, crea algunos para probar la vista previa.

​

Escribir una condición

Escribe la condición que permite guardar. Por ejemplo, employees > 0 permite guardar una empresa solo cuando su número de empleados es mayor que cero. Usa nombres de campo como employees, en lugar de etiquetas de visualización como Empleados. Al seleccionar un campo en la ayuda, se inserta la referencia correcta. Coloque el texto entre comillas simples o dobles y use paréntesis para agrupar condiciones. Use and y or en lugar de && y ||.

​

Comprobar valores faltantes

Para hacer que un campo sea obligatorio, use not isEmpty(fieldName). Esto también funciona para campos compuestos, como correos electrónicos y direcciones.

​

Hacer referencia a campos compuestos y relacionados

Use un punto para leer una parte de un campo compuesto, como name.firstName o amount.amountMicros. También puede leer un campo mediante una relación de varios a uno, como company.name en una persona. Seleccione campos en el asistente para encontrar las rutas disponibles. Los importes de moneda se almacenan en micros: una unidad monetaria equivale a 1000000 micros. Por ejemplo, amount.amountMicros >= 100000000 requiere un importe de al menos 100 en la moneda del registro. Para los campos de selección, compare el valor de opción almacenado, como 'CUSTOMER', en lugar de su etiqueta de visualización. Consulte los ejemplos del asistente para ver los valores disponibles en su campo.

​

Reglas de ejemplo

Adapte los nombres de campo y los valores de opción a su modelo de datos. Los campos startDate, endDate y tags de abajo son ejemplos de campos personalizados. El ejemplo de oportunidad usa or para hacer que el requisito de importe sea condicional: las demás etapas se pueden guardar sin un importe.

​

Cuándo se comprueban las reglas

Las reglas activas se comprueban cuando se crean o actualizan registros, incluidos los cambios realizados mediante la API, las importaciones y los flujos de trabajo. Un registro debe superar todas las reglas activas de su objeto para poder guardarse. Activar una regla no cambia los registros existentes. Un registro que no cumpla la nueva condición debe corregirse la próxima vez que se guarde. Una condición que lee un registro relacionado se evalúa cuando se guarda el registro al que pertenece la regla. Editar únicamente el registro relacionado no vuelve a comprobarlo.

​

Editar, desactivar o eliminar una regla

Vuelva a Settings → Data Model → your object → Settings → Validation rules y, a continuación, haga clic en la regla.

• Editar: Actualice la condición o el mensaje, compruebe la vista previa y haga clic en Guardar. Para una regla inactiva, este botón es Activar.
• Desactivar: En Zona de peligro, haga clic en Desactivar para dejar de aplicar la regla y conservar su configuración. Haga clic en Activar para aplicarla de nuevo.
• Eliminar: En Zona de peligro, haga clic en Eliminar y confirme para quitar permanentemente la regla. Los registros existentes no cambian.

Desactivar o eliminar un campo usado en una condición también desactiva las reglas que lo leen. Revise esas reglas antes de activarlas de nuevo. Para definir reglas de validación en una aplicación, consulte la guía para desarrolladores.