Verificar se duas tabelas batem certo
Descrição
Seção intitulada “Descrição”Antes de fechar, é necessário saber que um conjunto de valores está de acordo com outro: o razão geral com o balancete, um sistema de origem com o respetivo carregamento, os saldos finais deste mês com os saldos iniciais do mês seguinte. Uma reconciliação indica os dois lados e a forma como as respetivas linhas correspondem, e o Weave responde de uma de três formas:
Valores reais do razão geral bate certo com Balancete: todas as 1204 contas coincidem exatamente. Ambos totalizam 12 345 678,90.
Valores reais do razão geral não bate certo com Balancete: 3 de 1204 contas diferem, em 4210,00 no total, ignorando o sinal. Em termos líquidos, Valores reais do razão geral é 3900,00 superior. A maior diferença é a da conta 4000, com 3900,00 de diferença (Valores reais do razão geral 1 000 000,00, Balancete 996 100,00).
O Weave não conseguiu verificar se Valores reais do razão geral bate certo com Balancete: nenhum dos lados tem linhas que correspondam aos filtros desta reconciliação. Se esses dados ainda não foram carregados, carregue-os e verifique novamente.
O Weave nunca indica que uma reconciliação bate certo quando não conseguiu ler ambos os lados na íntegra. A comparação é uma consulta sobre os seus dados.
Criar uma reconciliação
Seção intitulada “Criar uma reconciliação”Só um Arquiteto do projeto pode criar, editar ou eliminar uma reconciliação, e o projeto tem de estar desbloqueado.
- Abra o separador Weave do projeto e clique em Reconciliações, em Close checks, na barra lateral Monitor.
- Clique em Novo.
- Atribua-lhe um Nome e, em As linhas chamam-se, indique o que é uma linha comparada, no plural — “contas”, ou “pares de conta e centro de custo”. O Weave utiliza-o em todas as frases; se o deixar em branco, indica “itens”.
- Em Primeiro lado e Segundo lado, atribua a cada lado uma Etiqueta — o nome que o Weave utiliza para ele, como “Valores reais do razão geral” — e escolha a respetiva Tabela. Em Medida, escolha como as linhas são agregadas — Soma de, Contagem de, Contagem distinta de, Mínimo, Máximo ou Média de — e a coluna.
- Adicione Filtros a qualquer um dos lados para ler apenas algumas das respetivas linhas. Separe vários valores com vírgulas. Para comparar dois períodos de uma tabela, escolha a mesma tabela em ambos os lados e filtre cada lado pelo respetivo período; não adicione a coluna do período em Corresponder por, caso contrário nenhuma linha corresponderá.
- Em Corresponder por, adicione uma linha por cada coluna-chave. Cada linha
emparelha uma coluna do primeiro lado com uma coluna do segundo, pelo que
accountpode corresponder aacct. Atribua um título à linha, como “Conta”; esse título encabeça essa coluna na lista de diferenças. Sem chaves, cada lado é comparado como um único valor — o respetivo total, no caso de uma soma ou de uma contagem. - Opcionalmente, defina uma Tolerância por linha: a distância máxima entre os dois
valores de uma linha para que continuem a coincidir, nas unidades da própria medida,
como
0.01. Não é uma percentagem. Deixe-a a 0 para que todas as linhas coincidam exatamente. - Opcionalmente, escolha um Fluxo de trabalho para colocar a reconciliação na lista de verificação de prontidão para o fecho desse fluxo de trabalho. Consulte Na lista de verificação de prontidão.
- Clique em Guardar rascunho.
O Weave recusa uma reconciliação que não conseguiria comparar de forma justa, e indica porquê:
- Os dois lados precisam do mesmo número de chaves, até 8, e de etiquetas diferentes, e não podem ser idênticos à exceção das etiquetas.
- As colunas-chave emparelhadas têm de conter o mesmo tipo de valor — números, texto,
datas, datas e horas, ou verdadeiro/falso. As colunas de números de vírgula flutuante
(tipos como
floatoudouble) não podem ser chaves, e uma chave não pode ser uma coluna com o nomevalueourows. - Uma medida tem de ser uma coluna numérica, a menos que seja uma contagem.
- Uma média, ou uma soma, mínimo ou máximo de uma coluna de números de vírgula flutuante, requer uma tolerância superior a 0, porque esses valores raramente coincidem exatamente.
- Todas as tabelas e colunas que indica têm de pertencer ao projeto, e o fluxo de trabalho a que está associada também tem de pertencer ao projeto.
- Guardar sem nenhuma alteração é recusado.
Os dois lados podem utilizar medidas diferentes, como uma soma num lado e uma contagem no outro. As linhas em falta só contam como 0 quando ambos os lados utilizam Soma de ou Contagem de; consulte Ler o resultado.
Aprovação
Seção intitulada “Aprovação”Uma reconciliação pode marcar um fluxo de trabalho como pronto para o fecho, pelo que requer duas pessoas. O que guarda é um rascunho. Outro Arquiteto seleciona-o e clica em Aprovar e, a partir daí, essa versão é a que os leitores e a lista de verificação de prontidão executam. Não é possível aprovar uma versão que tenha sido o último a editar, pelo que um projeto precisa de um segundo Arquiteto para pôr uma reconciliação em uso. A aprovação volta a verificar as tabelas e é recusada se o rascunho tiver sido alterado desde que o aprovador o leu.
Editar uma reconciliação aprovada guarda um novo rascunho, e a versão aprovada continua em uso até que a nova seja aprovada. Quando há um rascunho mais recente em espera, o resultado indica-o. Os Arquitetos podem clicar em Verificar o rascunho para executar a versão de trabalho antes de ser aprovada.
Ler o resultado
Seção intitulada “Ler o resultado”Selecione uma reconciliação para a executar. Clique em Verificar de Novo para a executar depois de os dados mudarem.
A coluna Last result guarda o resultado da última execução de cada reconciliação aprovada feita por um Arquiteto do projeto, numa frase como Bateu certo com o Balancete às 06:02. Assim que uma tabela que um dos lados lê volta a ser escrita, indica Não verificado desde e quando essa tabela foi escrita. A mesma frase aparece na resposta a Why this number e na lista de verificação de prontidão. Consulte Quando bateu certo pela última vez.
Quando não bate certo, as linhas que diferem são listadas por baixo da frase, a maior primeiro, com até 50 apresentadas. Cada uma mostra as respetivas chaves, os valores de ambos os lados e o primeiro lado menos o segundo. Uma linha encontrada apenas num lado mostra sem linhas para o outro lado, nunca 0, e uma linha cujo valor está vazio mostra sem valor. Quando há mais linhas diferentes do que as apresentadas, uma legenda indica quantas foram omitidas e qual a diferença total entre elas; adicione filtros para ver menos linhas de cada vez.
-
Tolerância. Uma linha coincide quando os dois valores não estão mais afastados do que a tolerância. Essas pequenas diferenças continuam a somar-se, pelo que uma reconciliação pode bater certo linha a linha enquanto os respetivos totais diferem, e a frase indica-o:
Valores reais do razão geral bate certo com Balancete: cada uma das 1204 contas está dentro da tolerância de 0,01. Em todas as contas, essas pequenas diferenças somam 0,37 em termos líquidos: Valores reais do razão geral totaliza 12 345 679,27 e Balancete 12 345 678,90, pelo que Valores reais do razão geral é 0,37 superior.
-
Linhas em falta. Quando ambos os lados utilizam Soma de ou Contagem de, uma linha que só um dos lados tem conta como 0 no outro lado, pelo que uma linha a 0 num lado e ausente do outro coincide. Um lado sem quaisquer linhas, enquanto o outro tem algumas, é sempre uma diferença.
-
Outras medidas. Para uma contagem distinta, o mínimo, o máximo ou uma média, uma linha que falta num dos lados é uma diferença, e não é apresentado nenhum total, uma vez que esses valores não se somam.
O Weave indica que não foi possível verificar quando não consegue comparar os dois lados na íntegra, e apresenta o motivo, incluindo quando:
- a sua função não pode ler dados de tabelas, ou não pode ver uma das tabelas que um lado lê;
- o acesso às linhas permite-lhe ver apenas algumas das linhas de um lado — uma correspondência numa parte dos dados não é uma correspondência;
- uma tabela ou coluna que a reconciliação utiliza foi removida ou mudou de nome, uma coluna-chave contém agora um tipo de valor diferente, ou uma coluna de medida deixou de conter números ou requer agora uma tolerância que não tem;
- uma pesquisa num lado corresponde agora a mais do que uma linha para algumas entradas;
- nenhum dos lados tem linhas que correspondam aos respetivos filtros, ou nenhum tem valor para qualquer linha;
- a reconciliação ainda não foi aprovada;
- não foi possível executá-la naquele momento, por exemplo quando o armazém de dados demora a responder.
Na lista de verificação de prontidão
Seção intitulada “Na lista de verificação de prontidão”Uma reconciliação associada a um fluxo de trabalho aparece no item desse fluxo de trabalho em todos os conjuntos de prontidão que incluem o fluxo de trabalho, como a linha Reconciliations tie out, com a frase da própria reconciliação e Abrir reconciliação. Uma reconciliação que não bate certo torna o fluxo de trabalho Não pronto. Uma que o Weave não conseguiu verificar, ou que não foi aprovada, torna-o Não foi possível verificar, a menos que outra linha já o torne Não pronto.
A lista de verificação executa a versão aprovada de cada uma, em nome da pessoa que a verifica, pelo que a resposta reflete as linhas que essa pessoa pode ver. Executa até 25 por lista de verificação e concede-lhes um minuto no total; as que excedam esse limite indicam-no em vez de serem executadas, e contam como Não foi possível verificar. Quando o Weave verifica um conjunto antes da respetiva hora limite, executa-as em nome do responsável pelo conjunto, e só lê tabelas se o responsável o podia fazer quando guardou o conjunto pela última vez.
Quem pode ver o quê
Seção intitulada “Quem pode ver o quê”Qualquer pessoa que possa abrir o separador Weave do projeto pode listar as respetivas reconciliações aprovadas. Executar uma também requer uma função que possa ler dados de tabelas. Um leitor que não seja Arquiteto vê o nome e as etiquetas dos lados de cada reconciliação, mas nunca as respetivas tabelas, colunas ou filtros, e os motivos que o Weave lhe apresenta nomeiam apenas os lados.
Através da API
Seção intitulada “Através da API”As reconciliações estão disponíveis através da API da plataforma:
GET /analyze/weave/reconciliations lista as reconciliações de um projeto, e
GET, POST, PUT e DELETE em /analyze/weave/reconciliation leem, criam,
substituem e eliminam uma. POST /analyze/weave/reconciliation/approve aprova um
rascunho: envie digest, definido como o content_digest que leu com ele, que
identifica exatamente a versão que reviu. GET /analyze/weave/reconciliation/run executa uma.
Um lado também pode consultar outras tabelas — uma junção da tabela do lado a uma tabela de pesquisa, que tem de encontrar no máximo uma linha para cada uma das linhas do lado. As pesquisas e a medida Média ponderada de, que requer uma tolerância superior a 0, tal como uma média, só podem ser definidas através da API; o formulário mantém-nas quando edita.
Os agentes de IA ligados através de MCP podem encontrar e executar reconciliações com
reconciliation_find e reconciliation_run. Um Arquiteto ligado com a sua própria
sessão também pode guardar um rascunho com reconciliation_upsert; uma IA que atue em
nome de alguém, como uma sessão de agente, o Microsoft 365 Copilot ou a conversa na
aplicação, não pode. Nenhuma ferramenta MCP aprova uma reconciliação.