SH - Como Fazer - Gerenciador de Processos

Visando atender às demandas do mercado foi desenvolvida uma nova funcionalidade, permite realizar a agendamento do rotinas do CIGAM por meio de integração com Agendador de Tarefa do Windows.

O Gerenciador de Processos visa a automação e controle de procedimentos de todas as áreas do CIGAM, possibilitando o agendamento e recorrência na execução de tarefas, sejam estas programas CIGAM ou rotinas preparados para tal, permitindo a configuração de seus diversos parâmetros e momentos a serem executados, bem como executáveis, ‘bats’ e ou processos do próprio servidor da aplicação automatizando os processos dentro do sistema gerando grande ganho de produtividade, assertividade e controle, já que os procedimentos uma vez programados, sempre serão executados conforme definidos podendo ter suas execuções acompanhada em tempo real e históricos, monitorados através de painel de logs gravados a partir do resultado de suas execuções.

Quais as configurações de ambiente necessárias para utilização do Gerenciador de Processos?

Informações sobre configurações de ambiente referente ao Gerenciador de Processos encontram-se em “GE - Como Fazer - Configurações no ambiente para utilizar o Gerenciador de Processos”.

Quais as tabelas necessárias para utilização Gerenciador de Processos?

Para a realizar o cadastro e gerenciamento de processos, foi desenvolvida uma nova funcionalidade, disponibilizada a partir da versão CIGAM 200106 RC. A partir dessa versão ou superior é necessário ter as seguintes tabelas com as devidas traduções.

WFAUTOMACOESXML = %DIR_APOIO%Geral\automacoes_cigam.xml*/
WFAUTOMACOES = WFAUTOMA
WFAUTPARAMETROS = WFAUTPAR
WFAGENDADOR = WFAGENDA
WFPARAMETROSAGE = WFPARAGE
WFSERVIDOR = WFSERVID
WFLOGAGENDADOR = WFLOGAGE
WFLOGAUTOMACAO = WFLOGAUT

Para a correta criação das tabelas é preciso realizar o procedimento de atualização do ambiente, por meio da criação da tabela e posteriormente atualização dos nomes lógicos.

Após o procedimento de atualização concluído, deve-se consultar se as tabelas constam no banco, assim como suas devidas traduções no magic.ini.

Como realizar o cadastro de servidores?

Para realizar o Cadastro de Servidores, basta acessar o menu: BPM > Workflow > Movimentos > Gerenciador de Processos.

Este cadastro tem por finalidade pré-parametrizar os locais onde o Agendador de Tarefas (AT) e o CIGAM estarão configurados. Pode-se utilizar tanto o AT da máquina local, quanto o de um servidor (neste caso, deve-se pré-parametrizar o método no IIS). Da mesma forma, pode-se utilizar o Magic Server localmente, ou em uma máquina remota.

OBS.1: Se endereço do servidor não for informado, será utilizado o host local. Atenção: caso servidor de aplicação, host local refere-se ao endereço, onde a tarefa será agendada.

OBS.2: Caso marcado como “Padrão”, o respectivo servidor deve ser trazido por padrão ao tentar agendar um novo processo.

Como realizar o gerenciamento através do Gerenciador de Processos?

Para realizar o Gerenciador de Processos, basta acessar o menu BPM > Workflow > Movimentos > Gerenciador de Processos.

Através do painel gerencial todos os processos agendados serão exibidos, independentemente do servidor parametrizado para execução das rotinas, ou seja, permitirá a visualização de forma geral de todos os agendamentos.

Por meio do Gerenciador de Processos, o usuário poderá cadastrar servidores, criar cadastros de novos processos, reagendar processos já existentes, ativar/inativar, executar e até mesmo excluir agendamentos nos quais não serão mais executados.

O campo “Situação” exibe o status do agendamento, ou seja, o processo no agendador, que pode ser: (Pronta, Em execução, Inativa e Não encontrada).

A situação “Não encontrada” significa que a processo está cadastrada no banco de dados, porém não foi possível encontrá-la no Agendador de Tarefas (AT) da máquina destino.

