Processo

Processo - Iniciar novo processo

Eventos deste tipo devem ser utilizados quando existe a necessidade de que um processo já existente no DOX seja iniciado a partir da colaboração com um outro processo.

Imagine que você tenha um processo de Contratação, e que após a efetivação da contratação, é necessário que as credenciais deste novo colaborador sejam criadas, mas você não possui acesso para criar tais credenciais. Deste modo, deve-se utilizar um evento Iniciar novo processo, trazendo por meio de variáveis globais os dados conforme foram repassados no processo de Contratação, para que o responsável possa, portanto, gerar as credenciais.

Ou seja, em determinada etapa do processo, um outro processo à parte será iniciado. Esse evento serve para quando há casos onde essa necessidade exista.

Descrição: Campo traz por padrão a ‘descrição do tipo do evento’, mas permite edição.
Momento da execução: Define o momento em que o evento vai ser executado: Ao entrar, Ao sair da atividade, ou Ao anexar.
Processo: Lista onde será selecionado o processo que será iniciado ao executar o evento, pode ser o valor de um processo guardado em uma variável ou ser um processo escolhido fixo;
Código processo: Variável armazenando o código da instância que será iniciado do novo processo.

Processo - Finalizar processo atual

Evento utilizado para finalizar o processo atual em colaboração. Com este evento, a instância será direcionada para a atividade fim (atividade 9999) e o status da instância mudará para 2 (finalizado).

Descrição: Campo traz por padrão a ‘descrição do tipo do evento’, mas permite edição.
Momento da execução: Define o momento em que o evento vai ser executado: Ao entrar, Ao sair da atividade, ou Ao anexar.
Motivo: Variável ou texto comum que será utilizado como motivo para a finalização do processo. Este valor será preenchido no campo motivo da tabela CRM_PROCESSO.

Processo - Cancelar processo atual

Evento utilizado para cancelar o processo em colaboração. Com este evento, a colaboração será cancelada e o status da instância mudará para 3. O procedimento irá parar exatamente onde está e seu status será mudado apenas. Não aparecerá mais para a colaboração, nem em telas de processo, etc.

Descrição: Campo traz por padrão a ‘descrição do tipo do evento’, mas permite edição.
Momento da execução: Define o momento em que o evento vai ser executado: Ao entrar, Ao sair da atividade, ou Ao anexar.
Motivo: Variável ou texto comum que será utilizado como motivo para o cancelamento do processo. Este valor será preenchido no campo motivocancelamento da tabela CRM_PROCESSO

Processo - Alterar informações do processo

Evento utilizado para que algumas informações do processo, como Objetivo, Expectativa, Motivo para iniciar, etc. sejam alteradas de acordo com a necessidade do modelador. Essas alterações serão inseridas nos campos da tabela CRM_PROCESSO, que geralmente são usadas para auxiliar na colaboração dos processos no portal.

Descrição: Campo traz por padrão a ‘descrição do tipo do evento’, mas permite edição.
Momento da execução: Define o momento em que o evento vai ser executado: Ao entrar, Ao sair da atividade, ou Ao anexar.
Propriedade: Propriedade do processo/campo da tabela que será alterada pelo evento;
Texto: Nesse campo podem ser utilizadas variáveis de processo para que as informações sejam alteradas de acordo com a necessidade, ou um com um texto fixo também funciona.

Processo - Gerar link do processo

Evento utilizado para gerar um link externo de colaboração com o processo, eventos deste tipo são utilizados geralmente em casos onde pessoas externas à empresa precisam colaborar com o processo em questão. A partir desse evento, gera-se o link do processo, que posteriormente será enviado por e-mail a pessoa que deverá realizar a colaboração.

Descrição: Campo traz por padrão a ‘descrição do tipo do evento’, mas permite edição.
Momento da execução: Define o momento em que o evento vai ser executado: Ao entrar, Ao sair da atividade, ou Ao anexar.
Processo: Variável que irá assumir o processo cujo link deve ser gerado, caso mantido em branco, o evento automaticamente assume que deve ser gerado para o processo atual;
Link gerado: Variável do tipo texto que armazenará o link gerado pelo evento;

Processo - Exibir mensagem para o usuário

Evento utilizado quando é necessário dar um retorno ao usuário sobre as operações realizadas por ele e pelo processo, podendo ser exibida uma mensagem de Erro ou Informação.

