Vollständiges funktionierendes Beispiel zum Entfernen von Annotationsobjekten aus PDF mit REST in Node.JS

Dieses Beispiel zeigt, wie man ein PDF hochlädt, alle seine Anmerkungen löscht und die bereinigte Datei mit dem GroupDocs.Annotation SDK herunterlädt.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, konsultieren Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

PDF-Anmerkungen über die REST-API mit cURL löschen

Im Folgenden finden Sie die cURL‑Befehle, die denselben Workflow zum Entfernen von Anmerkungen über die GroupDocs.Annotation Cloud REST‑Endpunkte ausführen.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d "{\"client_id\":\"YOUR_CLIENT_ID\",\"client_secret\":\"YOUR_CLIENT_SECRET\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Für eine vollständige Liste der Endpunkte und Parameter siehe die offizielle API-Dokumentation.

Wie das Entfernen von Annotationsobjekten aus PDF mit REST in Node.JS funktioniert

1. Authentifizierung einrichten – Die Configuration‑Klasse wird mit Ihrem clientId und clientSecret instanziiert und erstellt einen authentifizierten Kontext für alle nachfolgenden API‑Aufrufe.

   const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
   

2. Datei‑Upload – UploadFileRequest sendet die lokalen PDF‑Bytes an den GroupDocs Cloud‑Speicher. Die Methode storageApi.uploadFile übernimmt die Übertragung.

   const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
       path: remoteFilePath,
       file: fileBytes
   });
   await storageApi.uploadFile(uploadRequest);
   

3. Annotationen abrufen – GetAnnotationsRequest erstellt ein Anforderungsobjekt mit einem FileInfo‑Verweis. Der Aufruf annotationsApi.getAnnotations gibt eine Sammlung von Annotationsobjekten zurück, aus denen die IDs extrahiert werden.

   const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
       fileInfo: fileInfo
   });
   const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
   

4. Annotationen löschen – Wenn IDs vorhanden sind, wird DeleteAnnotationsRequest gefüllt und an annotationsApi.deleteAnnotations übergeben, das die Annotationen dauerhaft aus dem gespeicherten PDF entfernt.

   const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
       fileInfo: fileInfo,
       annotationIds: annotationIds
   });
   await annotationsApi.deleteAnnotations(deleteRequest);
   

5. Bereinigtes PDF herunterladen – Schließlich ruft DownloadFileRequest die aktualisierte Datei ab und fs.writeFileSync schreibt sie in das lokale Dateisystem.

   const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
       path: remoteFilePath
   });
   const fileStream = await storageApi.downloadFile(downloadRequest);
   fs.writeFileSync(localOutputPath, fileStream);
   

Für detaillierte Klassen‑ und Methodendefinitionen siehe die API‑Referenz.

Installation und Konfiguration GroupDocs.Annotation Cloud SDK for Node.js

Das SDK wird als npm‑Paket bereitgestellt. Installieren Sie es mit dem untenstehenden Befehl und binden Sie es dann in Ihrem Projekt ein.

npm install groupdocs-annotation-cloud

Sie können das neueste Paket auch direkt von der GitHub‑Release‑Seite oder der offiziellen Download‑URL herunterladen.

Nach der Installation importieren Sie die Bibliothek und erstellen ein Konfigurationsobjekt, wie im Codebeispiel gezeigt:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Stellen Sie sicher, dass Ihre Laufzeitumgebung die Node.js-Versionanforderungen erfüllt und dass Sie ein gültiges GroupDocs‑Konto besitzen, um die Client‑Anmeldeinformationen zu erhalten.

Optionen und Einstellungen zum Entfernen von Anmerkungen

Das SDK stellt mehrere Parameter zur Verfügung, die Sie anpassen können:

• clientId / clientSecret - Anmeldeinformationen für die OAuth-Authentifizierung. Legen Sie sie im Configuration-Konstruktor fest.
• fileInfo.filePath - Der Pfad der PDF-Datei im GroupDocs Cloud-Speicher. Passen Sie ihn an, wenn Sie Dateien in einem anderen Ordner speichern.
• annotationIds - Ein Array von IDs, das von GetAnnotations zurückgegeben wird. Die Angabe eines Teilsets ermöglicht eine selektive Löschung.

Zusätzliche Einstellungen wie Anforderungs‑Timeouts und Proxy‑Konfiguration sind in der SDK‑Dokumentation verfügbar; siehe die offizielle Dokumentation für die vollständige Liste.

Best Practices für das Entfernen von PDF-Anmerkungen über REST

