Excel을 HTML로 변환하고 Java 스프레드시트에서 숨겨진 행 및 열 렌더링하기 - GroupDocs.Viewer 사용

Are you struggling to Excel을 HTML로 변환 and visualize hidden rows and columns within a spreadsheet when converting it to HTML using Java? You’re not alone! Many developers face this challenge while trying to maintain the integrity of data visualization across different formats. This tutorial will guide you through how to effectively render hidden rows and columns in spreadsheets using GroupDocs.Viewer for Java, ensuring no crucial information is lost during conversion.

GroupDocs.Viewer for Java로 숨겨진 행 및 열 렌더링

GroupDocs.Viewer for Java로 숨겨진 행 및 열 렌더링

빠른 답변

  • GroupDocs.Viewer가 Excel을 HTML로 변환할 수 있나요? Yes, it provides out‑of‑the‑box support for converting XLSX files to HTML.
  • 숨겨진 행과 열이 HTML 출력에 표시되나요? 적절한 옵션을 활성화하면 숨겨진 데이터가 보이는 셀과 동일하게 렌더링됩니다.
  • 필요한 Maven 아티팩트는 무엇인가요? com.groupdocs:groupdocs-viewer (latest version recommended).
  • 프로덕션 사용을 위해 라이선스가 필요합니까? 프로덕션에는 영구 라이선스가 필요하며, 평가를 위해 무료 체험 또는 임시 라이선스를 사용할 수 있습니다.
  • 이 방법이 Java 8 이상과 호환되나요? 물론입니다 – JDK 8+에서 작동합니다.

“Excel을 HTML로 변환”이란?

Excel을 HTML로 변환하면 .xlsx 워크북을 웹에 적합한 HTML 페이지로 변환하면서 원래 레이아웃, 셀 스타일, 수식 및 데이터를 보존합니다. 생성된 HTML은 Microsoft Office가 설치되지 않은 최신 브라우저에서도 표시될 수 있어 웹 포털, 보고 대시보드 및 협업 플랫폼에 이상적입니다.

왜 숨겨진 스프레드시트 데이터를 렌더링해야 할까요?

숨겨진 행과 열을 렌더링하면 워크북에 저장된 모든 정보가 HTML 출력에 표시되어 감사 가능성, 데이터 분석 및 교육 시나리오에 필수적입니다. 숨겨진 셀을 노출함으로써 실수로 인한 데이터 손실을 방지하고, 하위 사용자들이 원본 파일에 존재하는 전체 데이터 세트를 정확히 볼 수 있도록 보장합니다.

사전 요구 사항

필요한 라이브러리 및 종속성

이 기능을 구현하려면 Maven 종속성으로 GroupDocs.Viewer for Java가 필요합니다. 이 라이브러리는 문서를 HTML, PDF 및 이미지 형식으로 렌더링합니다.

환경 설정 요구 사항

  • Java Development Kit (JDK): Version 8 이상
  • Integrated Development Environment (IDE): IntelliJ IDEA, Eclipse 또는 Java 호환 IDE
  • Maven: 종속성 관리를 위해

지식 사전 요구 사항

Java 기본 지식과 Maven 기본 사용법을 충분히 이해하면 단계별 진행이 원활합니다.

GroupDocs.Viewer for Java 설정

Java 애플리케이션에서 GroupDocs.Viewer를 사용하려면 Maven을 통해 라이브러리를 추가해야 합니다.

Maven
Add the following configuration to your pom.xml file:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

라이선스 획득 단계

  • Free trial – 모든 기능을 평가할 수 있는 체험 버전을 다운로드합니다.
  • Temporary license – 개발 중 전체 기능 접근을 위한 기간 제한 라이선스를 요청합니다.
  • Purchase – 제한 없는 프로덕션 사용을 위한 영구 라이선스를 구매합니다.

Maven 설정 및 라이선스를 획득한 후, GroupDocs.Viewer 초기화를 시작할 수 있습니다. 아래와 같이 진행합니다:

import com.groupdocs.viewer.Viewer;

