การแปลงเค้าโครงของเอกสาร Word เป็นความต้องการที่พบบ่อยเมื่อสร้างรายงาน, สัญญา หรือโบรชัวร์ที่สามารถพิมพ์ได้. GroupDocs.Merger Cloud SDK for Node.js ช่วยให้นักพัฒนาสามารถ แปลง Orientation ของหน้า Word ใน Node.JS ด้วยเพียงไม่กี่บรรทัดของโค้ด. คู่มือนี้จะพาคุณผ่านขั้นตอนที่จำเป็น, แสดงตัวอย่างการทำงานที่สมบูรณ์, สาธิตการเรียกใช้ cURL ที่เทียบเท่า, และอธิบายการติดตั้งและการกำหนดค่าเพื่อให้คุณสามารถรวมการเปลี่ยนแปลง orientation ของหน้าเข้าไปในแอปพลิเคชัน Node.js ของคุณ.

ขั้นตอนในการแปลงการวางแนวหน้าของ Word ใน Node.JS

  1. ติดตั้ง SDK และกำหนดค่า credentials: ใช้ npm เพื่อติดตั้งไลบรารีและตั้งค่า client ID และ secret ของคุณ.

    npm install groupdocs-merger-cloud

  2. สร้างอินสแตนซ์ของ API: เริ่มต้น ChangePageOrientationApi ด้วยอ็อบเจกต์การกำหนดค่า.

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. สร้างตัวเลือกคำขอ: กำหนดไฟล์ต้นทาง, ช่วงหน้า, การวางแนวที่ต้องการ, และเส้นทางออก.

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

  2. ดำเนินการเปลี่ยนแปลงการวางแนว: ส่งคำขอและจัดการการตอบกลับ.

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

  3. (ไม่บังคับ) ปรับการตั้งค่าเพิ่มเติม: คุณสามารถแก้ไขอาร์เรย์ pages เพื่อกำหนดเป้าหมายหน้าเฉพาะหรือสลับค่า enum orientation เป็น Portrait สำหรับการจัดวางแบบอื่น

การเปลี่ยนทิศทางหน้า Word - ตัวอย่างโค้ดเต็ม

ตัวอย่างต่อไปนี้แสดงขั้นตอนการทำงานทั้งหมดสำหรับการเปลี่ยนทิศทางของไฟล์ DOCX โดยใช้ 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);
    });

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ ให้ตรวจสอบให้แน่ใจว่าได้อัปเดตเส้นทางไฟล์ (input.docx, output.docx) ให้ตรงกับตำแหน่งไฟล์จริงของคุณ ตรวจสอบว่าขึ้นตอนการพึ่งพาที่จำเป็นทั้งหมดได้ติดตั้งอย่างถูกต้อง และทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนาของคุณ หากคุณพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อ ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

การเปลี่ยนแนวหน้ากระดาษผ่าน REST API ด้วย cURL

หากคุณต้องการใช้วิธีการ HTTP แบบบริสุทธิ์เดียวกัน การดำเนินการนี้สามารถทำได้ด้วยคำสั่ง cURL ที่เรียกใช้ REST endpoint ของ GroupDocs.Merger Cloud

  1. รับโทเค็นการเข้าถึง
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"}'

การตอบสนองมี access_token.

  1. อัปโหลดไฟล์ 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. ขอเปลี่ยนการวางแนว
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. ดาวน์โหลดไฟล์ผลลัพธ์
curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.docx

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ payload ของคำขอและพารามิเตอร์ที่รองรับ โปรดดู เอกสาร API อย่างเป็นทางการ.

การติดตั้งและกำหนดค่า GroupDocs.Merger Cloud SDK สำหรับ Node.js

เพื่อเริ่มต้น ให้ติดตั้งแพ็กเกจจาก npm และกำหนดค่าข้อมูลประจำตัวของคุณ

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

ดาวน์โหลดไลบรารีล่าสุดจาก หน้ารีลีส หากคุณต้องการเวอร์ชันเฉพาะ ตรวจสอบให้สภาพแวดล้อมของคุณทำงานบน Node.js 12 หรือสูงกว่าและคุณมีบัญชี GroupDocs Cloud ที่ใช้งานได้

กำหนดค่าตัวเลือกการวางแนวของหน้า

SDK เปิดเผยคุณสมบัติต่าง ๆ หลายรายการที่คุณสามารถปรับแต่งได้:

  • pages - กำหนดหน้าที่จะมีผล (เช่น ['1-5'] สำหรับห้าหน้าตัวแรก)
    options.pages = ['1-5'];
  • orientation - เลือก GroupDocsMergerCloud.Orientation.Portrait หรือ Landscape
    options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
  • outputPath - ระบุเส้นทางปลายทางในที่เก็บข้อมูลบนคลาวด์ของคุณ
    options.outputPath = 'converted/output.docx';

ตัวเลือกเหล่านี้เป็นส่วนหนึ่งของคลาส ChangePageOrientationOptions ที่อธิบายไว้ใน เอกสารอ้างอิง API.

สรุป

การเปลี่ยนแปลงเค้าโครงของไฟล์ Word อย่างอัตโนมัติเป็นเรื่องง่ายด้วย GroupDocs.Merger Cloud SDK for Node.js. โดยทำตามขั้นตอนข้างต้น คุณสามารถ แปลงการจัดแนวหน้าของ Word ใน Node.JS อัตโนมัติการประมวลผลเป็นกลุ่ม และรวมการเปลี่ยนแปลงการจัดแนวเข้าไปในกระบวนการทำงานของเอกสารใด ๆ

อย่าลืมจัดหาลิขสิทธิ์ที่เหมาะสมสำหรับการใช้งานในสภาพแวดล้อมจริง; รายละเอียดราคาอยู่บนหน้าผลิตภัณฑ์ และคุณสามารถรับลิขสิทธิ์ชั่วคราวจาก temporary license page. เมื่อ SDK ถูกติดตั้งและกำหนดค่าแล้ว คุณพร้อมที่จะเพิ่มประสิทธิภาพให้กับแอปพลิเคชันของคุณด้วยความสามารถในการจัดการเอกสารที่ยืดหยุ่น.

FAQs

  • ฉันจะเปลี่ยนการจัดแนวหน้าของเอกสาร Word โดยใช้ Node.js ได้อย่างไร?
    ใช้ ChangePageOrientationApi จาก GroupDocs.Merger Cloud SDK for Node.js, ตั้งค่า orientation ที่ต้องการในตัวเลือกของคำขอ, และดำเนินการเรียก API

  • มีวิธีส่งออกการจัดแนวหน้าของ Word ใน Node.JS โดยไม่ต้องเขียนโค้ดหรือไม่?
    ใช่, สามารถทำการดำเนินการเดียวกันผ่าน REST API ด้วยคำสั่ง cURL ซึ่งเป็นประโยชน์สำหรับสคริปต์ที่รวดเร็วหรือการผสานรวมกับระบบอื่น ๆ

  • การสนับสนุนการวางแนวของเอกสาร Word มีอะไรบ้าง?
    SDK รองรับโหมด Portrait และ Landscape ผ่าน enum Orientation คุณยังสามารถระบุช่วงหน้าที่ต้องการเปลี่ยนแปลงได้อย่างเลือกสรร

  • ฉันต้องการใบอนุญาตเพื่อใช้งานในสภาพแวดล้อมการผลิตหรือไม่?
    จำเป็นต้องมีใบอนุญาตที่ถูกต้องสำหรับการปรับใช้ในสภาพแวดล้อมการผลิต คุณสามารถเริ่มต้นด้วยใบอนุญาตชั่วคราวจาก หน้าลิขสิทธิ์ชั่วคราว และอัปเกรดเป็นใบอนุญาตเต็มเมื่อการใช้งานของคุณเพิ่มขึ้น.

Read More