• Annotation IDs validieren - Stellen Sie stets sicher, dass die IDs, die Sie löschen möchten, existieren; der Versuch, nicht vorhandene IDs zu löschen, kann einen 404‑Fehler verursachen.
• HTTPS verwenden - Alle API-Aufrufe müssen über HTTPS erfolgen, um Ihre Anmeldeinformationen und Dokumentdaten zu schützen.
• Große Dateien mit Chunked Uploads verarbeiten - Bei PDFs, die größer als 100 MB sind, sollten Sie den Multipart‑Upload‑Endpunkt bevorzugen, um Zeitüberschreitungen zu vermeiden.
• API‑Antworten protokollieren - Speichern Sie Anforderungs‑IDs und Antworten für Prüfpfade und einfachere Fehlersuche.
• Access‑Tokens wiederverwenden - Zwischenspeichern Sie das OAuth‑Token, bis es abläuft, um den Authentifizierungsaufwand zu reduzieren.

Häufige Fragen

• Wie authentifiziere ich mich bei der GroupDocs.Annotation Cloud API?
  Holen Sie eine Client-ID und ein Geheimnis aus Ihrem GroupDocs-Konto und fordern Sie dann ein Zugriffstoken über den OAuth-Endpunkt an. Siehe die offizielle Dokumentation für Details.

• Kann ich bestimmte Anmerkungen statt aller löschen?
  Ja, geben Sie die IDs der Anmerkungen an, die Sie entfernen möchten, im DeleteAnnotationsRequest. Das SDK gibt die Liste der Anmerkungs‑IDs nach einem GetAnnotations‑Aufruf zurück.

• Wie kann ich Annotationsobjekte aus einem PDF mit REST in Node.JS entfernen?
  Verwenden Sie das GroupDocs.Annotation Cloud SDK für Node.js, um den DeleteAnnotations-Endpunkt aufzurufen, nachdem Sie die Annotations-IDs abgerufen haben. Der vollständige Arbeitsablauf wird im Codebeispiel und im cURL-Abschnitt dieses Leitfadens demonstriert.

• Welche Lizenz ist für die Produktion erforderlich?
  Für die Produktion ist eine kostenpflichtige Lizenz erforderlich. Sie können während der Evaluierung eine temporäre Lizenz von der temporäre Lizenzseite erwerben.

Weiterführende Lektüre

• Extrahieren oder Entfernen von Anmerkungen aus PDF mit REST-API in Node.js
• Durchgestrichener Text in einem PDF mit Node.js und REST-API
• Entfernen von Anmerkungen aus PDF mit REST-API in Python

Excel-Datei in Node.js über REST bearbeiten - 5-Schritte-Anleitung

1. Installieren Sie das SDK und konfigurieren Sie die Anmeldeinformationen: Legen Sie Ihre CLIENT_ID und CLIENT_SECRET fest, damit die Bibliothek sich bei GroupDocs Cloud authentifizieren kann.

const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
const editApi = new GroupDocsEditorCloud.EditApi(config);

2. Laden Sie die Excel‑Arbeitsmappe zur Bearbeitung: Verwenden Sie EditDocumentRequest, um die in Ihrem Cloud‑Speicher gespeicherte Datei zu öffnen.

const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
    fileInfo: new GroupDocsEditorCloud.FileInfo({ filePath: "input.xlsx" })
});
const editResult = await editApi.editDocument(editRequest);

3. Rufen Sie das erste Arbeitsblatt ab und finden Sie die Zielzelle: Das SDK gibt ein document-Objekt zurück, das Arbeitsblätter und Zellen enthält.

const worksheet = editResult.document.worksheets[0];
let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);

4. Aktualisieren oder Erstellen des Zellwerts: Ändern Sie den Inhalt der Zelle A1 (oder fügen Sie ihn hinzu, falls er nicht existiert).

if (!targetCell) {
    targetCell = new GroupDocsEditorCloud.Cell({
        rowIndex: 0,
        columnIndex: 0,
        value: "Edited via GroupDocs Editor Cloud"
    });
    worksheet.cells.push(targetCell);
} else {
    targetCell.value = "Edited via GroupDocs Editor Cloud";
}

5. Speichern Sie die bearbeitete Arbeitsmappe zurück im Speicher: Geben Sie einen outputPath an und rufen Sie saveDocument auf.

