Fügen Sie Anmerkungen in Word Dokumenten mithilfe einer REST-API in Node.js hinzu

Wir können Word Dokumente problemlos programmgesteuert in der Cloud mit Anmerkungen versehen. Wir können den Dokumenten Bilder, Kommentare, Notizen oder andere Arten von externen Anmerkungen als Anmerkungen hinzufügen. In diesem Artikel erfahren Sie, wie Sie mithilfe einer REST-API in Node.js Anmerkungen in Word Dokumenten hinzufügen.

Die folgenden Themen sollen in diesem Artikel behandelt werden:

Word Document Annotation REST API und Node.js SDK

Zum Kommentieren von DOC oder DOCX Dateien verwenden wir die Node.js SDK der GroupDocs.Annotation Cloud API. Bitte installieren Sie es mit dem folgenden Befehl in der Konsole:

npm install groupdocs-annotation-cloud

Bitte holen Sie sich Ihre Kunden-ID und Ihr Geheimnis aus dem Dashboard, bevor Sie die genannten Schritte ausführen. Sobald Sie Ihre ID und Ihr Geheimnis haben, fügen Sie den Code wie unten gezeigt ein:

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

Kommentieren Sie Word Dokumente mithilfe der REST-API in Node.js

Wir können den DOCX Dateien Anmerkungen hinzufügen, indem wir die folgenden einfachen Schritte ausführen:

Laden Sie das Dokument hoch

Zunächst laden wir die DOCX-Datei mithilfe des unten angegebenen Codebeispiels in die Cloud hoch:

// API initialisieren
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// Öffnen Sie die Datei in IOStream von lokal/disc.
var resourcesFolder = 'C:\\Files\\Annotation\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // Upload-Anfrage erstellen
  var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  // Datei hochladen
  fileApi.uploadFile(request);
});

Dadurch ist die hochgeladene DOCX-Datei im Dateienbereich des Dashboards in der Cloud verfügbar.

Fügen Sie DOCX Dateien in Node.js mehrere Anmerkungen hinzu

Wir können den Word Dokumenten programmgesteuert mehrere Anmerkungen hinzufügen, indem wir die folgenden Schritte ausführen:

  • Erstellen Sie zunächst eine Instanz der AnnotateApi.
  • Erstellen Sie als Nächstes die erste Instanz von AnnotationInfo.
  • Legen Sie dann die Anmerkungseigenschaften für die erste Instanz fest, z. B. Position, Typ, Text usw.
  • Wiederholen Sie die obigen Schritte, um mehrere Instanzen von AnnotationInfo hinzuzufügen. Wir werden für jede Instanz unterschiedliche Anmerkungstypen und andere Eigenschaften festlegen, um mehrere Anmerkungen hinzuzufügen.
  • Erstellen Sie als Nächstes eine Instanz von FileInfo und legen Sie den Eingabedateipfad fest.
  • Erstellen Sie dann eine Instanz von AnnotateOptions.
  • Weisen Sie nun die FileInfo und definierten Annotationsinstanzen den AnnotateOptions zu.
  • Legen Sie außerdem den Pfad der Ausgabedatei fest.
  • Rufen Sie anschließend die AnnotateRequest-Methode mit AnnotateOptions auf.
  • Abschließend erhalten Sie Ergebnisse, indem Sie die Methode AnnotateApi.annotate() mit AnnotateRequest aufrufen.

Das folgende Codebeispiel zeigt, wie Sie mithilfe einer REST-API in Node.js mehrere Anmerkungen zu einem Word Dokument hinzufügen.

// API initialisieren
let annotateApi = groupdocs_annotation_cloud.KommentierenApi.fromKeys(clientId, clientSecret);

// Abstandsanmerkung definieren
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.";

// Bereichsanmerkung definieren
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.";

// Definieren Sie die Pfeilanmerkung
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.";

// Definieren Sie die Ellipsenanmerkung
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.";

// Pfad der Eingabedatei
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Definieren Sie Anmerkungsoptionen
let options = new groupdocs_annotation_cloud.KommentierenOptions();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "AddMultipleAnnotations.docx";

// Kommentierungsanfrage erstellen
let request = new groupdocs_annotation_cloud.KommentierenRequest(options);

// Kommentieren
let result = await annotateApi.annotate(request);
Fügen Sie DOCX Dateien in Node.js mehrere Anmerkungen hinzu

Fügen Sie DOCX Dateien in Node.js mehrere Anmerkungen hinzu

Laden Sie die kommentierte Datei herunter

Das obige Codebeispiel speichert das mit Anmerkungen versehene Word Dokument (DOCX) in der Cloud. Es kann mit dem folgenden Codebeispiel heruntergeladen werden:

// Konstruieren Sie FileApi
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);

// Erstellen Sie eine Download-Dateianfrage
let request = new groupdocs_annotation_cloud.DownloadFileRequest("AddMultipleAnnotations.docx", myStorage);
// Download-Datei
let response = await fileApi.downloadFile(request);

// Datei im Arbeitsverzeichnis speichern
fs.writeFile("C:\\Files\\Annotation\\AddMultipleAnnotations.docx", response, "binary", function (err) { });

Fügen Sie Bildanmerkungen in Word Dokumenten mithilfe der REST-API in Node.js hinzu

