💡 전체 작동 예제가 GitHub에 있습니다: one-line-document-merge-and-split-dotnet
백오피스 문서 작업이 실제로 위치하는 곳
재무 백오피스는 지난 달 명세서 PDF에 표지 페이지를 스테이플링하여 한 달을 마감합니다. 계약 팀은 원본 계약서에 서명된 수정안을 추가하고 아카이브로 보내기 전에 이를 첨부합니다. 영업 운영 보조자는 60장의 슬라이드 중 두 장만 필요했던 이해관계자를 위해 전체 프레젠테이션에서 두 슬라이드만 추출합니다. 기록 담당자는 파일이 건물을 떠나기 직전에 절대 배송되지 않아야 할 페이지를 삭제합니다.
이러한 작업은 모두 병합 프로젝트가 아닙니다. 각각은 하나의 파일과 하나의 작업이며, 작업이 실행될 때마다 동일한 방식으로 수행됩니다. 보통은 일반 목적 문서 API를 배우는 데 관심이 없는 사람이 수행합니다.
GroupDocs.Merger.LowCode는 .NET 패키지로, 조인, 분할 또는 페이지 제거와 같은 작업을 단일 생성자 호출로 변환합니다. 이는 해당 작업에 전혀 필요하지 않은 일반 목적 Merger 클래스와 구별됩니다. 일곱 개 제품 각각은 C#에서 생성자에 소스와 옵션을 전달받으며, Save가 호출될 때만 실행됩니다. 작업이 PDF이든 Word 문서이든 PowerPoint 데크이든 동일한 형태를 가집니다.
여기서는 일반적인 해결책이 통하지 않는다
이러한 작업을 마주한 팀은 보통 집중 패키지를 사용하기 전에 다음 세 가지 중 하나를 시도합니다:
- 데스크톱 편집기로 수작업: 하나의 문서에는 괜찮지만 일정에 넣기 어렵고, 새벽 2시에 수동 단계가 실행되는 것을 승인하는 사람도 없습니다.
- 원시 파일 API를 이용한 일회성 스크립트 작성: 다음 입력 형식이 나타날 때까지는 동작하지만, 스크립트가 바로 피하려던 일반 목적 클라이언트와 동일해집니다.
- 단일 호출을 위해 전체
Merger클래스 사용: 올바르지만, 하나의 작업에 필요하지 않은 더 넓은 API 표면을 추가합니다.
GroupDocs.Merger.LowCode는 바로 그 마지막 격차를 메우기 위해 존재합니다: 작업당 한 번의 호출, 먼저 배워야 할 것이 없습니다.
솔루션: 백오피스 파이프라인을 위한 GroupDocs.Merger.LowCode
GroupDocs.Merger.LowCode는 일곱 개의 단일 목적 제품을 하나의 생성자‑Save 형태로 패키징합니다. JoinPdf와 JoinDocx는 문서를 다른 문서에 추가하고, JoinPptx는 프레젠테이션에 동일하게 적용합니다; SplitPdf, SplitDocx, SplitPptx는 선택한 페이지 또는 슬라이드를 각각의 파일로 추출합니다; RemovePagesPdf는 소스를 건드리지 않고 페이지를 삭제합니다. 일곱 제품 모두 소스를 경로 또는 스트림으로 받아들이며, 쓰기 전에 소스와 전달된 모든 파일을 자체 형식에 맞는지 검사하므로 파이프라인이 출력 오류의 원인을 추측할 필요가 없습니다.
아래 구현을 따라하려면 다음이 필요합니다:
- .NET 6.0 이상 (이 샘플 프로젝트는 net8.0을 대상으로 함)
- 별도의
GroupDocs.Merger.LowCodeNuGet 패키지 - 평가 제한을 해제하고 출력을 확인하려면 temporary license가 필요합니다
dotnet add package GroupDocs.Merger.LowCode
이 패키지는 메인 GroupDocs.Merger 라이브러리와 별도로 NuGet에 존재합니다.
Reporting-Pack 작업을 단계별로 구현하기
다음은 일곱 제품이 모두 따르는 형태이며, 월간 PDF에 표지 페이지를 추가하는 조인 작업을 예시로 설명합니다.
Step 1: 제품에 소스를 지정하기
JoinPdf의 생성자는 소스 문서, 추가할 모든 파일, 그리고 JoinOptions 인스턴스를 받으며, 아직 실행되지 않습니다.
var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());
Step 2: 결과가 저장될 위치 결정하기
Save(outputPath)는 작업이 실제로 커밋되는 지점입니다. 상대 경로는 프로세스의 현재 작업 디렉터리를 기준으로 해석되며, Save는 출력 폴더가 존재하지 않을 경우 자동으로 생성합니다. 따라서 매 실행마다 새로운 월 폴더에 기록하는 파이프라인은 별도의 디렉터리 생성 단계가 필요하지 않습니다.
string outputPath = "output/monthly/report-with-appendix.pdf";
무인 작업에 중요한 이유:
- 직접 제어하는 경로: 출력 경로를 구성이나 작업 매개변수에서 만들고, 검증되지 않은 입력을 그대로 사용하지 마세요;
Save는 null 또는 빈 경로에 대해ArgumentNullException을 발생시킵니다. - 생성되는 폴더: 매 실행마다 새로운 대상에 기록하는 예약 작업은 별도의 “디렉터리 존재 확인” 단계를 포함하지 않아도 됩니다.
Step 3: 실행하고 반환값 캡처하기
Save를 호출하면 조인이 즉시 수행됩니다; 별도의 빌드‑실행 단계가 없습니다.
join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;
샘플 파일을 대상으로 직접 실행한 결과, 2페이지 report.pdf와 2페이지 appendix.pdf가 결합되어 4페이지, 257987바이트 크기의 report-with-appendix.pdf가 생성되었습니다.
Step 4: 결과를 파이프라인에 다시 전달하기
Save 직후 읽은 파일 크기는 일반적으로 스케줄러가 작업을 완료로 표시하거나, 최소 크기와 비교해 출력이 충분히 신뢰할 수 있는지 판단하는 데 필요한 전부입니다.
if (sizeInBytes == 0)
{
throw new InvalidOperationException("Join produced an empty file.");
}
GroupDocs.Merger.LowCode가 파일 경로 대신 스트림을 받아들일 수 있나요?
예, 입력 측면에서는 가능합니다. 일곱 제품 모두 파일 경로가 들어가는 동일한 생성자 위치에 스트림을 전달할 수 있어, 입력이 블롭 스토리지나 큐에서 올 때 유용합니다. Save는 여전히 출력 경로 문자열에 결과를 기록하므로, 출력 자체를 스트리밍하는 경우는 전체 Merger 클래스를 사용해야 합니다.
실제 워크플로: 아카이브에 도달하기 전에 파일 거부하기
계약 팀이 서명된 계약서에 수정안을 추가할 때, 받은 파일이 무엇이든 받아들일 위험을 감수할 수 없습니다. .docx 수정안이 PDF 조인 파일 옆에 잘못 배치되면 깨진 아카이브 항목이 생성될 수 있습니다. JoinPdf는 소스와 추가되는 모든 파일을 PDF 형식인지 검사하고, 형식이 맞지 않을 경우 FileTypeNotSupportedException을 즉시 발생시킵니다.
try
{
new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
.Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
Console.WriteLine(exception.Message);
}
샘플 실행에서 경로가 resources 폴더를 기준으로 구성된 경우, 메시지는 다음과 같이 출력됩니다: Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.
위 예제는 예외가 발생하면 output/mixed.pdf를 전혀 쓰지 않으므로, 계약 파이프라인은 해당 메시지를 기존 알림 또는 티켓 큐로 바로 전달할 수 있어, 며칠 뒤에 잘못된 아카이브 항목을 발견하는 상황을 방지합니다.
이 패턴이 적용되는 다른 백오피스 시나리오
위 조인이 정상 작동하면, 동일한 생성자‑Save 형태가 일정에 따라 백오피스가 수행하는 여러 작업을 포괄합니다:
- 문서가 건물을 떠나기 전에 페이지 자르기:
RemovePagesPdf는 선택한 페이지를 삭제하고 원본을 건드리지 않은 새 파일을 작성합니다. 따라서 원본은 감사용으로 그대로 남아 있습니다. 우리 테스트에서는report.pdf의 2페이지를 삭제해 1페이지, 86647바이트 크기의report-without-page-2.pdf가 생성되었으며,report.pdf자체는 변경되지 않았습니다. - 특정 이해관계자를 위한 프레젠테이션 분할:
SplitPptx는 요청된 슬라이드를 각각 파일로 추출합니다. 파일명은 출력 패턴에{0}토큰을 사용하거나 토큰이 없을 경우 동일 폴더에 번호가 붙은 형태로 생성됩니다. 이는SplitPdf가 PDF 페이지를 분할할 때 사용하는 패턴과 동일합니다. - PDF 대신 Word 문서 병합:
JoinDocx는JoinPdf와 동일한 생성자‑Save형태를 따르며, 원본의 마지막 페이지 뒤에 추가 문서를 삽입합니다.
라이선스가 없을 경우, 이 모든 작업은 평가 모드로 실행됩니다. 우리 비라이선스 실행에서는 결합된 PDF와 Word 출력이 각각 3페이지로 제한되었지만, 여섯 개 샘플 출력은 모두 생성되었습니다. 프로덕션에서 무인으로 실행하기 전에 License.Set을 사용해 라이선스를 적용하십시오.
백오피스 파이프라인 시작하기
엔드‑투‑엔드로 동작하는 저코드 문서 병합 패턴을 확보했으며, 형식 검사가 모든 호출에서 수행된다는 증거도 있습니다. 다음 단계는 다음과 같습니다:
- 전체 그림 보기: 동반 use-case guide가 샘플의 여섯 가지 작업을 단계별로 안내하고 전체 FAQ를 제공합니다.
- 작업이 커지면 더 깊이 파고들기: full GroupDocs.Merger API는 파이프라인이 하나의 작업을 넘어설 때 필요한 추가 기능을 모두 포함합니다.
- 코드 살펴보기: complete sample on GitHub에는 위에서 사용된 모든 입력 파일이 포함되어 있습니다.
- 설치하기: installation page는 별도 패키지와 지원되는 대상 프레임워크를 안내합니다.
- 평가 제한 해제: 프로덕션에서 실행하기 전에 temporary license를 받아 주세요.
- 질문: support forum에서 팀이 구현 관련 질문에 답변합니다.