O documento descreve como criar um workflow no RM para tornar o preenchimento de um campo complementar obrigatório. O workflow verifica se o campo "COMISSÃO" está preenchido e, caso não esteja, gera uma exceção com uma mensagem de erro personalizada.

1. Workflows Carolina Campos Mrad Malheiros Email: carolina.campos@totvs.com.br ; carolmrad@hotmail.com Linkedin: http://br.linkedin.com/in/carolinamrad Twitter: @carolina_mrad 1

2. Introdução 2 Workflows O Workflow é uma ferramenta de conceito amplo, que tem por objetivo estender os recursos e funcionalidades dos aplicativos da linha RM. Os Workflows são desenvolvidos de forma gráfica através da utilização de um designer (Fluxo de Trabalho), acessando uma galeria de componentes já disponíveis no RM. Os componentes são chamados de atividades e são utilizados na montagem dos Workflows, formando blocos como se fossem “Legos”. Em um primeiro momento os Workflows, da linha RM, foram desenvolvidos para permitir pequenas customizações nos aplicativos, pois eles poderão interagir em vários pontos dos sistemas.

3. Objetivo 3 Workflows O objetivo deste “Como Fazer” é demonstrar como podemos, através de um Workflow, tornar o preenchimento de um campo complementar obrigatório. Para isto utilizaremos a ferramenta Workflow, associado a atividade “Se/Senão” . Neste exemplo, vamos configurar o campo complementar “COMISSÃO”, do cadastro de “Lançamentos”, para ter o preenchimento obrigatório. Portanto é necessário que este campo já exista na base de dados.

4. Cadastro do Workflow Workflows 4 Primeiramente, acesse a ferramenta Workflow. Na nova MDI, basta acessar a guia Gestão, em seguida selecione o ícone Workflows (beta), e por último o botão Workflows.

5. Cadastrando o Workflow 5 Workflows Neste cadastro visualizamos todos os Workflows já desenvolvidos. Podemos editá-los e alterá-los.

6. Cadastrando o Workflow 6 Workflows Ao incluir um novo Workflow, é necessário o preenchimento dos campos: Nome e Categoria Atenção: É no campo Categoria que definimos o(s) perfil(s) que poderá(ão) dar manutenção no Workflow.

7. Desenvolvendo o Workflow 7 Workflows Após efetuar o cadastro do Workflow, dê um duplo clique sobre o mesmo.

8. Desenvolvendo o Workflow 8 Workflows Selecione a guia Atividades.

9. Desenvolvendo o Workflow 9 Workflows A primeira atividade que vamos utilizar é a “Se/Senão”. Esta atividade será responsável por verificar se o campo “COMISSAO” esta preenchido ou não. Para isto basta selecionar a atividade e arrastá-la para o Fluxo de Trabalho.

10. Desenvolvendo o Workflow 10 Workflows Selecione a atividade “Se/Senão”. Acesse a guia Propriedades, para então configurar as propriedades referente a atividade inserida.

11. Desenvolvendo o Workflow 11 Workflows Defina a propriedade “CONDITION”, como “Condição de Regra Declarativa”.

12. Desenvolvendo o Workflow 12 Workflows Defina um nome a propriedade “ConditionName”, por exemplo: “Nome da Condição”.

13. Desenvolvendo o Workflow 13 Workflows Por último, configure a propriedade “Expression” para this.Tables["FLANCOMPL"]["COMISSAO"].IsNull .

14. Desenvolvendo o Workflow 14 Workflows Será necessário inserir uma atividade de “Gerar Exceção”, para isto acesse a guia Atividades. Selecione a atividade e arraste para o Fluxo de Trabalho.

15. Desenvolvendo o Workflow 15 Workflows Acesse a guia Propriedades, para definir a propriedade “Mensagem de Erro”. Nesta propriedade configuramos a mensagem que será apresentada ao usuário quando o campo não for preenchido. Exemplo: “O registro não pode ser salvo, pois o campo Comissão não foi preenchido!”

16. Vinculando o Workflow ao Processo 16 Workflows Agora é necessário vincular o Workflow ao processo. Para isto acesse a visão dos registros onde se pretende inserir o controle. Portanto acesse a visão de Lançamentos.

17. Vinculando o Workflow ao Processo 17 Workflows Na visão de lançamentos, acesse o menu Processos. Escolha o item de menu Workflows e clique em Gerenciar.

18. Vinculando o Workflow ao Processo 18 Workflows Na janela de Gerenciamento de Workflows, visualizamos todos os Gatilhos / Workflow disponíveis. Selecione, o gatilho, Antes de Salvar o Registro. Localize o Workflow desenvolvido.

19. Teste do Workflow 19 Workflows Após vincular o Workflow, para testar seu funcionamento, basta editar ou incluir um lançamento e não preencher o campo complementar COMISSÃO. Ao salvar o lançamento a mensagem ao lado será apresentada.

20. Dúvidas 20 Workflows carolina.campos@totvs.com.br http://totvsconnect.blogspot.com http://www.tecnologiatotvs.net Linkedin: http://br.linkedin.com/in/carolinamrad Twitter: @carolina_mrad