Dodawaj adnotacje w dokumentach programu Word przy użyciu interfejsu API REST w Node.js

Możemy łatwo programowo dodawać adnotacje do dokumentów Worda w chmurze. Do dokumentów możemy dodawać zdjęcia, komentarze, notatki lub inne rodzaje zewnętrznych uwag w formie adnotacji. W tym artykule dowiemy się, jak dodawać adnotacje w dokumentach Word za pomocą REST API w Node.js.

W tym artykule zostaną omówione następujące tematy:

Interfejs API REST adnotacji dokumentu programu Word i zestaw SDK Node.js

Do dodawania adnotacji do plików DOC lub DOCX będziemy używać interfejsu API Node.js SDK of GroupDocs.Annotation Cloud. Zainstaluj go za pomocą następującego polecenia w konsoli:

npm install groupdocs-annotation-cloud

Proszę uzyskaj swój identyfikator klienta i klucz tajny z pulpitu nawigacyjnego przed wykonaniem wspomnianych kroków. Po uzyskaniu identyfikatora i tajnego kodu dodaj kod, jak pokazano poniżej:

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

Dodawaj adnotacje do dokumentów programu Word przy użyciu interfejsu API REST w Node.js

Możemy dodawać adnotacje do plików DOCX, wykonując proste czynności wymienione poniżej:

Prześlij dokument

Najpierw prześlemy plik DOCX do chmury, korzystając z przykładowego kodu podanego poniżej:

// Zainicjuj interfejs API
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// Otwórz plik w IOStream z pliku local/disc.
var resourcesFolder = 'C:\\Files\\Annotation\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // Utwórz prośbę o przesłanie
  var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  // Przesyłanie pliku
  fileApi.uploadFile(request);
});

W rezultacie przesłany plik DOCX będzie dostępny w sekcji plików pulpitu nawigacyjnego w chmurze.

Dodaj wiele adnotacji do plików DOCX w Node.js

Możemy programowo dodać wiele adnotacji do dokumentów programu Word, wykonując czynności podane poniżej:

  • Najpierw utwórz instancję klasy AnnotateApi.
  • Następnie utwórz pierwsze wystąpienie elementu AnnotationInfo.
  • Następnie ustaw właściwości adnotacji dla pierwszej instancji, np. pozycja, typ, tekst itp.
  • Powtórz powyższe kroki, aby dodać wiele wystąpień elementu AnnotationInfo. Ustawimy różne typy adnotacji i inne właściwości dla każdej instancji, aby dodać wiele adnotacji.
  • Następnie utwórz instancję FileInfo i ustaw ścieżkę pliku wejściowego.
  • Następnie utwórz instancję klasy AnnotateOptions.
  • Teraz przypisz FileInfo i zdefiniowane instancje adnotacji do AnnotateOptions.
  • Ustaw także ścieżkę pliku wyjściowego.
  • Następnie wywołaj metodę AnnotateRequest z AnnotateOptions.
  • Na koniec uzyskaj wyniki, wywołując metodę AnnotateApi.annotate() z AnnotateRequest.

Poniższy przykładowy kod pokazuje, jak dodać wiele adnotacji do dokumentu programu Word przy użyciu interfejsu API REST w Node.js.

// Zainicjuj interfejs API
let annotateApi = groupdocs_annotation_cloud.KomentowaćApi.fromKeys(clientId, clientSecret);

// Zdefiniuj adnotację 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 distance annotation";
a1.creatorName = "Anonym A.";

// Zdefiniuj opis 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 area annotation";
a2.creatorName = "Anonym A.";

// Zdefiniuj adnotację Strzałka
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.";

// Zdefiniuj adnotację 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 ellipse annotation";
a4.creatorName = "Anonym A.";

// Wprowadź ścieżkę pliku
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Zdefiniuj opcje adnotacji
let options = new groupdocs_annotation_cloud.KomentowaćOptions();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "AddMultipleAnnotations.docx";

// Utwórz żądanie adnotacji
let request = new groupdocs_annotation_cloud.KomentowaćRequest(options);

// Komentować
let result = await annotateApi.annotate(request);
Dodaj wiele adnotacji do plików DOCX w Node.js

Dodaj wiele adnotacji do plików DOCX w Node.js

Pobierz plik z adnotacjami

Powyższy przykładowy kod zapisze dokument programu Word z adnotacjami (DOCX) w chmurze. Można 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("AddMultipleAnnotations.docx", myStorage);
// Pobieranie pliku
let response = await fileApi.downloadFile(request);

// Zapisz plik w katalogu roboczym
fs.writeFile("C:\\Files\\Annotation\\AddMultipleAnnotations.docx", response, "binary", function (err) { });

Dodaj adnotacje do obrazów w dokumentach programu Word za pomocą interfejsu API REST w Node.js

