Kommentieren Sie PDF Dokumente mithilfe einer REST-API in Node.js

Als Node.js-Entwickler können Sie jedes Ihrer PDF Dokumente problemlos programmgesteuert in der Cloud mit Anmerkungen versehen. Sie können dem Dokument Bilder, Kommentare, Notizen oder andere Arten externer Anmerkungen als Anmerkungen hinzufügen. In diesem Artikel erfahren Sie, wie Sie PDF Dokumente mithilfe einer REST-API in Node.js mit Anmerkungen versehen.

Die folgenden Themen sollen in diesem Artikel behandelt werden:

Document Annotation REST API und Node.js SDK

Zum Kommentieren von PDF Dokumenten verwende ich das Node.js SDK der GroupDocs.Annotation Cloud API. Es ermöglicht Ihnen, programmgesteuert Online Dokumentanmerkungstools zu erstellen. Sie können den unterstützten Dokumentformaten Anmerkungen, Wasserzeichenüberlagerungen, Textersetzungen, Schwärzungen und Textmarkierungen hinzufügen. Es stellt außerdem .NET-, Java-, PHP-, Ruby und Python-SDKs als Mitglieder der Dokumentannotationsfamilie für die Cloud-API bereit.

Sie können GroupDocs.Annotation Cloud mit dem folgenden Befehl in der Konsole in Ihrer Node.js-Anwendung installieren:

npm install groupdocs-annotation-cloud

Bitte rufen Sie Ihre Client-ID und Ihr Client-Geheimnis vom Dashboard ab, bevor Sie mit dem Befolgen der Schritte und verfügbaren Codebeispiele beginnen. Sobald Sie Ihre ID und Ihr Geheimnis haben, fügen Sie den Code wie unten gezeigt ein:

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

Kommentieren Sie PDF Dokumente mithilfe einer REST-API in Node.js

Sie können Ihre PDF Dokumente in der Cloud mit Anmerkungen versehen, indem Sie die folgenden einfachen Schritte ausführen:

  1. Hochladen der PDF-Datei in die Cloud
  2. PDF Dokument mit Node.js kommentieren
  3. Herunterladen der kommentierten Datei

Laden Sie das Dokument hoch

Laden Sie zunächst die PDF-Datei mit dem folgenden Codebeispiel 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\\sample.pdf';
// Datei lesen
fs.readFile(resourcesFolder, (err, fileStream) => {
  // Anfrage zum Hochladen einer Datei erstellen
  var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", fileStream, myStorage);
  // Datei hochladen
  fileApi.uploadFile(request)
});

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

Kommentieren Sie ein PDF Dokument mit Node.js

Sie können dem PDF Dokument programmgesteuert mehrere Anmerkungen hinzufügen, indem Sie die unten aufgeführten Schritte ausführen:

  • Erstellen Sie eine Instanz der AnnotateApi
  • Erstellen Sie die erste Instanz der AnnotationInfo
  • Legen Sie Anmerkungseigenschaften für die erste Instanz fest, z. B. Position, Typ, Text usw.
  • Erstellen Sie eine zweite Instanz der AnnotationInfo
  • Legen Sie Anmerkungseigenschaften für die zweite Instanz fest, z. B. Position, Typ, Text usw.
  • Erstellen Sie eine dritte Instanz der AnnotationInfo
  • Legen Sie Anmerkungseigenschaften für die dritte Instanz fest, z. B. Position, Typ, Text usw.
  • Erstellen Sie eine vierte Instanz der AnnotationInfo
  • Legen Sie Anmerkungseigenschaften für die vierte Instanz fest, z. B. Position, Typ, Text usw.
  • Erstellen Sie eine FileInfo-Instanz und legen Sie den Eingabedateipfad fest
  • Erstellen Sie eine Instanz von AnnotateOptions
  • Weisen Sie die FileInfo und definierten Anmerkungsinstanzen den AnnotateOptions zu
  • Legen Sie den Pfad der Ausgabedatei fest
  • Erstellen Sie eine Anfrage, indem Sie die AnnotateRequest-Methode mit AnnotateOptions aufrufen
  • Erhalten Sie Ergebnisse, indem Sie die Methode AnnotateApi.annotate() mit AnnotateRequest aufrufen

