كيفية تدوير صفحات PDF باستخدام Rest API في Node.js

كيفية تدوير صفحات PDF باستخدام Rest API في Node.js

في هذه المقالة ، سوف نوضح السيناريوهات المتعلقة بالتناوب في ملفات PDF عند تحديد الدرجات. يمكنك تدوير جميع صفحات PDF دفعة واحدة أو صفحات PDF محددة في أي اتجاه بشكل دائم وفقًا لمتطلباتك. علاوة على ذلك ، يمكنك اختيار الزاوية لتدوير صفحات PDF مثل تدوير 90 درجة أو تدوير صفحات PDF 180 درجة. في هذه المقالة ، سوف نتعلم كيفية تدوير صفحات PDF باستخدام REST API في Node.js.

سيتم تناول الموضوعات التالية في هذه المقالة:

واجهة برمجة تطبيقات استدارة صفحات PDF و Node.js SDK

من أجل تدوير الصفحات من Adobe Adobe Acrobat PDF ، سأستخدم Node.js SDK من GroupDocs.Merger Cloud API. إنها مكتبة تنزيل مجانية لصفحات PDF عبر الإنترنت. يسمح لك بتقسيم ودمج واستخراج وإزالة وإعادة ترتيب صفحة واحدة أو مجموعة من الصفحات من تنسيقات المستندات المدعومة من Word و Excel و [PowerPoint] 7 و رسومات Visio و PDF و HTML.

يمكنك تثبيت سحابة GroupDocs.Merger لتدوير صفحات PDF في تطبيق Node.js الخاص بك باستخدام الأمر التالي في وحدة التحكم:

npm install groupdocs-conversion-cloud

يرجى الحصول على معرّف العميل وسر العميل من لوحة القيادة قبل البدء في اتباع الخطوات وأمثلة الكود المتاحة. بمجرد حصولك على المعرف والسر الخاص بك ، قم بإضافة الرمز كما هو موضح أدناه:

# قم باستيراد Node.js SDK في تطبيق العقدة من http://api.groupdocs.cloud
global.groupdocs_merger_cloud = require("groupdocs-merger-cloud");
global.fs = require("fs");

// احصل على clientId و clientSecret من https://dashboard.groupdocs.cloud (التسجيل المجاني مطلوب).
global.clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
global.clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
global.myStorage = "test-internal-storage";
const config = new groupdocs_merger_cloud.Configuration(clientId, clientSecret);
config.apiBaseUrl = "https://api.groupdocs.cloud";

قم بتدوير كل صفحات مستند PDF باستخدام Node.js

يمكنك تدوير صفحات PDF في مستند PDF برمجيًا على السحابة باتباع الخطوات الواردة أدناه. أولاً ، تحميل ملف PDF إلى السحابة وملف PDF الذي تم تحميله سيكون متاحًا في قسم الملفات من لوحة القيادة على السحابة. قد يكون هناك العديد من حالات الاستخدام التي تحتاج فيها إلى تدوير ملفات PDF. يمكنك تدوير جميع صفحات ملف PDF باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ PagesApi
  • بعد ذلك ، قم بإنشاء مثيل لـ RotateOptions
  • ثم قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار مستند إدخال PDF ومسار ملف الإخراج
  • بعد ذلك ، قم بتعيين تدوير الصفحة المطلوب مثل Rotate90
  • بعد ذلك ، قم بإنشاء RotateRequest باستخدام RotateOptions كوسيطة
  • أخيرًا ، قم باستدعاء طريقة rotate() واحفظ مستند PDF الناتج

يوضح مقتطف الشفرة التالي كيفية تدوير جميع صفحات ملف PDF باستخدام REST API في Node.js:

// كيفية تدوير كل صفحات مستند PDF باستخدام Node.js
const rotate = async() => {

  let documentApi = groupdocs_merger_cloud.PagesApi.fromKeys(clientId, clientSecret);

  // إنشاء خيارات تدوير PDF
  let options = new groupdocs_merger_cloud.RotateOptions();
  options.fileInfo = new groupdocs_merger_cloud.FileInfo();
  options.fileInfo.filePath = "nodejs-testing/sample-file.pdf";  
  options.outputPath = "nodejs-testing/rotated-sample-file.pdf";
  options.mode = merger_cloud.groupdocs_merger_cloud.ModeEnum.Rotate90;

  try {
    // إنشاء طلب مستند بتدوير PDF
    let rotateRequest = new groupdocs_merger_cloud.RotateRequest(options);
    let result = await pagesApi.rotate(rotateRequest);
  } 
  catch (err) {
    throw err;
  }
}

rotate()
.then(() => {
  console.log("Successfully rotated PDF document pages: ");
})
.catch((err) => {
  console.log("Error occurred while rotating PDF pages:", err);
})

أخيرًا ، سيحفظ نموذج الكود أعلاه ملف PDF المحدث على السحابة. يمكنك تحميل ملف التحميل باستخدام مقتطف الشفرة.

قم بتدوير صفحات معينة من ملف PDF باستخدام Node.js SDK

