Аннотации — это комментарии, всплывающие окна и различные другие графические объекты в документе, предоставляющие дополнительную информацию. Вы можете легко добавлять различные типы аннотаций к своим документам программно в облаке. Вы также можете извлечь или удалить все аннотации из документов с помощью Node.js. В этой статье вы узнаете, как извлекать или удалять аннотации из документов PDF с помощью REST API в Node.js.
В этой статье должны быть раскрыты следующие темы:
- REST API и Node.js SDK для аннотаций к документам
- Извлечение или удаление аннотаций из PDF-файлов с помощью REST API
REST API и Node.js SDK для аннотаций к документам
Я буду использовать API Node.js SDK GroupDocs.Annotation Cloud для извлечения или удаления аннотаций из документов PDF. Он позволяет создавать инструменты аннотирования документов в Node.js. Такие инструменты можно использовать для добавления, редактирования или удаления аннотаций, наложения водяных знаков, замены текста, редактирования, заметок и текстовых пометок во всех популярных форматах документов, таких как PDF, Word, Excel, PowerPoint, Outlook и форматы изображений. Он также предоставляет SDK для .NET, Java, PHP, Ruby и Python в качестве членов семейства аннотаций документов для Cloud API.
Вы можете установить GroupDocs.Annotation Cloud в свое приложение Node.js с помощью следующей команды в консоли:
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";
Извлечение или удаление аннотаций из PDF-файлов с помощью REST API в Node.js
Вы можете извлечь или удалить все аннотации из документов PDF, выполнив простые шаги, указанные ниже:
- Загрузить файл PDF в облако
- Извлечение аннотаций из файлов PDF в Node.js
- Удалить аннотации из файлов PDF в Node.js
- Скачать обновленный файл
Загрузить документ
Во-первых, загрузите файл PDF в облако, используя приведенный ниже пример кода:
// инициализация API
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// входной файл
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
- Создайте экземпляр FileInfo
- Установить путь к входному файлу
- Создайте запрос, вызвав метод ExtractRequest с объектом FileInfo.
- Получите результаты, вызвав метод AnnotateApi.extract() с объектом ExtractRequest.
В следующем фрагменте кода показано, как извлечь аннотации из документа PDF с помощью REST API в Node.js.
// инициализировать API
let annotateApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);
// входной файл
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
// создать запрос на извлечение
let request = new groupdocs_annotation_cloud.ExtractRequest(fileInfo);
// извлекать
let result = await annotateApi.извлекать(request);
// показать результаты
console.log("GetAnnotations: annotations count = " + result.length);
result.forEach(element => console.log("Annotation ID:" + element.id + " Element Text: " + element.text));
Извлечение аннотаций из файлов PDF в Node.js
Удалить аннотации из PDF-документов в Node.js
Вы можете программно удалить аннотации из PDF-документов, выполнив шаги, указанные ниже:
- Создайте экземпляр AnnotateApi
- Создайте экземпляр FileInfo
- Установить путь к входному файлу
- Создайте экземпляр RemoveOptions
- Установите для FileInfo значение RemoveOptions.
- Укажите идентификаторы аннотаций для удаления
- Установить путь к выходному файлу
- Создайте запрос, вызвав метод RemoveAnnotationsRequest с объектом RemoveOptions.
- Получите результаты, вызвав метод AnnotateApi.removeAnnotations().
В следующем примере кода показано, как удалить аннотации из документа PDF с помощью REST API в Node.js. Вы можете получить идентификаторы аннотаций, используя метод extract() с ExtractRequest, как описано ранее.
// инициализация API
let annotateApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);
// путь к входному файлу
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
// определить параметры удаления
let options = new groupdocs_annotation_cloud.RemoveOptions();
options.fileInfo = fileInfo;
options.annotationIds = [0, 1, 2, 3];
options.outputPath = "Output/output.pdf";
// создать запрос на удаление аннотации
let request = new groupdocs_annotation_cloud.RemoveAnnotationsRequest(options);
// Удалить аннотации
let result = await annotateApi.removeAnnotations(request);
console.log("DeleteAnnotations: annotations delete: " + result.href);
Удалить аннотации из PDF-документов в Node.js
Загрузите выходной файл
Приведенный выше пример кода сохранит выходной файл после удаления аннотаций в облаке. Вы можете загрузить его, используя следующий пример кода:
// построить 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);
Попробуйте онлайн
Попробуйте следующий бесплатный онлайн-инструмент для создания аннотаций PDF, разработанный с использованием указанного выше API. https://products.groupdocs.app/annotation/pdf
Заключение
В этой статье вы узнали, как извлекать или удалять аннотации из документов PDF в облаке с помощью Node.js. Вы также узнали, как программно загрузить файл PDF в облако, а затем загрузить обновленный файл из облака. Вы можете узнать больше о GroupDocs.Annotation Cloud API, используя документацию. Мы также предоставляем раздел Справочник по API, который позволяет визуализировать наши API и взаимодействовать с ними непосредственно через браузер. В случае возникновения каких-либо неясностей, пожалуйста, свяжитесь с нами на форуме.