Já o ícone ao lado do campo “última execução” significa o status da última execução do programa (o último log de execução do tipo “Fim do processo”), tendo como tooltip a descrição do log. A data/hora de última/próxima execução sempre estarão no formato do servidor (caso servidor em inglês, essa data/hora será no formato mm/dd/yyyy).

Como visualizar os agendamentos de um servidor específico através do Gerenciador de Processos?

Para visualizar as tarefas de um servidor específico, pode-se filtrar os agendamentos através do combobox "Servidor". Neste exemplo, são listados dois servidores conforme os cadastros previamente realizados, além da opção "Todos".

Como atualizar a listagem dos agendamentos através do Gerenciador de Processos?

Para atualizar a listagem de processos agendados pode-se clicar no botão “Atualizar”. Uma vez que se obtiveram alterações nos agendamentos estes serão atualizados.

Como agendar um novo processo pelo Gerenciador de Processos?

Para agendar um processo através do Gerenciador de Processos, basta clicar em “Agendar processo”, para que seja exibido a tela de Agendar Processo.

Na tela de Agendar Processo, deve-se informar os seguintes dados: Tipo de processo que pode ser (Funcionalidade CIGAM ou executável), Servidor de Tarefas consiste no servidor onde está agendo o processo, Servidor de Aplicação consiste no servidor onde a execução das rotinas CIGAM irá ocorrer, Processo consiste em informar qual a rotina será executada. Quando o processo é informado automaticamente são preenchidos os campos correspondentes a novo processo, Aplicação e Descrição. Sobre o Nome da tarefa por sua vez deve ser único, não permitirá cadastrar um nome repetido.

Quanto a recorrência, pode-se informar a periodicidade de execução do agendamento (ver Quais são as recorrências possíveis para realizar os agendamentos de processos?). Assim como estipular um período inicial e final. Após o preenchimento de todas as informações do cadastro da processo, basta clicar em ‘Confirmar’.

Como garantir que servidores de agendamento e aplicação estejam parametrizados corretamente?

Para garantir que os servidores de agendamento e aplicação estejam funcionando 100%, pode-se utilizar o ‘Testar Conexão’. Pois no processo de instalação da funcionalidade pode ocorrer de faltar alguma parametrização ou configurar algum serviço. Para auxiliar identificar o que pode ser as possíveis causas de problemas.

Para testar a conexão de uma tarefa com o servidor na qual ela será executada, é necessário se posicionar sobre a linha da tarefa desejada e clicar com o botão direito do mouse sobre ela, ir à opção de ‘Testar Conexão’.

Uma vez que a conexão com o servidor foi realizada com sucesso, será exibida na tela a mensagem de ‘Sucesso! Todos os endereços da tarefa estão parametrizados corretamente’.

Caso haja algum problema com um dos servidores, uma mensagem informativa será apresentada, bem como em “Detalhes” os específicos do problema.

Para garantir que o servidor de aplicação esteja funcionando corretamente, pode-se copiar diretamente a URL gerada pelo painel, executar diretamente no navegador, e avaliar o retorno:

O retorno esperado ao realizar este processo é “No output returned from remote program”, que neste caso indica que tudo foi executado corretamente, e nenhum erro foi encontrado no processo. Após isso pode-se consultar o log de execução da tarefa:

Como executar um processo pelo Gerenciador de Processos?

Para executar um processo pelo Gerenciador de Processos, existem três formas de realizar o processo. Após realizar o agendamento, com todas as conexão com o servidor estabelecidas corretamente,o processo será executado automaticamente conforme o horário agendado.

Caso necessário de executar o processo antes do próximo agendamento, basta clicar sobre o ícone ‘Executar está processo agora’.

Outra forma de iniciar um processo, é se posicionar sobre a linha do processo desejado, clicar com o botão direito do mouse sobre ela, ir à opção de ‘Executar Processo’.

Uma vez que a tarefa for iniciada corretamente, independente do caminho de acesso escolhido, será exibida a mensagem de ‘Tarefa iniciada com sucesso’.

Como visualizar os agendamentos de um processo pelo Gerenciador de Processos?

Para visualizar referente ao agendamento de um processo pelo Gerenciador de Processos, é necessário se posicionar sobre a linha do processo desejado e clicar com o botão direito do mouse sobre ela, ir à opção de ‘Exibir Logs de Agendamento’.

