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
- nenhum
- todos
- Espanhol
- todos
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 Smart Client, 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.
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), acesse o Cadastro de Menu (Cadastros/Menu) e adicione 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.
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 |
Decimal | 0 |
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.” |
Help | Hostname do Servidor da Fila |
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 |
Usado | Sim |
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 | |
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 |
Tamanho | 1 |
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. |
Pré-requisitos:
· Antes de cadastrar uma fila de envio de e-mail, é necessário que os servidores do Protheus 11 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.
· Filial: Filial utilizada pela fila.
Exemplo:
· Nome: Fila1
· Hostname: MEUPC
· Porta: 7777
· Rootpath: Z:
· Ambiente: PROTHEUS11
· Empresa: T1
· Filial: D MG 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 contrário, será enviado um e-mail para o Administrador Workflow (conforme cadastrado em Parâmetros WF[WFC000] ), indicando qual 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.
Tabelas Utilizadas | WFQ – Tabela de cadastro de filas de envio de e-mail. |