Integrações

consulte o catálogo de contratos que conectam o agility ao erp, acompanhe cada tentativa de leitura e reprocesse uma operação quando ela falhar pré requisito você precisa estar dentro de um workspace e ter acesso à opção integrações na seção sistema da barra lateral a tela integrações é o catálogo de adapters do erp para o workspace ativo ela mostra quais leituras estão publicadas, o domínio e a versão de cada contrato, o endpoint que pode ser auditado e a procedência do dado a tela não altera fatos no erp são operações de consulta, e qualquer correção deve ser feita no sistema de origem no ambiente de demonstração, o cabeçalho identifica explicitamente o adapter de demonstração os contratos usam o mesmo contrato http do produto, mas são atendidos por um adapter determinístico; portanto, nenhum dado desta tela deve ser interpretado como uma sincronização viva com o erp quando o modo erp real estiver ligado, a própria tela passa a informar que as consultas são feitas ao erp corporativo e cada leitura registra uma execução passo a passo abrir o catálogo do workspace na barra lateral, expanda o grupo sistema e clique em integrações a página mostra o título integrações e o subtítulo integrações configuradas para este workspace o catálogo é contextualizado pelo workspace selecionado no topo; se o identificador do workspace não puder ser resolvido, a página informa que o workspace não foi encontrado em vez de exibir contratos de outro contexto conferir a procedência da conexão leia o cartão superior antes de interpretar qualquer contrato no ambiente usado neste manual, o cartão diz adapter de demonstração e explica que os contratos são atendidos por um adapter determinístico, com o mesmo contrato http do produto, mas sem dados vindos do erp em uma instalação ligada ao erp, o cartão muda para integração ao vivo com o erp e informa que as leituras consultam o erp corporativo e registram uma execução identificar os contratos disponíveis cada cartão de contrato apresenta o nome funcional, o selo de disponibilidade e o estado de sincronização no workspace portal de serviços, o catálogo povoado exibe projetos (dimensão do erp), parceiros (clientes e fornecedores), centros de custo, títulos a pagar e a receber, saldo de orçamento por projeto e posição de aging e ciclo de caixa o estado sem sincronização e a frase nunca sincronizado significam que ainda não houve uma execução bem sucedida para aquele contrato; não significam que o contrato está indisponível auditar domínio, versão e endpoint abaixo do nome de cada contrato, confira o endpoint publicado, o domínio e a versão os contratos de registro usam get /api/registry/projects e get /api/registry/partners, no domínio registry, contrato v1 os contratos financeiros usam get /api/finance/cost centers e get /api/finance/financial documents, no domínio finance, contrato v1 o saldo por projeto usa get /api/costing/budget consumptions/balance by dimension, no domínio costing, contrato v1; aging informa get /api/finance/aging/kpis + /aging/top debtors, no domínio finance, contrato v1 interpretar os selos de estado o selo disponível indica que o contrato está publicado para consulta ao lado dele, o selo de frescor diferencia o dado atual, simulado, defasado ou desconhecido no adapter de demonstração, um resultado determinístico correto continua sendo identificado como simulado — não como atual quando a última tentativa falha, o cartão mostra a mensagem da falha e, se o dado estiver defasado, avisa que as telas continuam exibindo o último dado conhecido marcado como defasado ver o histórico de tentativas no contrato desejado, clique em ver tentativas a tela abre uma tabela abaixo dos botões com as colunas quando, resultado, itens, duração e correlação cada linha informa a data e hora de conclusão, ok ou erro, a quantidade de itens retornados, a duração em milissegundos e o correlation id o histórico é somente de acompanhamento e é cumulativo uma nova execução não apaga a tentativa anterior localizar uma falha para reprocessamento se a última execução falhar, leia o texto ao lado do ícone de alerta no cartão e abra ver tentativas para conferir o erro, a quantidade e o correlation id use essas informações para diferenciar uma falha transitória de uma resposta sem itens a tentativa que falhou permanece visível depois de qualquer nova tentativa, o que permite comparar o resultado anterior com o reprocessamento passo 8 — reprocessar uma operação sem parâmetros para contratos que não dependem de uma dimensão específica, clique em reprocessar o botão fica desabilitado durante o processamento e troca seu texto para reprocessando… ao terminar, o agility recarrega o contrato e as tentativas; o cartão atualiza o último resultado e a lista ganha uma nova linha o reprocessamento repete a leitura do contrato, não edita o fato correspondente no erp tratar o saldo de orçamento por projeto no cartão saldo de orçamento por projeto, o botão reprocessar aparece desabilitado e vem acompanhado da explicação de que a consulta exige informar projeto e data não tente contornar essa restrição clicando repetidamente esta tela não tem os campos necessários para montar esses parâmetros abra a superfície que solicita projeto e data para uma consulta parametrizada, ou corrija o dado no erp de origem conforme a regra do processo verificar o resultado depois de uma execução concluída, confirme a nova data em última sincronização bem sucedida em… e abra ver tentativas para localizar a linha mais recente um resultado ok, sua quantidade de itens, duração e correlation id são a evidência operacional da leitura se a execução continuar em erro, o cartão mantém a mensagem de falha e o estado defasado quando aplicável; isso é uma informação para investigação, não uma confirmação de atualização verificação o cabeçalho identifica explicitamente se a conexão é um adapter de demonstração ou uma integração ao vivo com o erp cada contrato mostra nome, disponibilidade, frescor, domínio, versão, endpoint e última sincronização (ou nunca sincronizado) ver tentativas revela data/hora, resultado, quantidade de itens, duração e correlation id sem apagar linhas anteriores após um reprocessamento permitido, uma nova execução aparece no histórico e o cartão atualiza o último resultado; o contrato parametrizado permanece corretamente bloqueado sem projeto e data erros comuns o catálogo mostra erro de carregamento confira se você está dentro de um workspace válido e recarregue a página a rota interrompe o carregamento quando não recebe workspaceid ou quando a consulta de contratos falha; ela mostra uma mensagem de erro em vez de apresentar uma lista parcial um contrato aparece como defasado leia a mensagem da última tentativa e abra o histórico defasado significa que a última leitura não confirmou um dado novo, embora o último dado conhecido possa continuar sendo exibido reprocesse apenas contratos sem parâmetros e confirme o novo resultado; para o saldo por projeto, informe projeto e data na consulta apropriada o botão reprocessar está desabilitado no contrato saldo de orçamento por projeto isso é intencional a operação requer projeto e data e a tela de catálogo não os coleta em outros contratos, aguarde o processamento terminar; o botão também fica desabilitado enquanto a chamada está em andamento a execução foi bem sucedida, mas o dado continua marcado como simulado esse é o comportamento honesto do adapter de demonstração simulado descreve a procedência do resultado, não a qualidade da resposta somente a configuração de uma integração erp real muda o modo indicado no cabeçalho o histórico não abre a tabela de tentativas é carregada separadamente do catálogo se a consulta falhar, a lista não é exibida e a mensagem falha ao carregar as tentativas aparece no cartão; registre o erro e tente novamente, sem interpretar a ausência da tabela como ausência de execuções