Filas de envio de e-mail do Workflow Produto : Microsiga Protheus Workflow Versão 10 Chamado : TEUEHH Data da publicação : 05/03/12 País(es) : Todos Banco(s) de Dados : Todos Esta melhoria depende de execução do update de base UPDWF002, conforme Procedimentos para Implementação. Implementada a funcionalidade Filas de Envio de Email (WFC008), para cadastrar diferentes servidores do Protheus para auxiliar no envio de e-mails do Workflow. Desta forma, é possível enviar mensagens com mais rapidez e segurança, pois mesmo que um servidor fique inativo, os e-mails são enviados por outras filas. PROCEDIMENTO PARA IMPLEMENTAÇÃO O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) e do compatibilizador UPDWF002. Antes de executar o compatibilizador UPDWF002 é imprescindível: a) Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS_DATA\DATA ) e dos dicionários de dados "SXs" (diretório \PROTHEUS_DATA\ SYSTEM ). b) Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa. c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema. d) Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname. e) O compatibilizador deve ser executado com a Integridade Referencial desativada*. 1. Em TOTVS SmartClient, digite U_UPDWF002 no campo Programa Inicial. 2. Clique em OK para continuar. 3. Será exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo. SIGAWF Filas de envio de email do Workflow 1
4. Clique em Prosseguir para iniciar o processamento. 5. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização, são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados. 6. Clique em Gravar para salvar o histórico (log) apresentado. 7. Clique em OK para encerrar o processamento. 8. No módulo Configurador (SIGACFG), acessar o Cadastro de Menu (Cadastros/Menu) e adicionar o item de menu em Ambiente/Workflow (logo após Parametros Wf), com a descrição Filas de Email e que chame o programa WFC008. ATUALIZAÇÕES DO COMPATIBILIZADOR Criação no arquivo SX2 s: Tabela WFQ Filas de envio de e-mail Nome Ac. Filial WFQ Fila de e-mail Compartilhado Criação no arquivo SX3 s: WFQ_FILIAL Tamanho 8 Filial Filial do Sistema Nível 1 Filial do Sistema WFQ_NOME Tamanho 50 2 SIGAWF Filas de envio de email do Workflow
Nome Nome Fila Nome da Fila WFQ_ROOT Tamanho 255 Rootpath Rootpath Fila Rootpath da Fila WFQ_HOST Tamanho 255 Hostname Hostname Fila Hostname do Servidor da Fila SIGAWF Filas de envio de email do Workflow 3
WFQ_PORTA Numérico Tamanho 5 Porta Porta da Fila Porta do Servidor da Fila WFQ_FENV Tamanho 255 Ambiente Ambiente Fila Ambiente da Fila WFQ_FEMP Tamanho 8 Empresa Empresa Fila 4 SIGAWF Filas de envio de email do Workflow
Empresa da Fila WFQ_FFIL Tamanho 8 Filial Filial da Fila Filial da Fila WFQ_EMAIL Tamanho 100 Email Email Fila Nível 1 e-mail da Fila WFQ_Ativa Lógico Tamanho 1 SIGAWF Filas de envio de email do Workflow 5
Ativa Fila Ativa Nível 1 Determina se a fila está ativa Criação no arquivo SIX s: Índice WFQ Ordem 1 Chave Mostra pesq. WFQ_FILIAL + WFQ_NOME FILIAL + NOME DA FILA.T. PROCEDIMENTO PARA UTILIZAÇÃO Pré-requisitos: Antes de cadastrar uma fila de envio de e-mail, é necessário que os servidores do Protheus 10, que atuarão como filas, estejam na mesma rede que o Gerenciador de filas (servidor principal, que vai conter os cadastros de todas as filas) e que utilizem o sistema operacional Windows. A fila deve ter uma Conta de e-mail do Workflow Ativa. A fila deve compartilhar seu diretório rootpath com o Gerenciador de filas. A porta utilizada pelo servidor não deve estar bloqueada pelo firewall. O Gerenciador de filas deve mapear a unidade de rede da fila. 1. O Gerenciador de filas deve acessar o módulo Configurador (SIGACFG) em Ambiente / Workflow / Filas de Email (WFC008). 2. Cadastre uma fila de e-mail, informando os campos: Nome: Nome utilizado para identificação da fila; Hostname: Nome da máquina na rede (ou ip), que contém a fila; Porta: Porta utilizada pelo appserver da fila ( porta da conexão TCP); Rootpath: Diretório do rootpath do protheus mapeado na rede; Ambiente: Ambiente utilizado pela fila; Empresa: Empresa utilizada pela fila; 6 SIGAWF Filas de envio de email do Workflow
Exemplo: Filial: Filial utilizada pela fila. Nome: Fila1 Hostname: MEUPC Porta: 7777 Rootpath: Z: Ambiente: PROTHEUS10 Empresa: 99 Filial: 01 3. Selecione a fila e clique em Configurar, para terminar a configuração da fila (o servidor da fila deve estar ativo). 4. No arquivo de configuração da Fila, seção ONSTART, adicione o Jobs=QueueSendMail e configure a chave REFRESHRATE, preferencialmente com valor 15. 5. No Arquivo de configuração do Gerenciador de Filas, adicione as linhas: [CheckQueues] Environment=<Ambiente> Main=CheckQueues nparms=2 parm1=<empresa> parm2=<filial> [ONSTART] Job= CheckQueues Refreshrate=300 6. No configurador acesse Ambiente / Workflow / Parâmetros Wf (WFC000) e marque a opção Utilizar filas de envio de e-mail. Ao executar o comando Configurar será adicionado ao Arquivo de configuração, o job QueueSendMail, que enviará todas a mensagens que estiverem na conta de e-mail do Workflow. Ao ser requisitado para criar uma mensagem de e-mail do Workflow, o Gerenciador de filas escolherá uma das filas ativas e criará a mensagem na caixa de saída da conta de e-mail respectiva da fila. O Job [CheckQueues] será responsável por verificar se as filas estão ativas. Caso alguma fila estiveja indisponível, será enviado um e- mail para o Administrador Workflow (conforme cadastrado em Parâmetros WF[WFC000] ), indicando o nome da fila que está desligada e a desativará. Se todas as filas estiverem desligadas, a funcionalidade de Filas de Envio de e-mail será desligada automaticamente. Parar ativar ou desativar uma fila, deve-se acessar o Cadastro de Filas de e-mail, selecionar uma fila e clicar em Ativar ou Desativar. SIGAWF Filas de envio de email do Workflow 7
INFORMAÇÕES TÉCNICAS Tabelas Utilizadas Rotinas Envolvidas Sistemas Operacionais WFQ Tabela de cadastro de filas de envio de e-mail. WFC008 - Filas de envio de e-mail. Windows 8 SIGAWF Filas de envio de email do Workflow