GroupDocs.Merger for Java를 사용하여 Excel에 PDF 삽입하는 방법

Excel에 PDF를 삽입하면 정적인 스프레드시트를 전체 원본 문서를 필요한 위치에 포함한 풍부하고 인터랙티브한 보고서로 변환할 수 있습니다. 이 튜토리얼에서는 GroupDocs.Merger for Java를 사용하여 PDF를 OLE(Object Linking and Embedding) 객체로 가져와 Excel에 PDF를 삽입하는 방법을 배웁니다. 우리는 모든 전제 조건을 단계별로 안내하고, 정확한 코드를 보여주며, 실용적인 팁을 제공하여 오늘 바로 여러분의 프로젝트에 이 기술을 적용할 수 있도록 도와드립니다.

빠른 답변

  • “Excel에 PDF를 삽입”이 의미하는 것은? PDF 파일을 OLE 객체로 삽입하여 스프레드시트에서 직접 PDF를 열 수 있게 하는 것을 의미합니다.
  • 어떤 라이브러리가 가져오기를 처리합니까? GroupDocs.Merger for Java는 이를 위해 importDocument 메서드를 제공합니다.
  • 라이선스가 필요합니까? 평가용으로는 무료 체험판을 사용할 수 있으며, 실제 운영을 위해서는 상업용 라이선스가 필요합니다.
  • 다른 파일 형식도 삽입할 수 있나요? 예 – Word, 이미지 및 기타 지원되는 형식도 OLE 객체로 가져올 수 있습니다.
  • 이 방법이 Java 8+와 호환되나요? 물론입니다 – 이 라이브러리는 Java 8 및 이후 버전을 지원합니다.

Excel에 PDF를 삽입한다는 것은 무엇인가요?

Excel에 PDF를 삽입하면 PDF가 워크북 내부에 OLE 객체로 저장되어 사용자가 아이콘을 더블 클릭하면 스프레드시트를 떠나지 않고 원본 PDF를 열 수 있습니다. 이 기술은 감사 추적, 상세 보고서 또는 원본 문서를 요약 데이터와 밀접하게 연결해야 하는 모든 상황에 이상적입니다.

왜 GroupDocs.Merger를 사용하여 Excel에 PDF를 삽입하나요?

GroupDocs.Merger를 사용하여 PDF 파일을 삽입하면 수동 복사‑붙여넣기를 없애고 수천 개의 워크북에서 일관된 위치를 보장합니다. 이 라이브러리는 30개 이상의 입력 및 출력 형식을 지원하며 전체 파일을 메모리에 로드하지 않고 500 MB까지의 워크북을 처리할 수 있어 대규모 보고 파이프라인에 빠르고 메모리 효율적인 자동화를 제공합니다.

Excel에 PDF를 삽입하는 방법 – 전제 조건

코딩을 시작하기 전에 개발 환경이 다음 조건을 충족하는지 확인하십시오. 호환되는 JDK가 설치되어 있어야 하고, 프로젝트에 GroupDocs.Merger 라이브러리를 추가했으며, 편집 및 실행을 위한 IDE가 준비되어 있어야 합니다. Java 파일 처리에 대한 기본 지식도 예제를 원활히 따라가는 데 도움이 됩니다.

  • Java Development Kit (JDK) 8 이상, 설치되어 PATH에 추가된 상태.
  • GroupDocs.Merger for Java – Maven 또는 Gradle을 통해 프로젝트에 추가합니다(아래 섹션 참조).
  • 코드를 편집하고 실행하기 위한 IntelliJ IDEA 또는 Eclipse와 같은 IDE.
  • Java 파일 처리 및 스트림에 대한 기본 지식.

GroupDocs.Merger for Java 설정

Maven

다음 의존성을 pom.xml 파일에 추가하십시오:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>latest-version</version>
</dependency>

Gradle

build.gradle 파일에 라이브러리를 포함하십시오:

implementation 'com.groupdocs:groupdocs-merger:latest-version'

You can also download the latest version directly from GroupDocs.Merger for Java 릴리스.

라이선스 획득 단계

  1. Free trial: 모든 기능을 탐색하기 위해 무료 체험으로 시작하십시오.
  2. Temporary license: 장기 테스트를 위해 임시 라이선스를 요청하십시오.
  3. Purchase: 상업적 배포를 위해 정식 라이선스를 획득하십시오.

단계별 구현

Step 1: 파일 경로 정의 및 객체 초기화

먼저 Excel 워크북, 삽입하려는 PDF 및 출력 파일의 경로를 설정합니다. 그런 다음 OLE 객체가 표시될 위치를 설명하는 OleSpreadsheetOptions를 생성합니다.

Definition anchor: OleSpreadsheetOptions는 Excel 워크시트 내 OLE 객체의 대상 셀, 크기 및 표시 속성을 구성합니다.

import com.groupdocs.merger.Merger;
import com.groupdocs.merger.domain.options.OleSpreadsheetOptions;