Wir können Bildanmerkungen in Word Dokumenten programmgesteuert hinzufügen, indem wir die folgenden Schritte ausführen:

  • Erstellen Sie zunächst eine Instanz der AnnotateApi.
  • Erstellen Sie als Nächstes eine Instanz der AnnotationInfo.
  • Definieren Sie dann ein Rechteck und legen Sie dessen Position, Höhe und Breite fest.
  • Anschließend legen Sie die Anmerkungseigenschaften fest, z. B. Position, Text, Höhe, Breite usw.
  • Legen Sie dann den Anmerkungstyp auf „Bild“ fest.
  • Erstellen Sie als Nächstes eine Instanz von FileInfo und legen Sie den Eingabedateipfad fest.
  • Erstellen Sie dann eine Instanz von AnnotateOptions.
  • Weisen Sie nun das FileInfo Objekt und die Annotation den AnnotateOptions zu.
  • Legen Sie außerdem den Pfad der Ausgabedatei fest.
  • Erstellen Sie anschließend eine Anfrage, indem Sie die AnnotateRequest-Methode mit dem AnnotateOptions Objekt als Argument aufrufen.
  • Abschließend erhalten Sie Ergebnisse, indem Sie die Methode AnnotateApi.annotate() mit dem AnnotateRequest Objekt aufrufen.

Das folgende Codebeispiel zeigt, wie Sie mithilfe einer REST-API in Node.js eine Bildanmerkung zu einem Word Dokument hinzufügen. Bitte befolgen Sie die zuvor genannten Schritte, um eine Datei hoch und herunterzuladen.

// API initialisieren
let annotateApi = groupdocs_annotation_cloud.KommentierenApi.fromKeys(clientId, clientSecret);

// Bildanmerkung definieren
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";

// Pfad der Eingabedatei
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Anmerkungsoptionen definieren
let options = new groupdocs_annotation_cloud.KommentierenOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddImageAnnotation.docx";

// Kommentierungsanfrage erstellen
let request = new groupdocs_annotation_cloud.KommentierenRequest(options);

// Kommentieren
let result = await annotateApi.annotate(request);
Fügen Sie Bildanmerkungen in Word Dokumenten mithilfe der REST-API in Node.js hinzu

Fügen Sie Bildanmerkungen in Word Dokumenten mithilfe der REST-API in Node.js hinzu

Fügen Sie Textfeldanmerkungen in Word Dokumenten mithilfe der REST-API in Node.js hinzu

Wir können Textfeldanmerkungen in Word Dokumenten programmgesteuert hinzufügen, indem wir die zuvor genannten Schritte ausführen. Allerdings müssen wir den Anmerkungstyp auf TextField festlegen.

Das folgende Codebeispiel zeigt, wie Sie mithilfe einer REST-API in Node.js eine Textfeldanmerkung zu einem Word Dokument hinzufügen. Bitte befolgen Sie die zuvor genannten Schritte, um eine Datei hoch und herunterzuladen.

// API initialisieren
let annotateApi = groupdocs_annotation_cloud.KommentierenApi.fromKeys(clientId, clientSecret);

// Definieren Sie Textfeldanmerkungen
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.";

// Pfad der Eingabedatei
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Anmerkungsoptionen definieren
let options = new groupdocs_annotation_cloud.KommentierenOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddTextFieldAnnotation.docx";

// Kommentierungsanfrage erstellen
let request = new groupdocs_annotation_cloud.KommentierenRequest(options);

// Kommentieren
let result = await annotateApi.annotate(request);
Fügen Sie Anmerkungen in Word Dokumenten mithilfe der REST-API in Node.js hinzu

Fügen Sie Textfeldanmerkungen in Word Dokumenten mithilfe der REST-API in Node.js hinzu

Wasserzeichenanmerkungen in Word Dokumenten mithilfe der REST-API in Node.js

Wir können Wasserzeichenanmerkungen in Word Dokumenten programmgesteuert hinzufügen, indem wir die zuvor genannten Schritte ausführen. Allerdings müssen wir den Anmerkungstyp auf „Wasserzeichen“ festlegen.

Das folgende Codebeispiel zeigt, wie Sie mithilfe einer REST-API in Node.js Wasserzeichenanmerkungen zu einem Word Dokument hinzufügen. Bitte befolgen Sie die zuvor genannten Schritte, um eine Datei hoch und herunterzuladen.

// API initialisieren
let annotateApi = groupdocs_annotation_cloud.KommentierenApi.fromKeys(clientId, clientSecret);

// Definieren Sie die Wasserzeichenanmerkung
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.";

// Pfad der Eingabedatei
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Anmerkungsoptionen definieren
let options = new groupdocs_annotation_cloud.KommentierenOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddWatermarkAnnotation.docx";

// Kommentierungsanfrage erstellen
let request = new groupdocs_annotation_cloud.KommentierenRequest(options);

// Kommentieren
let result = await annotateApi.annotate(request);
Wasserzeichenanmerkungen in Word Dokumenten mithilfe der REST-API in Node.js

Wasserzeichenanmerkungen in Word Dokumenten mithilfe der REST-API in Node.js

Versuchen Sie es online

Bitte probieren Sie das folgende kostenlose Online-DOCX-Annotationstool aus, das mit der oben genannten API entwickelt wurde. https://products.groupdocs.app/annotation/docx

Abschluss

In diesem Artikel haben wir erfahren, wie man Anmerkungen zu Word Dokumenten in der Cloud hinzufügt. Wir haben auch gesehen, wie man mithilfe einer REST-API in Node.js Bild und Textfeldanmerkungen zur DOCX-Datei hinzufügt. In diesem Artikel wurde auch erläutert, wie Sie eine DOCX-Datei programmgesteuert in die Cloud hochladen und dann die bearbeitete Datei aus der Cloud herunterladen. Außerdem können Sie mithilfe der Dokumentation mehr über die GroupDocs.Annotation Cloud API erfahren. Wir bieten auch einen Abschnitt API-Referenz an, mit dem Sie unsere APIs direkt über den Browser visualisieren und mit ihnen interagieren können. Bei Unklarheiten können Sie uns gerne im Forum kontaktieren.

Siehe auch