Configuration de GroupDocs.Merger Cloud SDK for Java

Avant de commencer à coder, assurez‑vous d’avoir ce qui suit :

• Kit de développement Java (JDK) 8 ou supérieur.
• Un IDE tel qu’IntelliJ IDEA ou Eclipse.
• Un compte GroupDocs Cloud avec client ID et client secret.

Ajoutez la dépendance Maven à votre pom.xml :

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

Téléchargez la dernière bibliothèque depuis la page officielle de publication : GroupDocs.Merger Cloud SDK for Java Download. Une fois la dépendance résolue, vous êtes prêt à écrire du code qui combine des fichiers PowerPoint.

Construction étape par étape : combiner et fusionner Powerpoint PPT PPTX en Java

Étape 1 : Initialiser le client API

Créez un ApiClient avec vos identifiants et instanciez MergerApi.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
MergerApi mergerApi = new MergerApi(apiClient);

Étape 2 : Définir les fichiers PowerPoint source

Créez des objets FileInfo pour chaque présentation que vous souhaitez fusionner.

FileInfo sourceFile1 = new FileInfo();
sourceFile1.setFilePath("input1.pptx"); // first PPTX file

FileInfo sourceFile2 = new FileInfo();
sourceFile2.setFilePath("input2.ppt"); // second PPT file

Étape 3 : Définir les options de fusion

Ajoutez les fichiers source à une liste et spécifiez le chemin de sortie.

List<FileInfo> sourceFiles = new ArrayList<>();
sourceFiles.add(sourceFile1);
sourceFiles.add(sourceFile2);

MergeOptions mergeOptions = new MergeOptions();
mergeOptions.setFileInfos(sourceFiles);          // files to be merged
mergeOptions.setOutputPath("merged_output.pptx"); // result file

Étape 4 : Exécuter la demande de fusion

Créez une MergeRequest et appelez la méthode merge.

MergeRequest mergeRequest = new MergeRequest(mergeOptions);
try {
    MergeResult mergeResult = mergerApi.merge(mergeRequest);
    System.out.println("Merge successful. Output file stored at: " + mergeResult.getPath());
} catch (Exception e) {
    System.err.println("An error occurred during merging: " + e.getMessage());
    e.printStackTrace();
}

Le code ci‑dessus montre le flux de travail complet pour combiner et fusionner Powerpoint PPT PPTX en Java à l’aide du SDK.

Exemple complet de code : combiner et fusionner des fichiers Powerpoint en Java

L’exemple suivant assemble toutes les pièces en un seul programme prêt à être exécuté.

import com.groupdocs.merger.cloud.ApiClient;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import com.groupdocs.merger.cloud.model.requests.MergeRequest;
import com.groupdocs.merger.cloud.model.responses.MergeResult;

import java.util.ArrayList;
import java.util.List;

public class PowerPointMergeExample {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

// Define the source PowerPoint files
        FileInfo sourceFile1 = new FileInfo();
        sourceFile1.setFilePath("input1.pptx"); // first PPTX file

FileInfo sourceFile2 = new FileInfo();
        sourceFile2.setFilePath("input2.ppt"); // second PPT file

List<FileInfo> sourceFiles = new ArrayList<>();
        sourceFiles.add(sourceFile1);
        sourceFiles.add(sourceFile2);

// Set merge options
        MergeOptions mergeOptions = new MergeOptions();
        mergeOptions.setFileInfos(sourceFiles);          // files to be merged
        mergeOptions.setOutputPath("merged_output.pptx"); // result file

// Create and execute the merge request
        MergeRequest mergeRequest = new MergeRequest(mergeOptions);
        try {
            MergeResult mergeResult = mergerApi.merge(mergeRequest);
            System.out.println("Merge successful. Output file stored at: " + mergeResult.getPath());
        } catch (Exception e) {
            System.err.println("An error occurred during merging: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez-vous de mettre à jour les chemins de fichiers (input1.pptx, input2.ppt, merged_output.pptx) pour qu’ils correspondent à vos emplacements réels, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Fusion de présentations PowerPoint avec cURL et l’API REST

Vous pouvez effectuer la même opération de fusion sans écrire de code Java en appelant les points de terminaison REST de GroupDocs Merger. Voici un flux de travail cURL typique.

1. Authentifier et obtenir le jeton d’accès

curl -X POST "https://api.groupdocs.cloud/v2.0/authentication/token" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

La réponse contient un access_token que vous utiliserez dans les appels ultérieurs.

2. Télécharger les fichiers source

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pptx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/local/path/input1.pptx"

Répétez la commande pour input2.ppt.

3. Exécuter l’opération de fusion

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "fileInfos": [
          {"filePath": "input1.pptx"},
          {"filePath": "input2.ppt"}
        ],
        "outputPath": "merged_output.pptx"
      }'

L’API renvoie un objet JSON contenant le chemin du fichier fusionné.

4. Télécharger le fichier fusionné

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pptx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o merged_output.pptx

Pour plus de détails, consultez la référence API officielle.

Options de fusion : configuration et paramètres

Bien que l’exemple de base fonctionne dans la plupart des scénarios, le SDK propose des options supplémentaires que vous pouvez ajuster.

Chemin de sortie

Spécifiez un dossier ou un nom de fichier personnalisé.

mergeOptions.setOutputPath("reports/combined_presentation.pptx");

Protection par mot de passe (si nécessaire)

mergeOptions.setPassword("StrongPassword123");

Conserver la mise en page d’origine

mergeOptions.setPreserveLayout(true);

Ces propriétés font partie de la classe MergeOptions ; consultez la référence API pour la liste complète.

Conclusion

En tirant parti du GroupDocs.Merger Cloud SDK for Java, vous pouvez facilement combiner et fusionner Powerpoint PPT PPTX en Java, que vous préfériez une bibliothèque Java native ou une approche RESTful cURL. Le SDK gère le stockage des fichiers, la logique de fusion et la génération de la sortie, vous permettant de vous concentrer sur les fonctionnalités principales de votre application. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; les détails de tarification sont disponibles sur la page du produit, et vous pouvez demander une licence temporaire pour l’évaluation sur la page de licence temporaire. Commencez dès aujourd’hui à intégrer la fusion PowerPoint et rationalisez vos flux de travail de documents.

FAQs

• Quels formats puis‑je fusionner avec le SDK ?
  Le SDK prend en charge les fichiers PPT et PPTX, ainsi que de nombreux autres types de documents répertoriés dans la référence API.

• Dois-je convertir les anciens fichiers PPT avant de les fusionner ?
  Aucune conversion n’est requise. Le SDK gère automatiquement le mélange des sources PPT et PPTX pendant le processus de fusion.

• Comment le SDK gère-t-il les présentations volumineuses ?
  La fusion est effectuée côté serveur, de sorte que la consommation de mémoire sur votre machine cliente reste faible. Vous pouvez également ajuster l’option PreserveLayout pour optimiser les performances.

• Puis-je fusionner des présentations sans écrire de code Java ?
  Oui. Utilisez l’API REST avec des commandes cURL comme indiqué précédemment, ou intégrez les appels dans n’importe quel langage capable d’effectuer des requêtes HTTP.

En savoir plus

• Diviser les fichiers PowerPoint PPT/PPTX en fichiers séparés avec Java
• Fusionner et combiner les présentations PowerPoint PPT/PPTX en C#
• Fusionner les fichiers PowerPoint en un seul en Java - Fusion de documents Java