Como visualizar os resultados das execuções de um processo pelo Gerenciador de Processos?

Para visualizar as execuções já realizadas, pode ser verificado através dos Logs de Execução/Ocorrência dentro do Gerenciador de Processos. Por dele será possível visualizar as ocorrências consistem nos agendamentos dos processos e as execuções apresentando assim o status e início da execução.

Outra forma de visualizar o Log de execução é pelo menu BPM > Workflow > Pesquisas > Ocorrências/Execuções.

Caso a rotina esteja executando corretamente, mas os logs de execução estejam sendo gerados sem o usuário correto, deve-se avaliar o cadastro do usuário em questão, e garantir que esse possua senha cadastrada condizente com o arquivo de segurança.

Logs sendo gerados sem usuário:

No cadastro de usuários, garantir que o usuário em questão esteja corretamente parametrizado:

Como modificar um agendamento de um processo pelo Gerenciador de Processos?

Para executar um agendamento de um processo Gerenciador de Processos, existem duas formas de realizar o processo. Sobre a tarefa desejada, basta clicar sobre o ícone ‘Editar este agendamento’.

Outra forma de modificar um processo, é se posicionar sobre a linha do processo desejado, clicar com o botão direito do mouse sobre ela, ir à opção de ‘Modificar agendamento’.

Dessa forma, poderá ser modificados os dados correspondentes ao usuário e recorrência de execução da tarefa.

Como desativar um processo já agendado pelo Gerenciador de Processos?

Para desativar um processo pelo Gerenciador de Processos, existem duas formas de realizar o processo. Sobre a tarefa desejada, basta clicar sobre o ícone ‘Desativar agendamento’.

Outra forma de desativar um processo, é se posicionar sobre a linha da tarefa desejada, clicar com o botão direito do mouse sobre ela, ir à opção de ‘Desativar’.

Como ativar um processo já agendado pelo Gerenciador de Processos?

Para ativar um processo pelo Gerenciador de Processos, existem duas formas de realizar o processo. Sobre o processo desejado, basta clicar sobre o ícone ‘Ativar agendamento’.

Outra forma de ativar um processo, é se posicionar sobre a linha do processo desejado, clicar com o botão direito do mouse sobre ele, ir à opção de ‘Ativar’.

Como excluir um processo já agendado pelo Gerenciador de Processos?

Para excluir um processo pelo Gerenciador de Processos, existem duas formas de realizar o processo. Sobre a processo desejado, basta clicar sobre o ícone ‘Excluir este agendamento’.

Outra forma de excluir um processo, é se posicionar sobre a linha do processo desejado, clicar com o botão direito do mouse sobre ele, ir à opção de ‘Excluir Agendamento’.

Em ambas as formas de acesso ao clicar na opção ‘Excluir Agendamento’, será exibida uma mensagem questionada se prosseguir com o processo.

Ao confirmar, o processo será excluído.

Como agendar um arquivo executável pelo gerenciador de tarefas?

É possível agendar a execução de arquivos executáveis do Windows, que deverão estar acessíveis através do servidor selecionado. Exemplo:

Como executáveis não necessitam de uma instalação CIGAM para executar, os campos Servidor de Aplicação, Processo, Aplicação, Nome público, Parâmetros e Usuário de Execução devem ficar desabilitados.

Neste caso, C:\ se refere à uma pasta que está no computador remoto, da máquina wts-28, já que o Agendador de Tarefas do Windows ficará nessa máquina, e ela possui um C:\ próprio. Caso servidor não possua endereço, trata-se da máquina local, utilizando o AT local. Neste caso, C:\ será referente ao computador do usuário:

Deve ser permitido apenas agendar executáveis que estejam no [file:///C:/ C:\] da máquina servidor AT, ou que estejam em uma unidade de rede mapeada:

Caso seja informado um local de rede (mapeado), no momento da confirmação do agendamento, será necessário informar um usuário/senha no domínio de rede do Windows, para a execução desta tarefa:

Não deve ser possível continuar o processo de agendamento, sem informar um usuário e senha para a criação da tarefa. A validação de usuário/senha válidos será feito ao confirmar o agendamento:

Como parametrizar um usuário específico para realizar os agendamentos de processos?

Para parametrizar um usuário específico para realizar os agendamentos, pode-se pré-preencher essas informações correspondentes ao usuário e senha nas configurações: WF - GE - 3101 - Usuário de rede para Gerenciador de Processos e WF - GE - 3102 - Senha de usuário de rede para Gerenciador de Processos.

Ao confirmar o agendamento, deve constar no Task Scheduler do Windows a informação de usuário “run as”, confirme informado o usuário e senha.

Nas propriedades do agendamento realizado no Task Scheduler é possível identificar o usuário utilizado, no agendamento realizado.

Processos executáveis não gerarão histórico, nem ocorrências, pois necessitariam chamar programas CIGAM para tal. Por isso, para tarefas que são executáveis, a guia “Histórico” deve ficar oculta. Será possível apenas visualizar os logs de agendamento:

Ao modificar um processo do tipo Executável, apenas o caminho do executável e a recorrência devem ficar disponíveis para edição:

Quais são as recorrências possíveis para realizar os agendamentos de processos?

A partir da , a recorrência passa a ter mais opções. Seguem abaixo elas:

Execução por: Ao selecionar a opção 'Minuto' ou 'Hora' é disponibilizado as opções:

• Ocorre a cada <x> minutos ou hora
• Inicia em (com data e hora)
• Expira em (com data e hora)

Execução por: Ao selecionar a opção 'Dia' é disponibilizado as opções:

• Ocorra a cada <x> dias
• Inicia em (com data e hora)
• Expira em (com data e hora)
• Repetir a cada <x> minutos, durante o período de <x> minutos.

Execução por: Ao selecionar a opção 'Semana', é disponibilizado as opções:

• Ocorre a cada <x> semanas
• Escolha múltiplos dias da semana para executar (obrigatoriedade de selecionar pelo menos um dia da semana)
  • Segunda-feira
  • Terça-feira
  • Quarta-feira
  • Quinta-feira
  • Sexta-feira
  • Sábado
  • Domingo
• Inicia em (com data e hora).
• Expira em (com data e hora).
• Repetir a cada <x> minutos, durante o período de ‘x’ minutos.

Execução por: Ao selecionar a opção ‘Mês, é disponibilizado as opções:

• 'Ocorrência'
  • Mensal – Executada o agendamento em todos os meses do ano
  • Bimestral - Executado somente nos meses pares (Fevereiro (02), Abril (04), Junho (06), Agosto (08), Outubro (10), Dezembro (12))
  • Trimestral - Executado somente nos meses de Março, Junho, Setembro e Dezembro
  • Quadrimestral - Executado somente nos meses de Abril, Agosto e Dezembro.
  • Quinquimestral - Executado somente nos meses de Maio e Outubro
  • Semestral - Executado somente nos meses de Junho e Dezembr
  • Janeiro
  • Fevereiro
  • Março
  • Abril
  • Maio
  • Junho
  • Julho
  • Agosto
  • Setembro
  • Outubro
  • Novembro
  • Dezembro

Ao lado do campo 'Ocorrência' em o ícone de ajuda . Ao clicar nele, sistema exbie esta tela com a explicação de algumas opções deste campo:

• 'Específica' – Realiza o agendamento no dia específico selecionado:
  • 1, ao 31, Último Dia (execução realizada no último dia do mês).

• 'Semana' (primeiro combo) - Seleciona qual semana será realizado o agendamento criado.
  • Primeira (execução realizada na primeira semana do mês).
  • Segunda (execução realizada na segunda semana do mês).
  • Terceira (execução realizada na terceira semana do mês).
  • Quarta (execução realizada na quarta semana do mês).
  • Última (execução realizada na última semana do mês).
• 'Semana' (segundo combo) - Seleciona o dia da semana será realizado o agendamento cadastrado.
  • Segunda-feira.
  • Terça-feira.
  • Quarta-feira.
  • Quinta-feira.
  • Sexta-feira.
  • Sábado.
  • Domingo.

• Inicia em (com data e hora).
• Expira em (com data e hora).
• Repetir a cada ‘x’ minutos, durante o período de ‘x’ minutos.

Versões

Versão 230502