const saveOptions = new GroupDocsEditorCloud.SaveOptions({ outputPath: "output.xlsx" });
const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
    documentId: editResult.documentId,
    document: editResult.document,
    saveOptions: saveOptions
});
await editApi.saveDocument(saveRequest);

Für eine vollständige Liste von Klassen und Methoden siehe die API-Referenz.

Excel-Datei in Node.js über REST bearbeiten – Vollständiges Codebeispiel

Das folgende Beispiel zeigt, wie man eine Excel‑Datei in Node.js über REST mit dem GroupDocs.Editor Cloud SDK bearbeitet.

const GroupDocsEditorCloud = require("@groupdocs/editor-cloud");

// Replace with your actual GroupDocs Cloud credentials
const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

// Paths for the source Excel file and the edited result
const INPUT_FILE_PATH = "input.xlsx";
const OUTPUT_FILE_PATH = "output.xlsx";

async function editExcel() {
    // Configure the SDK
    const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
    const editApi = new GroupDocsEditorCloud.EditApi(config);

// 1. Load the Excel workbook for editing
    const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
        fileInfo: new GroupDocsEditorCloud.FileInfo({
            filePath: INPUT_FILE_PATH
        })
    });

const editResult = await editApi.editDocument(editRequest);
    const documentId = editResult.documentId;
    const document = editResult.document;

// 2. Retrieve the first worksheet
    const worksheet = document.worksheets[0];

// 3. Update cell A1 (rowIndex = 0, columnIndex = 0) with a new value
    let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);
    if (!targetCell) {
        targetCell = new GroupDocsEditorCloud.Cell({
            rowIndex: 0,
            columnIndex: 0,
            value: "Edited via GroupDocs Editor Cloud"
        });
        worksheet.cells.push(targetCell);
    } else {
        targetCell.value = "Edited via GroupDocs Editor Cloud";
    }

// 4. Save the edited workbook back to storage
    const saveOptions = new GroupDocsEditorCloud.SaveOptions({
        outputPath: OUTPUT_FILE_PATH
    });

const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
        documentId: documentId,
        document: document,
        saveOptions: saveOptions
    });

const saveResult = await editApi.saveDocument(saveRequest);
    console.log(`Edited file saved to: ${saveResult.path}`);
}

// Execute the edit operation
editExcel().catch(error => {
    console.error("Error during Excel editing:", error);
});

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support‑Team für Unterstützung.

XLSX-Blatt mit REST-API in Node.js über cURL aktualisieren

Im Folgenden finden Sie eine kurze Anleitung für dieselbe Operation mithilfe von rohen HTTP‑Aufrufen. Ersetzen Sie die Platzhalterwerte durch Ihre tatsächlichen Anmeldeinformationen und Dateinamen.

1. Ein Zugriffstoken erhalten

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"

Die Antwort enthält access_token.

2. Laden Sie die Quell‑XLSX‑Datei hoch

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.xlsx"

3. Arbeitsmappe bearbeiten (Zelle A1 ändern)

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "options": {
               "cells": [
                   { "rowIndex": 0, "columnIndex": 0, "value": "Edited via GroupDocs Editor Cloud" }
               ]
           }
         }'

4. Herunterladen der bearbeiteten Datei

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.xlsx

Weitere Details zu den Anforderungs‑Payloads finden Sie in der offiziellen API-Dokumentation.

Voraussetzungen und Einrichtung für GroupDocs.Editor Cloud SDK for Node.js

Um das SDK zu verwenden, benötigen Sie Node.js 14 oder höher und ein GroupDocs Cloud-Konto.

npm install groupdocs-editor-cloud

Sie können das neueste Paket auch von der Release‑Seite herunterladen. Nach der Installation erstellen Sie eine client_id und ein client_secret in Ihrem GroupDocs Cloud‑Dashboard und bewahren sie sicher auf.

Was macht das GroupDocs.Editor Cloud SDK for Node.js ideal für die Bearbeitung von Excel-Arbeitsblättern

• Vollständige XLSX-Unterstützung – Laden, bearbeiten und speichern Sie Arbeitsmappen, wobei Formeln, Formatvorlagen und Datenvalidierung erhalten bleiben.
• Bearbeitung auf Zellebene – Greifen Sie programmgesteuert auf einzelne Zellen, Zeilen oder Spalten zu, was ideal für die Aktualisierung von Berichten oder Dashboards ist.
• Cloud‑Speicher‑Integration – Arbeiten Sie direkt mit Dateien, die in GroupDocs Cloud gespeichert sind, ohne sie lokal herunterzuladen.
• Sichere REST‑Kommunikation – Alle Vorgänge erfolgen über HTTPS, und das SDK übernimmt die Tokenverwaltung für Sie.

