Integração dos dados do sistema com sistemas externos

Índice

Filas de integração

INTDADOS.CAD_FILAS_INTEGRACAO_SISTEMAS_EXTERNOS

Descrição

Interface para manutenção da fila dos registros de integração com sistemas externos.
Esta interface permite consultar e interagir com os registros de integração, permitindo ao usuário:

Campos:

Data e hora em que o registro foi inserido na fila.
Indica a situação do registro.
  • Pendente - Ainda não foi feita uma tentativa de envio.
  • Sucesso - O envio foi realizado com sucesso. Registros pendentes podem ser eliminados após um tempo.
  • Erro - Ocorreu um erro na tentativa de envio. A mensagem de erro fica armazenada no atributo "Mensagem de erro". Registros em "Erro" serão reprocessados no próximo ciclo até que se obtenha sucesso ou que o número máximo de tentativas seja alcançado e, neste caso, o registro passa para "Finalizado".

  • Finalizado - Indica que não foi possível integrar o registro mesmo depois de várias tentativas. Essa é uma situação extrema e que exige uma avaliação do integrador.
Texto meramente informativo para descrever o evento. Este texto é apenas um facilitador para a administração da fila e é criado pela rotina que inclui o registro na mesma. Exemplos:
  • Atualização do produto 98234 - AMPLIFICADOR KT-20
  • Baixar pedidos pendentes
  • Atualizar estoque do produto 20340
Indica o nome do evento a ser integrado.
Este nome de evento é reconhecido pelo integrador. Ver documentação do integrador para saber quais os eventos reconhecidos por ele.
Exemplos:
  • ENVIAR_ESTOQUE - Evento para atualizar o estoque disponível em um sistema externo
  • ENVIAR_PRODUTO - Evento para atualizar o cadastro de um produto em um sistema externo
  • RECEBER_PEDIDOS - Evento para baixar novos pedidos em um sistema externo

Identificador do registro relacionado ao evento. Pode apontar, por exemplo, para um registro a das seguintes entidades:
  • Produto
  • Contrato
  • Pedido
  • etc.
Para maiores detalhes, veja a documentação do evento específico.
Parâmetros adicionais a serem passados para o evento do integrador. Os parâmetros são armazenados no formato CHAVE=VALOR. Os atributos reconhecidos dependem do evento e do integrador. Ver documentação específica para cada evento.
Nome dado para identificar o sistema externo ao qual está sendo feita algum tipo de integração de informações.
Quantidade de vezes que o registro foi enviado porém retornou mensagem de erro.
Quando informado, indica que o registro pode ser excluído após esta data.
O tempo de retenção pode ser definido no integrador e é calculado a partir da data do envio com sucesso.
O domínio LABEL representa um título e é utilizado como elemento delimitador dos grupos de campos de um formulário. O grupo é definido por todos os campos que sucedem o campo do tipo LABEL até encontrar um outro campo LABEL ou o final do formulário.

O domínio possui recursos como:
  • Suporte a expandir/retrair (expand/collapse) os campos do grupo.
  • Tratamento para esconder o título (label) automaticamente quando os campos do grupo não são visíveis.
  • Hint para o grupo.
Data e hora em que ocorreu o evento (tentativa).
Indica se integração ocorreu com sucesso.
Mensagem que indica o erro que ocorreu durante o processamento do registro.
Preenchida apenas quando o registro está com resultado "E".
Mensagem enviada pelo integrador. Este atributo é preenchido pelo integrador e seu propósito é de auxiliar na depuração de problemas relacionados à integração entre os sistemas.
Mensagem recebida do integrador como resposta à mensagem de envio (composta por um XML ou JSON, por exemplo). Este atributo é preenchido pelo integrador e seu propósito é de auxiliar na depuração de problemas relacionados à integração entre os sistemas.

Operações

Topo

Pesquisar

Ao pesquisar, o usuário poderá informar critérios de filtro para listar apenas os registros desejados. Normalmente depois de informar os filtros desejados, o usuário deverá executar a operação [b:Listar].
Obtenha maiores detalhes em Como utilizar a tela de pesquisa?.
Comportamento:Topo

Listar

Apresenta uma lista com os registros que atendem aos filtros informados.
A lista possui diversos recursos práticos e importantes para o usuário:
Pendente
Sucesso
Erro
Finalizado
Comportamento:Topo

Consultar

A consulta de um registro é realizada quando o usuário clica no primeiro link de um dos registros resultantes a operação [b:Listar]. A tela apresenta as informações detalhadas do registro, bem como as ações que o usuário pode disparar a partir dele (alterar, excluir, cancelar, etc.).
Comportamento:Topo

Novo

Permite criar novos registros no sistema. Ao ser executado, o sistema apresenta um formulário com todos os campos do registro que deverão ser preenchidos. Quando todos os campos desejados estiverem preenchidos, clique em [b:Salvar].
Topo

Alterar

A partir da tela de consulta de um registro, esta operação permite alterar os dados do mesmo.
O sistema abre um formulário com os campos editáveis. Após alterar os campos, o usuário deverá clicar em [b:Salvar].
Topo

Excluir

Exclui o registro selecionado. A exclusão do registro pode ser disparada a partir da tela de consulta e/ou de manutenção do mesmo.
O registro somente será excluído se todas as condições necessárias forem encontradas, gerando um erro, caso alguma destas condições não estiver sendo atendida.
Topo

Processar

Tenta reprocessar o envio do registro.
Esta operação somente pode ser executada quando o registro está pendente ou com erro.
Topo

Processar pendentes

Tenta processar todos os registros pendentes.
Topo

Processar todos

Tenta reprocessar os registros filtrados na consulta.
Topo

Excluir todos

Ação que permite excluir todos os registros que obedecem ao filtro informado!