Compilazione dinamica di un messaggio script di convalida

È possibile compilare in modo dinamico un messaggio script di convalida con un valore recuperato da un'origine dati. Ciò serve a garantire che gli utenti inseriscano nel campo il valore corretto.

Ad esempio, è possibile visualizzare un messaggio di errore personalizzato quando gli utenti immettono in un campo dati che non corrispondono a ciò che lo script prevede. Ad esempio, un campo numerico come Quantità potrebbe presentare uno script ad esso associato che indica che il numero in questo campo non può essere maggiore di 100. Se l'utente immette un numero maggiore di 100, verrà visualizzato un messaggio di errore personalizzato.

Lo schema a cui ci si collega può presentare dati definiti per uno script di convalida di questo tipo:

<form> 
      <validationScript dp_scriptMessage="message1"/> 
</form>

Il file dati a cui si punta può presentare dati definiti per script di convalida di questo tipo:

<form> 
      <validationScript dp_scriptMessage="DP Script Message - The quantity must be less than or equal to 100."/> 
</form>

Quando si unisce il file di dati alla struttura del modulo e si immette un numero nel campo Quantità maggiore di 100, viene visualizzata una finestra di dialogo di errore.

Un altro esempio potrebbe consistere nel fornire messaggi di errore personalizzati collegati a uno script in un'altra lingua. Il file dati a cui si punta può presentare dati definiti per script di convalida di questo tipo:

<form> 
      <validationScript dp_scriptMessage="Entrez un nombre inférieur ou égal à 100."/> 
</form>

Quando si unisce il file di dati alla struttura del modulo e si immette un numero nel campo Quantità maggiore di 100, viene visualizzata una finestra di dialogo di errore in francese.

Nota: Per utilizzare testo non ASCII (ad esempio accenti) nel file di dati, è necessario assicurarsi che il file sia appropriatamente codificato e che la codifica sia correttamente identificata nell'istruzione di elaborazione XML. Ad esempio:

<?xml version="1.0" encoding="UTF-8"?>

A questo scopo, è innanzitutto necessario verificare di avere eseguito le operazioni seguenti:

  1. Nella palette Libreria oggetto, fare clic sulla categoria Standard e trascinare un oggetto nella struttura del modulo.

    Ad esempio, inserire un oggetto Campo numerico.

  2. (Facoltativo) Nella palette Oggetto, fare clic sulla scheda Campo e inserire una didascalia per l'oggetto nella casella Didascalia.

    Ad esempio, digitare Quantity.

  3. Nell'Editor di script, selezionare Convalida dall'elenco Mostra.

  4. Nell'Editor di script, selezionare un linguaggio dalla casella Linguaggio.

    Ad esempio, selezionare JavaScript dalla casella Linguaggio.

  5. Digitare uno script per l'oggetto.

    Ad esempio, digitare questo script per il campo Quantità:

    this.rawValue <= 100

  6. Nella palette Oggetto, fare clic sulla scheda Valore, quindi fare clic sulla tabella attiva Messaggio script convalida.

  7. Selezionare la connessione dati.

    Nota: se non si è già connessi a un'origine dati, Binding dei dati predefinito è l'unica selezione presente nell'elenco Connessione dati.
  8. Fare clic sul triangolo accanto alla casella Binding, quindi selezionare un binding.

    Ad esempio, selezionare convalida > @dp_scriptMessage.

    La seguente stringa verrà visualizzata nella casella Binding:

    $record.validation.dp_scriptMessage

    È possibile digitare questa stringa nella casella Elementi anziché selezionarla.
  9. Al termine, fare clic su OK.

  10. Visualizzare messaggio di errore utilizzando la scheda Anteprima PDF.

    Ad esempio, nella scheda Anteprima PDF, immettere una quantità maggiore di 100.