Linha Microsiga Protheus

Árvore de páginas

Para que o envio das mensagens assíncronas seja realizado, é necessário efetuar o cadastro das rotinas FWEAIRECE /FWEAISEND, no Schedule Protheus. 
  • FWEAISEND : Esta rotina é exclusiva para o envio das mensagens da fila do EAI. O agendamento desta rotina é realizado por Empresa cadastrada no sistema. No envio da mensagem, um canal de comunicação é aberto com o webservice do produto integrado, e esta comunicação é encerrada após o recebimento  da mensagem de retorno (no caso das Mensagens Única Totvs, após o recebimento da  ReceiptMessage, indicando que que o processo ocorreu corretamente) ou por timeout (mensagem com status de falha).
  • FWEAIRECE :   Esta rotina é exclusiva para o recebimento das mensagens do EAI Protheus. Quando configurada esta rotina inicia o processamento das mensagens disponíveis para processamento na fila do EAI Protheus.

       Inclusão do Agent:

  1.  No Configurador ( SIGACFG) acesse Schedule / Agent. 
  2. Essa tela lista todos os agentes cadastrados e as tarefas atribuídas a cada um. Aqui é possível inicializar ou parar os agentes (todos ou de cada vez) através da seguinte barra de opções: 
  3. Para criar um novo agente, clique na opção “Cadastro”

         Será exibida a tela de manutenção dos agentes.

         Ela exibe os agentes cadastrados no browse superior ( pode selecionar um agente e ver suas configurações na parte debaixo) e, na parte inferior, a área para edição das propriedades do agente. 

            Nessa tela existem as seguintes informações :

  • Código: Valor sequencial que representa o identificador único desse agente no sistema. Ele é preenchido automaticamente;

  • Nome: Nome que identifica o agente. O preenchimento é livre e, sugere-se que indique o tipo de tarefa executada nos agendamentos;

  • IP: Endereço IP do servidor do Protheus no qual o agente se conectará para executar as tarefas agendadas. Embora permitido informar o DNS da máquina na rede (nome da máquina), é interessante sempre informar o IP do servidor;

  • Porta: Porta do serviço do Protheus no IP informado. Essas informações são indispensáveis para que o agente consiga se conectar corretamente;

  • Ambiente: Ambiente do Protheus utilizado para a conexão. Automaticamente, o sistema já traz o ambiente em que o usuário que está fazendo a manutenção está autenticado;

  • Empresa: Qual a empresa em que o Agente irá se logar no sistema. Embora exista essa informação no cadastro, nada impede que o desenvolvedor utilize funções específicas para abrir o ambiente de execução da função em outra empresa;

  • Nome da Empresa: Nome da empresa, de acordo com a instalação do Protheus (sigamat.emp – SM0). Valor preenchido automaticamente através do código da empresa informado anteriormente;

  • Número de Threads: Quantidade de instâncias do Protheus que esse agente irá utilizar quando ativado. Esse controle é muito importante pois impacta diretamente na quantidade de licenças que serão consumidas durante a execução;

  • Habilitado:Flag que indica se o Agente está ativo no momento ou não. Lembrando que as rotinas atreladas a um Agente só serão executadas caso ele esteja ativo, não importando o horário e data para o qual estão agendadas. 

      Importante! 

      Após cadastrar corretamente um Agente, não se esqueça de ativá-lo.

       Para mais detalhes, acesse o link A camada do EAI 

       Inclusão do Agendamento:

       Inclusão da rotina de Recebimento das Mensagens do EAI Protheus: FWEAIRECE

  1. Para incluir um novo agendamento, clique  no item “Cadastro”  
  2. Essa tela irá apresentar uma listagem dos agendamentos já cadastrados e, na parte inferior, uma área de manutenção dos agendamentos:

         As seguintes propriedades do agendamento estão disponíveis para edição:

  • Código: Valor sequencial que representa o identificador único desse agente no sistema. Ele é preenchido automaticamente;

  • Usuário: Usuário do Protheus que será utilizado para inicializar o processo;

  • Nome do usuário: Nome do usuário no sistema. É preenchido à partir do Usuário selecionado no campo anterior;

  • Rotina: FWEAIRECE ( Rotina recebimento de mensagens do EAI Protheus).

  • Data: Qual a data da execução do agendamento.

  • Hora: Qual a hora em que a função será executada.

  • Observe a opção “Recorrência” na barra de opções permite que você especifique a execução em intervalos regulares (diáriamente, mensalmente, anual, a cada X horas…)

    

  • Ambiente: Qual o ambiente que será inicializado na execução; 

  • Empresa/Filial: Qual empresa e filial será aberta no momento da execução. Novamente, repare que esses campos não invalidam funcionalidades que abram e utilizem um ambiente diferente;

  • Módulo: Qual o módulo do Protheus que será utilizado na execução do agendamento. Essa informação é importante pois interfere na forma como o Protheus irá consumir as licenças disponíveis para a execução do job;

  • Nome do Módulo: O nome do módulo selecionado no campo anterior e é preenchido automaticamente;

  • Habilitada:Flag que determina se a execução do agendamento está habilitada ou não; 

  • Descrição: Descrição livre sobre o agendamento;   

     Inclusão da rotina de Envio das Mensagens do EAI Protheus: FWEAISEND:

  1. Para incluir um novo agendamento, clique  no item “Cadastro” 
  2. Essa tela irá apresentar uma listagem dos agendamentos já cadastrados e, na parte inferior, uma área de manutenção dos agendamentos:

       As seguintes propriedades do agendamento estão disponíveis para edição:

  • Código: Valor sequencial que representa o identificador único desse agente no sistema. Ele é preenchido automaticamente;

  • Usuário: Usuário do Protheus que será utilizado para inicializar o processo;

  • Nome do usuário: Nome do usuário no sistema. É preenchido à partir do Usuário selecionado no campo anterior;

  • Rotina: FWEAISEND( Rotina recebimento de mensagens do EAI Protheus).

  • Data: Qual a data da execução do agendamento.

  • Hora: Qual a hora em que a função será executada.

  • Observe a opção “Recorrência” na barra de opções permite que você especifique a execução em intervalos regulares (diariamente, mensalmente, anual, a cada X horas…) 

     

       Ambiente: Qual o ambiente que será inicializado na execução;

  • Empresa/Filial: Qual empresa e filial será aberta no momento da execução. Novamente, repare que esses campos não invalidam funcionalidades que abram e utilizem um ambiente diferente;

  • Módulo: Qual o módulo do Protheus que será utilizado na execução do agendamento. Essa informação é importante pois interfere na forma como o Protheus irá consumir as licenças disponíveis para a execução do job;

  • Nome do Módulo: O nome do módulo selecionado no campo anterior e é preenchido automaticamente;

  • Habilitada:Flag que determina se a execução do agendamento está habilitada ou não;

  • Descrição: Descrição livre sobre o agendamento;