La conversione del layout di un documento Word è una necessità frequente quando si generano report, contratti o brochure stampabili. GroupDocs.Merger Cloud SDK for Node.js consente agli sviluppatori di convertire l’orientamento della pagina Word in Node.JS con poche righe di codice. Questa guida ti accompagna attraverso i passaggi necessari, mostra un esempio completo funzionante, dimostra le chiamate cURL equivalenti e spiega l’installazione e la configurazione in modo da poter integrare le modifiche dell’orientamento della pagina nelle tue applicazioni Node.js.

Passaggi per convertire l’orientamento della pagina Word in Node.JS

  1. Installa l’SDK e configura le credenziali: Usa npm per aggiungere la libreria e impostare il tuo client ID e secret.

    npm install groupdocs-merger-cloud

  2. Crea l’istanza dell’API: Inizializza ChangePageOrientationApi con l’oggetto di configurazione.

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

  3. Crea le opzioni della richiesta: Definisci il file di origine, l’intervallo di pagine, l’orientamento desiderato e il percorso di output.

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';
  1. Esegui la modifica dell’orientamento: Invia la richiesta e gestisci la risposta.
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. (Opzionale) Regola impostazioni aggiuntive: È possibile modificare l’array pages per mirare a pagine specifiche o cambiare l’enumerazione orientation in Portrait per un layout diverso.

Modifica dell’orientamento della pagina Word - Esempio di codice completo

Il seguente esempio dimostra il flusso di lavoro completo per modificare l’orientamento di un file DOCX utilizzando il 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: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input.docx, output.docx) per corrispondere alle tue effettive posizioni, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Modifica dell’orientamento della pagina tramite REST API con cURL

Se preferisci un approccio HTTP puro, la stessa operazione può essere eseguita con comandi cURL contro gli endpoint REST di GroupDocs.Merger Cloud.

  1. Ottieni un token di accesso
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 risposta contiene access_token.

  1. Carica il file DOCX di origine
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. Richiesta di cambio orientamento
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. Scarica il file risultante
curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.docx

Per ulteriori dettagli sui payload delle richieste e sui parametri supportati, consultare la documentazione ufficiale dell’API.

Installazione e configurazione GroupDocs.Merger Cloud SDK for Node.js

Per iniziare, installa il pacchetto da npm e configura le tue credenziali.

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

Scarica l’ultima libreria dalla pagina di rilascio se hai bisogno di una versione specifica. Assicurati che il tuo ambiente esegua Node.js 12 o versioni successive e che tu disponga di un account GroupDocs Cloud valido.

Configurazione delle opzioni di orientamento della pagina

L’SDK espone diverse proprietà che è possibile modificare:

  • pages - Definisci quali pagine influenzare (ad es., ['1-5'] per le prime cinque pagine).
options.pages = ['1-5'];
  • orientation - Scegli GroupDocsMergerCloud.Orientation.Portrait o Landscape.
options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
  • outputPath - Specifica il percorso di destinazione nel tuo storage cloud.
options.outputPath = 'converted/output.docx';

Queste opzioni fanno parte della classe ChangePageOrientationOptions documentata nel riferimento API.

Conclusione

Modificare il layout dei file Word in modo programmatico è semplice con il GroupDocs.Merger Cloud SDK for Node.js. Seguendo i passaggi sopra, è possibile convertire l’orientamento della pagina Word in Node.JS, automatizzare l’elaborazione in blocco e integrare le modifiche di orientamento in qualsiasi flusso di lavoro dei documenti. Ricorda di ottenere una licenza adeguata per l’uso in produzione; i dettagli dei prezzi sono disponibili nella pagina del prodotto, e puoi ottenere una licenza temporanea dalla pagina di licenza temporanea. Con l’SDK installato e configurato, sei pronto a migliorare le tue applicazioni con capacità flessibili di manipolazione dei documenti.

FAQ

  • Come cambio l’orientamento della pagina nei documenti Word usando Node.js?
    Usa l’ChangePageOrientationApi dal GroupDocs.Merger Cloud SDK for Node.js, imposta l’orientation desiderata nelle opzioni della richiesta e esegui la chiamata API.

  • Esiste un modo per esportare l’orientamento della pagina Word in Node.JS senza scrivere codice?
    Sì, la stessa operazione può essere eseguita tramite l’API REST usando comandi cURL, il che è utile per script rapidi o integrazioni con altri sistemi.

  • Quali orientamenti sono supportati per i documenti Word?
    L’SDK supporta sia le modalità Portrait che Landscape tramite l’enumerazione Orientation. È inoltre possibile specificare intervalli di pagine per applicare la modifica in modo selettivo.

  • Devo avere una licenza per eseguire questo in produzione?
    È necessaria una licenza valida per le distribuzioni in produzione. È possibile iniziare con una licenza temporanea dalla pagina della licenza temporanea e passare a una licenza completa man mano che l’uso aumenta.

Read More