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

Questo esempio mostra come convalidare i dati della pagina in un servizio con interazione dell'utente heritage utilizzando uno script di convalida in Process Designer. La convalida basata su script è l'implementazione più semplice e tipica per la validazione dei dati di pagina in Process Designer.

1. Fare clic su Dati > Oggetto di business e creare l'oggetto di business CreditCardApplication con i seguenti parametri:
   • name(String)
   • salary(Decimal)
   • creditLimit(Decimal)
2. Fare clic su Interfaccia utente > Heritage Human Service e creare il servizio con interazione dell'utente CreateCreditApplication heritage. Etichettare la pagina predefinita su Credit Application.
3. Nella scheda Variabili del servizio con interazione dell'utente heritage, aggiungere application(CreditCardApplication) come variabile privata.
   
4. Nella vista diagramma, fare doppio clic sulla pagina Credit Application per aprirla.
5. Dalla sezione Variabili della tavolozza, rilasciare i parametri name, salarye creditLimit nella pagina. Rietichettare il pulsante OK predefinito su Submit.
   
6. Selezionare la connessione tra il nodo finale e la pagina Credit Application . Impostare Avvia convalida su Before
   La connessione ha ora un punto verde all'inizio, che indica che la convalida è abilitata per il pulsante Inoltra .
   Un evento di limite viene automaticamente allegato alla pagina, indicando che è possibile collegare la pagina allo script di convalida.
   
   
   Il costrutto di convalida garantisce che in fase di runtime, quando l'utente fa clic sul pulsante Inoltra , il flusso prima va allo script di convalida per eseguire la convalida dei dati della pagina. Se i dati sono validi, il flusso passa al nodo finale. Se si lascia l'impostazione predefinita per Convalida di attivazione su Never, la convalida dei dati non si verifica e il flusso va direttamente al nodo finale.
7. Creare lo script del server per convalidare i dati della pagina:
   1. Dalla tavolozza, in Attività, utilizzare lo strumento di attività Script server per aggiungere un nodo script al diagramma del servizio umano e selezionare quindi il nodo.
   2. Nelle proprietà Script del nodo, aggiungere il seguente codice JavaScript per la convalida.

      
      if (tw.local.application.name == ""){
          tw.system.addCoachValidationError(tw.system.coachValidation, "tw.local.application.name",
          "The name cannot be empty.");
      }
      if ( tw.local.application.salary <= 0){
          tw.system.addCoachValidationError(tw.system.coachValidation, "tw.local.application.salary",
          "The salary must be above 0.");
      }
      if (tw.local.application.creditLimit > 2 * tw.local.application.salary){
          tw.system.addCoachValidationError(tw.system.coachValidation, "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.system.coachValidation è 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 script di convalida per convalidare i propri dati. Tuttavia, più di una pagina può utilizzare lo stesso script di convalida.
      • 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.
   3. Collegare il nodo di script nel diagramma CreateCreditApplication come mostrato. Aggiungere un nodo stay - on - page al diagramma e collegare il nodo script al nodo stay - on - page.
      
      Il nodo stay - on - page esegue il loop del flusso alla pagina se i dati nella pagina non sono validi. Il sistema restituisce le informazioni di errore alla pagina e gli utenti vedono un indicatore accanto alla vista con i dati problematici. Se il servizio di convalida fornisce messaggi di errore, gli utenti visualizzano il messaggio appropriato quando si passa con il mouse su un indicatore. Se i dati sono validi, il sistema elabora l'evento di limite per passare al passo successivo.
8. Fare clic su Salva o Termina modifica.
9. Eseguire il servizio con interazione dell'utente heritage facendo clic su Esegui .
10. Nel browser che visualizza la pagina, verificare la convalida effettuando quanto segue:
    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 0 nel campo Salario con un 1. Sostituire il 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 3 nel campo Limite di credito con un 2. Fare clic su Submit. Il servizio umano termina perché tutti e tre i valori sono ora validi.