두 테이블이 일치하는지 확인
마감하기 전에 한 수치 집합이 다른 수치 집합과 일치하는지 알아야 합니다. 총계정원장과 시산표, 소스 시스템과 그 로드 결과, 이번 달 기말 잔액과 다음 달 기초 잔액이 그 예입니다. 대사는 두 측과 각 측의 행이 일치하는 방식을 지정하며, Weave는 다음 세 가지 중 하나로 답합니다.
총계정원장 실적이 시산표와 일치합니다. 계정 1,204개가 모두 정확히 일치합니다. 양쪽 합계는 모두 12,345,678.90입니다.
총계정원장 실적이 시산표와 일치하지 않습니다. 계정 1,204개 중 3개가 다르며, 부호를 무시한 차이는 총 4,210.00입니다. 상계하면 총계정원장 실적이 3,900.00 더 큽니다. 가장 큰 차이는 4000으로, 3,900.00 차이가 납니다(총계정원장 실적 1,000,000.00, 시산표 996,100.00).
Weave가 총계정원장 실적이 시산표와 일치하는지 검사할 수 없었습니다. 어느 측에도 이 대사의 필터와 일치하는 행이 없습니다. 해당 데이터가 아직 로드되지 않았다면 로드한 후 다시 확인하십시오.
Weave는 두 측을 모두 완전히 읽을 수 없었을 때 대사가 일치한다고 말하지 않습니다. 비교는 데이터에 대한 쿼리입니다.
대사 만들기
섹션 제목: “대사 만들기”프로젝트 아키텍트만 대사를 만들거나 편집하거나 삭제할 수 있으며, 프로젝트가 잠금 해제되어 있어야 합니다.
- 프로젝트의 Weave 탭을 열고 Monitor 레일의 Close checks 아래에서 대사를 클릭합니다.
- 새로 만들기를 클릭합니다.
- 이름을 지정하고, 행 명칭 아래에 비교되는 행 하나가 무엇인지 복수형으로 입력합니다. 예: “계정” 또는 “계정 및 원가 센터 쌍”. Weave는 모든 문장에서 이 명칭을 사용하며, 비워 두면 “항목”이라고 표시합니다.
- 첫 번째 측과 두 번째 측 아래에서 각 측에 레이블(Weave가 해당 측을 부르는 이름, 예: “총계정원장 실적”)을 지정하고 테이블을 선택합니다. 측정값 아래에서 행을 집계하는 방식(합계:, 개수:, 고유 개수:, 최솟값, 최댓값 또는 평균: 중 하나)과 열을 선택합니다.
- 어느 측에든 필터를 추가하여 일부 행만 읽을 수 있습니다. 여러 값은 쉼표로 구분합니다. 한 테이블의 두 기간을 비교하려면 양쪽에 같은 테이블을 선택하고 각 측을 해당 기간으로 필터링합니다. 기간 열을 일치 기준 아래에 추가하지 마십시오. 추가하면 일치하는 행이 없게 됩니다.
- 일치 기준 아래에서 키 열마다 한 행씩 추가합니다. 각 행은 첫 번째 측의 열과 두 번째 측의
열을 짝지으므로,
account를acct와 일치시킬 수 있습니다. 행에 “계정”과 같은 제목을 지정합니다. 이 제목은 차이 목록에서 해당 열의 머리글이 됩니다. 키가 없으면 각 측이 하나의 수치(합계 또는 개수의 경우 그 총계)로 비교됩니다. - 필요한 경우 행별 허용 오차를 설정합니다. 이는 행의 두 값이 얼마나 차이 나도 일치하는
것으로 볼지를 측정값 자체의 단위로 나타낸 값입니다(예:
0.01). 백분율이 아닙니다. 모든 행이 정확히 일치해야 하면 0으로 둡니다. - 필요한 경우 워크플로를 선택하여 해당 워크플로의 마감 준비 상태 체크리스트에 대사를 추가합니다. 준비 상태 체크리스트에서를 참조하십시오.
- 초안 저장을 클릭합니다.
Weave는 공정하게 비교할 수 없는 대사를 거부하고 그 이유를 알려 줍니다.
- 두 측은 키 수가 같아야 하며(최대 8개), 레이블이 달라야 하고, 레이블을 제외하고 동일할 수 없습니다.
- 짝지어진 키 열은 같은 종류의 값(숫자, 텍스트, 날짜, 날짜 및 시간, 또는 참/거짓)을 담아야
합니다. 부동 소수점 숫자 열(
float또는double과 같은 유형)은 키가 될 수 없으며, 이름이value또는rows인 열도 키가 될 수 없습니다. - 개수를 세는 경우가 아니면 측정값은 숫자 열이어야 합니다.
- 부동 소수점 숫자 열의 평균, 합계, 최솟값 또는 최댓값은 이러한 값이 정확히 일치하는 경우가 드물기 때문에 0보다 큰 허용 오차가 필요합니다.
- 대사가 지정하는 모든 테이블과 열은 프로젝트에 있어야 하며, 연결된 워크플로도 프로젝트에 있어야 합니다.
- 변경 사항 없이 저장하면 거부됩니다.
두 측은 한쪽은 합계, 다른 쪽은 개수처럼 서로 다른 측정값을 사용할 수 있습니다. 누락된 행은 두 측이 모두 합계: 또는 개수: 측정값을 사용할 때만 0으로 간주됩니다. 결과 읽기를 참조하십시오.
대사는 워크플로를 마감 준비됨으로 표시할 수 있으므로 두 사람이 필요합니다. 저장한 내용은 초안입니다. 다른 아키텍트가 초안을 선택하고 승인을 클릭하면, 그때부터 해당 버전이 읽는 사람과 준비 상태 체크리스트가 실행하는 버전이 됩니다. 마지막으로 편집한 사람이 자신인 버전은 승인할 수 없으므로, 대사를 사용하려면 프로젝트에 두 번째 아키텍트가 필요합니다. 승인할 때 테이블을 다시 검사하며, 승인자가 초안을 읽은 후 초안이 변경되었으면 승인이 거부됩니다.
승인된 대사를 편집하면 새 초안이 저장되며, 새 초안이 승인될 때까지는 승인된 버전이 계속 사용됩니다. 더 새로운 초안이 대기 중이면 결과에 그 사실이 표시됩니다. 아키텍트는 초안 확인을 클릭하여 승인 전에 작업 중인 버전을 실행할 수 있습니다.
결과 읽기
섹션 제목: “결과 읽기”대사를 선택하면 실행됩니다. 데이터가 변경된 후 다시 실행하려면 다시 확인을 클릭합니다.
Last result 열에는 프로젝트 아키텍트가 승인된 각 대사를 마지막으로 실행한 결과가 06:02에 Trial Balance와 일치함. 과 같은 한 문장으로 보관됩니다. 어느 한쪽이 읽는 테이블이 다시 기록되면 Not checked since와 함께 그 테이블이 기록된 시점이 표시됩니다. 같은 문장이 Why this number의 답변과 준비 상태 체크리스트에도 표시됩니다. 마지막으로 일치한 시점을 참조하십시오.
일치하지 않으면 다른 행이 문장 아래에 큰 차이부터 최대 50개까지 나열됩니다. 각 행에는 키, 양쪽 측의 값, 첫 번째 측에서 두 번째 측을 뺀 값이 표시됩니다. 한쪽에만 있는 행은 다른 측에 0이 아니라 행 없음으로 표시되고, 값이 비어 있는 행은 값 없음으로 표시됩니다. 표시된 것보다 많은 행이 다르면 캡션에 제외된 행 수와 그 행들의 차이 합계가 표시됩니다. 한 번에 더 적은 행을 보려면 필터를 추가하십시오.
-
허용 오차. 행의 두 값 차이가 허용 오차 이하이면 행이 일치합니다. 이러한 작은 차이도 누적되므로, 대사가 행별로는 일치하지만 합계는 다를 수 있으며, 그러면 문장에 그 사실이 표시됩니다.
총계정원장 실적이 시산표와 일치합니다. 계정 1,204개가 모두 허용 오차 0.01 이내입니다. 전체 계정에서 이러한 작은 차이를 상계하면 0.37입니다. 총계정원장 실적의 합계는 12,345,679.27이고 시산표는 12,345,678.90이므로, 총계정원장 실적이 0.37 더 큽니다.
-
누락된 행. 두 측이 모두 합계: 또는 개수: 측정값을 사용하면, 한쪽에만 있는 행은 다른 측에서 0으로 간주되므로 한쪽에서 0이고 다른 쪽에 없는 행은 일치합니다. 다른 측에는 행이 있는데 한 측에 행이 전혀 없으면 항상 차이로 간주됩니다.
-
기타 측정값. 고유 개수, 최솟값, 최댓값 또는 평균의 경우 한쪽에 없는 행은 차이로 간주되며, 이러한 값은 합산되지 않으므로 합계가 제공되지 않습니다.
Weave는 두 측을 완전히 비교할 수 없으면 검사할 수 없음이라고 말하고 이유를 알려 줍니다. 다음과 같은 경우가 포함됩니다.
- 역할에 테이블 데이터를 읽을 권한이 없거나, 한 측이 읽는 테이블 중 하나를 볼 수 없는 경우
- 행 액세스로 한 측의 행 중 일부만 볼 수 있는 경우. 데이터의 일부에서 일치하는 것은 일치가 아닙니다.
- 대사가 사용하는 테이블이나 열이 제거되었거나 이름이 바뀌었거나, 키 열이 이제 다른 종류의 값을 담고 있거나, 측정값 열이 더 이상 숫자를 담고 있지 않거나 이제 설정되지 않은 허용 오차가 필요한 경우
- 한 측의 조회가 이제 일부 항목에 대해 둘 이상의 행과 일치하는 경우
- 어느 측에도 필터와 일치하는 행이 없거나, 어느 측에도 값이 있는 행이 없는 경우
- 대사가 아직 승인되지 않은 경우
- 웨어하우스의 응답이 느린 경우처럼 지금 당장 실행할 수 없었던 경우
준비 상태 체크리스트에서
섹션 제목: “준비 상태 체크리스트에서”워크플로에 연결된 대사는 해당 워크플로를 포함하는 모든 준비 상태 세트의 해당 워크플로 항목에 Reconciliations tie out 줄로 표시되며, 각 대사의 문장과 대사 열기가 함께 표시됩니다. 일치하지 않는 대사가 있으면 워크플로는 준비되지 않음이 됩니다. Weave가 검사할 수 없었거나 승인되지 않은 대사가 있으면, 다른 줄이 이미 준비되지 않음으로 만들지 않는 한 워크플로는 검사할 수 없음이 됩니다.
체크리스트는 확인하는 사람의 권한으로 각 대사의 승인된 버전을 실행하므로, 그 답은 해당 사람이 볼 수 있는 행을 반영합니다. 체크리스트당 최대 25개를 실행하며 모두 합쳐 1분이 주어집니다. 이를 넘는 대사는 실행되지 않고 그렇다고 알려 주며, 검사할 수 없음으로 집계됩니다. Weave가 마감 시간 전에 세트를 검사할 때는 세트 담당자의 권한으로 대사를 실행하며, 담당자가 세트를 마지막으로 저장했을 때 테이블을 읽을 수 있었던 경우에만 테이블을 읽습니다.
누가 무엇을 볼 수 있는가
섹션 제목: “누가 무엇을 볼 수 있는가”프로젝트의 Weave 탭을 열 수 있는 사람은 누구나 승인된 대사를 나열할 수 있습니다. 대사를 실행하려면 테이블 데이터를 읽을 수 있는 역할도 필요합니다. 아키텍트가 아닌 사용자는 각 대사의 이름과 측 레이블만 보며, 테이블, 열, 필터는 볼 수 없습니다. Weave가 그러한 사용자에게 알려 주는 이유도 측의 이름만 언급합니다.
API 사용
섹션 제목: “API 사용”대사는 플랫폼 API를 통해 사용할 수 있습니다. GET /analyze/weave/reconciliations는
프로젝트의 대사를 나열하며, /analyze/weave/reconciliation에 대한 GET, POST, PUT,
DELETE는 대사 하나를 읽고, 만들고, 대체하고, 삭제합니다.
POST /analyze/weave/reconciliation/approve는 초안을 승인합니다. 초안과 함께 읽은
content_digest로 설정한 digest를 보내십시오. 이 값은 검토한 버전을 정확히 식별합니다.
GET /analyze/weave/reconciliation/run은 대사 하나를 실행합니다.
한 측은 다른 테이블을 조회할 수도 있습니다. 이는 해당 측의 테이블에서 조회 테이블로의 조인이며, 측의 각 행에 대해 최대 한 행만 찾아야 합니다. 조회와 가중 평균: 측정값(평균과 마찬가지로 0보다 큰 허용 오차가 필요함)은 API를 통해서만 설정할 수 있으며, 양식에서 편집할 때도 유지됩니다.
MCP를 통해 연결된 AI 에이전트는 reconciliation_find와 reconciliation_run으로 대사를 찾고
실행할 수 있습니다. 자신의 로그인으로 연결된 아키텍트는 reconciliation_upsert로 초안을 저장할
수도 있습니다. 에이전트 세션, Microsoft 365 Copilot 또는 앱 내 채팅처럼 다른 사람을 대신하여
작동하는 AI는 초안을 저장할 수 없습니다. 대사를 승인하는 MCP 도구는 없습니다.