1 Introdução
O Folder245FlowService é um módulo do
Folder245 Flow que
permite a realização de tarefas baseadas em bases de dados, que podem ser bases nativas do
WorkFlow ou bases externas. A configuração das tarefas a serem executadas deve ser feita pelo
Folder245FlowManager.
2 Especificações
Uma tarefa é a execução de qualquer programa (ou função interna do Folder245FlowService)
em horário e intervalos pré-determinados, com condições relativas às bases de dados. Alguns
exemplos de tarefas são: envio de e-mail para pessoas cadastradas em uma base, execução de determinado
programa em intervalo de tempo ou horário programado, mudança de etapa de um processo e etc.
Tarefas podem ser basicamente de dois tipos:
-
Tarefas de Etapas: São tarefas relativas à base do fluxo. Para configuração de uma tarefa
de etapa é necessário especificar o fluxo e a etapa aos quais aquela tarefa se aplica. Exemplo:
sempre que um processo entrar em uma etapa, enviar um e-mail para todas as pessoas que têm acesso
àquela etapa.
-
Tarefas de Agendamento: São tarefas que podem ser configuradas para qualquer base externa,
bastando informar a base e a tabela que se deseja utilizar. Exemplo: dada uma tabela que possui
dados relativos a e-mails e data de aniversário de clientes, a tarefa agendada pode ter como
função enviar um e-mail de felicitações de aniversário.
3 Configurações - Folder245 FlowManager
3.1 Configuração de Tarefas de Etapas
Abaixo seguem os procedimentos que devem ser tomados para criação de uma tarefa de etapa.
Na aba nomeada Tarefas de Etapas (Figura 1) devemos clicar em Nova Tarefa
Figura 1
Uma janela (Figura 2) será aberta para inserir a nova tarefa e configurar os seguintes campos:
-
Nome - Nome que deve ser dado à nova tarefa e que será exibido na listagem de tarefas
de etapas.
Tarefas não podem ter nomes iguais.
-
Condição - A condição para que a tarefa seja executada, por exemplo: CAMPO6='pendente'.
Dado o Fluxo e a Etapa que serão escolhidos posteriormente, se o CAMPO6 de determinado processo
for igual à 'pendente', aquela tarefa será executada.
-
Tempo - O tempo inicial para que aquela tarefa seja executada. Se o tempo for definido
como 0 aquela tarefa não será executada. Em geral utiliza-se o valor 1.
-
Intervalo - O intervalo de tempo para que aquela tarefa seja executada. Deve ser
especificado em minutos. Ex: 1440 (1440 minutos correspondem a 1 dia).
-
Prioridade - A prioridade daquela tarefa em relação às outras.
Figura 2
Após clicar em aplicar consultar item 3.3 Configuração de Funções e 3.4 Gerenciar Etapas.
3.2 Configuração de Tarefas de Agendamento
Abaixo seguem os procedimentos que devem ser tomados para criação de uma tarefa de agendamento.
Na aba nomeada Tarefas de Agendamento (Figura 3) devemos clicar em Nova Tarefa e configurar os seguintes
campos:
-
Nome - Nome que deve ser dado à nova tarefa, e que será exibido na listagem de tarefas
de agendamento. Tarefas não podem ter nomes iguais.
-
Condição - A condição para que a tarefa seja executada. Por exemplo: data>=now(). Dadas a
Base e a Tabela, na verificação do campo data, se a data presente no campo for maior ou igual à
data atual, aquela tarefa será executada.
-
Chave - A chave primária (ou campo que se comporte como tal) da tabela escolhida. Esta
chave será utilizada como referência para controle de quais registros foram ou devem ser afetados
pela execução da tarefa.
-
Intervalo - O intervalo de tempo para que aquela tarefa seja executada. Deve ser
especificado em minutos. Ex: 1440 (1440 minutos correspondem a 1 dia).
-
Prioridade - A prioridade daquela tarefa em relação às outras.
-
DBMS - Especifica a natureza da base a ser utilizada (Banco de dados Access ou qualquer
outra fonte de dados ODBC)
-
Base - Caminho para a base que conterá a origem dos dados. No caso de uma fonte de dados
ODBC o alias que corresponde à base desejada.
-
Tabela - Tabela onde estão os dados que se deseja utilizar.
Figura 3
3.3 Configuração de Funções
Após clicar em aplicar (em qualquer uma das interfaces, agendamento ou etapas) após a criação de
uma tarefa, é liberada a interface (Figura 4) que fornece as funções que a tarefa pode executar.
Inicialmente todas as funções não estão associadas à tarefa recém criada. Para associar uma
função basta selecionar o nome da função e clicar em associar. O procedimento é análogo para
desassociar uma função.
Figura 4
Após clicar em associar, a caixa de texto parâmetro é liberada para edição. A caixa parâmetro
deve conter o parâmetro ou os parâmetros necessários para a execução do programa ou função
interna do Folder245FlowService.
Se a função desejada não estiver na lista de funções, basta clicar em Nova Função e selecionar
o programa desejado na janela que será aberta (Figura 5). Quando o programa estiver na lista é necessário que se clique em associar para que a função fique associada àquela tarefa.
Figura 5
3.4 Gerenciar Etapas
Para associar as etapas referentes às Tarefas de Etapas, clica-se no botão Gerenciar Etapas existente na aba Tarefas de Etapas (Figura 1)
Ja janela Associar Etapas (Figura 6) selecione as etapas e clique no botão Associar ou Desassociar para desassociar.
Figura 6