Das folgende Codebeispiel zeigt, wie Sie ein PDF Dokument mithilfe einer REST-API in Node.js mit mehreren Anmerkungen versehen.

// API initialisieren
let kommentierenApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);

// Abstandsanmerkung
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 Abstandsanmerkung";
a1.creatorName = "Anonym A.";

// Bereichsanmerkung
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 Bereichsanmerkung";
a2.creatorName = "Anonym A.";

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

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

// Anmerkungsanfrage erstellen
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// kommentieren
let result = await kommentierenApi.kommentieren(request);

console.log("Multiple Annotations added: " + result.href);
Kommentieren Sie PDF Dokumente mithilfe einer REST-API in Node.js

Kommentieren Sie PDF Dokumente mithilfe einer REST-API in Node.js

Weitere Informationen zu den unterstützten Anmerkungstypen finden Sie im Abschnitt Anmerkungen hinzufügen in der Dokumentation.

Laden Sie die kommentierte Datei herunter

Das obige Codebeispiel speichert die kommentierte PDF-Datei in der Cloud. Sie können es mit dem folgenden Codebeispiel herunterladen:

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

// Download-Dateianfrage erstellen
let request = new groupdocs_annotation_cloud.DownloadFileRequest("Output/output.pdf", myStorage);
// Download-Datei
let response = await fileApi.downloadFile(request);

// Datei im Arbeitsverzeichnis speichern
fs.writeFile("C:\\Files\\output.pdf", response, "binary", function (err) { });
console.log(response);

Fügen Sie Bildanmerkungen mit Node.js hinzu

Sie können Ihren PDF Dokumenten Bildanmerkungen programmgesteuert hinzufügen, indem Sie die folgenden Schritte ausführen:

  • Erstellen Sie eine Instanz der AnnotateApi
  • Erstellen Sie eine Instanz der AnnotationInfo
  • Definieren Sie ein Rechteck und legen Sie dessen Position, Höhe und Breite fest
  • Legen Sie Anmerkungseigenschaften fest, z. B. Position, Text, Höhe, Breite usw.
  • Legen Sie den Anmerkungstyp auf „Bild“ fest
  • Erstellen Sie eine FileInfo-Instanz und legen Sie den Eingabedateipfad fest
  • Erstellen Sie eine Instanz von AnnotateOptions
  • Weisen Sie FileInfo und Annotation den AnnotateOptions zu
  • Legen Sie den Pfad der Ausgabedatei fest
  • Erstellen Sie eine Anfrage, indem Sie die AnnotateRequest-Methode mit AnnotateOptions aufrufen
  • 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 Bildanmerkungen zum PDF Dokument hinzufügen. Bitte befolgen Sie die zuvor genannten Schritte, um eine Datei hoch und herunterzuladen.

// API initialisieren
let kommentierenApi = groupdocs_annotation_cloud.AnnotateApi.fromKeys(clientId, clientSecret);

// Bildanmerkung
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 Bildanmerkung";
a1.creatorName = "Anonym A.";
a1.imagePath = "JohnSmith.png";

// Eingabedateipfad
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";

// Anmerkungsoptionen definieren
let options = new groupdocs_annotation_cloud.AnnotateOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "Output/output.pdf";

// Anmerkungsanfrage erstellen
let request = new groupdocs_annotation_cloud.AnnotateRequest(options);
// kommentieren
let result = await kommentierenApi.kommentieren(request);

console.log("Image Annotation added: " + result.href);
Fügen Sie Bildanmerkungen mit Node.js hinzu

Fügen Sie Bildanmerkungen mit Node.js hinzu

Versuchen Sie es online

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

Abschluss

In diesem Artikel haben Sie erfahren, wie Sie PDF Dokumenten in der Cloud mehrere Anmerkungen hinzufügen. Sie haben außerdem gelernt, wie Sie Bildanmerkungen programmgesteuert zu PDF Dokumenten hinzufügen. Darüber hinaus haben Sie gelernt, wie Sie eine PDF-Datei programmgesteuert in die Cloud hochladen und dann die kommentierte Datei aus der Cloud herunterladen. Weitere Informationen zur GroupDocs.Annotation Cloud API finden Sie in der Dokumentation. 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