Converter o layout de um documento Word é uma necessidade frequente ao gerar relatórios, contratos ou folhetos imprimíveis. GroupDocs.Merger Cloud SDK for Node.js permite que os desenvolvedores convertem a orientação de página do Word no Node.JS com apenas algumas linhas de código. Este guia orienta você através das etapas necessárias, mostra um exemplo completo em funcionamento, demonstra chamadas cURL equivalentes e explica a instalação e configuração para que você possa integrar alterações de orientação de página em suas aplicações Node.js.

Etapas para Converter a Orientação da Página do Word no Node.JS

  1. Instale o SDK e configure as credenciais: Use o npm para adicionar a biblioteca e configurar seu ID de cliente e segredo.

    npm install groupdocs-merger-cloud

  2. Crie a instância da API: Inicialize ChangePageOrientationApi com o objeto de configuração.

    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. Construa as opções de solicitação: Defina o arquivo de origem, o intervalo de páginas, a orientação desejada e o caminho de saída.

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

  4. Execute a mudança de orientação: Envie a solicitação e trate a resposta.

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 configurações adicionais: Você pode modificar o array pages para direcionar páginas específicas ou mudar o enum orientation para Portrait para um layout diferente.

Alteração de Orientação de Página do Word - Exemplo de Código Completo

O exemplo a seguir demonstra o fluxo de trabalho completo para alterar a orientação de um arquivo DOCX usando o 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 exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar os caminhos dos arquivos (input.docx, output.docx) para corresponderem às suas localizações reais, verifique se todas as dependências necessárias estão corretamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Alterando a Orientação da Página via API REST com cURL

Se você preferir uma abordagem puramente HTTP, a mesma operação pode ser realizada com comandos cURL contra os endpoints REST do GroupDocs.Merger Cloud.

  1. Obtenha um token de acesso
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"}'

A resposta contém access_token.

  1. Carregue o arquivo DOCX de origem
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 alteração de orientação
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. Baixe o arquivo 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 mais detalhes sobre os payloads de solicitação e os parâmetros suportados, veja a documentação oficial da API.

Instalando e Configurando GroupDocs.Merger Cloud SDK for Node.js

Para começar, instale o pacote do npm e configure suas credenciais.

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

Baixe a biblioteca mais recente na página de lançamentos se precisar de uma versão específica. Certifique‑se de que seu ambiente execute Node.js 12 ou superior e que você possua uma conta válida do GroupDocs Cloud.

Configurando Opções de Orientação da Página

O SDK expõe várias propriedades que você pode ajustar:

  • pages - Defina quais páginas afetar (por exemplo, ['1-5'] para as primeiras cinco páginas).
    options.pages = ['1-5'];
  • orientation - Escolha GroupDocsMergerCloud.Orientation.Portrait ou Landscape.
    options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
  • outputPath - Especifique o caminho de destino no seu armazenamento em nuvem.
    options.outputPath = 'converted/output.docx';

Essas opções fazem parte da classe ChangePageOrientationOptions documentada na referência da API.

Conclusão

Alterar o layout de arquivos Word programaticamente é simples com o GroupDocs.Merger Cloud SDK for Node.js. Seguindo os passos acima, você pode converter a orientação da página do Word no Node.JS, automatizar o processamento em massa e integrar alterações de orientação em qualquer fluxo de trabalho de documentos. Lembre-se de garantir uma licença adequada para uso em produção; detalhes de preços estão disponíveis na página do produto, e você pode obter uma licença temporária na página de licença temporária. Com o SDK instalado e configurado, você está pronto para aprimorar suas aplicações com capacidades flexíveis de manipulação de documentos.

FAQs

  • Como altero a orientação da página em documentos Word usando Node.js?
    Use o ChangePageOrientationApi do GroupDocs.Merger Cloud SDK for Node.js, defina a orientation desejada nas opções de requisição e execute a chamada da API.

  • Existe uma maneira de exportar a orientação da página do Word no Node.JS sem escrever código?
    Sim, a mesma operação pode ser realizada via API REST usando comandos cURL, o que é útil para scripts rápidos ou integração com outros sistemas.

  • Quais orientações são suportadas para documentos Word?
    O SDK oferece suporte aos modos Portrait e Landscape por meio do enum Orientation. Você também pode especificar intervalos de páginas para aplicar a alteração seletivamente.

  • Preciso de uma licença para executar isso em produção?
    É necessária uma licença válida para implantações em produção. Você pode começar com uma licença temporária na página de licença temporária e atualizar para uma licença completa à medida que seu uso aumenta.

Read More