Додайте анотації в документи Word за допомогою REST API у Node.js

Ми можемо легко коментувати документи Word програмно в хмарі. Ми можемо додавати зображення, коментарі, примітки чи інші типи зовнішніх зауважень до документів як анотації. У цій статті ми дізнаємося, як додавати анотації в документи Word за допомогою REST API у Node.js.

У цій статті будуть розглянуті такі теми:

REST API для анотації документа Word і SDK Node.js

Для анотування файлів DOC або DOCX ми будемо використовувати API Node.js SDK GroupDocs.Annotation Cloud. Встановіть його за допомогою такої команди в консолі:

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

// Визначте анотацію Ellipse
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 API у Node.js

Ми можемо програмно додавати анотації до зображень у документи Word, виконавши наведені нижче дії.

  • По-перше, створіть екземпляр AnnotateApi.
  • Далі створіть екземпляр AnnotationInfo.
  • Потім визначте прямокутник і встановіть його положення, висоту та ширину.
  • Після цього встановіть властивості анотації, наприклад положення, текст, висоту, ширину тощо.
  • Потім встановіть тип анотації як Зображення.
  • Далі створіть екземпляр 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";

// Визначте параметри анотації
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

Додайте анотації текстових полів у документи Word за допомогою REST API у Node.js

Ми можемо додавати анотації текстових полів у документи 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";

// Визначте параметри анотації
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 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";

// Визначте параметри анотації
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 у хмару, а потім завантажити відредагований файл із хмари. Крім того, ви можете дізнатися більше про GroupDocs.Annotation Cloud API за допомогою документації. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-яких неясностей зв’яжіться з нами на форумі.

Дивись також