Árvore de páginas

Boletim Técnico: Filas de envio de e-mail do Workflow
Ocorrência
Melhoria
Resumo
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
ID do Chamado
TEQBJ4
Produtos
  • Microsiga 11
  • Módulos
    Portais
    • nenhum
    Países
    • todos
    Traduções
    • Espanhol
    Sistema Operacional
  • todos
  • Bancos de Dados
    • todos
    Nome + Fonte
    WFC008 - Filas de envio de e-mail.
    Ajustes no Compatibilizador
    Sim
    Integridade Referencial
    Não
    Aplicação de Patch
    Não
    Compatibilizador 1
    - UPDWF002
    Procedimentos 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  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.

     

    Descrição de Ajustes

    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

    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

    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.

     

    Procedimentos para Configuração

    Procedimentos para Utilização

    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.


    Informações Técnicas

    Tabelas Utilizadas

    WFQ – Tabela de cadastro de filas de envio de e-mail.

    Observações

    • Sem rótulos