Für ein tieferes Eintauchen, siehe die Dokumentation.

Feineinstellungen der Excel-Bearbeitungsoptionen in GroupDocs.Editor Cloud

Das SDK bietet mehrere Optionen, mit denen Sie steuern können, wie die bearbeitete Arbeitsmappe gespeichert wird.

const saveOptions = new GroupDocsEditorCloud.SaveOptions({
    outputPath: "output.xlsx",
    // You can also set compression level, password protection, etc.
});

• outputPath - Zielpfad im Cloud-Speicher.
• compressionLevel - Reduzieren Sie die Dateigröße für große Arbeitsmappen (verfügbar in der API-Referenz).
• password - Schützen Sie die resultierende Datei bei Bedarf mit einem Passwort.

Passen Sie diese Einstellungen an, um den Sicherheits‑ und Leistungsanforderungen Ihres Projekts zu entsprechen.

Leistungsüberlegungen beim Bearbeiten von XLSX-Arbeitsmappen über REST

1. Konfigurationsobjekt wiederverwenden - Das Erstellen einer neuen Configuration für jede Anforderung verursacht zusätzlichen Aufwand. Halten Sie eine einzelne Instanz für die Laufzeit Ihrer Anwendung.
2. Zellen-Updates stapeln - Wenn Sie viele Zellen ändern müssen, sammeln Sie sie in einem Array und senden Sie eine einzige Bearbeitungsanfrage anstelle mehrerer Aufrufe.
3. Arbeitsblattgröße begrenzen - Sehr große Arbeitsblätter erhöhen den Speicherverbrauch. Ziehen Sie in Betracht, Daten nach Möglichkeit auf mehrere Blätter zu verteilen.
4. Unnötige Speicherungen vermeiden - Rufen Sie saveDocument nur auf, nachdem alle erforderlichen Änderungen angewendet wurden, um I/O‑Operationen zu reduzieren.

Fazit

Das Bearbeiten einer Excel‑Datei in Node.js über REST wird mit dem GroupDocs.Editor Cloud SDK for Node.js unkompliziert. Sie können programmgesteuert eine Arbeitsmappe laden, Zellen ändern und das Ergebnis mit nur wenigen API‑Aufrufen oder einfachen cURL‑Befehlen speichern. Die cloudbasierte Architektur des SDK eliminiert die Notwendigkeit lokaler Office‑Installationen und skaliert mit der Arbeitslast Ihrer Anwendung. Für Produktionsbereitstellungen erwerben Sie eine Lizenz, die zu Ihrem Nutzungsmuster passt, und Sie können auch eine temporäre Lizenz zum Testen von der temporären Lizenzseite erhalten. Beginnen Sie noch heute mit der Integration der Excel‑Bearbeitung und optimieren Sie Ihre Datenverarbeitungspipelines.

FAQs

Wie bearbeite ich eine Excel-Datei in Node.js über REST, ohne benutzerdefinierten HTTP-Code zu schreiben?
Verwenden Sie das GroupDocs.Editor Cloud SDK for Node.js, das die REST-Aufrufe abstrahiert und Ihnen ermöglicht, Excel-Dateien in Node.js über REST mit einfachen Methodenaufrufen zu bearbeiten.

Kann ich ein XLSX‑Blatt mit der REST‑API Node.js für große Dateien aktualisieren?
Ja. Das SDK streamt Daten und unterstützt Batch‑Updates, was es für große Arbeitsmappen geeignet macht. Passen Sie compressionLevel und batch‑Zelländerungen an, um die Leistung zu verbessern.

Was ist der beste Weg, ein Excel-Arbeitsblatt programmgesteuert mit Node.js zu ändern?
Arbeiten Sie mit den worksheet- und cell-Objekten, die von editDocument zurückgegeben werden. Dies gibt Ihnen die volle Kontrolle über Zeilen, Spalten und Zellwerte, ohne die Node.js-Umgebung zu verlassen.

Wo finde ich Informationen zu Preisen und Lizenzierung?
Alle Lizenzdetails, einschließlich Preisstufen und einer temporären Lizenz für die Evaluierung, sind auf der temporäre Lizenzseite verfügbar.

Mehr lesen

• Excel‑Tabelle über REST in Java bearbeiten
• Excel‑Tabelle mit REST‑API in Python bearbeiten
• Best Practices für die CSV‑Editor‑Entwicklung in Java