Comment utiliser GroupDocs.Viewer Java pour la conversion d’Excel en HTML/JPG/PNG/PDF : guide étape par étape

Introduction

Convertir les données d’une feuille de calcul en différents formats (HTML, JPG, PNG ou PDF) tout en conservant les informations essentielles comme les en-têtes de lignes et de colonnes est essentiel dans de nombreux cas. Que vous génériez des rapports, partagiez des informations avec vos parties prenantes ou intégriez des feuilles de calcul à des applications web, la conversion de feuilles Excel peut être essentielle. Ce guide vous explique comment GroupDocs.Viewer Java simplifie et optimise ces tâches.

Ce que vous apprendrez :

  • Configuration et utilisation de GroupDocs.Viewer pour Java
  • Rendu de fichiers Excel aux formats HTML, JPG, PNG et PDF
  • Configuration des options pour inclure les en-têtes de ligne et de colonne dans vos sorties
  • Applications pratiques des documents rendus

Commençons par les prérequis nécessaires avant de nous lancer dans la mise en œuvre.

Prérequis

Avant de restituer des feuilles de calcul avec GroupDocs.Viewer Java, assurez-vous d’avoir :

Bibliothèques et dépendances requises

Configurez GroupDocs.Viewer pour Java avec Maven. Voici comment l’inclure dans votre projet :

Configuration Maven :

<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>

Configuration de l’environnement

  • Assurez-vous que le kit de développement Java (JDK) est installé.
  • Utilisez un IDE comme IntelliJ IDEA ou Eclipse pour faciliter le développement.

Prérequis en matière de connaissances

  • Familiarité avec la programmation Java
  • Compréhension de base de Maven pour la gestion des dépendances

Une fois ces conditions préalables remplies, passons à la configuration de GroupDocs.Viewer pour Java et commençons à implémenter les fonctionnalités.

Configuration de GroupDocs.Viewer pour Java

GroupDocs.Viewer pour Java est une bibliothèque polyvalente qui permet de générer des documents dans différents formats. Voici comment démarrer :

Informations d’installation

Comme mentionné, utilisez Maven pour ajouter GroupDocs.Viewer en tant que dépendance dans votre projet pom.xml déposer.

Étapes d’acquisition de licence

  1. Essai gratuit : Téléchargez la version d’essai à partir de Essai gratuit de GroupDocs.
  2. Licence temporaire : Obtenez une licence temporaire pour plus de fonctionnalités auprès de Licence temporaire GroupDocs.
  3. Achat: Pour un accès complet et une assistance, achetez une licence sur Achat GroupDocs.

Initialisation de base

Une fois installé, vous pouvez initialiser GroupDocs.Viewer avec :

import com.groupdocs.viewer.Viewer;

public class ViewerSetup {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("Sample.xlsx")) {
            // Votre code ici pour utiliser la visionneuse
        }
    }
}

Cela initialise votre environnement, vous préparant au rendu des documents.

Guide de mise en œuvre

Décomposons chaque fonctionnalité et explorons comment les implémenter en détail.

Convertir une feuille de calcul en HTML

Aperçu: Convertissez des feuilles Excel au format HTML tout en préservant les en-têtes de ligne et de colonne pour les présentations Web ou les rapports.

Mise en œuvre étape par étape :

1. Importer les bibliothèques requises
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
2. Définir le répertoire de sortie

Définissez où vos fichiers rendus seront stockés.

Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");
3. Initialiser la visionneuse et configurer les options

Utilisez GroupDocs.Viewer pour afficher le document :

try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
    
    // Activer le rendu des en-têtes de ligne et de colonne dans la feuille de calcul.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Rendre les pages 1 à 3.
}

Explication: Le HtmlViewOptions La classe est utilisée pour configurer la sortie HTML. setRenderHeadings(true) garantit que les en-têtes de ligne et de colonne sont visibles dans le HTML rendu.

Convertir une feuille de calcul en JPG

Aperçu: Transformez les feuilles Excel en fichiers image de haute qualité (JPG) tout en incluant des en-têtes de ligne et de colonne, idéaux pour les présentations visuelles ou les impressions.

Mise en œuvre étape par étape :

1. Importer les bibliothèques requises
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
2. Définir le répertoire de sortie
Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.jpg");
3. Initialiser la visionneuse et configurer les options
try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    JpgViewOptions options = new JpgViewOptions(pageFilePathFormat);
    
    // Activer le rendu des en-têtes de ligne et de colonne dans la feuille de calcul.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Rendre les pages 1 à 3.
}

Explication: JpgViewOptions gère les paramètres d’image. setRenderHeadings(true) L’option garantit que les en-têtes sont inclus dans la sortie JPG.

Rendre une feuille de calcul au format PNG

Aperçu: Convertissez des feuilles Excel au format PNG tout en conservant les en-têtes de ligne et de colonne, adaptés aux sorties d’images de haute qualité.

Mise en œuvre étape par étape :

1. Importer les bibliothèques requises
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
2. Définir le répertoire de sortie
Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.png");
3. Initialiser la visionneuse et configurer les options
try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    PngViewOptions options = new PngViewOptions(pageFilePathFormat);
    
    // Activer le rendu des en-têtes de ligne et de colonne dans la feuille de calcul.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Rendre les pages 1 à 3.
}

Explication: PngViewOptions est utilisé pour les paramètres PNG. Avec setRenderHeadings(true), les en-têtes sont inclus dans les images de sortie.

Convertir une feuille de calcul en PDF

Aperçu: Transformez les feuilles Excel au format PDF tout en garantissant que les en-têtes de ligne et de colonne sont visibles, parfait pour l’archivage ou le partage de documents.

Mise en œuvre étape par étape :

1. Importer les bibliothèques requises
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
2. Définir le répertoire de sortie
Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("output.pdf");
3. Initialiser la visionneuse et configurer les options
try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    PdfViewOptions options = new PdfViewOptions(pageFilePathFormat);
    
    // Activer le rendu des en-têtes de ligne et de colonne dans la feuille de calcul.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Rendre les pages 1 à 3.
}

Explication: PdfViewOptions configure les paramètres de sortie PDF. Le setRenderHeadings(true) l’option garantit que les en-têtes sont visibles dans le PDF final.

Applications pratiques

Voici quelques scénarios réels dans lesquels ces fonctionnalités peuvent être appliquées :

  1. Rapports d’activité : Partagez des rapports détaillés avec les parties prenantes en convertissant les données Excel aux formats HTML ou PDF pour une diffusion et une visualisation faciles.
  2. Visualisation des données : Convertissez des feuilles de calcul en formats d’image tels que JPG ou PNG pour les présentations, en vous assurant que les en-têtes fournissent un contexte pour les données visualisées.
  3. Archivage de documents : Utilisez la conversion PDF pour archiver des documents dans un format universellement accessible, en préservant tous les détails nécessaires tels que les titres.