Як розробник Node.js ви можете легко коментувати будь-які свої PDF-документи програмним шляхом у хмарі. Ви можете додавати зображення, коментарі, примітки чи інші типи зовнішніх приміток до документа як анотації. У цій статті ви дізнаєтеся, як анотувати PDF-документи за допомогою REST API у Node.js.
У цій статті будуть розглянуті такі теми:
- REST API анотації документа та пакет SDK Node.js
- Анотуйте PDF-документи за допомогою REST API у Node.js
- Додайте анотації до зображень за допомогою Node.js
REST API анотації документа та пакет SDK Node.js
Для анотування документів PDF я буду використовувати API Node.js SDK GroupDocs.Annotation Cloud. Це дозволяє вам програмно створювати інструменти анотації документа в Інтернеті. Ви можете додавати анотації, накладення водяних знаків, заміни тексту, редагування та текстові розмітки до підтримуваних форматів документів. Він також надає .NET, Java, PHP, Ruby та Python SDK як члени сімейства анотацій документів для 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";
Анотуйте PDF-документи за допомогою REST API у Node.js
Ви можете коментувати свої PDF-документи в хмарі, виконавши прості дії, наведені нижче:
- Завантажте файл PDF у хмару
- Додайте коментарі до документа PDF за допомогою Node.js
- Завантажити анотований файл
Завантажте документ
По-перше, завантажте PDF-файл у хмару, використовуючи такий зразок коду:
// ініціалізувати 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-файл буде доступний у розділі файлів вашої інформаційної панелі в хмарі.
Додайте коментарі до документа PDF за допомогою Node.js
Ви можете програмно додати кілька анотацій до 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);
Анотуйте 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
- Визначте прямокутник і встановіть його положення, висоту та ширину
- Встановіть властивості анотації, наприклад положення, текст, висоту, ширину тощо.
- Встановіть тип анотації як Зображення
- Створіть екземпляр 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
Спробуйте онлайн
Будь ласка, спробуйте наведений нижче безкоштовний онлайн-інструмент анотування PDF-файлів, розроблений за допомогою вищезазначеного API. https://products.groupdocs.app/annotation/pdf
Висновок
У цій статті ви дізналися, як додати кілька анотацій до документів PDF у хмарі. Ви також дізналися, як програмно додавати анотації до зображень у PDF-документи. Крім того, ви навчилися програмно завантажувати PDF-файл у хмару, а потім завантажувати анотований файл із хмари. Ви можете дізнатися більше про GroupDocs.Annotation Cloud API за допомогою документації. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-якої неясності зв’яжіться з нами на форумі.