페이지 빌더 기능은 사용자가 다양한 문서의 페이지를 정밀하게 쉽게 결합할 수 있도록 문서 병합을 변형합니다. 이는 최종 문서의 구조에 대한 완전한 제어를 제공하며, 어떤 순서로든 페이지를 병합할 수 있게 해줍니다. 몇 개의 주요 페이지를 병합하든 포괄적인 문서를 작성하든 이 도구는 유연성과 효율성을 보장합니다. 수작업 노력을 줄여 맞춤형 문서 작성 과정을 단순화하여 소중한 시간을 절약하고 개인 및 직업적인 작업 흐름에서 전반적인 생산성을 높입니다.

페이지 빌더 - 문서에서 페이지를 병합하는 방법

다음 주제가 여기에서 논의됩니다:

당신이 Merging documents online에 관심이 있다면, GroupDocs에서 제공하는 Online Merging Tool을 방문하세요.

페이지 빌더 이해하기

페이지 빌더 기능은 여러 소스 문서에서 페이지를 결합하여 사용자 지정 문서를 만드는 간소화된 방법을 소개합니다. 이 기능은 개발자가 두 개 이상의 문서에서 임의의 순서로 페이지를 추가하여 단계별로 새 문서를 만들 수 있도록 합니다. 프로세스는 다음과 같이 작동합니다:

  • 소스 Word 문서를 Merger 클래스를 사용하여 로드한 다음 생성자에 소스 문서 중 하나를 전달하여 시작합니다.
  • 문서를 하나씩 합쳐 Join 방법을 사용하여 병합하십시오.
  • Page Builder를 초기화합니다. Merger 인스턴스의 CreatePageBuilder 메서드를 사용합니다. 이것은 새 문서를 작성하기 위한 시작점 역할을 합니다.
  • The AddPage 메서드는 페이지 빌더 인스턴스가 이전에 결합된 문서의 특정 페이지를 대상 문서에 추가할 수 있게 해줍니다.
  • 각 원본 문서에 대해 인덱스에 포함할 특정 페이지를 선택하십시오.
  • 이 페이지들을 원하는 순서로 새 문서에 추가하세요. 필요에 따라 다양한 문서에서 페이지를 혼합하여 사용할 수 있습니다;
  • 이 프로세스를 추가 소스 문서에 대해 반복하여 요구 사항에 가장 적합한 방식으로 페이지를 결합할 수 있는 유연성을 확보하십시오;
  • Using ApplyPageBuilder method to apply changes from the Page Builder instance
  • 병합된 문서를 원하는 위치에 저장하십시오. 필요한 모든 페이지가 추가되면 새 문서를 저장하십시오. 최종 출력물은 여러 출처의 페이지가 포함된 완전히 사용자 정의된 파일이 될 것이며, 원하는 대로 정확하게 정리됩니다.

이 단계별 접근 방식은 보고서 작성, 개인화된 프레젠테이션 생성 또는 법적 문서 조립과 같은 특정 사용 사례에 맞는 문서를 쉽게 만들 수 있도록 합니다. Page Builder를 사용하면 개발자는 페이지 순서와 콘텐츠에 대한 완전한 제어력을 가지므로 시간 소모적인 수동 편집의 필요성을 없애고 최종 출력의 정확성을 보장합니다.

샘플 케이스 및 코드 구현

페이지 빌더 기능을 GroupDocs.Merger에서 사용하는 방법을 실제 사례를 통해 시연해 보겠습니다. 사례를 단순화하기 위해 두 개의 문서를 가지고 있다고 가정합시다:

  • Document A with 4 pages.
  • Document B with 4 pages.

우리는 특정 시나리오에 따라 이러한 두 문서의 페이지를 서로 다른 순서로 병합하여 새로운 문서를 만들기를 목표로 합니다.

페이지 빌더 - 샘플 A 및 B 문서 구조, 각 4페이지 포함

여기 각 문서 페이지에 문서 레터 A, B 및 페이지 번호를 표시했습니다. 문서 A와 B에서 다음 구조를 가진 맞춤형 문서 C를 받아야 합니다.

