Esempio: convalida dei dati di pagina in un servizio con interazione dell'utente heritage nel desktop Process Designer (obsoleto)

• name(String)
• salary(Decimal)
• creditLimit(Decimal)

1. Dalla libreria, creare un servizio di sistema generale denominato CreditApplicationFormValidation.
2. Nella pagina Variabili del servizio, aggiungi application(CreditCardApplication) come input del servizio.
   Importante: il nome e il tipo dell'input del servizio devono corrispondere al nome e al tipo della variabile di pagina che contiene i dati che si desidera convalidare.
   Aggiungi validate(CoachValidation) come output del servizio. Il servizio deve avere un solo output ed è di tipo CoachValidation . La presenza di questo output indica che il servizio è un servizio di convalida. In questo caso, l'esempio utilizza l'input per fornire i dati convalidati dal servizio.
   
3. Aggiungere uno script del server al diagramma del servizio e collegare i nodi iniziale e finale allo script.
4. Nell'implementazione dello script del server, aggiungere il seguente codice per creare l'oggetto di business CoachValidation :

   tw.local.validate = new tw.object.CoachValidation();
   
   if (tw.local.application.name == ""){
       tw.system.addCoachValidationError(tw.local.validate, "tw.local.application.name",
       "The name cannot be empty.");
   }
   if ( tw.local.application.salary <= 0){
       tw.system.addCoachValidationError(tw.local.validate, "tw.local.application.salary",
       "The salary must be above 0.");
   }
   if (tw.local.application.creditLimit > 2 * tw.local.application.salary){
       tw.system.addCoachValidationError(tw.local.validate, "tw.local.application.creditLimit",
       "The credit limit cannot be more than double the salary. " + "The maximum credit limit is $" + 
       2 * tw.local.application.salary + ".");
   }

   Il parametro tw.local.validate è l'oggetto di business CoachValidation che contiene le informazioni di convalida. La prima stringa contiene il percorso completo della variabile all'elemento dati con i dati problematici. La seconda stringa è il messaggio per l'utente. Il messaggio dovrebbe identificare cosa non va con i dati o indicare all'utente come risolvere il problema.
   Importante:

   • Una pagina può utilizzare un solo servizio di convalida o script del server per convalidarne i dati. Tuttavia, più di una pagina può utilizzare lo stesso servizio di convalida o script.
   • Se l'elemento dati in fase di convalida non è collegato a una vista, non è possibile visualizzare un errore di convalida se si verifica un errore.
   • Se una vista in fase di convalida contiene rich text, il servizio di convalida deve rimuovere qualsiasi formattazione prima di convalidare il contenuto.

tw.system.coachValidation

1. Lasciare vuoto il campo Nome , immettere 1 nel campo Stipendio e nel campo Limite di credito . Fare clic su Submit. Il browser visualizza un messaggio che indica che il campo Nome non può essere vuoto.
2. Immettere un nome nel campo Nome e sostituire 1 nel campo Salario con un 0. Fare clic su Submit. Il browser visualizza un messaggio che indica che lo stipendio deve essere maggiore di 0.
3. Sostituire lo 0 nel campo Salario con un 1. Sostituire 1 nel campo Limite di credito con un 3. Fare clic su Submit. Il browser visualizza un messaggio che indica che il limite di credito non può essere più del doppio dello stipendio.
4. Sostituire il 3 nel campo Limite di credito con un 2. Fare clic su Submit. Il servizio umano ora termina perché tutti e tre i valori sono ora validi.