Esempio: Convalida di un Coach in un servizio con interazione dell'utente lato client

Questo esempio mostra come utilizzare le proprietà di modifica dati di un coach in un servizio con interazione dell'utente lato client per convalidare i dati del coach senza uscire dal coach.

1. Creare il servizio con interazione dell'utente lato client che contiene il coach da convalidare. Vedi Creazione di un servizio con interazione dell'utente lato client.
2. Nell'allenatore Variables del servizio umano, creare due variabili private, startDate e endDate, e impostare il tipo di ciascuna variabile su Date.
3. Nel diagramma del servizio con interazione dell'utente lato client, ridenominare il Coach in Prompt for Start and End Dates.
4. Nell'allenatore, utilizzare il punto di inserimento superiore del pulsante OK per aggiungere due viste Date Time Picker (impilate verticalmente), rinominare le viste in startDate e endDate, e assicurarsi che siano vincolate rispettivamente alle variabili startDate e endDatevariables, rispettivamente. Lasciare invariato il pulsante OK predefinito.
   
5. Salvare la configurazione del coach.
6. Nella vista del diagramma per il coach, sotto Modifica dati > Script, immettere il seguente costrutto JavaScript :

   if (tw.local.startDate.getTime() > tw.local.endDate.getTime())
   	tw.system.coachValidation.addValidationError("tw.local.startDate", "The start date must precede the end date. Set the start date before the end date, and try again.");

   Nell'oggetto coachValidation , la prima stringa contiene il percorso completo della variabile per gli elementi i cui dati devono essere convalidati. La seconda stringa è il messaggio per l'utente, che specifica cosa non va nei dati e indica all'utente come risolvere il problema.

   Nota:

   • Se l'elemento dati che viene convalidato non è collegato a una vista, non vi è alcun punto in cui visualizzare un errore di convalida, se si verifica.
   • Se una vista in fase di convalida contiene rich text, lo script di convalida deve rimuovere la formattazione prima di convalidare il contenuto.
   • Se si sta convalidando un elenco e si desidera che l'errore faccia riferimento all'intero elenco, il parametro variableName deve includere [] come suffisso. Corrisponde al binding della vista dove [] indica che l'oggetto è un elenco. Ad esempio, se una vista è associata a tw.local.var3[], che è un elenco, hai bisogno di codice come il seguente esempio:

     tw.system.coachValidation.addValidationError("tw.local.var3[]", "Var3 has validation error");

7. Facoltativo: per evitare che l'utente proceda al passo successivo quando i dati non sono validi, completare i seguenti passi:
   1. Nell'allenatore Variables per il servizio umano, aggiungere un'altra variabile privata chiamata readyToSubmit e impostare il suo tipo a Boolean.
   2. Nelle proprietà Modifica dati > Script del coach, accodare il codice JavaScript seguente allo script esistente:

      tw.local.readyToSubmit = tw.system.coachValidation.validationErrors.length==0;

   3. Nel coach, configurare il tasto OK in modo che sia di sola lettura quando non è pronto, come mostrato:
      
8. Fare clic su Salva o Termina modifica.
9. Fare clic su Esegui per eseguire il servizio umano.
10. Nel browser che visualizza il coach, verificare la convalida completando la seguente procedura:
    1. Impostare la Data di inizio su una data precedente alla data di inizio. Fare clic su OK.
       Il browser evidenzia il campo Data di inizio e visualizza un'icona di avvertenza. Se si passa con il mouse sull'icona di avvertenza, viene visualizzato un messaggio che indica che la data di inizio deve precedere la data di fine.

       
    2. Impostare la data di fine su una data successiva alla data di inizio. Fare clic su OK.
       Il servizio con interazione dell'utente è stato completato correttamente perché entrambe le date sono valide.