페이지 빌더 - 샘플 A 및 B 문서 구조, 각 4페이지 포함

다음 소스 코드 조각은 결과 문서에서 여러 문서의 특정 페이지를 병합하는 방법을 보여줍니다.

string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
    // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    
    pageBuilder.AddPage(docA.Pages[0]); // document A, page 1 or Page A-1
    pageBuilder.AddPage(docB.Pages[0]); // document B, page 1 or Page B-1
    pageBuilder.AddPage(docB.Pages[1]); // document B, page 2 or Page B-2
    pageBuilder.AddPage(docB.Pages[2]); // document B, page 3 or Page B-3
    pageBuilder.AddPage(docA.Pages[1]); // document A, page 2 or Page A-2
    pageBuilder.AddPage(docA.Pages[3]); // document A, page 4 or Page A-4
    
    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

필요한 페이지의 범위를 지정하기

문서 조작을 할 때 여러 페이지를 효율적으로 추가하는 것은 복잡한 작업 흐름을 처리하는 데 중요합니다. 페이지를 개별적으로 추가하는 대신, 특정 페이지를 나타내는 IPageInfo 객체의 배열을 수용하는 AddPageRange 메서드를 사용할 수 있습니다. 이 접근 방식은 프로세스를 단순화하고 반복 코드를 줄이며 배치 작업을 허용함으로써 성능을 향상시킵니다. 아래는 여러 문서에서 여러 페이지를 단일, 간소화된 작업으로 추가하기 위해 이 방법을 사용하는 방법을 보여주는 코드 예제입니다.

여기 여러 문서의 여러 페이지를 범위로 지정하여 결합하는 단계가 있습니다:

  • Create a Merger 객체를 만들고 소스 파일의 경로나 스트림을 제공하세요.
  • 소스 문서를 추가하려면 Join 을 사용하세요. 병합하려는 각 문서에 대해 이 단계를 반복하세요.
  • Create a PageBuilder 객체를 CreatePageBuilder 메서드를 호출하여 생성합니다.
  • AddPageRange 메서드를 호출하고 적절한 페이지를 설명하는 IPageInfo 객체 배열을 전달하십시오. IPageInfo 객체는 소스 문서 및 페이지 번호에 대해 0 기반 표기법을 사용한다는 점에 유의하십시오.
  • 지정된 페이지 순서를 병합된 문서에 적용하려면 ApplyPageBuilder 메서드를 사용하십시오.
  • 결과 문서를 Save 메서드를 호출하고 파일 경로를 제공하여 저장하십시오.
string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
     // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    // Specify a range of pages
    IPageInfo[] range = new IPageInfo[] {
        docA.Pages[0], // Page A-1 from the document A
        docB.Pages[0], // Page B-1 from the document B
        docB.Pages[1], // Page B-2 from the document B
        docB.Pages[2], // Page B-3 from the document B
        docA.Pages[1], // Page A-2 from the document A
        docA.Pages[3], // Page A-4 from the document A                    
    };
    // Append a page of pages
    pageBuilder.AddPageRange(range);

    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

결론

이러한 예시는 페이지 빌더 기능의 다양성을 설명합니다. 개발자는 다양한 순서로 여러 문서에서 페이지를 쉽게 결합하여 맞춤형 출력을 생성할 수 있습니다. 이 기능은 수작업을 크게 줄이고 문서 생성의 정확성을 보장하여 다양한 사용 사례에 필수적인 도구가 됩니다.

무료 API 라이선스 받기

You can get a free temporary license to use the API without the evaluation limitations.

자신만의 병합 페이지 빌더 애플리케이션 만들기

여기 여러분이 자신의 문서 비교 애플리케이션을 구축하는 데 도움이 될 몇 가지 중요한 링크가 있습니다.

Documentation | API Reference | Supported File Formats

Running Examples – GitHub | Free Support Forum | Release Notes

See Also

자세한 정보와 추가 자료는 다음 링크가 유용할 수 있습니다: