Exemplo: validando dados de coach em um serviço manual legado no web Process Designer

Este exemplo mostra como validar os dados de coach em um serviço manual legado usando um script de validação no web Process Designer. A validação baseada em script é a implementação típica mais simples para validação de dados de coach no web Process Designer.

1. Na biblioteca, clique em Dados > Objeto de negócios e crie o objeto de negócios CreditCardApplication com os parâmetros a seguir:
   • nome(String)
   • salary(Decimal)
   • creditLimit(Decimal)
2. Clique em Interface com o usuário > Serviço manual legado e crie o serviço manual legado CreateCreditApplication. Rotule o coach padrão como Aplicativo de crédito.
3. Na guia Variáveis do serviço manual legado, inclua application(CreditCardApplication) como uma variável privada.
   
4. Na visualização do diagrama, clique duas vezes no coach Aplicativo de crédito para abri-lo.
5. Na seção Variáveis da paleta, solte os parâmetros name, salary e creditLimit no coach. Rotule novamente o botão OK padrão para Enviar.
   
6. Selecione a conexão entre o coach Aplicativo de crédito e o nó de extremidade. Configure Disparar validação como Antes. A conexão agora tem um ponto verde em seu início, que indica que a validação está ativada para o botão Enviar. Um evento fronteira é conectado automaticamente ao coach, indicando que é possível conectar o coach ao script de validação.
   A construção de validação assegura que no tempo de execução, quando o usuário clicar no botão Enviar, o fluxo vá primeiro para o script de validação para executar a validação de dados do coach. Se os dados forem válidos, o fluxo então vai para o nó final. Se você deixar a configuração padrão para Disparar validação como Nunca, a validação de dados não ocorrerá e o fluxo irá diretamente para o nó de extremidade.
7. Crie o script de servidor para validar os dados de coach:
   1. Na paleta, em Atividade, use a ferramenta de atividade Script de servidor para incluir um nó de script no diagrama de serviço manual e, em seguida, selecione o nó.
   2. Nas propriedades de Script do nó, inclua o código JavaScript a seguir para a validação.

      if (tw.local.application.name == ""){
          tw.system.addCoachValidationError(tw.system.coachValidation, "tw.local.application.name",
          "O nome não pode ficar vazio.");
      }
      if ( tw.local.application.salary <= 0){
          tw.system.addCoachValidationError(tw.system.coachValidation, "tw.local.application.salary",
          "O salário deve ser superior a 0.");
      }
      if (tw.local.application.creditLimit > 2 * tw.local.application.salary){
          tw.system.addCoachValidationError(tw.system.coachValidation, "tw.local.application.creditLimit",
          "O limite de crédito não pode ter mais do que o dobro do salário. " "O limite máximo de crédito é $" 
          2 * tw.local.application.salary + ".");
      }

      O parâmetro tw.system.coachValidation é o objeto de negócios CoachValidation que contém as informações de validação. A primeira sequência contém o caminho da variável integral para o elemento de dados com os dados problemáticos. A segunda sequência é a mensagem para o usuário. A mensagem deve identificar o que está errado com os dados ou informe ao usuário como corrigir o problema.
      Importante:

      • Um coach pode usar somente um script de validação para validar seus dados. No entanto, mais de um coach pode usar o mesmo script de validação.
      • Se o elemento de dados que está sendo validado não ligado a uma visualização coach, há nenhum lugar para exibir um erro de validação se um ocorrer.
      • Se uma visualização de coach sendo validada contiver rich text, o serviço de validação deverá remover qualquer formatação antes de validar o conteúdo.
   3. Conecte o nó de script no diagrama CreateCreditApplication conforme mostrado. Inclua um nó permanecer na página no diagrama e conecte o nó de script ao nó permanecer na página.
      
      O nó permanecer na página efetuará loop do fluxo de volta para o coach se os dados no coach não forem válidos. O sistema transmite as informações de erro de volta para o coach e os usuários veem um indicador ao lado da visualização de coach com os dados problemáticos. Se o serviço de validação fornece mensagens de erro, os usuários vêem a mensagem apropriada quando eles pairam sobre um indicador. Se os dados forem válidos, o sistema processará o evento de limite para mover para a próxima etapa.
8. Clique em Salvar ou Concluir edição.
9. Execute o serviço manual legado clicando em Executar .
10. No navegador que exibe o coach, teste a validação fazendo o seguinte:
    1. Deixe o campo Nome vazio e digite um valor 1 no campo Salário e no campo Limite de Crédito. Clique em Enviar. O navegador exibe uma mensagem de que o campo Nome não pode ficar vazio.
    2. Digite um nome no campo Nome e substitua o 1 no campo Salário por 0. Clique em Enviar. O navegador exibe uma mensagem que o salário deve ser maior que 0.
    3. Substitua o 0 no campo Salário por 1. Substitua o 1 no campo Limite de crédito por 3. Clique em Enviar. O navegador exibe uma mensagem dizendo que o limite de crédito não pode ser maior que o dobro do salário.
    4. Substitua o 3 no campo Limite de crédito por 2. Clique em Enviar. O serviço manual é concluído porque todos os três valores agora são válidos.