أضف التعليقات التوضيحية في مستندات Word باستخدام واجهة برمجة تطبيقات REST في Node.js

يمكننا بسهولة إضافة تعليقات توضيحية إلى مستندات Word برمجيًا على السحابة. يمكننا إضافة صور أو تعليقات أو ملاحظات أو أنواع أخرى من الملاحظات الخارجية إلى المستندات كتعليقات توضيحية. في هذه المقالة ، سوف نتعلم كيفية إضافة التعليقات التوضيحية في مستندات Word باستخدام واجهة برمجة تطبيقات REST في Node.js.

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

شرح مستند Word REST API و Node.js SDK

للتعليق على ملفات DOC أو DOCX ، سنستخدم Node.js SDK من GroupDocs.Annotation Cloud API. الرجاء تثبيته باستخدام الأمر التالي في وحدة التحكم:

npm install groupdocs-annotation-cloud

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

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

علق مستندات Word باستخدام REST API في Node.js

يمكننا إضافة تعليقات توضيحية إلى ملفات DOCX باتباع الخطوات البسيطة المذكورة أدناه:

قم بتحميل المستند

أولاً ، سنقوم بتحميل ملف DOCX إلى السحابة باستخدام مثال الرمز الموضح أدناه:

// تهيئة 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.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليقات توضيحية متعددة إلى مستند Word باستخدام واجهة برمجة تطبيقات REST في 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 = 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

قم بتنزيل الملف المشروح

سيحفظ نموذج الكود أعلاه مستند Word المشروح (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 في Node.js

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

  • أولاً ، قم بإنشاء مثيل لـ AnnotateApi.
  • بعد ذلك ، قم بإنشاء مثيل AnnotationInfo.
  • بعد ذلك ، حدد مستطيلًا واضبط موضعه وارتفاعه وعرضه.
  • بعد ذلك ، قم بتعيين خصائص التعليق التوضيحي ، على سبيل المثال ، الموضع ، والنص ، والارتفاع ، والعرض ، وما إلى ذلك.
  • ثم قم بتعيين نوع التعليق التوضيحي كصورة.
  • بعد ذلك ، قم بإنشاء مثيل FileInfo وقم بتعيين مسار ملف الإدخال.
  • ثم قم بإنشاء مثيل AnnotateOptions.
  • الآن ، قم بتعيين كائن FileInfo والتعليق التوضيحي إلى AnnotateOptions.
  • أيضا ، قم بتعيين مسار ملف الإخراج.
  • بعد ذلك ، أنشئ طلبًا عن طريق استدعاء أسلوب AnnotateRequest باستخدام كائن AnnotateOptions كوسيطة.
  • أخيرًا ، احصل على النتائج عن طريق استدعاء الأسلوب AnnotateApi.annotate() باستخدام كائن AnnotateRequest.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي لصورة إلى مستند Word باستخدام واجهة برمجة تطبيقات REST في 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";

// تحديد خيارات التعليق التوضيحي
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 في Node.js

أضف تعليقات توضيحية للصور في مستندات Word باستخدام واجهة برمجة تطبيقات REST في Node.js

أضف التعليقات التوضيحية لحقل النص في مستندات Word باستخدام REST API في Node.js

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

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي لحقل نصي إلى مستند Word باستخدام واجهة برمجة تطبيقات REST في 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";

// تحديد خيارات التعليق التوضيحي
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

أضف التعليقات التوضيحية لحقل النص في مستندات Word باستخدام REST API في Node.js

التعليقات التوضيحية للعلامة المائية في مستندات Word باستخدام واجهة برمجة تطبيقات REST في Node.js

يمكننا إضافة التعليقات التوضيحية للعلامة المائية في مستندات Word برمجيًا باتباع الخطوات المذكورة سابقًا. ومع ذلك ، نحتاج إلى تعيين نوع التعليق التوضيحي كعلامة مائية.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي للعلامة المائية إلى مستند Word باستخدام واجهة برمجة تطبيقات REST في 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";

// تحديد خيارات التعليق التوضيحي
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 في Node.js

التعليقات التوضيحية للعلامة المائية في مستندات Word باستخدام واجهة برمجة تطبيقات REST في Node.js

جرب عبر الإنترنت

يرجى تجربة أداة التعليق التوضيحي DOCX المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/annotation/docx

خاتمة

في هذه المقالة ، تعلمنا كيفية إضافة التعليقات التوضيحية إلى مستندات Word على السحابة. لقد رأينا أيضًا كيفية إضافة التعليقات التوضيحية للصور والحقول النصية إلى ملف DOCX باستخدام واجهة برمجة تطبيقات REST في Node.js. توضح هذه المقالة أيضًا كيفية تحميل ملف DOCX برمجيًا إلى السحابة ثم تنزيل الملف المحرر من السحابة. بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول GroupDocs.Annotation Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا