Validazione di un controllo Edit Box nelle XPages

Nelle XPages i controlli “Edit Box” hanno alcune impostazioni che permettono di eseguire semplici validazioni.
Queste impostazioni si trovano sotto l’etichetta “Validation” del controllo e dipendono dal valore di “Display Type” sotto l’etichetta “Data”; nella figura puoi vedere un schermata per la validazione di un controllo Edit Box di tipo stringa
validation

L’esito della validazione se negativo può essere mostrato sulla pagina dai controlli “Display Error” e “Display Errors”.

Un semplice tutorial è il seguente:

  1. crea un modulo con campo di tipo text di nome “Subject”
  2. crea una XPage con il sequente codice

    dove al posto di “enter your form here” inserisci il nome del modulo creato nel punto precedente;
    questo codice è stato ottenuto con questa procedura:

    • sotto l’etichetta “Data” aggiungi un “Domino Document” come “data source” e inserisci il nome del modulo creato nel punto precedente
    • dal pannello “Data palette” (a destra) seleziona “Data” e trascina il campo “Subject” sulla XPage
    • nell’edit box Subject, sotto l’etichetta Validation, spunta “Required field” e scrivi “You must enter a value in Subject field”
    • aggiungi un pulsante Save di tipo Submit e con un evento lato server per salvare il documento

    l’aspetto visivo della xpage è quello mostrato in figura
    xpage

  3. lancia la xpage nel browser e salva il documento con un campo Subject vuoto, l’errore di validazione è mostrato in una dialog box
    dialogbox

In questo esempio il messaggio di errore è mostrato in una dialogo box ma è possibile visualizzarlo sulla pagina html utilizzando i controlli Display Error e Display Errors

Per ottenere questo esegui i seguenti punti:

  1. modifica il codice della xpage

    dove, come prima, al posto di “enter your form here” inserisci il nome del modulo creato inizialmente;
    puoi ottenere questo codice partendo dalla xpage precedentemente creata e

    • aggiungi una colonna alla tabella già presente e contenente l’etichetta e il campo
    • aggiungi il controllo Display Error nella nuova cella
    • nel controllo Display Error inserisci Subject1 come valore per “Show error messages for”
    • aggiungi il controllo Display Errors alla fine della xpage
    • nelle proprietà del controllo Edit Box imposta disableClientsideValidation a true

    l’aspetto visivo della xpage è
    xpage_error_message

  2. lancia la xpage nel browser e salva il documento con un campo Subject vuoto
    xpage_browser

In questo esempio ho utilizzato contemporaneamente i due controlli “Display Error” e “Display Errors” ma è possibile utilizzarne solo uno dei due tenendo presente che:

  • Display Error: si riferisce a quel controllo Edit Box specificato nella proprietà basics/for
  • Display Errors: si riferisce a ogni controllo della xpage

In entrambi i casi è fondamentale impostare a true la proprietà data/disableClientSideValidation per ogni Edit Box, oppure è possibile impostare questa proprietà a livello di database nelle “Application Properties” sotto l’etichetta “Xpages” e Client Validation = off
application_properties

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *

Questo sito usa Akismet per ridurre lo spam. Scopri come i tuoi dati vengono elaborati.