Ejemplo completo y funcional para combinar varios documentos Word en Java

Este ejemplo muestra cómo combinar varios documentos Word en Java usando la 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());
        }
    }
}

Nota: Este ejemplo de código muestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén instaladas correctamente y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Fusionar archivos Word mediante la API REST usando cURL

Si prefieres un enfoque puramente REST, la misma operación de fusión se puede realizar con llamadas cURL. Los pasos a continuación muestran cómo obtener un token de acceso, cargar los archivos de origen, solicitar la fusión y descargar el resultado.

Autenticar y obtener un token de acceso:

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"}'

Cargue cada archivo DOCX en su almacenamiento en la nube (reemplaza YOUR_ACCESS_TOKEN con el token del paso anterior):

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

Repita el comando de carga para input2.docx y input3.docx.

Crear la solicitud de fusión:

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"}
           ]
         }'

Descargar el documento combinado:

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

Para obtener más detalles sobre los parámetros de la solicitud, consulte la documentación oficial de la API.

Comprendiendo el proceso de combinar documentos Word en Java

A continuación se muestra un desglose paso a paso del código presentado anteriormente.

1. Crear un ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") establece una conexión con el servicio en la nube de GroupDocs.

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

2. Instanciar MergerApi - new MergerApi(apiClient) brinda acceso a los endpoints relacionados con la fusión.

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. Preparar la lista de archivos de origen - Cada objeto FileInfo apunta a un archivo DOCX almacenado en la nube. La lista se pasa a MergeOptions.

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

4. Configurar MergeOptions - Establezca la ruta de salida deseada y adjunte la lista de archivos de origen.

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

5. Ejecutar la fusión - mergerApi.merge(mergeOptions) envía la solicitud y devuelve un FileInfo para el documento fusionado.

   FileInfo result = mergerApi.merge(mergeOptions);
   

Para obtener una lista completa de las propiedades disponibles, consulte la referencia de API.

Requisitos y configuración para GroupDocs.Merger Cloud SDK

Antes de poder ejecutar el código, agregue la dependencia de Maven a su proyecto y asegúrese de tener una cuenta válida de GroupDocs.

Agrega el SDK a tu pom.xml:

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

Descargue los últimos JAR y el código fuente desde la página de descarga.
También necesitará Java 8 o superior y acceso a internet para las llamadas a la nube.
Cree una cuenta de GroupDocs, obtenga su Client ID y Client Secret, y manténgalos seguros.

Conclusión

Fusionar archivos DOCX programáticamente ahora es sencillo con el GroupDocs.Merger Cloud SDK for Java. El código de ejemplo y los fragmentos cURL ilustran dos formas flexibles de combinar varios documentos Word en Java, ya sea que prefiera una biblioteca nativa o llamadas REST directas. Recuerde configurar sus credenciales, manejar archivos grandes mediante streaming si es necesario y probar la operación de fusión con documentos representativos. Para implementaciones en producción necesitará una licencia paga; los detalles de precios están disponibles en la página del producto y puede solicitar una licencia temporal para evaluación desde la página de licencia temporal.

Preguntas frecuentes

• ¿Cómo combinar varios documentos de Word en Java sin escribir código personalizado de manejo de archivos?
  Utilice el GroupDocs.Merger Cloud SDK for Java. El SDK abstrae todas las operaciones de bajo nivel y le permite combinar archivos DOCX con unas pocas llamadas a la API.

• ¿Es posible combinar documentos que están almacenados en diferentes carpetas en la nube?
  Sí. Proporcione las rutas completas de los archivos en la nube en los objetos FileInfo, y la operación de combinación obtendrá cada archivo de su ubicación antes de combinarlos.

• ¿Qué debo hacer si la fusión falla con un ApiException?
  Verifique el mensaje de excepción para obtener detalles, como archivos faltantes o problemas de permisos. Asegúrese de que las rutas de los archivos sean correctas y de que su cuenta tenga acceso de lectura/escritura al almacenamiento. Consulte la documentación oficial para obtener códigos de error.

• ¿Necesito una licencia separada para cada entorno (desarrollo, pruebas, producción)?
  Una única licencia cubre todos los entornos, pero debe respetar los límites de uso definidos en su acuerdo de licencia. Para pruebas, puede usar la licencia temporal vinculada arriba.

Leer más

• Proteger con contraseña archivo ZIP usando software de protección de contraseñas
• Proteger con contraseña Excel usando servicio de protección de contraseñas
• Combinar documentos Word en C#

Combinar varios documentos de Word en Node.JS - Ejemplo de código completo

Este ejemplo muestra cómo fusionar tres archivos DOCX en un solo documento usando el 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);
    }
})();