public class ImportOLEToSpreadsheet {
    public static void main(String[] args) throws Exception {
        // Define the paths for input and output files.
        String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx";  // Excel file path
        String embeddedFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.pdf";  // PDF file to embed

        // Specify the output file path.
        String filePathOut = "YOUR_OUTPUT_DIRECTORY/ImportDocumentToSpreadsheet-output.xlsx";

        // Specify the page number of the OLE object and its position in the spreadsheet.
        int pageNumber = 2;  
        OleSpreadsheetOptions oleCellsOptions = new OleSpreadsheetOptions(embeddedFilePath, pageNumber);
        
        // Set the desired row and column indices for the OLE object placement.
        oleCellsOptions.setRowIndex(2); 
        oleCellsOptions.setColumnIndex(2);

        // Create a Merger instance for the target Excel file.
        Merger merger = new Merger(filePath);
    }
}

Step 2: OLE 문서 가져오기

importDocument 메서드를 사용하여 정의한 위치에 PDF를 OLE 객체로 삽입합니다.

Definition anchor: importDocument는 제공된 파일을 OLE 객체로 처리하도록 GroupDocs.Merger에 지시하며, 원본 바이너리 콘텐츠를 보존하면서 워크시트에 연결합니다.

// Import the OLE document into the specified position in the spreadsheet.
merger.importDocument(oleCellsOptions);

// Save the updated spreadsheet to the output path.
merger.save(filePathOut);

importDocument 사용 이유: 이 메서드는 Excel에서 열 때 PDF가 완전히 기능하도록 보장하며, 필요한 바이너리 패키징 및 관계 메타데이터를 자동으로 처리합니다.

Step 3: 스프레드시트 저장

원본 워크북을 그대로 두고 변경 사항을 새 파일에 저장합니다.

merger.save(filePathOut);

Key configuration options: OleSpreadsheetOptions를 추가로 조정할 수 있습니다—예를 들어 객체의 크기, 가시성, 혹은 삽입 대신 링크로 설정할지 여부 등을 조정합니다.

일반적인 함정 및 문제 해결 팁

  • FileNotFoundException: 제공한 경로가 실제 파일을 가리키는지 다시 확인하십시오.
  • Version mismatch: 사용 중인 GroupDocs.Merger 버전이 JDK 버전과 일치하는지 확인하십시오.
  • Corrupt PDF: 삽입하기 전에 PDF가 독립적으로 열리는지 확인하십시오.
  • Memory pressure: 많은 워크북을 처리할 때 각 Merger 인스턴스를 즉시 닫거나 try‑with‑resources를 사용하여 리소스를 해제하십시오.

실용적인 적용 사례

Excel에 OLE 객체를 삽입하는 것은 다양한 시나리오에서 유용합니다:

  1. Data consolidation: 분기별 PDF를 하나의 대시보드 워크북으로 병합합니다.
  2. Interactive presentations: 회의 중 필요에 따라 열리는 상세 사양서를 제공합니다.
  3. Automated reporting: 자동으로 지원 문서를 포함하는 월간 재무 보고서를 생성합니다.

성능 고려 사항

  • Memory management: 더 이상 필요하지 않은 Merger 인스턴스를 닫아 리소스를 해제하십시오.
  • Batch processing: 수십 개의 스프레드시트를 처리할 때 메모리 급증을 방지하기 위해 작은 배치로 처리하십시오.
  • Java best practices: 스트림에 try‑with‑resources를 사용하고 예외를 적절히 처리하십시오.

결론

이제 GroupDocs.Merger for Java를 사용하여 Excel에 PDF 삽입 및 문서를 Excel에 가져오기를 위한 완전하고 프로덕션 준비된 솔루션을 갖추었습니다. 다양한 파일 유형을 실험하고, 배치 옵션을 조정하며, 이 워크플로를 자동 보고 파이프라인에 통합하십시오.

다음 단계

  • Word 문서 또는 이미지를 삽입하여 API가 다른 형식을 어떻게 처리하는지 확인하십시오.
  • 분할, 병합 또는 문서 변환과 같은 추가 GroupDocs.Merger 기능을 탐색하십시오.

자주 묻는 질문

Q: 단일 Excel 파일에 여러 OLE 객체를 삽입할 수 있나요?
A: 예, 각 객체마다 importDocument 호출을 반복하고 OleSpreadsheetOptions를 조정하여 다른 셀을 대상으로 지정합니다.

Q: OLE 객체로 지원되는 파일 형식은 무엇인가요?
A: GroupDocs.Merger는 PDF, Word 문서, Excel 파일, 이미지 및 기타 여러 일반 형식을 지원하며, 총 30개 이상의 유형을 지원합니다.

Q: GroupDocs.Merger로 대용량 파일을 효율적으로 처리하려면 어떻게 해야 하나요?
A: 파일을 작은 배치로 처리하고, 스트리밍 API를 사용하며, Merger 인스턴스를 즉시 해제하여 메모리 사용량을 낮게 유지하십시오.

Q: 삽입된 파일에 접근할 수 없거나 손상된 경우 어떻게 해야 하나요?
A: 삽입을 시도하기 전에 원본 파일의 경로와 무결성을 확인하십시오. 손상된 파일은 가져오기 중 예외를 발생시킵니다.

Q: Excel에서 OLE 객체의 외관을 맞춤 설정할 수 있나요?
A: 예, OleSpreadsheetOptions를 사용하면 행/열 인덱스, 크기 및 가시성을 설정하여 워크시트에서 객체가 어떻게 표시될지 조정할 수 있습니다.

리소스

마지막 업데이트: 2026-10-06
테스트 환경: GroupDocs.Merger for Java 최신 버전
작성자: GroupDocs

관련 튜토리얼