تحويل اتجاه صفحة Word في Node.JS

تحويل تخطيط مستند Word هو حاجة متكررة عند إنشاء التقارير أو العقود أو الكتيبات القابلة للطباعة. GroupDocs.Merger Cloud SDK for Node.js يتيح للمطورين برمجياً تحويل توجيه صفحة Word في Node.JS باستخدام بضع أسطر من الشيفرة. يشرح هذا الدليل الخطوات المطلوبة، ويعرض مثالاً عملياً كاملاً، ويظهر مكالمات cURL المكافئة، ويشرح عملية التثبيت والتكوين حتى تتمكن من دمج تغييرات توجيه الصفحات في تطبيقات Node.js الخاصة بك.

خطوات تحويل اتجاه صفحة Word في Node.JS

تثبيت SDK وتكوين بيانات الاعتماد: استخدم npm لإضافة المكتبة وإعداد معرف العميل والسر.
```
npm install groupdocs-merger-cloud
```
إنشاء نسخة 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);

إنشاء خيارات الطلب: تحديد ملف المصدر، نطاق الصفحات، الاتجاه المطلوب، ومسار الإخراج.

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

تنفيذ تغيير الاتجاه: أرسل الطلب وتعامل مع الاستجابة.

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

(اختياري) تعديل الإعدادات الإضافية: يمكنك تعديل مصفوفة pages لاستهداف صفحات محددة أو تغيير تعداد 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 ضد GroupDocs.Merger Cloud REST endpoints.

الحصول على رمز وصول

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.

رفع ملف 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"

طلب تغيير الاتجاه

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"
         }'

تنزيل الملف الناتج

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، أنت جاهز لتعزيز تطبيقاتك بقدرات مرنة لمعالجة المستندات.

FAQs

كيف يمكنني تغيير اتجاه الصفحة في مستندات Word باستخدام Node.js؟
استخدم ChangePageOrientationApi من GroupDocs.Merger Cloud SDK for Node.js، حدد orientation المطلوبة في خيارات الطلب، ونفّذ استدعاء API.
هل هناك طريقة لتصدير اتجاه صفحة Word في Node.JS دون كتابة كود؟
نعم، يمكن تنفيذ العملية نفسها عبر واجهة برمجة التطبيقات REST باستخدام أوامر cURL، وهو ما يكون مفيدًا للسكريبتات السريعة أو التكامل مع الأنظمة الأخرى.
ما الاتجاهات المدعومة لمستندات Word؟
يدعم SDK كلًا من وضعية Portrait و Landscape من خلال تعداد Orientation. يمكنك أيضًا تحديد نطاقات الصفحات لتطبيق التغيير بشكل انتقائي.
هل أحتاج إلى ترخيص لتشغيل هذا في بيئة الإنتاج؟
الترخيص الصالح مطلوب للنشر في بيئة الإنتاج. يمكنك البدء بترخيص مؤقت من صفحة الترخيص المؤقت وترقية إلى ترخيص كامل مع زيادة استخدامك.

خطوات تحويل اتجاه صفحة Word في Node.JS#

تغيير اتجاه صفحة Word - مثال كامل على الكود#

تغيير اتجاه الصفحة عبر REST API باستخدام cURL#

تثبيت وتكوين GroupDocs.Merger Cloud SDK for Node.js#

تكوين خيارات اتجاه الصفحة#

الخلاصة#

FAQs#

Read More#