Konwertowanie układu dokumentu Word jest częstą potrzebą przy generowaniu raportów, umów lub drukowalnych broszur. GroupDocs.Merger Cloud SDK for Node.js umożliwia programistom programowe konwertowanie orientacji strony Word w Node.JS przy użyciu kilku linijek kodu. Ten przewodnik przeprowadzi Cię przez wymagane kroki, pokaże kompletny działający przykład, przedstawi równoważne wywołania cURL oraz wyjaśni instalację i konfigurację, abyś mógł zintegrować zmiany orientacji stron w swoich aplikacjach Node.js.

Kroki konwersji orientacji strony Word w Node.JS

  1. Zainstaluj SDK i skonfiguruj poświadczenia: Użyj npm, aby dodać bibliotekę i ustawić swój identyfikator klienta oraz sekret.

    npm install groupdocs-merger-cloud

  2. Utwórz instancję API: Zainicjalizuj ChangePageOrientationApi przy użyciu obiektu konfiguracji.

    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. Zbuduj opcje żądania: Określ plik źródłowy, zakres stron, żądaną orientację oraz ścieżkę wyjściową.

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. Wykonaj zmianę orientacji: Wyślij żądanie i obsłuż odpowiedź.
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. (Opcjonalnie) Dostosuj dodatkowe ustawienia: Możesz zmodyfikować tablicę pages, aby celować w określone strony lub przełączyć wyliczenie orientation na Portrait, aby uzyskać inny układ.

Zmiana orientacji strony w dokumencie Word – kompletny przykład kodu

Poniższy przykład demonstruje pełny przepływ pracy zmiany orientacji pliku DOCX przy użyciu 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);
    });

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (input.docx, output.docx), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są prawidłowo zainstalowane, i dokładnie przetestuj w środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Zmiana orientacji strony za pomocą REST API i cURL

Jeśli wolisz czyste podejście HTTP, tę samą operację można wykonać przy użyciu poleceń cURL wobec endpointów REST GroupDocs.Merger Cloud.

  1. Uzyskaj token dostępu
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"}'

Odpowiedź zawiera access_token.

  1. Prześlij plik źródłowy DOCX
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. Żądanie zmiany orientacji
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. Pobierz wynikowy plik
curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.docx

Aby uzyskać więcej informacji o ładunkach żądań i obsługiwanych parametrach, zobacz oficjalną dokumentację API.

Installing and Configuring GroupDocs.Merger Cloud SDK for Node.js

Aby rozpocząć, zainstaluj pakiet z npm i skonfiguruj swoje dane uwierzytelniające.

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

Pobierz najnowszą bibliotekę ze strony wydania, jeśli potrzebujesz konkretnej wersji. Upewnij się, że Twoje środowisko działa na Node.js 12 lub wyższym oraz że masz ważne konto GroupDocs Cloud.

Konfigurowanie opcji orientacji strony

SDK udostępnia kilka właściwości, które możesz dostosować:

  • pages - Określ, które strony mają być objęte (np. ['1-5'] dla pierwszych pięciu stron).
options.pages = ['1-5'];
  • orientation - Wybierz GroupDocsMergerCloud.Orientation.Portrait lub Landscape.
options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
  • outputPath - Określ ścieżkę docelową w swojej pamięci w chmurze.
options.outputPath = 'converted/output.docx';

Te opcje są częścią klasy ChangePageOrientationOptions udokumentowanej w referencji API.

Podsumowanie

Zmiana układu plików Word programowo jest prosta dzięki GroupDocs.Merger Cloud SDK for Node.js. Postępując zgodnie z powyższymi krokami, możesz konwertować orientację stron Word w Node.JS, automatyzować przetwarzanie wsadowe i integrować zmiany orientacji w dowolnym przepływie pracy dokumentów. Pamiętaj, aby zabezpieczyć odpowiednią licencję do użytku produkcyjnego; szczegóły cenowe są dostępne na stronie produktu, a tymczasową licencję możesz uzyskać na stronie tymczasowej licencji. Po zainstalowaniu i skonfigurowaniu SDK, jesteś gotowy, aby wzbogacić swoje aplikacje o elastyczne możliwości manipulacji dokumentami.

Najczęściej zadawane pytania

  • Jak zmienić orientację strony w dokumentach Word przy użyciu Node.js?
    Użyj ChangePageOrientationApi z GroupDocs.Merger Cloud SDK for Node.js, ustaw żądaną orientation w opcjach żądania i wykonaj wywołanie API.

  • Czy istnieje sposób na wyeksportowanie orientacji strony Word w Node.JS bez pisania kodu?
    Tak, tę samą operację można wykonać za pośrednictwem REST API przy użyciu poleceń cURL, co jest przydatne w szybkich skryptach lub integracji z innymi systemami.

  • Jakie orientacje są obsługiwane w dokumentach Word?
    SDK obsługuje zarówno tryby Portrait, jak i Landscape za pomocą wyliczenia Orientation. Można również określić zakresy stron, aby zastosować zmianę selektywnie.

  • Czy potrzebuję licencji, aby uruchomić to w środowisku produkcyjnym?
    Wymagana jest ważna licencja do wdrożeń produkcyjnych. Możesz rozpocząć od tymczasowej licencji ze strony tymczasowej licencji, a następnie przejść na pełną licencję w miarę rosnącego zużycia.

Read More