# 다중 페이지 병합: 여러 페이지의 결과를 하나로 결합

> 다중 페이지 병합은 한 문서에 속하는 추출된 행을 단일 레코드로 결합합니다. 이 페이지에서는 행을 그룹화하는 세 가지 방법, 충돌하는 값이 처리되는 방식, 그리고 이 설정이 적용되는 시점을 설명합니다.

[**Multi-Page Merge**](/docs/reference/glossary#multi-page-merge)는 동일한 문서에 속하는 추출 결과를 하나의 레코드로 결합합니다. 한 문서가 여러 파일로 업로드될 때 — 신분증 앞면과 뒷면을 따로 촬영한 경우, 여러 페이지에 걸친 은행 명세서, 여러 조각으로 스캔된 계약서 — 각 파일은 독립적으로 처리되어 각자의 결과를 생성합니다. Multi-Page Merge를 켜면 앱이 어떤 행이 서로 관련이 있는지 인식하고 이를 단일 [병합 그룹](/docs/reference/glossary#merge-group)으로 접는 방법을 알 수 있습니다.

## 동일한 문서가 여러 행으로 표시될 수 있는 이유

업로드하는 모든 파일은 독립적으로 처리되어 각자의 결과를 생성합니다. 단일 업로드 자체가 여러 행을 생성할 수 있습니다 — 은행 명세서의 한 페이지에 수십 개의 거래가 포함되어 있고, 각 거래가 자체 행이 되는 경우입니다. 따라서 세 개의 파일로 도착하는 문서는 결과의 한 행을 생성하지 않고, 파일당 하나씩 세 개의 별도 행 집합을 생성합니다.

한 문서가 여러 파일로 분할되는 일반적인 경우는 다음과 같습니다:

- **신분증**이 두 이미지로 촬영된 경우: 앞면에는 이름과 ID 번호가 있고, 뒷면에는 주소와 만료 날짜가 있습니다.
- **은행 명세서**가 여러 페이지에 걸쳐 있는 경우: 계좌 번호는 1페이지 상단에 한 번 나타나고, 거래 테이블은 다음 페이지에 계속됩니다.
- **다중 페이지 계약서**가 페이지별로 스캔된 경우, 계약 번호나 서명 블록이 일부 페이지에만 나타납니다.

Multi-Page Merge는 페이지가 아닌 **행** 단위로 작동합니다. 먼저 어떤 행이 서로 관련이 있는지 결정한 다음 각 그룹의 값을 결합합니다. 그룹화 규칙은 [템플릿](/docs/reference/glossary#template)에 저장되므로, 한 번 구성하면 해당 템플릿으로 처리되는 모든 [배치](/docs/reference/glossary#batch)에 적용됩니다.

## 파일을 하나의 레코드로 그룹화하는 세 가지 방법

템플릿 설정에서 세 가지 병합 모드 중 정확히 하나를 선택합니다. 각 모드는 "어떤 결과가 서로 관련이 있는가?"라는 동일한 질문에 서로 다른 방식으로 답합니다.

### Sequential Merge

이 모드는 업로드 순서대로 파일을 읽습니다. 선택한 [열](/docs/reference/glossary#column) 이 비어 있거나 동일한 값으로 유지되는 한, 해당 파일들은 하나의 레코드로 함께 유지됩니다. 열에 새롭고 다른 값이 나타나는 순간, 그 지점부터 새 레코드가 시작됩니다. 이는 식별 값이 한 번만 나타나는 문서에 적합합니다 — 예를 들어 1페이지에만 인쇄된 송장 번호나 각 계약서 상단에 나타나는 이름과 같은 경우입니다.

Sequential Merge를 선택하면 **Where to break** — 새 레코드를 시작하는 조건 — 도 함께 선택하게 됩니다. **Break on value change**가 기본적으로 선택되어 있습니다.

| 중단 조건 | 새 레코드를 시작하는 조건 |
| --- | --- |
| Break on value change | 파일은 업로드 순서대로 처리됩니다. 선택한 열이 비어 있거나 변경되지 않은 동안에는 동일한 레코드에 유지됩니다. 열에 다른 값이 표시되는 첫 번째 파일에서 새 레코드가 시작됩니다. |
| Break on a blank item | 모든 열이 완전히 비어 있는 파일은 구분 기호로 처리됩니다. 그 앞의 모든 파일이 하나의 레코드가 되고, 바로 다음 파일이 새 레코드를 시작합니다. |
| Break when a value appears | 선택한 열에 내용이 처음으로 있는 파일 — 내용이 무엇이든 관계없이 — 새 레코드를 시작합니다. 도장, 체크 표시, 또는 새 문서를 표시하는 필드가 있는 경우에 유용합니다. |
| Break on a specific value | 선택한 열이 입력한 텍스트 또는 패턴과 일치하는 파일에서 새 레코드가 시작됩니다. 일반 텍스트는 그대로 작동하며, INV-\d+ 와 같은 패턴은 고정된 값 대신 형식을 일치시킵니다. |

### Match by Value

이 모드는 업로드 순서를 무시합니다. 선택한 열에서 동일한 값을 공유하는 모든 파일은 업로드된 위치와 관계없이 하나의 레코드로 결합됩니다. 서로 다른 문서의 파일이 섞여 있는 배치에 적합합니다. 예를 들어 여러 주문의 통관 문서가 특별한 순서 없이 촬영된 경우, 주문 번호가 어떤 파일들이 함께 속하는지 식별하는 값이 됩니다.

모든 결과를 서로 비교하기 때문에, 이 모드는 그룹화되어야 하는 모든 파일에서 선택한 열이 존재하고 올바르게 읽혀야 합니다. 해당 열의 값이 비어 있으면, 그 파일은 그룹에 매칭되지 않고 자체 레코드로 남습니다.

### Fixed Count

이 모드는 내용을 완전히 무시합니다. 연속된 N개의 파일이 하나의 레코드가 됩니다. 그룹 크기(N)를 입력하면 앱이 파일을 고정된 블록으로 결합합니다. 항상 동일한 수의 서로 다른 항목으로 구성된 레코드를 위한 것입니다. 예를 들어 영수증 사진, 은행 결제 스크린샷, 승인 이메일로 항상 구성되는 비용 레코드의 경우 레코드당 세 개의 파일이 필요합니다.

## 여러 파일이 값에 대해 일치하지 않는 경우

행이 그룹화되면 앱은 필드별로 결합합니다. 모든 파일이 일치하거나 하나의 파일만 값을 가진 열은 공유 값으로 처리되어 레코드의 모든 행에 채워집니다. 예를 들어 1페이지에만 나타나는 계정 번호가 이후 페이지의 모든 거래 행에 복사될 수 있습니다.

한 그룹 내에서 열에 두 개 이상의 서로 다른 비어 있지 않은 값이 있으면 이는 [충돌](/docs/reference/glossary#conflict-handling)이며, 해결 방법을 선택합니다. 이 선택은 개별 열이 아닌 전체 템플릿에 적용됩니다.

| 충돌 시 옵션 | 충돌하는 열에 발생하는 작업 |
| --- | --- |
| Combine into one | 모든 서로 다른 값이 단일 셀로 결합됩니다. 기본 결합 구분자는 공백이 있는 슬래시( / )이며, Join Values With 에서 변경할 수 있습니다. 구분자를 지워 값 사이에 아무것도 없이 결합할 수도 있습니다. |
| Keep all, split into rows | 추측하지 않습니다. 병합된 행 하나 대신 파일당 하나의 행이 생성되므로 각 값을 직접 확인할 수 있습니다. 파일들이 일치하는 값은 여전히 채워집니다. |
| Keep the first value | 가장 먼저 업로드된 파일의 값이 우선하며, 나머지는 삭제됩니다. |
| Keep the last value | 가장 나중에 업로드된 파일의 값이 우선하며, 나머지는 삭제됩니다. |

실제로 충돌하는 열만 영향을 받습니다. 파일들이 일치하는 열과 하나의 파일만 채운 열은 여전히 전체 레코드에서 공유됩니다.

## 설정 위치

Multi-Page Merge는 템플릿 내부의 설정으로, 템플릿의 다른 옵션 옆에 있습니다.

1. 대시보드에서 **Data Columns** 패널을 열고 템플릿 헤더에서 **Settings**를 클릭합니다.
2. **Template Settings** 대화상자에서 **Merge Multiple Results** 행을 찾아 켭니다.
3. **How to merge** 아래에서 병합 모드를 선택합니다. Sequential Merge를 선택한 경우 **Where to break** 아래에서 분할 조건을 선택하고, 표시되는 경우 모드에 필요한 Data Column, 값 또는 그룹 크기를 선택합니다.
4. **Merge Conflict Handling** 아래에서 옵션을 선택합니다.

대화상자에는 현재 선택 사항에 대한 쉬운 설명 요약과 실제 예시가 표시되므로, 설정에 의존하기 전에 설정이 수행할 작업을 확인할 수 있습니다. 변경 사항은 자동으로 저장되며 별도의 저장 버튼이 없고, 대화상자를 닫아도 변경 사항이 유지됩니다. 필수 열, 값 또는 그룹 크기가 아직 입력되지 않은 경우 대화상자에 설정이 완료될 때까지 적용되지 않는다는 경고가 표시됩니다. 앱은 불완전한 병합 설정에 대해 오류를 표시하지 않고 결과를 병합하지 않은 상태로 둡니다.

이 설정은 템플릿 설정에 포함되어 있으므로 [Templates & Columns](/docs/concepts/templates-and-columns) 페이지에 설명된 것과 동일한 대화상자입니다. 병합 설정은 항상 템플릿에 속하며, 템플릿 없이 처리된 배치에는 이를 보관할 템플릿 설정이 없습니다.

## 병합 적용 위치

Multi-Page Merge는 파일 처리 방식을 변경하지 않습니다. 내보낼 때 생성되는 테이블을 변경합니다. 단일 배치 내에서 작동하며 서로 다른 배치의 행을 결합하지 않습니다. 배치의 정의와 파일이 배치에 포함되는 방식은 [Batches](/docs/concepts/batches)를 참조하세요.

- **앱에서 결과 보기는 파일별로 이루어집니다.** 파일을 열어 추출된 행을 확인하면 해당 파일의 자체 결과가 표시됩니다. 이 보기에서는 행이 결합되지 않습니다.
- **배치 내보내기 시 병합이 자동으로 적용됩니다.** 배치의 템플릿에 병합이 켜져 있으면 내보낸 스프레드시트가 병합됩니다. 내보낼 때 활성화할 별도의 "이 내보내기 병합" 스위치는 없습니다.
- **여러 배치를 함께 내보낼 때도 병합이 적용됩니다.** 각 배치의 자체 템플릿 설정을 사용하여 배치가 하나의 파일로 정렬되기 전에 병합됩니다.
- **병합은 배치가 병합이 켜진 템플릿으로 처리된 경우에만 적용됩니다.** 설정은 내보낼 때 템플릿에서 읽히므로, 처리 후 병합 설정을 수정하면 해당 배치의 다음 내보내기에서 수정된 설정이 사용됩니다.

동일한 설정이 Google Sheets 애드온으로 전송되는 결과에도 적용됩니다. 배치의 템플릿에 병합이 켜져 있으면 시트에 기록되는 행은 결합된 행입니다.

### 내보내기 전 확인

기본적으로 병합이 켜진 단일 배치를 내보내면 먼저 **내보내기 전 병합 확인** 화면이 열립니다. 이 화면에는 **병합 전**과 **병합 후**라는 두 개의 테이블이 나란히 표시되며, 동일한 병합 그룹의 행은 같은 색으로 공유되어 어떤 원시 행이 어떤 결합 행을 생성했는지 확인할 수 있습니다. 여기서 원시 값을 편집하고, 같은 화면에서 병합 설정을 조정한 다음, **확인 및 내보내기**를 클릭하여 파일을 생성할 수 있습니다.

매번 이 확인을 원하지 않으면 템플릿 설정에서 **내보내기 전 확인 건너뛰기**를 켜세요. 여러 배치를 함께 내보낼 때는 이 확인 화면이 표시되지 않으며, 병합을 적용하고 파일을 직접 생성합니다.

---

Source: https://imagetotable.ai/ko/docs/concepts/multi-page-merge