Das Konvertieren des Layouts eines Word‑Dokuments ist ein häufiger Bedarf beim Erstellen von Berichten, Verträgen oder druckbaren Broschüren.
GroupDocs.Merger Cloud SDK for Node.js ermöglicht Entwicklern, programmgesteuert Word‑Seitenorientierung in Node.JS mit nur wenigen Codezeilen zu konvertieren.
Dieser Leitfaden führt Sie durch die erforderlichen Schritte, zeigt ein vollständiges funktionierendes Beispiel, demonstriert äquivalente cURL‑Aufrufe und erklärt Installation und Konfiguration, sodass Sie Seitenorientierungsänderungen in Ihre Node.js‑Anwendungen integrieren können.

Schritte zum Konvertieren der Word‑Seitenorientierung in Node.JS

  1. Installieren Sie das SDK und konfigurieren Sie die Anmeldeinformationen: Verwenden Sie npm, um die Bibliothek hinzuzufügen und Ihre Client‑ID sowie das Geheimnis einzurichten.

    npm install groupdocs-merger-cloud

  2. Erstellen Sie die API-Instanz: Initialisieren Sie ChangePageOrientationApi mit dem Konfigurationsobjekt.

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. Erstellen Sie die Anfrageoptionen: Definieren Sie die Quelldatei, den Seitenbereich, die gewünschte Ausrichtung und den Ausgabepfad.
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. Führen Sie die Orientierungänderung aus: Senden Sie die Anfrage und verarbeiten Sie die Antwort.
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. (Optional) Zusätzliche Einstellungen anpassen: Sie können das pages-Array ändern, um bestimmte Seiten anzusprechen, oder das orientation-Enum auf Portrait umstellen, um ein anderes Layout zu erhalten.

Word-Seitenorientierung ändern - Vollständiges Codebeispiel

Das folgende Beispiel demonstriert den vollständigen Arbeitsablauf zum Ändern der Ausrichtung einer DOCX Datei mithilfe des GroupDocs.Merger Cloud SDK für 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);
    });

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (input.docx, output.docx) an Ihre tatsächlichen Speicherorte anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Ändern der Seitenorientierung über die REST-API mit cURL

Wenn Sie einen reinen HTTP-Ansatz bevorzugen, kann dieselbe Operation mit cURL-Befehlen gegen die GroupDocs.Merger Cloud REST-Endpunkte ausgeführt werden.

  1. Ein Zugriffstoken erhalten
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"}'

Die Antwort enthält access_token.

  1. Laden Sie die Quell‑DOCX‑Datei hoch
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. Anfrage zur Änderung der Ausrichtung
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. Laden Sie die resultierende Datei herunter
curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.docx

Weitere Details zu Anfrage‑Payloads und unterstützten Parametern finden Sie in der offiziellen API‑Dokumentation.

Installation und Konfiguration GroupDocs.Merger Cloud SDK for Node.js

Um loszulegen, installieren Sie das Paket von npm und konfigurieren Sie Ihre Anmeldeinformationen.

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

Laden Sie die neueste Bibliothek von der Release‑Seite herunter, wenn Sie eine bestimmte Version benötigen. Stellen Sie sicher, dass Ihre Umgebung Node.js 12 oder höher ausführt und dass Sie ein gültiges GroupDocs Cloud‑Konto haben.

Konfigurieren von Seitenorientierungsoptionen

Das SDK stellt mehrere Eigenschaften zur Verfügung, die Sie anpassen können:

  • pages - Definieren Sie, welche Seiten betroffen sein sollen (z. B. ['1-5'] für die ersten fünf Seiten).
    options.pages = ['1-5'];
  • orientation - Wählen Sie GroupDocsMergerCloud.Orientation.Portrait oder Landscape.
    options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
  • outputPath - Geben Sie den Zielpfad in Ihrem Cloud‑Speicher an.
    options.outputPath = 'converted/output.docx';

Diese Optionen sind Teil der Klasse ChangePageOrientationOptions, die in der API-Referenz dokumentiert ist.

Fazit

Das Ändern des Layouts von Word‑Dateien programmgesteuert ist mit dem GroupDocs.Merger Cloud SDK for Node.js unkompliziert. Wenn Sie den obigen Schritten folgen, können Sie Word‑Seitenorientierung in Node.JS konvertieren, die Massenverarbeitung automatisieren und Orientierungsänderungen in jeden Dokumenten‑Workflow integrieren. Denken Sie daran, für die Produktion eine geeignete Lizenz zu sichern; Preisdetails finden Sie auf der Produktseite, und Sie können eine temporäre Lizenz von der temporären Lizenzseite erhalten. Mit dem installierten und konfigurierten SDK sind Sie bereit, Ihre Anwendungen mit flexiblen Dokumenten‑Manipulationsfunktionen zu erweitern.

FAQs

  • Wie ändere ich die Seitenorientierung in Word-Dokumenten mit Node.js?
    Verwenden Sie die ChangePageOrientationApi aus dem GroupDocs.Merger Cloud SDK for Node.js, setzen Sie die gewünschte orientation in den Anforderungsoptionen und führen Sie den API-Aufruf aus.

  • Gibt es eine Möglichkeit, die Seitenorientierung von Word in Node.JS zu exportieren, ohne Code zu schreiben?
    Ja, dieselbe Operation kann über die REST‑API mit cURL‑Befehlen durchgeführt werden, was für schnelle Skripte oder die Integration mit anderen Systemen nützlich ist.

  • Welche Ausrichtungen werden für Word‑Dokumente unterstützt?
    Das SDK unterstützt sowohl Portrait als auch Landscape Modi über das Orientation‑Enum. Sie können auch Seitenbereiche angeben, um die Änderung selektiv anzuwenden.

  • Benötige ich eine Lizenz, um dies in der Produktion auszuführen?
    Für Produktionsbereitstellungen ist eine gültige Lizenz erforderlich. Sie können mit einer temporären Lizenz von der temporären Lizenzseite beginnen und zu einer Volllizenz wechseln, wenn Ihr Bedarf wächst.

Read More