= Filtro de Instâncias =

[[WikiInclude(WF/tableofcontents)]]

Esta é uma importante ferramente para o monitoramento dos processos. Com ela o usuário monitor pode encontrar intâncias de acordo com critérios de seleção. A funcionalidade de filtro está disponível para as opções de Intâncias Ativas e Instâncias Finalizadas. Ao ser escolhida uma destas opções será exibida uma barra de botões para filtragem, conforme mostrado na figura abaixo:

[[Image(htdocs:wf/images/monitoramento_filtro1.png)]]

As opções são as seguintes:

 * Adicionar filtro: deve ser adicionado pelo menos um filtro de seleção. Podem ser adicionados mais filtros, e o módulo irá fazer a união dos mesmos ao filtrar as instâncias;
 * Filtrar: este é o botão de ação a ser acionado depois que os filtros forem adicionados;
 * Enviar email: para as instâncias resultantes da filtragem (aquelas que estiverem listadas na página), pode-se enviar email automático de comunicação para os usuários das instâncias. Esta função está melhor descrita mais à frente neste documento;
 * Total de instâncias: contador de instâncias selecionadas pelo(s) filtro(s).

=== Critérios de Filtragem ===

A filtragem das instâncias ativas pode ser feita utilizando os seguintes critérios:

 * Atividade da Instância: a atividade em que a instância está parada no momento;
 * Data da Instância: data quando a instância foi criada;
 * Data na Atividade: data quando a instância chegou na atividade atual;
 * ID da Instância: o número sequencial único de identificação da instância;
 * Identificador: o atributo que identifica a instância, varia de acordo com o processo;
 * Prioridade: o grau de urgência das instâncias. Varia de 0 a 4, onde 4 é mais prioritário;
 * Proprietário: aquele que criou a instância;
 * Status: a situação atual da instância, podendo ser ativa, completada, abortada, ou em espera;
 * Usuário da Instância: aquele que detém a posse da instância no momento.


Já as instâncias finalizadas podem ser filtradas de acordo com os seguintes critérios:

 * Data da Instância: idem acima;
 * Data de Finalização da Instância: a data em que a instância foi finalizada;
 * ID da Instância: idem acima;
 * Identificador: idem acima;
 * Prioridade: idem acima;
 * Proprietário: idem acima;
 * Status: idem acima.

Lembrando que podem ser usados mais de um filtro ao mesmo tempo.

Depois que os filtros estiverem construídos, clique no botão Filtrar.

=== Enviar Email ===

Com o envio de email é possível alertar os usuários sobre situações que necessitam a sua intervenção, como por exemplo, instâncias paradas a muito tempo com determinado usuário. Primeiramente filtre as instâncias que deseja, e depois clique no envio de email para compor uma mensagem de aviso. Segue uma imagem da página de envio de email:

[[Image(htdocs:wf/images/monitoramento_filtro2.png)]]

Será exibido um texto de email padrão, mas pode-se modificar o texto conforme necessário. Existem variáveis de substituição (inciadas e terminadas pelo caracter %) que estando presentes no texto serão, no momento da execução, trocas pelos valores que representam. São elas:

[[Image(htdocs:wf/images/monitoramento_filtro3.png)]]

Quando terminar de compor o email, clique no botão Preview para ver como ficará, antes de enviá-lo definitivamente.

Existe ainda uma opção adicional para indicar como as instâncias serão relacionadas no email:

 * Um email por usuário: irá montar um email único e listar dentro dele cada instância. Útil caso o número de instâncias seja grande;
 * Um email por instância: nesta opção, para cada instância filtrada, será gerado um email.