public class ViewerInitialization {
    public static void main(String[] args) {
        // Initialize the viewer with your license file if available.
        try (Viewer viewer = new Viewer("path/to/your/document.xlsx")) {
            // Your code here...
        }
    }
}

숨겨진 데이터를 포함하여 Excel을 HTML로 변환하는 방법

숨겨진 행과 열이 보이도록 Excel 워크북을 HTML로 변환하려면 GroupDocs.Viewer로 파일을 로드하고, SpreadsheetOptions를 구성하여 숨겨진 요소를 렌더링하도록 설정하고, 원하는 출력 형식을 위해 HtmlViewOptions를 설정한 뒤, 뷰어를 호출해 HTML 파일을 생성합니다. 아래 단계에 따라 수행하십시오.

단계 1: 출력 디렉터리 경로 정의

생성된 HTML 파일이 저장될 폴더를 지정합니다:

import java.nio.file.Path;
import java.nio.file.Paths;

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "RenderHiddenRowsAndColumns");

단계 2: HTML 보기 옵션 구성

HtmlViewOptions는 HTML 파일이 생성되는 방식을 제어하며, 리소스를 임베드할지 별도 파일로 저장할지를 포함합니다.
HtmlViewOptions 클래스는 GroupDocs.Viewer에서 HTML 렌더링을 위한 핵심 구성 객체입니다.

단계 3: 숨겨진 열 및 행 렌더링 활성화

SpreadsheetOptions를 사용하면 변환 중 숨겨진 행과 열의 가시성을 전환할 수 있습니다.
SpreadsheetOptions는 숨겨진 셀, 그리드 라인, 워크시트 선택 등 스프레드시트 전용 기능이 어떻게 처리되는지를 결정하는 설정 컨테이너입니다.

단계 4: 문서와 함께 Viewer 초기화 및 렌더링

Viewer 클래스는 GroupDocs.Viewer에서 문서를 렌더링하는 주요 구성 요소입니다.
Viewer 인스턴스를 생성하고 Excel 파일 경로를 전달한 뒤, 준비된 옵션으로 view 메서드를 호출합니다.
Viewer 클래스는 GroupDocs.Viewer의 진입점이며, 소스 문서를 읽어 요청된 출력 형식을 생성합니다.

import com.groupdocs.viewer.options.HtmlViewOptions;

// Create a file path format for rendering each page.
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

실용적인 적용 사례

  1. Financial reporting – 감사 추적에 모든 숨겨진 메트릭을 포함하여 규정 준수를 보장합니다.
  2. Data analysis – 웹 기반 대시보드로 내보낼 때 전체 데이터 세트를 보존합니다.
  3. Educational tools – 학생들에게 수식 및 데이터 구조 학습을 위한 완전한 스프레드시트 내용을 제공합니다.

성능 고려 사항

  • GroupDocs.Viewer는 50개 이상의 문서 형식 변환을 지원하며 전체 파일을 메모리에 로드하지 않고 수백 페이지 워크북을 처리하여 메모리 사용량을 낮게 유지합니다.
  • 매우 큰 Excel 파일의 경우 JVM 힙 크기를 모니터링하고 필요하면 -Xmx를 늘립니다.
  • 출력 파일을 빠른 SSD 스토리지에 저장하여 I/O 지연을 줄입니다.
  • 라이브러리를 최신 상태로 유지하십시오; 각 릴리스에는 성능 최적화와 버그 수정이 포함됩니다.

결론

이 튜토리얼에서는 Excel을 HTML로 변환하고 GroupDocs.Viewer for Java를 구성하여 스프레드시트의 숨겨진 행과 열을 렌더링하는 방법을 배웠습니다. 위 단계들을 따르면 보이든 숨겨진든 모든 셀이 HTML 출력에 포함되어 플랫폼 전반에 걸쳐 완전한 데이터 가시성을 제공합니다. 맞춤 CSS나 단일 페이지 출력과 같은 추가 옵션을 실험하여 결과를 애플리케이션 요구에 맞게 더욱 세밀하게 조정해 보세요.

