Mengonversi tata letak dokumen Word adalah kebutuhan yang sering muncul saat membuat laporan, kontrak, atau brosur yang dapat dicetak. GroupDocs.Merger Cloud SDK for Node.js memungkinkan pengembang untuk secara programatis mengonversi Orientasi halaman Word di Node.JS dengan hanya beberapa baris kode. Panduan ini memandu Anda melalui langkah‑langkah yang diperlukan, menampilkan contoh kerja lengkap, menunjukkan panggilan cURL yang setara, dan menjelaskan instalasi serta konfigurasi sehingga Anda dapat mengintegrasikan perubahan orientasi halaman ke dalam aplikasi Node.js Anda.

Langkah-langkah untuk Mengubah Orientasi Halaman Word di Node.JS

  1. Instal SDK dan konfigurasikan kredensial: Gunakan npm untuk menambahkan pustaka dan mengatur ID klien serta rahasia Anda.

    npm install groupdocs-merger-cloud

  2. Buat instance API: Inisialisasi ChangePageOrientationApi dengan objek konfigurasi.

    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. Bangun opsi permintaan: Definisikan file sumber, rentang halaman, orientasi yang diinginkan, dan jalur 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';

  4. Jalankan perubahan orientasi: Kirim permintaan dan tangani respons.

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. (Opsional) Sesuaikan pengaturan tambahan: Anda dapat memodifikasi array pages untuk menargetkan halaman tertentu atau mengubah enum orientation menjadi Portrait untuk tata letak yang berbeda.

Mengubah Orientasi Halaman Word - Contoh Kode Lengkap

Contoh berikut menunjukkan alur kerja lengkap untuk mengubah orientasi file DOCX menggunakan 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);
    });

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input.docx, output.docx) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Mengubah Orientasi Halaman melalui REST API dengan cURL

Jika Anda lebih memilih pendekatan HTTP murni, operasi yang sama dapat dilakukan dengan perintah cURL terhadap endpoint REST GroupDocs.Merger Cloud.

  1. Dapatkan token akses
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"}'

Respons berisi access_token.

  1. Unggah file DOCX sumber
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. Permintaan perubahan orientasi
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. Unduh file yang dihasilkan
curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.docx

Untuk detail lebih lanjut tentang payload permintaan dan parameter yang didukung, lihat dokumentasi API resmi.

Menginstal dan Mengonfigurasi GroupDocs.Merger Cloud SDK for Node.js

Untuk memulai, instal paket dari npm dan konfigurasikan kredensial Anda.

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

Unduh perpustakaan terbaru dari halaman rilis jika Anda memerlukan versi tertentu. Pastikan lingkungan Anda menjalankan Node.js 12 atau lebih tinggi dan Anda memiliki akun GroupDocs Cloud yang valid.

Mengonfigurasi Opsi Orientasi Halaman

SDK menyediakan beberapa properti yang dapat Anda sesuaikan:

  • pages - Tentukan halaman mana yang akan dipengaruhi (misalnya, ['1-5'] untuk lima halaman pertama).
options.pages = ['1-5'];
  • orientation - Pilih GroupDocsMergerCloud.Orientation.Portrait atau Landscape.
options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
  • outputPath - Tentukan jalur tujuan di penyimpanan cloud Anda.
options.outputPath = 'converted/output.docx';

Opsi-opsi ini merupakan bagian dari kelas ChangePageOrientationOptions yang didokumentasikan dalam referensi API.

Kesimpulan

Mengubah tata letak file Word secara programatik sangat mudah dengan GroupDocs.Merger Cloud SDK for Node.js. Dengan mengikuti langkah‑langkah di atas, Anda dapat mengonversi Orientasi halaman Word di Node.JS, mengotomatisasi pemrosesan massal, dan mengintegrasikan perubahan orientasi ke dalam alur kerja dokumen apa pun. Ingatlah untuk mengamankan lisensi yang tepat untuk penggunaan produksi; detail harga tersedia di halaman produk, dan Anda dapat memperoleh lisensi sementara dari halaman lisensi sementara. Dengan SDK terpasang dan dikonfigurasi, Anda siap meningkatkan aplikasi Anda dengan kemampuan manipulasi dokumen yang fleksibel.

FAQ

  • Bagaimana cara mengubah orientasi halaman dalam dokumen Word menggunakan Node.js?
    Gunakan ChangePageOrientationApi dari GroupDocs.Merger Cloud SDK for Node.js, atur orientation yang diinginkan dalam opsi permintaan, dan jalankan panggilan API.

  • Apakah ada cara mengekspor Orientasi halaman Word di Node.JS tanpa menulis kode?
    Ya, operasi yang sama dapat dilakukan melalui REST API menggunakan perintah cURL, yang berguna untuk skrip cepat atau integrasi dengan sistem lain.

  • Orientasi apa yang didukung untuk dokumen Word?
    SDK mendukung mode Portrait dan Landscape melalui enum Orientation. Anda juga dapat menentukan rentang halaman untuk menerapkan perubahan secara selektif.

  • Apakah saya memerlukan lisensi untuk menjalankannya di produksi?
    Lisensi yang valid diperlukan untuk penyebaran produksi. Anda dapat memulai dengan lisensi sementara dari halaman lisensi sementara dan meningkatkan ke lisensi penuh seiring penggunaan Anda meningkat.

Read More