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

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

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

Word Document Annotation REST API و Node.js SDK

برای حاشیه نویسی فایل های DOC یا DOCX، از Node.js SDK of GroupDocs.Annotation Cloud API استفاده خواهیم کرد. لطفا با استفاده از دستور زیر در کنسول آن را نصب کنید:

npm install groupdocs-annotation-cloud

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

global.clientId = "659fe7da-715b-4744-a0f7-cf469a392b73"; 
global.clientSecret = "b377c36cfa28fa69960ebac6b6e36421";
global.myStorage = "";

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

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

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

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

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

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

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

اضافه کردن حاشیه نویسی های متعدد به فایل های DOCX در Node.js

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

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

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

// API را راه اندازی کنید
let annotateApi = groupdocs_annotation_cloud.حاشیه نویسی کنیدApi.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 distance annotation";
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 area annotation";
a2.creatorName = "Anonym A.";

// حاشیه نویسی پیکان را تعریف کنید
let a3 = new groupdocs_annotation_cloud.AnnotationInfo();
a3.annotationPosition = new groupdocs_annotation_cloud.Point();
a3.annotationPosition.x = 1;
a3.annotationPosition.y = 1;
a3.box = new groupdocs_annotation_cloud.Rectangle();
a3.box.x = 100;
a3.box.y = 100;
a3.box.width = 200;
a3.box.height = 100;
a3.pageNumber = 0;
a3.penColor = 1201033;
a3.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a3.penWidth = 1;
a3.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Arrow;
a3.text = "This is arrow annotation";
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 ellipse annotation";
a4.creatorName = "Anonym A.";

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

// گزینه های حاشیه نویسی را تعریف کنید
let options = new groupdocs_annotation_cloud.حاشیه نویسی کنیدOptions();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "AddMultipleAnnotations.docx";

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

// حاشیه نویسی کنید
let result = await annotateApi.annotate(request);
اضافه کردن حاشیه نویسی های متعدد به فایل های DOCX در Node.js

اضافه کردن حاشیه نویسی های متعدد به فایل های DOCX در Node.js

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

نمونه کد بالا، سند ورد مشروح (DOCX) را در ابر ذخیره می کند. با استفاده از نمونه کد زیر قابل دانلود است:

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

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

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

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

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

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

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

// API را راه اندازی کنید
let annotateApi = groupdocs_annotation_cloud.حاشیه نویسی کنیدApi.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 = 320;
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 image annotation";
a1.creatorName = "Anonym A.";
a1.imagePath = "JohnSmith.png";

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

// گزینه های Annotation را تعریف کنید
let options = new groupdocs_annotation_cloud.حاشیه نویسی کنیدOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddImageAnnotation.docx";

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

// حاشیه نویسی کنید
let result = await annotateApi.annotate(request);
اضافه کردن حاشیه نویسی تصویر در اسناد Word با استفاده از REST API در Node.js

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

با استفاده از REST API در Node.js، حاشیه‌نویسی فیلد متنی را در اسناد Word اضافه کنید

با دنبال کردن مراحلی که قبلا ذکر شد، می‌توانیم حاشیه‌نویسی فیلد متنی را به صورت برنامه‌نویسی در اسناد Word اضافه کنیم. با این حال، باید نوع حاشیه نویسی را به عنوان TextField تنظیم کنیم.

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

// API را راه اندازی کنید
let annotateApi = groupdocs_annotation_cloud.حاشیه نویسی کنیدApi.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 = 310;
a1.box.width = 200;
a1.box.height = 50;
a1.pageNumber = 0;
a1.fontColor = 3093151;
a1.fontSize = 12;
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.TextField;
a1.text = "Text field text";
a1.creatorName = "Anonym A.";

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

// گزینه های Annotation را تعریف کنید
let options = new groupdocs_annotation_cloud.حاشیه نویسی کنیدOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddTextFieldAnnotation.docx";

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

// حاشیه نویسی کنید
let result = await annotateApi.annotate(request);
اضافه کردن حاشیه نویسی در اسناد Word با استفاده از REST API در Node.js

با استفاده از REST API در Node.js، حاشیه‌نویسی فیلد متنی را در اسناد Word اضافه کنید

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

می‌توانیم با دنبال کردن مراحلی که قبلاً ذکر شد، حاشیه‌نویسی واترمارک را به صورت برنامه‌نویسی در اسناد Word اضافه کنیم. با این حال، ما باید نوع حاشیه نویسی را به عنوان واترمارک تنظیم کنیم.

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

// API را راه اندازی کنید
let annotateApi = groupdocs_annotation_cloud.حاشیه نویسی کنیدApi.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 = 700;
a1.box.width = 500;
a1.box.height = 100;
a1.pageNumber = 0;
a1.penColor = 1201033;
a1.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a1.penWidth = 2;
a1.fontSize = 24;
a1.angle = 75;
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Watermark;
a1.text = "This is a watermark annotation";
a1.creatorName = "Anonym A.";

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

// گزینه های Annotation را تعریف کنید
let options = new groupdocs_annotation_cloud.حاشیه نویسی کنیدOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddWatermarkAnnotation.docx";

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

// حاشیه نویسی کنید
let result = await annotateApi.annotate(request);
حاشیه نویسی واترمارک در اسناد Word با استفاده از REST API در Node.js

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

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

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

نتیجه

در این مقاله نحوه اضافه کردن حاشیه نویسی به اسناد Word در فضای ابری را یاد گرفتیم. همچنین نحوه افزودن حاشیه‌نویسی فیلد تصویر و متن را به فایل DOCX با استفاده از REST API در Node.js دیده‌ایم. این مقاله همچنین نحوه آپلود برنامه‌نویسی یک فایل DOCX را در فضای ابری و سپس دانلود فایل ویرایش شده از Cloud توضیح داد. علاوه بر این، می توانید با استفاده از documentation درباره GroupDocs.Annotation Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [فروم 13 تماس بگیرید.

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