تبدیل طرح‌بندی یک سند Word یک نیاز مکرر هنگام تولید گزارش‌ها، قراردادها یا بروشورهای چاپی است. GroupDocs.Merger Cloud SDK for Node.js به توسعه‌دهندگان امکان می‌دهد به‌صورت برنامه‌نویسی تبدیل جهت صفحه Word در Node.JS تنها با چند خط کد. این راهنما شما را از مراحل مورد نیاز عبور می‌دهد، یک مثال کامل کاری را نشان می‌دهد، تماس‌های معادل cURL را نمایش می‌دهد و نصب و پیکربندی را توضیح می‌دهد تا بتوانید تغییرات جهت‌گیری صفحه را در برنامه‌های Node.js خود ادغام کنید.

مراحل تبدیل جهت صفحه Word در Node.JS

  1. نصب SDK و پیکربندی اعتبارها: از npm برای افزودن کتابخانه و تنظیم شناسه مشتری و رمز عبور استفاده کنید.

    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);
    });
  1. (اختیاری) تنظیمات اضافی را تنظیم کنید: می‌توانید آرایه 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 سرویس 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

برای جزئیات بیشتر در مورد بارهای درخواست و پارامترهای پشتیبانی‌شده، به مستندات رسمی API مراجعه کنید.

نصب و پیکربندی GroupDocs.Merger Cloud SDK for 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 تبدیل کنید، پردازش دسته‌ای را خودکار کنید و تغییرات جهت را در هر جریان کاری سندی یکپارچه کنید. به یاد داشته باشید برای استفاده در محیط تولید یک لایسنس مناسب تهیه کنید؛ جزئیات قیمت‌گذاری در صفحه محصول موجود است و می‌توانید یک لایسنس موقت از صفحه لایسنس موقت دریافت کنید. با نصب و پیکربندی SDK، آماده‌اید تا برنامه‌های خود را با قابلیت‌های انعطاف‌پذیر دستکاری اسناد ارتقا دهید.

سوالات متداول

  • چگونه می‌توانم جهت صفحه را در اسناد 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 پشتیبانی می‌کند. همچنین می‌توانید بازه‌های صفحه را برای اعمال تغییر به‌صورت انتخابی مشخص کنید.

  • آیا برای اجرای این در محیط تولید به مجوز نیاز دارم؟
    یک مجوز معتبر برای استقرارهای تولیدی لازم است. می‌توانید با یک مجوز موقت از صفحه مجوز موقت شروع کنید و با افزایش استفاده، به یک مجوز کامل ارتقا دهید.

بیشتر بخوانید