Convertir el diseño de un documento Word es una necesidad frecuente al generar informes, contratos o folletos imprimibles. GroupDocs.Merger Cloud SDK for Node.js permite a los desarrolladores programáticamente convertir la orientación de página de Word en Node.JS con solo unas pocas líneas de código. Esta guía le guía a través de los pasos necesarios, muestra un ejemplo completo en funcionamiento, demuestra llamadas cURL equivalentes y explica la instalación y configuración para que pueda integrar cambios de orientación de página en sus aplicaciones Node.js.

Pasos para convertir la orientación de página de Word en Node.JS

  1. Instalar el SDK y configurar credenciales: Utiliza npm para agregar la biblioteca y configurar tu ID de cliente y secreto.

    npm install groupdocs-merger-cloud

  2. Crear la instancia de la API: Inicializar ChangePageOrientationApi con el objeto de configuración.

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);

  1. Construir las opciones de solicitud: Defina el archivo de origen, el rango de páginas, la orientación deseada y la ruta de salida.

    const options = new GroupDocsMergerCloud.ChangePageOrientationOptions();
options.fileInfo = new GroupDocsMergerCloud.FileInfo();
options.fileInfo.filePath = 'input.docx';
options.pages = ['1-']; // all pages
options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // or Portrait
options.outputPath = 'output.docx';

  2. Ejecutar el cambio de orientación: Envíe la solicitud y maneje la respuesta.

const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);
orientationApi.changePageOrientation(request)
    .then(response => {
        console.log('Page orientation conversion completed.');
        console.log('Output stored at:', response.path);
    })
    .catch(error => {
        console.error('Error during orientation conversion:', error);
    });
  1. (Opcional) Ajustar configuraciones adicionales: Puedes modificar la matriz pages para apuntar a páginas específicas o cambiar el enumerado orientation a Portrait para un diseño diferente.

Cambio de orientación de página de Word - Ejemplo de código completo

El siguiente ejemplo muestra el flujo de trabajo completo para cambiar la orientación de un archivo DOCX 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);

// ==== API Instance ====
const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);

// ==== Request Construction ====
const options = new GroupDocsMergerCloud.ChangePageOrientationOptions();
options.fileInfo = new GroupDocsMergerCloud.FileInfo();
options.fileInfo.filePath = 'input.docx';               // source Word document
options.pages = ['1-'];                                 // apply to all pages (1 to end)
options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // Portrait or Landscape
options.outputPath = 'output.docx';                     // destination file

const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);

// ==== Execution ====
orientationApi.changePageOrientation(request)
    .then(response => {
        console.log('Page orientation conversion completed.');
        console.log('Output stored at:', response.path);
    })
    .catch(error => {
        console.error('Error during orientation conversion:', error);
    });

Nota: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar las rutas de los archivos (input.docx, output.docx) para que coincidan con sus ubicaciones reales, verifique que todas las dependencias requeridas estén correctamente instaladas 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.

Cambiar la orientación de la página mediante la API REST con cURL

Si prefiere un enfoque HTTP puro, la misma operación se puede realizar con comandos cURL contra los endpoints REST de GroupDocs.Merger Cloud.

  1. Obtener un token de acceso
curl -X POST "https://api.groupdocs.cloud/v1.0/oauth2/token" \
        -H "Content-Type: application/json" \
        -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

La respuesta contiene access_token.

  1. Cargar el archivo DOCX de origen
curl -X POST "https://api.groupdocs.cloud/v1.0/merger/storage/upload" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@input.docx" \
        -F "path=/input.docx"
  1. Solicitar cambio de orientación
curl -X POST "https://api.groupdocs.cloud/v1.0/merger/words/changePageOrientation" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "/input.docx" },
           "pages": ["1-"],
           "orientation": "Landscape",
           "outputPath": "/output.docx"
         }'
  1. Descargar el archivo resultante
curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.docx

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

Instalación y Configuración de GroupDocs.Merger Cloud SDK for Node.js

Para comenzar, instala el paquete desde npm y configura tus credenciales.

npm install groupdocs-merger-cloud

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

Descargue la última biblioteca desde la página de lanzamientos si necesita una versión específica. Asegúrese de que su entorno ejecute Node.js 12 o superior y que tenga una cuenta válida de GroupDocs Cloud.

Configuración de opciones de orientación de página

El SDK expone varias propiedades que puedes ajustar:

  • pages - Defina qué páginas afectar (p. ej., ['1-5'] para las primeras cinco páginas).
options.pages = ['1-5'];
  • orientation - Elija GroupDocsMergerCloud.Orientation.Portrait o Landscape.
options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
  • outputPath - Especifique la ruta de destino en su almacenamiento en la nube.
options.outputPath = 'converted/output.docx';

Estas opciones forman parte de la clase ChangePageOrientationOptions documentada en la referencia de API.

Conclusión

Cambiar la disposición de los archivos Word de forma programática es sencillo con el GroupDocs.Merger Cloud SDK for Node.js. Siguiendo los pasos anteriores, puedes convertir la orientación de página de Word en Node.JS, automatizar el procesamiento masivo e integrar los cambios de orientación en cualquier flujo de trabajo de documentos. Recuerda obtener una licencia adecuada para uso en producción; los detalles de precios están disponibles en la página del producto, y puedes obtener una licencia temporal en la página de licencia temporal. Con el SDK instalado y configurado, estás listo para mejorar tus aplicaciones con capacidades flexibles de manipulación de documentos.

Preguntas frecuentes

  • ¿Cómo cambio la orientación de página en documentos Word usando Node.js?
    Utilice ChangePageOrientationApi del GroupDocs.Merger Cloud SDK for Node.js, establezca la orientation deseada en las opciones de la solicitud y ejecute la llamada a la API.

  • ¿Existe una forma de exportar la orientación de página de Word en Node.JS sin escribir código?
    Sí, la misma operación se puede realizar a través de la API REST usando comandos cURL, lo que es útil para scripts rápidos o la integración con otros sistemas.

  • ¿Qué orientaciones son compatibles para documentos Word?
    El SDK admite los modos Portrait y Landscape a través del enum Orientation. También puede especificar rangos de página para aplicar el cambio selectivamente.

  • ¿Necesito una licencia para ejecutarlo en producción?
    Se requiere una licencia válida para implementaciones en producción. Puede comenzar con una licencia temporal desde la página de licencia temporal y actualizar a una licencia completa a medida que su uso crezca.

Leer más