يتم تطبيق التدوير في مستند PDF على مستوى الصفحة. لذلك ، يمكنك أيضًا تدوير صفحات معينة من ملف PDF وفقًا لمتطلباتك. ما عليك سوى اختيار رقم الصفحة التي تريد تطبيق التدوير عليها. توضح الخطوات أدناه كيفية تدوير صفحات معينة من ملف PDF:

  • أولاً ، أنشئ مثيلاً لـ PagesApi
  • بعد ذلك ، قم بإنشاء مثيل لـ RotateOptions
  • ثم قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار مستند إدخال PDF ومسار ملف الإخراج
  • قم بتعيين أرقام الصفحات الدقيقة باستخدام مجموعة الصفحات
  • قم بتعيين تدوير الصفحة المطلوب مثل Rotate90 أو Rotate180 أو Rotate270
  • بعد ذلك ، قم بإنشاء RotateRequest باستخدام RotateOptions كوسيطة
  • أخيرًا ، قم باستدعاء طريقة rotate() واحفظ مستند PDF الناتج

يوضح مقتطف الشفرة التالي كيفية تدوير صفحات معينة أو معينة في مستند PDF باستخدام Node.js:

// كيفية تدوير صفحات معينة من ملف PDF باستخدام Node.js SDK

const rotate = async() => {

  let documentApi = groupdocs_merger_cloud.PagesApi.fromKeys(clientId, clientSecret);

  // إنشاء خيارات تدوير PDF
  let options = new groupdocs_merger_cloud.RotateOptions();
  options.fileInfo = new groupdocs_merger_cloud.FileInfo();
  options.fileInfo.filePath = "nodejs-testing/sample-file.pdf";  
  options.outputPath = "nodejs-testing/rotated-sample-file.pdf";
  options.pages = [2, 4];
  options.mode = merger_cloud.groupdocs_merger_cloud.ModeEnum.Rotate90;

  try {
    // إنشاء طلب مستند بتدوير PDF
    let rotateRequest = new groupdocs_merger_cloud.RotateRequest(options);
    let result = await pagesApi.rotate(rotateRequest);
  } 
  catch (err) {
    throw err;
  }
}

rotate()
.then(() => {
  console.log("Successfully rotated PDF document pages: ");
})
.catch((err) => {
  console.log("Error occurred while rotating PDF pages:", err);
})

أخيرًا ، سيحفظ نموذج الكود أعلاه ملف PDF الناتج على السحابة.

قم بتدوير صفحات PDF حسب رقم الصفحة باستخدام Node.js SDK

يمكنك أيضًا تدوير صفحات PDF حسب رقم الصفحة. تحتاج إلى توفير رقم صفحة البداية ورقم صفحة النهاية لتطبيق التدوير. توضح الخطوات أدناه كيفية تدوير صفحات PDF حسب أرقام الصفحات لملف PDF:

  • أولاً ، أنشئ مثيلاً لـ PagesApi
  • بعد ذلك ، قم بإنشاء مثيل لـ RotateOptions
  • ثم قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار مستند إدخال PDF ومسار ملف الإخراج
  • تعيين رقم صفحة البداية وقيم رقم صفحة النهاية ؛
  • قم بتعيين تدوير الصفحة المطلوب مثل Rotate270
  • بعد ذلك ، قم بإنشاء RotateRequest باستخدام RotateOptions كوسيطة
  • أخيرًا ، قم باستدعاء طريقة rotate() واحفظ مستند PDF الناتج

يوضح مقتطف الشفرة أدناه كيفية تدوير الصفحات في مستند PDF من خلال توفير أرقام الصفحات باستخدام Node.js Rest API:

// كيفية تدوير صفحات PDF حسب رقم الصفحة باستخدام Node.js SDK
const rotate = async() => {

  let documentApi = groupdocs_merger_cloud.PagesApi.fromKeys(clientId, clientSecret);

  // إنشاء خيارات تدوير PDF
  let options = new groupdocs_merger_cloud.RotateOptions();
  options.fileInfo = new groupdocs_merger_cloud.FileInfo();
  options.fileInfo.filePath = "nodejs-testing/sample-file.pdf";  
  options.outputPath = "nodejs-testing/rotated-sample-file.pdf";
  options.startPageNumber = 1;
  options.endPageNumber = 10;
  options.mode = merger_cloud.groupdocs_merger_cloud.ModeEnum.Rotate270;

  try {
    // إنشاء طلب مستند بتدوير PDF
    let rotateRequest = new groupdocs_merger_cloud.RotateRequest(options);
    let result = await pagesApi.rotate(rotateRequest);
  } 
  catch (err) {
    throw err;
  }
}

rotate()
.then(() => {
  console.log("Successfully rotated PDF document pages: ");
})
.catch((err) => {
  console.log("Error occurred while rotating PDF pages:", err);
})

سيحفظ مثال الرمز أعلاه مستند PDF الناتج على السحابة.

قم بتدوير صفحات PDF عبر الإنترنت مجانًا

يرجى تجربة أداة مجانية عبر الإنترنت لتدوير صفحات مستندات PDF ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه.

تلخيص لما سبق

لقد تعلمت في هذا المقال:

  • كيفية تدوير جميع صفحات مستند PDF عبر الإنترنت باستخدام Node.js ؛
  • تدوير صفحات معينة برمجيًا من ملف PDF باستخدام Node.js ؛
  • كيفية تدوير صفحات PDF حسب رقم الصفحة ووضع النطاق باستخدام Node.js ؛

بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول GroupDocs.Merge Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. علاوة على ذلك ، تقوم groupdocs.cloud بكتابة منشورات مدونة جديدة حول مواضيع أخرى مثيرة للاهتمام. لذلك ، يرجى البقاء على اتصال للحصول على تحديثات منتظمة.

طرح سؤال

إذا كانت لديك أي استفسارات حول تدوير صفحات PDF ، فلا تتردد في سؤالنا على منتدى الدعم المجاني

أنظر أيضا