Descrição: Campo traz por padrão a ‘descrição do tipo do evento’, mas permite edição.
Momento da execução: Define o momento em que o evento vai ser executado: Ao entrar, Ao sair da atividade, ou Ao anexar.
Tipo mensagem: Tipo de mensagem que será exibida, se é uma mensagem de erro ou uma Informação.
Texto: Texto que será exibido na tela ao usuário;

Processo - Criar lembrete

Evento responsável por criar um lembrete para o usuário. Quando este evento é utilizado, ele mostra na portal uma tela de notificação de acordo com os dados informados no evento (Data, Hora, Usuário, Descrição).

Antes de tudo, verifique se no ema_configurador o seguinte serviço está sendo executado, caso não esteja, marque-o e suba os serviços novamente, senão o evento de lembrete não vai ser executado.

Evento:

Descrição: Campo traz por padrão a 'descrição do tipo do evento' mas permite edição.
Momento da execução: Define o momento em que o evento vai ser executado: Ao entrar, Ao sair da atividade, ou Ao anexar.
Processo: Variável que irá assumir o código do processo, caso mantido em branco, o evento automaticamente assume que deve ser gerado para o processo atual.
Usuário: Usuário que irá receber o lembrete, podendo ser configurado com as seguintes opções:
- Usuário atual.
- Conector.
- Variável.
Descrição: Texto do lembrete.
Data: Variável contendo a data do lembrete.
Hora: Variável contendo a hora do lembrete.

Exemplo de sua utilização em um BPM:

Vamos criar uma FK para que o usuário possa escolher o usuário destino que receberá o lembrete na tela. É importante esse detalhe, pois o evento só funciona se o valor do destino ser o USERNAME do usuário. Em conectores, crie um tipo Foreign key que busque dados da tabela USUARIO de acordo com a imagem abaixo:

Agora, vamos criar uma atividade para informar esses dados.
Neste atividade faça quatro formulários.

— Um formulário do tipo dissertativo com a Fk que criamos vinculada para escolher o usuário, sem variável vinculada.

**OBS: Vamos criar um evento PEX ao sair desse formulário para atribuir o valor do campo da FK USERNAME para a variável de processo DESTINO, pois quando salvamos o processo, o formulário de FK salva automaticamente o ID do usuário, não a descrição.

Vá até a tela de programação PEX deste formulário e faça como na imagem:

— Um formulário dissertativo para colocar a descrição do lembrete com uma variável do tipo texto vinculada
— Um formulário dissertativo para colocar a data do lembrete com uma variável do tipo data vinculada
— Um formulário dissertativo para colocar a hora que o lembrete vai ser disparado com uma variável do tipo hora vinculada.

Em seguida, ao sair da atividade, procure o evento de lembrete (Processo - Criar lembrete) e informe:

No portal, o processo aparecerá assim:

Ao clicar em "Confirmar" e finalizar o processo, quando o evento ser executado na data e hora informadas, ele aparecerá na tela, assim no portal:

Note que a descrição ali da notificação é aquela que informamos no campo do processo "Descrição".

Caso queira que o USERNAME já seja setado quando entrar na atividade por um usuário fixo, pode-se utilizar o evento de Variáveis - Definir valor variável.

Processo - Adicionar comentário

Novo evento do sistema, disponível na versão 12.10+ no agrupador "Processo".
Este evento permite, por meio de um processo BPM, que seja vinculado na instância de um processo (atual ou informado na variável) um comentário, tendo o usuário logado, executando o processo, como criador do comentário. Ele contém os seguintes campos:

Sendo possível definir:

Descrição
Momento da execução
Instância do processo ("atua" ou "informada na variável")
Comentário: campo para informar o texto do comentário, possibilitando o uso de variáveis do processo ou do sistema
Notificar participantes: com as opções "Sim", "Não", "Conforme variável".

Caso for usando a opção "Conforme variável", a variável deverá conter um dos seguintes valores: "S" ou "N".
OBS: Como citado inicialmente, o criador do comentário é sempre o usuário logado que está executando o processo.

Exemplo do evento em um processo:

No canto superior direito. No pequeno ícone de comentário

Em um kanban por exemplo:

Na aba "Comentários" do card.