Pełny działający przykład usuwania obiektów adnotacji z PDF przy użyciu REST w Node.JS

Ten przykład demonstruje, jak przesłać plik PDF, usunąć wszystkie jego adnotacje i pobrać oczyszczony plik przy użyciu GroupDocs.Annotation SDK.

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}`);
})();

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki plików i wartości konfiguracyjne, aby odpowiadały rzeczywistemu środowisku, sprawdź, czy wszystkie wymagane zależności są prawidłowo zainstalowane, oraz dokładnie przetestuj w środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Usuwanie adnotacji PDF za pomocą REST API przy użyciu cURL

Poniżej znajdują się polecenia cURL, które wykonują ten sam przepływ usuwania adnotacji za pośrednictwem punktów końcowych REST usługi GroupDocs.Annotation Cloud.

# 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

Aby uzyskać pełną listę punktów końcowych i parametrów, zobacz oficjalną dokumentację API.

Jak działa usuwanie obiektów adnotacji z PDF przy użyciu REST w Node.JS

1. Konfiguracja uwierzytelniania - Klasa Configuration jest tworzona z Twoim clientId i clientSecret, tworząc uwierzytelniony kontekst dla wszystkich kolejnych wywołań API.

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

2. Przesyłanie pliku - UploadFileRequest wysyła lokalne bajty PDF do magazynu GroupDocs Cloud. Metoda storageApi.uploadFile obsługuje transfer.

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

3. Pobieranie adnotacji - GetAnnotationsRequest tworzy obiekt żądania z odniesieniem do FileInfo. Wywołanie annotationsApi.getAnnotations zwraca kolekcję obiektów adnotacji, z których wyodrębnia się identyfikatory.

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

4. Usuwanie adnotacji - Jeśli istnieją jakiekolwiek identyfikatory, DeleteAnnotationsRequest jest wypełniany i przekazywany do annotationsApi.deleteAnnotations, które trwale usuwa adnotacje z przechowywanego PDF.

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

5. Pobieranie czystego PDF - Na koniec DownloadFileRequest pobiera zaktualizowany plik, a fs.writeFileSync zapisuje go w lokalnym systemie plików.

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

Aby uzyskać szczegółowe definicje klas i metod, odwołaj się do referencji API.

Instalowanie i konfigurowanie GroupDocs.Annotation Cloud SDK dla Node.js

SDK jest dystrybuowany jako pakiet npm. Zainstaluj go przy pomocy poniższego polecenia, a następnie użyj require w swoim projekcie.

npm install groupdocs-annotation-cloud

Możesz również pobrać najnowszy pakiet bezpośrednio ze strony wydań GitHub lub z oficjalnego adresu URL do pobrania.

Po instalacji zaimportuj bibliotekę i utwórz obiekt konfiguracji, jak pokazano w przykładzie kodu:

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

Upewnij się, że Twoje środowisko uruchomieniowe spełnia wymagania dotyczące wersji Node.js oraz że posiadasz ważne konto GroupDocs, aby uzyskać dane uwierzytelniające klienta.

Opcje i ustawienia usuwania adnotacji

SDK udostępnia kilka parametrów, które możesz dostroić:

• clientId / clientSecret - Dane uwierzytelniające do autoryzacji OAuth. Ustaw je w konstruktorze Configuration.
• fileInfo.filePath - Ścieżka do pliku PDF w pamięci GroupDocs Cloud. Dostosuj ją, jeśli przechowujesz pliki w innym folderze.
• annotationIds - Tablica identyfikatorów zwróconych przez GetAnnotations. Podanie podzbioru umożliwia selektywne usuwanie.

Dodatkowe ustawienia, takie jak limit czasu żądania i konfiguracja proxy, są dostępne w dokumentacji SDK; zobacz oficjalną dokumentację po pełną listę.

Najlepsze praktyki usuwania adnotacji PDF za pośrednictwem REST

• Sprawdź identyfikatory adnotacji - Zawsze sprawdzaj, czy identyfikatory, które zamierzasz usunąć, istnieją; próba usunięcia nieistniejących identyfikatorów może spowodować błąd 404.
• Używaj HTTPS - Wszystkie wywołania API muszą być wykonywane przez HTTPS, aby chronić Twoje poświadczenia i dane dokumentu.
• Obsługuj duże pliki przy użyciu przesyłania w częściach - Dla plików PDF większych niż 100 MB, preferuj punkt końcowy wieloczęściowego przesyłania, aby uniknąć przekroczenia limitu czasu.
• Loguj odpowiedzi API - Przechowuj identyfikatory żądań i odpowiedzi w celu tworzenia ścieżek audytu i ułatwienia rozwiązywania problemów.
• Ponownie używaj tokenów dostępu - Buforuj token OAuth, dopóki nie wygaśnie, aby zmniejszyć obciążenie uwierzytelniania.

Często zadawane pytania

• Jak uwierzytelnić się w GroupDocs.Annotation Cloud API?
  Uzyskaj identyfikator klienta (client ID) i sekret z konta GroupDocs, a następnie żądaj tokenu dostępu poprzez punkt końcowy OAuth. Zobacz oficjalną dokumentację, aby uzyskać szczegóły.

• Czy mogę usunąć konkretne adnotacje zamiast wszystkich?
  Tak, podaj identyfikatory adnotacji, które chcesz usunąć w DeleteAnnotationsRequest. SDK zwraca listę identyfikatorów adnotacji po wywołaniu GetAnnotations.

• Jak mogę usunąć obiekty adnotacji z PDF przy użyciu REST w Node.JS?
  Użyj GroupDocs.Annotation Cloud SDK for Node.js, aby wywołać endpoint DeleteAnnotations po pobraniu identyfikatorów adnotacji. Pełny przepływ pracy jest przedstawiony w przykładzie kodu oraz sekcji cURL tego przewodnika.

• Jakie licencjonowanie jest wymagane do użytku produkcyjnego?
  Do produkcji wymagana jest płatna licencja. Podczas oceny możesz uzyskać tymczasową licencję ze strony tymczasowej licencji.

Dalsza lektura

• Wyodrębnij lub usuń adnotacje z PDF przy użyciu REST API w Node.js
• Tekst przekreślony w PDF przy użyciu Node.js i REST API
• Usuń adnotacje z PDF przy użyciu REST API w Pythonie

Edytuj plik Excel w Node.js za pomocą REST - 5‑etapowy przewodnik

1. Zainstaluj SDK i skonfiguruj poświadczenia: Ustaw swoje CLIENT_ID i CLIENT_SECRET, aby biblioteka mogła uwierzytelnić się w GroupDocs Cloud.

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. Załaduj skoroszyt Excel do edycji: Użyj EditDocumentRequest, aby otworzyć plik przechowywany w Twojej chmurze.

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

3. Pobierz pierwszy arkusz i zlokalizuj docelową komórkę: SDK zwraca obiekt document, który zawiera arkusze i komórki.

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

4. Zaktualizuj lub utwórz wartość komórki: Zmień zawartość komórki A1 (lub dodaj ją, jeśli nie istnieje).

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. Zapisz edytowany skoroszyt z powrotem w magazynie: Podaj outputPath i wywołaj saveDocument.

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

Aby uzyskać pełną listę klas i metod, zobacz referencję API.

Edytuj plik Excel w Node.js za pośrednictwem REST - Pełny przykład kodu

Poniższy przykład demonstruje, jak edytować plik Excel w Node.js za pomocą REST przy użyciu GroupDocs.Editor Cloud SDK.

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);
});

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki plików i wartości konfiguracyjne, aby odpowiadały rzeczywistemu środowisku, sprawdź, czy wszystkie wymagane zależności są poprawnie zainstalowane, i dokładnie przetestuj w środowisku deweloperskim. Jeśli napotkasz problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Aktualizowanie arkusza XLSX przy użyciu REST API w Node.js za pomocą cURL

Poniżej znajduje się szybki przewodnik po tej samej operacji przy użyciu surowych wywołań HTTP. Zastąp wartości zastępcze swoimi rzeczywistymi poświadczeniami i nazwami plików.

1. Uzyskaj token dostępu

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"

Odpowiedź zawiera access_token.

2. Prześlij plik źródłowy XLSX

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

3. Edytuj skoroszyt (zmodyfikuj komórkę A1)

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. Pobierz edytowany plik

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

Aby uzyskać więcej informacji o ładunkach żądań, zobacz oficjalną dokumentację API.

Wymagania wstępne i konfiguracja GroupDocs.Editor Cloud SDK dla Node.js

Aby rozpocząć korzystanie z SDK, potrzebujesz Node.js 14 lub nowszego oraz konta GroupDocs Cloud.

npm install groupdocs-editor-cloud

Możesz również pobrać najnowszy pakiet ze strona wydania. Po instalacji utwórz client_id i client_secret w swoim panelu GroupDocs Cloud i zachowaj je w bezpiecznym miejscu.

Co sprawia, że GroupDocs.Editor Cloud SDK for Node.js jest idealny do modyfikowania arkuszy Excel

• Pełne wsparcie XLSX - Ładuj, edytuj i zapisuj skoroszyty, zachowując formuły, style i walidację danych.
• Edycja na poziomie komórek - Uzyskaj dostęp do pojedynczych komórek, wierszy lub kolumn programowo, co jest idealne do aktualizacji raportów lub pulpitów nawigacyjnych.
• Integracja z przechowywaniem w chmurze - Pracuj bezpośrednio z plikami przechowywanymi w GroupDocs Cloud, bez ich pobierania lokalnie.
• Bezpieczna komunikacja REST - Wszystkie operacje odbywają się przez HTTPS, a SDK zarządza tokenami za Ciebie.

Aby uzyskać bardziej szczegółowe informacje, odwołaj się do dokumentacji.

Dostosowywanie opcji edycji Excela w GroupDocs.Editor Cloud

SDK udostępnia kilka opcji, które pozwalają kontrolować, jak zapisywany jest edytowany skoroszyt.

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

• outputPath - Ścieżka docelowa w pamięci w chmurze.
• compressionLevel - Zmniejsz rozmiar pliku dla dużych skoroszytów (dostępne w dokumentacji API).
• password - Zabezpiecz wynikowy plik hasłem, jeśli jest to wymagane.

Dostosuj te ustawienia, aby odpowiadały potrzebom bezpieczeństwa i wydajności Twojego projektu.

Rozważania dotyczą się wydajności przy edycji skoroszytów XLSX za pośrednictwem REST

1. Ponowne użycie obiektu konfiguracji - Tworzenie nowego Configuration dla każdego żądania zwiększa narzut. Utrzymuj jedną instancję przez cały czas działania aplikacji.
2. Zbiorcze aktualizacje komórek - Jeśli musisz zmodyfikować wiele komórek, zbierz je w tablicy i wyślij jedno żądanie edycji zamiast wielu wywołań.
3. Ogranicz rozmiar arkusza - Bardzo duże arkusze zwiększają zużycie pamięci. Rozważ podzielenie danych na wiele arkuszy, gdy to możliwe.
4. Unikaj niepotrzebnych zapisów - Wywołuj saveDocument tylko po zastosowaniu wszystkich wymaganych zmian, aby zmniejszyć operacje I/O.

Wnioski

Edycja pliku Excel w Node.js za pośrednictwem REST staje się prosta dzięki GroupDocs.Editor Cloud SDK for Node.js. Możesz programowo załadować skoroszyt, modyfikować komórki i zapisać wynik, używając zaledwie kilku wywołań API lub prostych poleceń cURL. Architektura SDK oparta na chmurze eliminuje potrzebę lokalnych instalacji Office i skalowalnie dopasowuje się do obciążenia Twojej aplikacji. W przypadku wdrożeń produkcyjnych zakup licencji dopasowanej do Twojego modelu użycia, a także możesz uzyskać tymczasową licencję do testów ze strony tymczasowej licencji. Rozpocznij integrację edycji Excela już dziś i usprawnij swoje pipeline’y przetwarzania danych.

FAQs

Jak edytować plik Excel w Node.js za pośrednictwem REST bez pisania własnego kodu HTTP?
Użyj GroupDocs.Editor Cloud SDK for Node.js, które abstrahuje wywołania REST i pozwala edytować plik Excel w Node.js za pośrednictwem REST przy użyciu prostych wywołań metod.

Czy mogę zaktualizować arkusz XLSX przy użyciu REST api Node.js dla dużych plików?
Tak. SDK strumieniuje dane i obsługuje aktualizacje wsadowe, co czyni go odpowiednim dla dużych skoroszytów. Dostosuj compressionLevel i zmiany komórek wsadowych, aby poprawić wydajność.

Jaki jest najlepszy sposób na programowe modyfikowanie arkusza Excel w Node.js?
Pracuj z obiektami worksheet i cell, które zwraca editDocument. Daje to pełną kontrolę nad wierszami, kolumnami i wartościami komórek bez opuszczania środowiska Node.js.

Gdzie mogę znaleźć informacje o cenach i licencjonowaniu?
Wszystkie szczegóły licencjonowania, w tym poziomy cen i tymczasowa licencja do oceny, są dostępne na stronie tymczasowej licencji.

Read More

• Edytuj arkusz Excel za pomocą REST w Javie
• Edytuj arkusz Excel przy użyciu REST API w Pythonie
• Najlepsze praktyki tworzenia edytora CSV w Javie