1. Schedule e Agent

Para a configuração do Schedule e Agent e necessário acessar o Protheus pela porta que irá funcionar o serviço de Schedule, é recomendado que seja uma porta exclusiva para este serviço.

    Iniciando o Schedule: 

1. Acessar Configurador (SIGACFG) pela porta destinada ao schedule e iniciar o serviço do Schedule

    Inclusão do Agent:

1. Acessar Configurador (SIGACFG) pela porta destinada ao schedule e ir na aba 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).
3. Para criar um novo agente, clique na opção “Cadastro”;
4. No canto superior direito clicar no ícone confirme imagem abaixo, ele é um wizard que irá criar os agentes para todos os ambientes configurados com o IP e porta do serviço de schedule ou pela porta que foi acessado o sistema.

         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. 

       Para mais detalhes, acesse o link "A camada do EAI"

2. Agendamentos

Para o funcionamento da integração via mensagem EAI é necessário fazer o cadastro das rotinas FWEAIRECE / FWEAISEND / SCHEDESTMG / FWEAICLEAR, elas são responsáveis pelo envio e recebimento de mensagens e limpeza das tabelas de schedule.

• • 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.
  • FWEAICLEAR: - Rotina de limpeza da fila do EAI Protheus. Quando configurada esta rotina faz a deleção física de todos os registros com o status de 'finalizado', na fila do EAI. Esta limpeza é importante devido ao volume de dados que a tabela XX3 (fila do EAI Protheus) pode atingir.
  • SCHEDESTMG: A rotina SCHEDESTMG que deverá ser responsável por enviar o estoque dos produtos que tiverem movimentação.

Inclusão do Agendamento:

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

1. 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.  

    • 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;   

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…)

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

1. 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;   

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…)

2.3 Inclusão da rotina de Envio das Mensagens do EAI Protheus "FWEAICLEAR":

1. 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: FWEAICLEAR
    • Data: Qual a data da execução do agendamento.
    • Hora: Qual a hora em que a função será executada.
    • 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. Nesta rotina será Módulo 99 – Configurador.
    • 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;  

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…)

2.4 Inclusão da rotina de Envio das Mensagens do EAI Protheus "SCHEDESTMG":

Obs.: Este agendamento deve ser cadastrado somente no momento que for fazer a carga de estoque.

1. 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: SCHEDESTMG
    • Data: Qual a data da execução do agendamento.
    • Hora: Qual a hora em que a função será executada.
    • 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; Nesta rotina será Módulo 04 – Estoque/Custos.
    • 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;  

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…)