Overview

Validations

Regole di validazione custom su campi, form e flussi applicativi.

Screenshot reference (manuali utente)

  • manual__validations__01.png: tab Validazione (parte alta) nel metadata editor colonna.
  • manual__validations__02.png: tab Validazione (parte bassa) con script custom e type validation.
  • manual__validations__03.png: esempio runtime in form con campi required non valorizzati.

Metadati colonna principali (tab Validazione)

  • mc_validation_required: rende il campo obbligatorio in edit/insert.
  • mc_validation_required_message: messaggio custom per il required (tooltip/errore vicino al campo).
  • mc_validation_pattern: regex di validazione (eseguita lato client sul valore campo).
  • mc_validation_pattern_message: messaggio custom quando il pattern non e rispettato.
  • mc_validation_max_length: lunghezza massima consentita.
  • mc_validation_max_length_message: messaggio custom per superamento max length.
  • mc_validation_min_length: lunghezza minima richiesta.
  • mc_validation_min_length_message: messaggio custom per min length non rispettata.
  • mc_validation_custom_callback: script custom di validazione (firma tipica: record, field, vr, wtoolbox), usato per regole business non esprimibili con i vincoli standard.
  • mc_validation_type: validazione tipizzata (es. email/url/numero/data in base ai tipi supportati dalla build).
  • mc_validation_type_message: messaggio custom per errore della type validation.
  • mc_value_change_trigger_event: hook su cambio valore, utile per innescare ricalcoli o validazioni dipendenti tra campi.

Comportamento runtime

  • Nel form, i campi required sono marcati con *.
  • Se il campo non passa le regole, viene mostrato un indicatore errore con il messaggio configurato nei metadati.
  • Le regole vengono applicate prima del salvataggio, riducendo roundtrip inutili verso il server.
  • Le validazioni custom permettono logica condizionale basata su record corrente e contesto UI.

Note operative

  • Usare i messaggi custom per rendere l'errore comprensibile all'utente finale.
  • Evitare regex troppo aggressive su campi lookup o formatter automatici.
  • Per regole complesse cross-field, preferire mc_validation_custom_callback rispetto a pattern lunghi e poco manutenibili.

Screenshot

validations / form-required-state
validations / form-required-state
validations / validation-tab-bottom
validations / validation-tab-bottom
validations / validation-tab-top
validations / validation-tab-top