Jako programista Node.js możesz łatwo programowo dodawać adnotacje do dowolnych dokumentów PDF w chmurze. Możesz dodawać obrazy, komentarze, notatki lub inne rodzaje zewnętrznych uwag do dokumentu jako adnotacje. W tym artykule dowiesz się, jak dodawać adnotacje do dokumentów PDF za pomocą REST API w Node.js.
W tym artykule zostaną omówione następujące tematy:
- Adnotacje w dokumentach REST API i Node.js SDK
- Dodawaj adnotacje do dokumentów PDF za pomocą interfejsu API REST w Node.js
- Dodaj adnotacje do obrazów za pomocą Node.js
Adnotacje w dokumentach REST API i Node.js SDK
Do opisywania dokumentów PDF będę używał Node.js SDK of GroupDocs.Annotation Cloud API. Umożliwia programowe tworzenie narzędzi do adnotacji w dokumentach online. Do obsługiwanych formatów dokumentów można dodawać adnotacje, nakładki ze znakami wodnymi, zamienniki tekstu, redakcje i znaczniki tekstu. Udostępnia również zestawy SDK .NET, Java, PHP, Ruby i Python jako członkowie rodziny adnotacji dokumentów dla Cloud API.
Możesz zainstalować GroupDocs.Annotation Cloud w swojej aplikacji Node.js za pomocą następującego polecenia w konsoli:
npm install groupdocs-annotation-cloud
Zanim zaczniesz postępować zgodnie z instrukcjami i dostępnymi przykładami kodu, uzyskaj swój identyfikator klienta i klucz tajny klienta z panelu nawigacyjnego. Po uzyskaniu identyfikatora i tajnego kodu dodaj kod, jak pokazano poniżej:
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";
Dodawaj adnotacje do dokumentów PDF za pomocą interfejsu API REST w Node.js
Możesz dodawać adnotacje do dokumentów PDF w chmurze, wykonując proste czynności podane poniżej:
- Prześlij plik PDF do chmury
- Dodaj adnotacje do dokumentu PDF za pomocą Node.js
- Pobierz plik z adnotacjami
Prześlij dokument
Najpierw prześlij plik PDF do chmury, korzystając z następującego przykładowego kodu:
// zainicjować api
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// Otwórz plik w IOStream z pliku local/disc.
var resourcesFolder = 'C:\\Files\\sample.pdf';
// przeczytaj plik
fs.readFile(resourcesFolder, (err, fileStream) => {
// utwórz prośbę o przesłanie pliku
var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", fileStream, myStorage);
// Przesyłanie pliku
fileApi.uploadFile(request)
});
W rezultacie przesłany plik PDF będzie dostępny w sekcji plików Twojego pulpitu nawigacyjnego w chmurze.
Adnotuj dokument PDF za pomocą Node.js
Możesz programowo dodać wiele adnotacji do dokumentu PDF, wykonując czynności wymienione poniżej:
- Utwórz instancję AnnotateApi
- Utwórz pierwszą instancję AnnotationInfo
- Ustaw właściwości adnotacji dla pierwszego wystąpienia, np. pozycja, typ, tekst itp.
- Utwórz drugie wystąpienie klasy AnnotationInfo
- Ustaw właściwości adnotacji dla drugiej instancji, np. pozycja, typ, tekst itp.
- Utwórz trzecie wystąpienie klasy AnnotationInfo
- Ustaw właściwości adnotacji dla trzeciego wystąpienia, np. pozycja, typ, tekst itp.
- Utwórz czwartą instancję AnnotationInfo
- Ustaw właściwości adnotacji dla czwartej instancji, np. pozycja, typ, tekst itp.
- Utwórz instancję FileInfo i ustaw ścieżkę pliku wejściowego
- Utwórz instancję AnnotateOptions
- Przypisz FileInfo i zdefiniowane instancje adnotacji do AnnotateOptions
- Ustaw ścieżkę pliku wyjściowego
- Utwórz żądanie, wywołując metodę AnnotateRequest z AnnotateOptions
- Uzyskaj wyniki, wywołując metodę AnnotateApi.annotate() z AnnotateRequest
Poniższy przykładowy kod pokazuje, jak dodawać adnotacje do dokumentu PDF z wieloma adnotacjami przy użyciu interfejsu API REST w Node.js.
// zainicjować api
let komentowaćApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);
// adnotacja odległości
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 adnotacja odległości";
a1.creatorName = "Anonym A.";
// adnotacja obszaru
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 adnotacja obszaru";
a2.creatorName = "Anonym A.";
// adnotacja pola tekstowego
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.";
// adnotacja elipsy
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 adnotacja elipsy";
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";
// utwórz żądanie adnotacji
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// komentować
let result = await komentowaćApi.komentować(request);
console.log("Multiple Annotations added: " + result.href);
Dodawaj adnotacje do dokumentów PDF za pomocą interfejsu API REST w Node.js
Możesz przeczytać więcej o obsługiwanych typach adnotacji w sekcji dodawanie adnotacji w dokumentacji.
Pobierz plik z adnotacjami
Powyższy przykładowy kod zapisze plik PDF z adnotacjami w chmurze. Możesz go pobrać, korzystając z następującego przykładowego kodu:
// skonstruuj FileApi
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// utwórz żądanie pobrania pliku
let request = new groupdocs_annotation_cloud.DownloadFileRequest("Output/output.pdf", myStorage);
// pobieranie pliku
let response = await fileApi.downloadFile(request);
// zapisz plik w katalogu roboczym
fs.writeFile("C:\\Files\\output.pdf", response, "binary", function (err) { });
console.log(response);
Dodaj adnotacje do obrazów za pomocą Node.js
Możesz programowo dodawać adnotacje do obrazów w dokumentach PDF, wykonując poniższe czynności:
- Utwórz instancję AnnotateApi
- Utwórz instancję AnnotationInfo
- Zdefiniuj prostokąt i ustaw jego położenie, wysokość i szerokość
- Ustaw właściwości adnotacji, np. pozycję, tekst, wysokość, szerokość itp.
- Ustaw typ adnotacji jako Obraz
- Utwórz instancję FileInfo i ustaw ścieżkę pliku wejściowego
- Utwórz instancję AnnotateOptions
- Przypisz FileInfo i adnotację do AnnotateOptions
- Ustaw ścieżkę pliku wyjściowego
- Utwórz żądanie, wywołując metodę AnnotateRequest z AnnotateOptions
- Uzyskaj wyniki, wywołując metodę AnnotateApi.annotate() z AnnotateRequest
Poniższy przykładowy kod pokazuje, jak dodawać adnotacje do obrazów w dokumencie PDF przy użyciu interfejsu API REST w Node.js. Wykonaj czynności wymienione wcześniej, aby przesłać i pobrać plik.
// zainicjować api
let komentowaćApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);
// adnotacja obrazu
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 adnotacja obrazu";
a1.creatorName = "Anonym A.";
a1.imagePath = "JohnSmith.png";
// ścieżka pliku wejściowego
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
// zdefiniuj opcje adnotacji
let options = new groupdocs_annotation_cloud.AnnotateOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "Output/output.pdf";
// utwórz żądanie adnotacji
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// komentować
let result = await komentowaćApi.komentować(request);
console.log("Image Annotation added: " + result.href);
Dodaj adnotacje do obrazów za pomocą Node.js
Wypróbuj online
Wypróbuj następujące bezpłatne narzędzie online do adnotacji PDF, które zostało opracowane przy użyciu powyższego interfejsu API. https://products.groupdocs.app/annotation/pdf
Wniosek
W tym artykule nauczyłeś się, jak dodawać wiele adnotacji do dokumentów PDF w chmurze. Nauczyłeś się również, jak programowo dodawać adnotacje graficzne do dokumentów PDF. Ponadto nauczyłeś się, jak programowo przesłać plik PDF do chmury, a następnie pobrać plik z adnotacjami z chmury. Możesz dowiedzieć się więcej o GroupDocs.Annotation Cloud API, korzystając z dokumentacji. Udostępniamy również sekcję Informacje o interfejsach API, która umożliwia wizualizację naszych interfejsów API i interakcję z nimi bezpośrednio w przeglądarce. W przypadku jakichkolwiek niejasności prosimy o kontakt na forum.