Nota: Este ejemplo de código muestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar las rutas de los archivos (input1.docx, combined_output.docx, etc.) para que coincidan con la ubicación real de sus archivos, verifique que todas las dependencias requeridas estén correctamente instaladas y realice pruebas exhaustivas en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Fusionar documentos Word mediante la API REST usando cURL

Si prefieres un enfoque puramente REST, la misma operación de fusión se puede realizar con comandos cURL. A continuación se muestra un flujo de trabajo conciso que autentica, carga los archivos de origen, ejecuta la fusión y descarga el resultado.

1. Autenticar y obtener el token de acceso

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 respuesta contiene un access_token que se utiliza en llamadas posteriores.

2. Cargar los archivos de origen

Repita este paso para cada archivo DOCX que desee combinar.

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. Ejecutar la operación de fusión

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"
}'

La API devuelve la ruta del archivo fusionado.

4. Descargar el documento combinado

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

Para obtener más detalles sobre las cargas útiles de la solicitud y las opciones, consulte la documentación oficial de la API.

Cómo funciona la fusión de varios documentos Word en Node.JS

El SDK abstrae el proceso de fusión en unos pocos pasos lógicos:

1. Creación de configuración - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) crea el contexto de autenticación. Consulte la referencia de la clase en la Referencia de API.

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

2. Instancia de API - new GroupDocsMergerCloud.MergeApi(config) proporciona acceso a operaciones de fusión.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Entradas de documento - Cada archivo de origen se envuelve en un DocumentEntry que contiene un FileInfo con la ruta del archivo.

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

4. Solicitud de fusión - MergeDocumentsRequest agrupa las entradas y la ruta de salida deseada.

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

5. Ejecución - mergeApi.mergeDocuments(mergeRequest) envía la solicitud al servicio en la nube. La promesa se resuelve con un objeto de resultado que contiene la ruta del archivo de salida.

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

Estos pasos, en conjunto, le permiten combinar varios documentos de Word de manera eficiente sin manejar flujos de archivo de bajo nivel.

Preparando el entorno para GroupDocs.Merger

1. Instalar el SDK

npm install groupdocs-merger-cloud

El paquete está disponible en la página oficial de página de descarga.

2. Node.js Version - Asegúrese de que está ejecutando Node.js 12 o posterior.

3. Configurar credenciales - Reemplace YOUR_CLIENT_ID y YOUR_CLIENT_SECRET en el código con los valores de su cuenta de GroupDocs Cloud.

4. Crear una carpeta de proyecto - Coloque los archivos DOCX de origen en una subcarpeta documents/ como se muestra en el ejemplo.

Con estos pasos completados, ya estás listo para ejecutar el script de fusión o invocar los endpoints REST.

Conclusión

Combinar varios documentos Word en Node.JS se vuelve sencillo con el GroupDocs.Merger Cloud SDK for Node.js. El SDK maneja la carga de archivos, la lógica de fusión y la generación de salida, lo que le permite centrarse en la lógica de negocio en lugar de la manipulación de archivos de bajo nivel. Recuerde obtener una licencia adecuada para uso en producción; puede comenzar con una licencia temporal y actualizar a una suscripción completa a medida que sus necesidades crezcan. Comience a fusionar hoy y optimice sus flujos de trabajo de documentos.

Preguntas frecuentes

• ¿Cómo combinar varios documentos Word en Node.JS usando el SDK?
  Utilice la clase MergeApi para crear una MergeDocumentsRequest que enumere cada archivo DOCX como un DocumentEntry. El SDK los combina en el orden proporcionado y guarda el resultado en la ruta de salida especificada.

• ¿Es posible combinar PDFs juntos con el mismo SDK?
  Sí, el Merger SDK admite PDF, DOCX, ODT, y varios otros formatos. Simplemente cambie las extensiones de archivo en la matriz inputFiles y el SDK manejará la conversión automáticamente. Consulte la documentación oficial para obtener detalles de los formatos.

• ¿Cuáles son los límites en la cantidad de documentos que puedo combinar en una sola solicitud?
  El servicio en la nube impone un límite de tamaño en lugar de un recuento estricto. Mientras el tamaño combinado se mantenga dentro de la cuota de su cuenta, puede combinar docenas de archivos. Para lotes muy grandes, considere cargar los archivos al almacenamiento de GroupDocs primero y referenciarlos por ID.

• ¿Necesito preocuparme por la licencia para desarrollo versus producción?
  El desarrollo y las pruebas pueden usar una licencia temporal obtenida de la página de licencia temporal. Para implementaciones en producción, adquiera una licencia completa para desbloquear fusiones ilimitadas y soporte prioritario.

Read More

• Proteger con contraseña un archivo ZIP usando software de protección de contraseñas
• Proteger con contraseña un archivo Excel usando el servicio de protección de contraseñas
• Combinar documentos Word en C#