Możemy programowo dodawać adnotacje do obrazów w dokumentach Word, wykonując czynności podane poniżej:

  • Najpierw utwórz instancję klasy AnnotateApi.
  • Następnie utwórz wystąpienie klasy AnnotationInfo.
  • Następnie zdefiniuj prostokąt i ustaw jego położenie, wysokość i szerokość.
  • Następnie ustaw właściwości adnotacji, np. pozycję, tekst, wysokość, szerokość itp.
  • Następnie ustaw typ adnotacji jako Obraz.
  • Następnie utwórz instancję FileInfo i ustaw ścieżkę pliku wejściowego.
  • Następnie utwórz instancję klasy AnnotateOptions.
  • Teraz przypisz obiekt FileInfo i adnotację do AnnotateOptions.
  • Ustaw także ścieżkę pliku wyjściowego.
  • Następnie utwórz żądanie, wywołując metodę AnnotateRequest z obiektem AnnotateOptions jako argumentem.
  • Na koniec uzyskaj wyniki, wywołując metodę AnnotateApi.annotate() z obiektem AnnotateRequest.

Poniższy przykładowy kod pokazuje, jak dodać adnotację obrazu do dokumentu programu Word przy użyciu interfejsu API REST w Node.js. Wykonaj czynności wymienione wcześniej, aby przesłać i pobrać plik.

// Zainicjuj interfejs API
let annotateApi = groupdocs_annotation_cloud.KomentowaćApi.fromKeys(clientId, clientSecret);

// Zdefiniuj adnotację 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 = 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";

// Wprowadź ścieżkę pliku
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Zdefiniuj opcje adnotacji
let options = new groupdocs_annotation_cloud.KomentowaćOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddImageAnnotation.docx";

// Utwórz żądanie adnotacji
let request = new groupdocs_annotation_cloud.KomentowaćRequest(options);

// Komentować
let result = await annotateApi.annotate(request);
Dodaj adnotacje do obrazów w dokumentach programu Word za pomocą interfejsu API REST w Node.js

Dodaj adnotacje do obrazów w dokumentach programu Word za pomocą interfejsu API REST w Node.js

Dodaj adnotacje pól tekstowych w dokumentach programu Word za pomocą interfejsu API REST w Node.js

Możemy programowo dodawać adnotacje pól tekstowych w dokumentach Word, wykonując kroki wymienione wcześniej. Musimy jednak ustawić typ adnotacji jako TextField.

Poniższy przykładowy kod pokazuje, jak dodać adnotację pola tekstowego do dokumentu programu Word przy użyciu interfejsu API REST w Node.js. Wykonaj czynności wymienione wcześniej, aby przesłać i pobrać plik.

// Zainicjuj interfejs API
let annotateApi = groupdocs_annotation_cloud.KomentowaćApi.fromKeys(clientId, clientSecret);

// Zdefiniuj adnotację pola tekstowego
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.";

// Wprowadź ścieżkę pliku
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Zdefiniuj opcje adnotacji
let options = new groupdocs_annotation_cloud.KomentowaćOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddTextFieldAnnotation.docx";

// Utwórz żądanie adnotacji
let request = new groupdocs_annotation_cloud.KomentowaćRequest(options);

// Komentować
let result = await annotateApi.annotate(request);
Dodaj adnotacje w dokumentach programu Word za pomocą interfejsu API REST w Node.js

Dodaj adnotacje pól tekstowych w dokumentach programu Word za pomocą interfejsu API REST w Node.js

Adnotacje znaku wodnego w dokumentach programu Word przy użyciu interfejsu API REST w Node.js

Możemy programowo dodawać adnotacje znaku wodnego w dokumentach programu Word, wykonując czynności wymienione wcześniej. Musimy jednak ustawić typ adnotacji na Znak wodny.

Poniższy przykładowy kod pokazuje, jak dodać adnotację znaku wodnego do dokumentu programu Word przy użyciu interfejsu API REST w Node.js. Wykonaj czynności wymienione wcześniej, aby przesłać i pobrać plik.

// Zainicjuj interfejs API
let annotateApi = groupdocs_annotation_cloud.KomentowaćApi.fromKeys(clientId, clientSecret);

// Zdefiniuj adnotację znaku wodnego
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.";

// Wprowadź ścieżkę pliku
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Zdefiniuj opcje adnotacji
let options = new groupdocs_annotation_cloud.KomentowaćOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddWatermarkAnnotation.docx";

// Utwórz żądanie adnotacji
let request = new groupdocs_annotation_cloud.KomentowaćRequest(options);

// Komentować
let result = await annotateApi.annotate(request);
Adnotacje znaku wodnego w dokumentach Word przy użyciu interfejsu API REST w Node.js

Adnotacje znaku wodnego w dokumentach Word przy użyciu interfejsu API REST w Node.js

Wypróbuj online

Wypróbuj następujące bezpłatne narzędzie online do tworzenia adnotacji DOCX, które zostało opracowane przy użyciu powyższego interfejsu API. https://products.groupdocs.app/annotation/docx

Wniosek

W tym artykule nauczyliśmy się, jak dodawać adnotacje do dokumentów Worda w chmurze. Widzieliśmy również, jak dodawać adnotacje do obrazów i pól tekstowych do pliku DOCX za pomocą REST API w Node.js. W tym artykule wyjaśniono również, jak programowo przesłać plik DOCX do chmury, a następnie pobrać edytowany plik z chmury. Poza tym 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.

Zobacz też