Exemple complet fonctionnel pour combiner plusieurs documents Word en Java

Cet exemple montre comment combiner plusieurs documents Word en Java en utilisant l’API Merger.

import com.groupdocs.merger.cloud.client.ApiClient;
import com.groupdocs.merger.cloud.client.ApiException;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import java.util.ArrayList;
import java.util.List;

public class CombineWordDocuments {
    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);

try {
            // List of Word documents to combine
            List<FileInfo> sourceFiles = new ArrayList<>();
            sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input2.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input3.docx"));

// Configure merge options
            MergeOptions mergeOptions = new MergeOptions();
            mergeOptions.setOutputPath("merged_output.docx");
            mergeOptions.setFileInfos(sourceFiles);

// Execute the merge operation
            FileInfo result = mergerApi.merge(mergeOptions);

System.out.println("Merge completed successfully. Output file: " + result.getFilePath());
        } catch (ApiException e) {
            System.err.println("An error occurred while merging documents: " + e.getMessage());
        }
    }
}

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, 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.

Fusionner des fichiers Word via l’API REST avec cURL

Si vous préférez une approche purement REST, la même opération de fusion peut être effectuée avec des appels cURL. Les étapes ci-dessous montrent comment obtenir un jeton d’accès, télécharger les fichiers source, demander la fusion et télécharger le résultat.

Authentifiez‑vous et obtenez un jeton d’accès:

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

Téléchargez chaque fichier DOCX dans votre stockage cloud (remplacez YOUR_ACCESS_TOKEN par le jeton de l’étape précédente) :

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input1.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
     --data-binary @input1.docx

Répétez la commande de téléchargement pour input2.docx et input3.docx.

Créer la demande 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 '{
           "outputPath":"merged_output.docx",
           "fileInfos":[
               {"filePath":"input1.docx"},
               {"filePath":"input2.docx"},
               {"filePath":"input3.docx"}
           ]
         }'

Télécharger le document fusionné:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/merged_output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.docx

Pour plus de détails sur les paramètres de la requête, consultez la documentation officielle de l’API.

Comprendre le processus de combinaison de documents Word en Java

Voici une explication détaillée, étape par étape, du code présenté précédemment.

1. Créer un ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") établit une connexion au service cloud GroupDocs.

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

2. Instancier MergerApi - new MergerApi(apiClient) donne accès aux points de terminaison liés à la fusion.

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. Préparer la liste des fichiers source - Chaque objet FileInfo pointe vers un fichier DOCX stocké dans le cloud. La liste est transmise à MergeOptions.

   List<FileInfo> sourceFiles = new ArrayList<>();
   sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
   

4. Configurer MergeOptions - Définissez le chemin de sortie souhaité et joignez la liste des fichiers source.

   MergeOptions mergeOptions = new MergeOptions();
   mergeOptions.setOutputPath("merged_output.docx");
   mergeOptions.setFileInfos(sourceFiles);
   

5. Exécuter la fusion - mergerApi.merge(mergeOptions) envoie la requête et renvoie un FileInfo pour le document fusionné.

   FileInfo result = mergerApi.merge(mergeOptions);
   

Pour une liste complète des propriétés disponibles, consultez la référence API.

Pré-requis et configuration pour GroupDocs.Merger Cloud SDK

Avant de pouvoir exécuter le code, ajoutez la dépendance Maven à votre projet et assurez‑vous de disposer d’un compte GroupDocs valide.

Ajoutez le SDK à votre pom.xml :

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

Téléchargez les derniers JAR et le code source depuis la page de téléchargement.
Vous aurez également besoin de Java 8 ou supérieur et d’un accès Internet pour les appels cloud.
Créez un compte GroupDocs, obtenez votre Client ID et Client Secret, et conservez‑les en sécurité.

Conclusion

La fusion de fichiers DOCX par programmation est désormais simple avec le GroupDocs.Merger Cloud SDK for Java. Le code d’exemple et les extraits cURL illustrent deux méthodes flexibles pour combiner plusieurs documents Word en Java, que vous préfériez une bibliothèque native ou des appels REST directs. N’oubliez pas de configurer vos identifiants, de gérer les gros fichiers en les diffusant en continu si nécessaire, et de tester l’opération de fusion avec des documents représentatifs. Pour les déploiements en production, vous aurez besoin d’une licence payante ; les détails de tarification sont disponibles sur la page produit et vous pouvez demander une licence temporaire pour l’évaluation depuis la page de licence temporaire.

FAQ

• Comment puis‑je combiner plusieurs documents Word en Java sans écrire de code de gestion de fichiers personnalisé ?
  Utilisez le GroupDocs.Merger Cloud SDK for Java. Le SDK abstrait toutes les opérations de bas niveau et vous permet de fusionner des fichiers DOCX avec quelques appels d’API.

• Est-il possible de fusionner des documents stockés dans différents dossiers cloud ?
  Oui. Fournissez les chemins complets des fichiers cloud dans les objets FileInfo, et l’opération de fusion récupérera chaque fichier depuis son emplacement avant de les combiner.

• Que faire si la fusion échoue avec une ApiException ?
  Vérifiez le message d’exception pour obtenir des détails tels que des fichiers manquants ou des problèmes d’autorisations. Assurez-vous que les chemins de fichiers sont corrects et que votre compte dispose d’un accès en lecture/écriture au stockage. Consultez la documentation officielle pour les codes d’erreur.

• Dois-je disposer d’une licence distincte pour chaque environnement (développement, préproduction, production) ?
  Une licence unique couvre tous les environnements, mais vous devez respecter les limites d’utilisation définies dans votre contrat de licence. Pour les tests, vous pouvez utiliser la licence temporaire mentionnée ci-dessus.

