Filas de envio de e-mail do Workflow
Produto : Microsiga Protheus Workflow Versão 10Chamado : TEUEHH Data da publicação : 05/03/12
País(es) : Todos Banco(s) de Dados : Todos
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. Esta melhoria depende de execução do update de baseUPDWF002, conforme Procedimentos para
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 – Campos: Tabela WFQ – Filas de envio de e-mail
Nome WFQ
Descrição Fila de e-mail
Ac. Filial Compartilhado
Criação no arquivo SX3 – Campos:
Campo WFQ_FILIAL
Tipo Caracter
Tamanho 8
Decimal 0
Título Filial
Descrição Filial do Sistema
Nível 1
Usado Sim
Obrigatório Sim
Browse Não
Relação “.T.”
Help Filial do Sistema
Campo WFQ_NOME
Tipo Caracter
Tamanho 50
Título Nome
Descrição Nome Fila
Nível 0
Usado Sim
Obrigatório Sim
Browse Sim
Relação “.T.”
Help Nome da Fila
Campo WFQ_ROOT
Tipo Caracter
Tamanho 255
Decimal 0
Título Rootpath
Descrição Rootpath Fila
Nível 0
Usado Sim
Obrigatório Sim
Browse Sim
Relação “.T.”
Help Rootpath da Fila
Campo WFQ_HOST
Tipo Caracter
Tamanho 255
Decimal 0
Título Hostname
Descrição Hostname Fila
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Relação “.T.”
Campo WFQ_PORTA
Tipo Numérico
Tamanho 5
Decimal 0
Título Porta
Descrição Porta da Fila
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Relação “.T.”
Help Porta do Servidor da Fila
Campo WFQ_FENV
Tipo Caracter
Tamanho 255
Decimal 0
Título Ambiente
Descrição Ambiente Fila
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Relação “.T.”
Help Ambiente da Fila
Campo WFQ_FEMP
Tipo Caracter
Tamanho 8
Decimal 0
Título Empresa
Descrição Empresa Fila
Nível 0
Obrigatório Não
Browse Sim
Relação “.T.”
Help Empresa da Fila
Campo WFQ_FFIL
Tipo Caracter
Tamanho 8
Decimal 0
Título Filial
Descrição Filial da Fila
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Relação “.T.”
Help Filial da Fila
Campo WFQ_EMAIL
Tipo Caracter
Tamanho 100
Decimal 0
Título Email
Descrição Email Fila
Nível 1
Usado Sim
Obrigatório Não
Browse Sim
Relação “.T.”
Help e-mail da Fila
Campo WFQ_Ativa
Tipo Lógico
Decimal 0
Título Ativa
Descrição Fila Ativa
Nível 1
Usado Sim
Obrigatório Não
Browse Sim
Relação “.T.”
Help Determina se a fila está ativa
Criação no arquivo SIX – Campos:
Índice WFQ
Ordem 1
Chave WFQ_FILIAL + WFQ_NOME
Descrição FILIAL + NOME DA FILA
Mostra pesq. .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;
Filial: Filial utilizada pela fila. Exemplo: 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.
INFORMAÇÕES TÉCNICAS
Tabelas Utilizadas WFQ – Tabela de cadastro de filas de envio de e-mail.
Rotinas Envolvidas WFC008 - Filas de envio de e-mail.