더 깊이 탐구할 준비가 되셨나요? 이 기능을 프로젝트에 구현하고 애플리케이션 기능이 어떻게 향상되는지 확인해 보세요!

FAQ 섹션

Q1: GroupDocs.Viewer를 무료로 사용할 수 있나요?
A1: 예, 공식 사이트에서 체험 버전을 다운로드하여 기능을 살펴볼 수 있습니다. 제한 없이 전체 기능을 사용하려면 임시 또는 영구 라이선스 획득을 고려하십시오.

Q2: GroupDocs.Viewer가 지원하는 파일 형식은 무엇인가요?
A2: PDF, Word, Excel, PowerPoint 및 일반 이미지 형식을 포함해 50개 이상의 다양한 문서 형식을 지원합니다.

Q3: GroupDocs.Viewer로 대용량 문서를 처리하려면 어떻게 해야 하나요?
A3: Java 힙 설정을 조정하여 메모리 관리를 최적화하고, 필요하면 대형 워크북을 렌더링 전에 작은 청크로 분할하십시오.

Q4: HTML 출력 형식을 맞춤 설정할 수 있나요?
A4: 예, HtmlViewOptions를 사용해 외관을 조정하고, 리소스를 임베드하거나 단일 페이지 HTML 파일을 생성하도록 다양한 옵션을 구성할 수 있습니다.

Q5: GroupDocs.Viewer 문제를 해결하는 가장 좋은 방법은 무엇인가요?
A5: 공식 문서와 커뮤니티 포럼을 참고하고, 모든 Maven 종속성이 라이브러리 버전과 일치하는지 확인하며, 자세한 오류 정보를 캡처하기 위해 상세 로깅을 활성화하십시오.

자주 묻는 질문

Q: setRenderHiddenColumns(true)를 활성화하면 성능에 영향을 줍니까?
A: 숨겨진 열을 렌더링하면 약간의 오버헤드가 추가되지만 일반 워크북에서는 영향이 미미합니다. 매우 큰 시트의 경우 메모리 사용량을 모니터링하고 JVM 힙 크기 확대를 고려하십시오.

Q: XLSX 파일을 여러 페이지가 아닌 단일 HTML 페이지로 변환할 수 있나요?
A: 예, {0} 플레이스홀더 없이 HtmlViewOptions에 사용자 정의 파일 이름을 설정하면 모든 워크시트를 포함하는 단일 HTML 파일을 생성합니다.

Q: 특정 워크시트에 대해서만 숨겨진 스프레드시트 데이터를 표시하려면 어떻게 해야 하나요?
A: 숨겨진 렌더링을 활성화하기 전에 viewOptions.getSpreadsheetOptions().setWorksheetIndexes(...)를 사용해 특정 시트를 지정하십시오.

Q: 변환 후 툴바나 네비게이션을 숨길 방법이 있나요?
A: GroupDocs.Viewer가 생성하는 HTML 출력은 정적이므로, 생성된 템플릿을 편집하거나 맞춤 CSS를 적용해 네비게이션 요소를 수동으로 제거할 수 있습니다.

Q: 숨겨진 행/열 렌더링을 위해 필요한 GroupDocs.Viewer 버전은 무엇인가요?
A: 이 기능은 버전 22.0부터 제공되며, 최상의 성능과 지원을 위해 최신 안정 릴리스(현재 25.2)를 사용하는 것을 권장합니다.

리소스

마지막 업데이트: 2026-09-20
테스트 대상: GroupDocs.Viewer 25.2 for Java
작성자: GroupDocs

// Enable rendering of hidden columns and rows.
viewOptions.getSpreadsheetOptions().setRenderHiddenColumns(true);
viewOptions.getSpreadsheetOptions().setRenderHiddenRows(true);

import com.groupdocs.viewer.Viewer;

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_HIDDEN_ROW_AND_COLUMN")) {
    // Render the document to HTML using the specified view options.
    viewer.view(viewOptions);
} catch (Exception e) {
    System.out.println("Error rendering document: " + e.getMessage());
}

관련 튜토리얼