Read More

• Protéger un fichier ZIP avec un logiciel de protection par mot de passe
• Protéger Excel à l’aide du service de protection par mot de passe
• Combiner des documents Word en C#

Combiner plusieurs documents Word dans Node.JS - Exemple de code complet

Cet exemple montre comment fusionner trois fichiers DOCX en un seul document en utilisant le GroupDocs.Merger Cloud SDK for Node.js.

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

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.docx, combined_output.docx, etc.) 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 documents Word via l’API REST en utilisant cURL

Si vous préférez une approche REST pure, la même opération de fusion peut être effectuée avec des commandes cURL. Ci-dessous se trouve un flux de travail concis qui authentifie, téléverse les fichiers source, exécute la fusion et télécharge le résultat.

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

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

La réponse contient un access_token utilisé dans les appels ultérieurs.

2. Téléverser les fichiers source

Répétez cette étape pour chaque fichier DOCX que vous souhaitez fusionner.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

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 '{
    "documents": [
        {"fileInfo": {"filePath": "documents/input1.docx"}},
        {"fileInfo": {"filePath": "documents/input2.docx"}},
        {"fileInfo": {"filePath": "documents/input3.docx"}}
    ],
    "outputPath": "documents/combined_output.docx"
}'

L’API renvoie le chemin du fichier fusionné.

4. Télécharger le document fusionné

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

Pour plus de détails sur les charges utiles de requête et les options, consultez la documentation officielle de l’API.

Comment la fusion de plusieurs documents Word en Node.JS fonctionne

Le SDK abstrait le processus de fusion en quelques étapes logiques :

1. Création de la configuration - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) construit le contexte d’authentification. Voir la référence de classe dans la Référence API.

   const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
   

2. Instance d’API - new GroupDocsMergerCloud.MergeApi(config) fournit l’accès aux opérations de fusion.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Entrées de document - Chaque fichier source est encapsulé dans un DocumentEntry qui contient un FileInfo avec le chemin du fichier.

   const documentEntries = inputFiles.map(path => {
       return new GroupDocsMergerCloud.Models.DocumentEntry({
           fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
       });
   });
   

4. Demande de fusion - MergeDocumentsRequest regroupe les entrées et le chemin de sortie souhaité.

   const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
       documents: documentEntries,
       outputPath: outputFile
   });
   

5. Exécution - mergeApi.mergeDocuments(mergeRequest) envoie la requête au service cloud. La promesse se résout avec un objet résultat contenant le chemin du fichier de sortie.

   const result = await mergeApi.mergeDocuments(mergeRequest);
   console.log(`Merge completed successfully. Output file: ${result.path}`);
   

Ces étapes vous permettent de combiner plusieurs documents Word efficacement sans gérer les flux de fichiers de bas niveau.

Préparer l’environnement pour GroupDocs.Merger

1. Installez le SDK

npm install groupdocs-merger-cloud

Le package est disponible sur la page de téléchargement officielle.

2. Node.js Version - Assurez-vous d’exécuter Node.js 12 ou une version ultérieure.

3. Configurer les informations d’identification - Remplacez YOUR_CLIENT_ID et YOUR_CLIENT_SECRET dans le code par les valeurs de votre compte GroupDocs Cloud.

4. Créer un dossier de projet - Placez les fichiers DOCX source dans un sous-dossier documents/ comme indiqué dans l’exemple.

Une fois ces étapes terminées, vous êtes prêt à exécuter le script de fusion ou à appeler les points de terminaison REST.

Conclusion

Combiner plusieurs documents Word dans Node.JS devient simple avec le GroupDocs.Merger Cloud SDK for Node.js. Le SDK gère le téléchargement des fichiers, la logique de fusion et la génération de la sortie, vous permettant de vous concentrer sur la logique métier plutôt que sur la manipulation de fichiers de bas niveau. N’oubliez pas d’obtenir une licence appropriée pour la production ; vous pouvez commencer avec une licence temporaire et passer à un abonnement complet à mesure que vos besoins augmentent. Commencez à fusionner dès aujourd’hui et rationalisez vos flux de travail de documents.

FAQs

• Comment combiner plusieurs documents Word dans Node.JS en utilisant le SDK ?
  Utilisez la classe MergeApi pour créer une MergeDocumentsRequest qui répertorie chaque fichier DOCX en tant que DocumentEntry. Le SDK les fusionne dans l’ordre fourni et enregistre le résultat dans le chemin de sortie spécifié.

• Est-il possible de fusionner des PDF ensemble avec le même SDK ?
  Oui, le Merger SDK prend en charge PDF, DOCX, ODT, et plusieurs autres formats. Il suffit de modifier les extensions de fichier dans le tableau inputFiles et le SDK gérera automatiquement la conversion. Consultez la documentation officielle pour les détails des formats.

• Quelles sont les limites du nombre de documents que je peux fusionner dans une seule requête ?
  Le service cloud impose une limite de taille plutôt qu’un nombre strict. Tant que la taille combinée reste dans le quota de votre compte, vous pouvez fusionner des dizaines de fichiers. Pour des lots très volumineux, envisagez de télécharger les fichiers dans le stockage GroupDocs d’abord et de les référencer par ID.

• Do I need to worry about licensing for development versus production?
  Le développement et les tests peuvent utiliser une licence temporaire obtenue depuis la page de licence temporaire. Pour les déploiements en production, achetez une licence complète pour débloquer des fusions illimitées et un support prioritaire.

Read More

• Protéger un fichier ZIP avec un logiciel de protection par mot de passe
• Protéger Excel avec le service de protection par mot de passe
• Combiner des documents Word en C#