با استفاده از REST API در Node.js، اسناد PDF را حاشیه نویسی کنید

به عنوان یک توسعه دهنده Node.js، می توانید به راحتی هر یک از اسناد PDF خود را به صورت برنامه نویسی در فضای ابری حاشیه نویسی کنید. می توانید تصاویر، نظرات، یادداشت ها یا انواع دیگر اظهارات خارجی را به عنوان حاشیه نویسی به سند اضافه کنید. در این مقاله، نحوه حاشیه نویسی اسناد PDF را با استفاده از REST API در Node.js خواهید آموخت.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

API REST Annotation Document و Node.js SDK

برای حاشیه نویسی اسناد PDF، از Node.js SDK of GroupDocs.Annotation Cloud API استفاده خواهم کرد. این به شما امکان می دهد ابزارهای حاشیه نویسی سند را بصورت آنلاین بسازید. می توانید حاشیه نویسی، همپوشانی واترمارک، جایگزینی متن، ویرایش و نشانه گذاری متن را به قالب های سند پشتیبانی شده اضافه کنید. همچنین دات نت، جاوا، پی اچ پی، روبی، و SDKهای پایتون را به عنوان [اعضای خانواده حاشیه نویسی سند3 برای Cloud API فراهم می کند.

می توانید با استفاده از دستور زیر در کنسول، GroupDocs.Annotation Cloud را در برنامه Node.js خود نصب کنید:

npm install groupdocs-annotation-cloud

لطفاً قبل از شروع به دنبال کردن مراحل و نمونه‌های کد موجود، شناسه مشتری و راز مشتری خود را از داشبورد دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:

global.clientId = "659fe7da-715b-4744-a0f7-cf469a392b73"; // Get ClientId and ClientSecret from https://dashboard.groupdocs.cloud
global.clientSecret = "b377c36cfa28fa69960ebac6b6e36421"; // Get ClientId and ClientSecret from https://dashboard.groupdocs.cloud
global.myStorage = "";

const configuration = new groupdocs_annotation_cloud.Configuration(clientId, clientSecret);
configuration.apiBaseUrl = "https://api.groupdocs.cloud";

با استفاده از REST API در Node.js، اسناد PDF را حاشیه نویسی کنید

با دنبال کردن مراحل ساده زیر می توانید اسناد PDF خود را در فضای ابری حاشیه نویسی کنید:

  1. آپلود فایل PDF در Cloud
  2. یادداشت سند PDF با استفاده از Node.js
  3. دانلود فایل مشروح

سند را آپلود کنید

ابتدا فایل PDF را با استفاده از نمونه کد زیر در Cloud آپلود کنید:

// api را مقداردهی اولیه کنید
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);

// فایل را در IOStream از محلی/دیسک باز کنید.
var resourcesFolder = 'C:\\Files\\sample.pdf';
// خواندن فایل
fs.readFile(resourcesFolder, (err, fileStream) => {
  // ایجاد درخواست آپلود فایل
  var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", fileStream, myStorage);
  // آپلود فایل
  fileApi.uploadFile(request)
});

در نتیجه، فایل PDF آپلود شده در بخش فایل ها داشبورد شما در فضای ابری در دسترس خواهد بود.

با استفاده از Node.js سند PDF را حاشیه نویسی کنید

می توانید با دنبال کردن مراحل ذکر شده در زیر، چندین حاشیه نویسی را به صورت برنامه ریزی شده به سند PDF اضافه کنید:

  • یک نمونه از AnnotateApi ایجاد کنید
  • اولین نمونه از AnnotationInfo را ایجاد کنید
  • ویژگی های حاشیه نویسی را برای نمونه اول تنظیم کنید مانند موقعیت، نوع، متن و غیره.
  • نمونه دوم AnnotationInfo را ایجاد کنید
  • ویژگی های حاشیه نویسی را برای نمونه دوم تنظیم کنید مانند موقعیت، نوع، متن و غیره.
  • نمونه سوم AnnotationInfo را ایجاد کنید
  • ویژگی های حاشیه نویسی را برای نمونه سوم تنظیم کنید مانند موقعیت، نوع، متن و غیره.
  • نمونه چهارم AnnotationInfo را ایجاد کنید
  • ویژگی های حاشیه نویسی را برای نمونه چهارم تنظیم کنید، مانند موقعیت، نوع، متن و غیره.
  • یک نمونه FileInfo ایجاد کنید و مسیر فایل ورودی را تنظیم کنید
  • یک نمونه از AnnotateOptions ایجاد کنید
  • FileInfo و نمونه های حاشیه نویسی تعریف شده را به AnnotateOptions اختصاص دهید
  • مسیر فایل خروجی را تنظیم کنید
  • با فراخوانی روش AnnotateRequest با AnnotateOptions یک درخواست ایجاد کنید
  • با فراخوانی متد AnnotateApi.annotate() با AnnotateRequest نتیجه بگیرید

نمونه کد زیر نحوه حاشیه نویسی یک سند PDF با چندین حاشیه نویسی را با استفاده از REST API در Node.js نشان می دهد.

// api را مقداردهی اولیه کنید
let حاشیه نویسی کنیدApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);

// حاشیه نویسی فاصله
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 100
a1.box.y = 100
a1.box.width = 200
a1.box.height = 100
a1.pageNumber = 0
a1.penColor = 1201033
a1.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a1.penWidth = 3
a1.opacity = 1
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Distance;
a1.text = "This is حاشیه نویسی فاصله";
a1.creatorName = "Anonym A.";

// حاشیه نویسی منطقه
let a2 = new groupdocs_annotation_cloud.AnnotationInfo();
a2.annotationPosition = new groupdocs_annotation_cloud.Point();
a2.annotationPosition.x = 1;
a2.annotationPosition.y = 1;
a2.box = new groupdocs_annotation_cloud.Rectangle();
a2.box.x = 80
a2.box.y = 400
a2.box.width = 200
a2.box.height = 100
a2.penColor = 1201033;
a2.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a2.pageNumber = 0;
a2.penWidth = 3;
a2.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Area;
a2.text = "This is حاشیه نویسی منطقه";
a2.creatorName = "Anonym A.";

// حاشیه نویسی فیلد متنی
let a3 = new groupdocs_annotation_cloud.AnnotationInfo();
a3.annotationPosition = new groupdocs_annotation_cloud.Point();
a3.annotationPosition.x = 100;
a3.annotationPosition.y = 100;
a3.box = new groupdocs_annotation_cloud.Rectangle();
a3.box.x = 450
a3.box.y = 150
a3.box.width = 100
a3.box.height = 30
a3.pageNumber = 0;
a3.fontColor = 65535;
a3.fontSize = 16;
a3.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.TextField;
a3.text = "Text field text";
a3.creatorName = "Anonym A.";

// حاشیه نویسی بیضی
let a4 = new groupdocs_annotation_cloud.AnnotationInfo();
a4.annotationPosition = new groupdocs_annotation_cloud.Point();
a4.annotationPosition.x = 1;
a4.annotationPosition.y = 1;
a4.box = new groupdocs_annotation_cloud.Rectangle();
a4.box.x = 350;
a4.box.y = 350;
a4.box.width = 200;
a4.box.height = 100;
a4.pageNumber = 0;
a4.penColor = 1201033;
a4.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a4.penWidth = 4;
a4.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Ellipse;
a4.text = "This is حاشیه نویسی بیضی";
a4.creatorName = "Anonym A.";

let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
let options = new groupdocs_annotation_cloud.AnnotateOptions();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "Output/output.pdf";

// ایجاد درخواست حاشیه نویسی
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// حاشیه نویسی کنید
let result = await حاشیه نویسی کنیدApi.حاشیه نویسی کنید(request);

console.log("Multiple Annotations added: " + result.href);
با استفاده از REST API در Node.js، اسناد PDF را حاشیه نویسی کنید

با استفاده از REST API در Node.js، اسناد PDF را حاشیه نویسی کنید

می توانید در مورد انواع حاشیه نویسی پشتیبانی شده در بخش افزودن حاشیه نویسی در مستندات بیشتر بخوانید.

فایل حاشیه نویسی را دانلود کنید

نمونه کد بالا فایل پی‌دی‌اف مشروح‌شده را در فضای ابری ذخیره می‌کند. با استفاده از نمونه کد زیر می توانید آن را دانلود کنید:

// FileApi را بسازید
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);

// ایجاد درخواست دانلود فایل
let request = new groupdocs_annotation_cloud.DownloadFileRequest("Output/output.pdf", myStorage);
// دریافت فایل
let response = await fileApi.downloadFile(request);

// ذخیره فایل در پوشه کاری
fs.writeFile("C:\\Files\\output.pdf", response, "binary", function (err) { });
console.log(response);

اضافه کردن حاشیه نویسی تصویر با استفاده از Node.js

با دنبال کردن مراحل زیر می توانید حاشیه نویسی تصویر را به صورت برنامه ریزی شده در اسناد PDF خود اضافه کنید:

  • یک نمونه از AnnotateApi ایجاد کنید
  • یک نمونه از AnnotationInfo ایجاد کنید
  • یک مستطیل را تعریف کنید و موقعیت، ارتفاع و عرض آن را تنظیم کنید
  • ویژگی های حاشیه نویسی را تنظیم کنید مانند موقعیت، متن، ارتفاع، عرض و غیره.
  • نوع حاشیه نویسی را به عنوان Image تنظیم کنید
  • یک نمونه FileInfo ایجاد کنید و مسیر فایل ورودی را تنظیم کنید
  • یک نمونه از AnnotateOptions ایجاد کنید
  • FileInfo و حاشیه نویسی را به AnnotateOptions اختصاص دهید
  • مسیر فایل خروجی را تنظیم کنید
  • با فراخوانی روش AnnotateRequest با AnnotateOptions یک درخواست ایجاد کنید
  • با فراخوانی متد AnnotateApi.annotate() با AnnotateRequest نتیجه بگیرید

نمونه کد زیر نحوه اضافه کردن حاشیه نویسی تصویر را در سند PDF با استفاده از REST API در Node.js نشان می دهد. لطفاً برای آپلود و دانلود یک فایل مراحل ذکر شده را دنبال کنید.

// api را مقداردهی اولیه کنید
let حاشیه نویسی کنیدApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);

// حاشیه نویسی تصویر
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 300;
a1.box.y = 160;
a1.box.width = 200;
a1.box.height = 40;
a1.pageNumber = 0;
a1.penColor = 1201033;
a1.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a1.penWidth = 1;
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Image;
a1.text = "This is حاشیه نویسی تصویر";
a1.creatorName = "Anonym A.";
a1.imagePath = "JohnSmith.png";

// مسیر فایل ورودی
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";

// تعریف گزینه های حاشیه نویسی
let options = new groupdocs_annotation_cloud.AnnotateOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "Output/output.pdf";

// ایجاد درخواست حاشیه نویسی
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// حاشیه نویسی کنید
let result = await حاشیه نویسی کنیدApi.حاشیه نویسی کنید(request);

console.log("Image Annotation added: " + result.href);
اضافه کردن حاشیه نویسی تصویر با استفاده از Node.js

اضافه کردن حاشیه نویسی تصویر با استفاده از Node.js

آنلاین را امتحان کنید

لطفاً ابزار حاشیه نویسی PDF آنلاین رایگان زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/annotation/pdf

نتیجه

در این مقاله، نحوه افزودن چندین حاشیه به اسناد PDF در فضای ابری را یاد گرفتید. همچنین یاد گرفته‌اید که چگونه به صورت برنامه‌ریزی، حاشیه‌نویسی تصویر را به اسناد PDF اضافه کنید. علاوه بر این، شما یاد گرفته اید که چگونه به صورت برنامه ریزی شده یک فایل PDF را در فضای ابری آپلود کنید و سپس فایل حاشیه نویسی را از ابر دانلود کنید. می‌توانید با استفاده از مستندات درباره GroupDocs.Annotation Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد API‌های ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس حاصل فرمایید14.

همچنین ببینید