Arricchire la definizione di una entity

Il file portlet-model-hints.xml permette arricchire la definizione delle entity effettuata nel file service.xml, dando la possibilità di dare indicazioni su aspetti di look and fee e di validazione.

Di seguito sono riportate le possibili definizioni:

• auto-escape, valore booleano, permette di indicare al portale se al valore deve essere applicata il metodo HtmlUtil.escape affinché sia visualizzabile
• autoSize, valore booleano, permette di indicare al portale di visualizzare il valore del campo in una textarea scrollabile
• day-nullable, valore booleano, permette di indicare al portale che la visualizzazione del campo data non deve prevedere la visualizzazione e selezione del giorno
• default-value, valore di tipo String, permette di indicare il valore predefinito che deve essere assegnato al campo
• display-height, valore intero, permette di indicare l'altezza con cui deve essere renderizzato il campo di input di un form utilizzando alloyui
• display-width, valore intero, permette di indicare la larghezza con cui deve essere renderizzato il campo di input di un form utilizzando alloyui
• editor, valore booleano, permette di indicare se utilizzare un editor per la gestione del valore di un campo
• max-length, valore intero, permette di indicare la lunghezza massima di un campo, questa definizione ha impatto sul DDL SQL, in particolare sulla lunghezza massima con cui viene creata la colonna del database
• month-nullable, valore booleano, permette di indicare al portale che la visualizzazione del campo data non deve prevedere la visualizzazione e selezione del mese
• secret, valore booleano, permette di indicare che il campo deve essere renderizzato come di tipo password, ovvero i dati inseriti dall'utente non devono essere visibili durante la digitazione
• show-time, valore booleano, permette di indicare al portale che la visualizzazione del campo data non deve prevedere la visualizzazione e selezione dell'orario
• upper-case, valore booleano, permette di indicare che i caratteri inseriti nel campo devono essere convertiti automaticamente in lettere maiuscole
• year-nullable, valore booleano, permette di indicare al portale che la visualizzazione del campo data non deve prevedere la visualizzazione e selezione dell'anno
• year-range-delta, valore intero, permette di indicare il range, in termini di numero di anni, che deve poter essere selezionato tramite il campo di input di tipo data renderizzato con alloyui
• year-range-future, valore booleano, permette di indicare se il campo di input di tipo data renderizzato con alloyui deve permette la selezione di date nel futuro
• year-range-past, valore booleano, permette di indicare se il campo di input di tipo data renderizzato con alloyui deve permette la selezione di date nel passato

Validazioni

Altra definizione molto utile da indicare direttamente nel file portlet-model-hints.xml è l'indicazione dei validatori. I validatori permettono di innestare automaticamente dei validatori nelle interfacce, che gestiscono la validazione dei dati inseriti in un form gestito con alloyui.

Di seguito riportiamo i validatori da noi più utilizzati:

• required, indica che il campo richiede di essere esplicitamente popolato
• number, indica che il campo richiede di essere valorizzato con un valore numerico
• alphanum, indica che il campo richiede di essere valorizzato con un valore alfanumerico
• url, viene applicato la validazione del formato del valore del campo affinché sia conforme con il formato di un url
• email, viene applicato la validazione del formato del valore del campo affinché sia conforme con il formato di un indirizzo email
• max, permette di indicare il valore massimo con cui può essere valorizzato un campo numerico
• min, permette di indicare il valore minimo con cui può essere valorizzato un campo numerico
• range, permette di indicare il valore minimo ed il valore massimo con cui può essere valorizzato un campo numerico
• maxLength, permette di indicare la lunghezza massima della stringa con cui può essere valorizzato un campo di tipo String
• minLength, permette di indicare la lunghezza minima della stringa con cui può essere valorizzato un campo di tipo String

Alloyui mette a disposizione altri meccanismi per gestire la validazione dei form, per maggiori informazioni visitare direttamente la sezione "form validator" del sito di AlloyUI http://alloyui.com/tutorials/form-validator/