Painel da integração: mudanças entre as edições

De CIGAM WIKI
Sem resumo de edição
Sem resumo de edição
 
(2 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 3: Linha 3:
<p>
<p>
O painel disponibiliza métricas, monitoramento e rastreabilidade da integração.
O painel disponibiliza métricas, monitoramento e rastreabilidade da integração.
[[Arquivo:Mercos integracaoHome.png|miniaturadaimagem]]
</p>
</p>
[[Arquivo:Mercos_integracaoHome.png]]


<h2>Métricas Iniciais</h2>
<h2>Métricas Iniciais</h2>
 
[[Arquivo:Mercos_integracaoHomeVinculos.png]]
<p>
Painel que mostra o andamento da integração:
</p>
<ul>
<ul>
     <li>Tarefas na fila</li>
     <li>Tarefas na fila
     <li>Vínculos De/Para</li>
* Indica quantas tarefas estão aguardando na fila , geralmente são tarefas de envio de dados do CIGAM para o MERCOS</li>
     <li>Pedidos importados</li>
     <li>Vínculos De/Para
     <li>Logs processados</li>
* Indica o total de vínculos de/para armazenados e controlados pela integração.
* Vínculos de/para são  dados vinculados entre Id mercos e ID CIGAM de cada registro</li>
     <li>Pedidos importados
* Total de pedidos importados pela integração, são pedidos que são baixados do MERCOS para dentro do CIGAM</li>
     <li>Logs processados
* Cada comunicação efetuada entre os sistemas é armazenada em LOG, isso possibilita rastrear o resultado de cada comunicação efetuada entre os dois sistemas e ver como um determinado dado foi enviado e recebido.</li>
</ul>
</ul>


<h2>Classificação dos Logs</h2>
<h2>Classificação dos Logs</h2>
 
[[Arquivo:Mercos_integraçãohomeLogs.png]]
<ul>
<ul>
     <li><strong>Azul:</strong> envio para o MERCOS</li>
     <li><strong>Azul:</strong> envio para o MERCOS</li>
     <li><strong>Verde:</strong> resposta HTTP 200 ou 201</li>
     <li><strong>Verde:</strong> resposta HTTP 200 ou 201</li>
     <li><strong>Vermelho:</strong> erro de comunicação</li>
     <li><strong>Vermelho:</strong> erro de comunicação
* Erros de comunicação podem ocorrer por seguintes situações:
** Indisponibilidade temporária da api Mercos, o Código Http armazenado no log ajudará a diagnosticar.
** Envio Incorreto de alguma informação ou falta dela. Exemplo: No Mercos pode estar marcado que o telefone é um campo obrigatório e o cadastro da empresa no CIGAM pode estar vazio.
** Nos casos de erros o diagnostico deve ser feito caso a caso pois as regras de negócio podem variar.</li>
</ul>
</ul>
<h2>Gráfico de Vínculos e Respostas</h2>
<p>
Apresenta a quantidade de vínculos por entidade e respostas HTTP retornadas pela API.
</p>


<h2>Fila de Processos</h2>
<h2>Fila de Processos</h2>
<p>
<p>
Lista os processos aguardando execução.
Lista os processos aguardando execução.
* Quando um evento ocorre no CIGAM  uma tarefa é adicionada na fila de envio para o Mercos.
* Exemplos:
** Um novo cliente é Cadastrado no CIGAM, uma ação GEEMPRES é adicionada na fila para envio ao Mercos.
** Um cadastro de cliente é Editado no CIGAM, uma ação GEEMPRES é adicionada na fila para envio ao Mercos.
** Um preço é alterado na tabela, uma ação GEPRECTA é adicionada na fila para envio ao Mercos.
** Um pedido troca de Controle no CIGAM, uma ação STATUSPEDIDO é adicionada na fila para envio ao Mercos.
** Um pedido é faturado no CIGAM, uma ação FATURAPEDIDO é adicionada na fila para envio ao Mercos.
** Um pedido é cancelado no CIGAM, uma ação CANCELAPEDIDO é adicionada na fila para envio ao Mercos.
** A Execução das tarefas da fila é parametrizada conforme o volume de eventos que ocorrem na base do Cliente,  por padrão a fila é executada a cada 3 ou 4 minutos podendo baixar a 2 minutos.
</p>
</p>


Linha 40: Linha 54:
Apresenta as últimas comunicações realizadas entre MERCOS e CIGAM.
Apresenta as últimas comunicações realizadas entre MERCOS e CIGAM.
</p>
</p>
<p>
A integração serve como um intérprete entre dois sistemas completamente diferentes. A Mercos disponibiliza sua interface de programação de Aplicações (API) para que seja consumida para envio e retorno de informação entre os sistemas. Nesta questão, em vários momentos a integração pergunta e o Mercos responde. Para que possamos rastrear Como um dado foi enviado ao Mercos ou Como um dado veio do Mercos, a integração armazena logs para diagnosticos.
</p>
<p>
<p>
Próxima Página
Próxima Página
</p>
</p>
* [[Menu da Integração]]
* [[Menu da Integração]]

Edição atual tal como às 16h54min de 21 de agosto de 2026

Painel da Integração

O painel disponibiliza métricas, monitoramento e rastreabilidade da integração.

Métricas Iniciais

Painel que mostra o andamento da integração:

  • Tarefas na fila
    • Indica quantas tarefas estão aguardando na fila , geralmente são tarefas de envio de dados do CIGAM para o MERCOS
  • Vínculos De/Para
    • Indica o total de vínculos de/para armazenados e controlados pela integração.
    • Vínculos de/para são dados vinculados entre Id mercos e ID CIGAM de cada registro
  • Pedidos importados
    • Total de pedidos importados pela integração, são pedidos que são baixados do MERCOS para dentro do CIGAM
  • Logs processados
    • Cada comunicação efetuada entre os sistemas é armazenada em LOG, isso possibilita rastrear o resultado de cada comunicação efetuada entre os dois sistemas e ver como um determinado dado foi enviado e recebido.

Classificação dos Logs

  • Azul: envio para o MERCOS
  • Verde: resposta HTTP 200 ou 201
  • Vermelho: erro de comunicação
    • Erros de comunicação podem ocorrer por seguintes situações:
      • Indisponibilidade temporária da api Mercos, o Código Http armazenado no log ajudará a diagnosticar.
      • Envio Incorreto de alguma informação ou falta dela. Exemplo: No Mercos pode estar marcado que o telefone é um campo obrigatório e o cadastro da empresa no CIGAM pode estar vazio.
      • Nos casos de erros o diagnostico deve ser feito caso a caso pois as regras de negócio podem variar.

Fila de Processos

Lista os processos aguardando execução.

  • Quando um evento ocorre no CIGAM uma tarefa é adicionada na fila de envio para o Mercos.
  • Exemplos:
    • Um novo cliente é Cadastrado no CIGAM, uma ação GEEMPRES é adicionada na fila para envio ao Mercos.
    • Um cadastro de cliente é Editado no CIGAM, uma ação GEEMPRES é adicionada na fila para envio ao Mercos.
    • Um preço é alterado na tabela, uma ação GEPRECTA é adicionada na fila para envio ao Mercos.
    • Um pedido troca de Controle no CIGAM, uma ação STATUSPEDIDO é adicionada na fila para envio ao Mercos.
    • Um pedido é faturado no CIGAM, uma ação FATURAPEDIDO é adicionada na fila para envio ao Mercos.
    • Um pedido é cancelado no CIGAM, uma ação CANCELAPEDIDO é adicionada na fila para envio ao Mercos.
    • A Execução das tarefas da fila é parametrizada conforme o volume de eventos que ocorrem na base do Cliente, por padrão a fila é executada a cada 3 ou 4 minutos podendo baixar a 2 minutos.

Últimos Logs

Apresenta as últimas comunicações realizadas entre MERCOS e CIGAM.

A integração serve como um intérprete entre dois sistemas completamente diferentes. A Mercos disponibiliza sua interface de programação de Aplicações (API) para que seja consumida para envio e retorno de informação entre os sistemas. Nesta questão, em vários momentos a integração pergunta e o Mercos responde. Para que possamos rastrear Como um dado foi enviado ao Mercos ou Como um dado veio do Mercos, a integração armazena logs para diagnosticos.

Próxima Página