Contoh Kerja Penuh untuk Menghapus Objek Anotasi dari PDF dengan REST di Node.JS

Contoh ini menunjukkan cara mengunggah PDF, menghapus semua anotasinya, dan mengunduh file yang telah dibersihkan menggunakan 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}`);
})();

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terinstal dengan benar, dan lakukan pengujian secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Hapus Anotasi PDF melalui REST API Menggunakan cURL

Berikut adalah perintah cURL yang melakukan alur kerja penghapusan anotasi yang sama melalui endpoint REST 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

Untuk daftar lengkap endpoint dan parameter, lihat dokumentasi API resmi.

Cara Menghapus Objek Anotasi dari PDF dengan REST di Node.JS Berfungsi

1. Authentication Setup - Kelas Configuration diinstansiasi dengan clientId dan clientSecret Anda, membuat konteks terautentikasi untuk semua panggilan API berikutnya.

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

2. File Upload - UploadFileRequest mengirimkan byte PDF lokal ke penyimpanan GroupDocs Cloud. Metode storageApi.uploadFile menangani transfer.

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

3. Retrieve Annotations - GetAnnotationsRequest membangun objek permintaan dengan referensi FileInfo. Pemanggilan annotationsApi.getAnnotations mengembalikan koleksi objek anotasi, dari mana ID diekstrak.

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

4. Delete Annotations - Jika ada ID, DeleteAnnotationsRequest diisi dan diteruskan ke annotationsApi.deleteAnnotations, yang secara permanen menghapus anotasi dari PDF yang disimpan.

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

5. Download Clean PDF - Akhirnya, DownloadFileRequest mengambil file yang diperbarui, dan fs.writeFileSync menuliskannya ke sistem file lokal.

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

Untuk definisi kelas dan metode yang detail, lihat referensi API.

Menginstal dan Mengonfigurasi GroupDocs.Annotation Cloud SDK for Node.js

SDK didistribusikan sebagai paket npm. Instal dengan perintah di bawah ini dan kemudian require di proyek Anda.

npm install groupdocs-annotation-cloud

Anda juga dapat mengunduh paket terbaru secara langsung dari halaman rilis GitHub atau URL unduhan resmi.

Setelah instalasi, impor perpustakaan dan buat objek konfigurasi seperti yang ditunjukkan dalam contoh kode:

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

Pastikan lingkungan runtime Anda memenuhi persyaratan versi Node.js dan Anda memiliki akun GroupDocs yang valid untuk memperoleh kredensial klien.

Opsi dan Pengaturan Penghapusan Anotasi

SDK menyediakan beberapa parameter yang dapat Anda sesuaikan:

• clientId / clientSecret - Kredensial untuk autentikasi OAuth. Atur mereka di konstruktor Configuration.
• fileInfo.filePath - Jalur PDF di penyimpanan GroupDocs Cloud. Sesuaikan ini jika Anda menyimpan file di folder yang berbeda.
• annotationIds - Sebuah array ID yang dikembalikan oleh GetAnnotations. Menyediakan subset memungkinkan penghapusan selektif.

Pengaturan tambahan seperti batas waktu permintaan dan konfigurasi proxy tersedia dalam dokumentasi SDK; lihat dokumentasi resmi untuk daftar lengkap.

Praktik Terbaik untuk Menghapus Anotasi PDF melalui REST

• Validasi ID Anotasi - Selalu periksa bahwa ID yang ingin Anda hapus memang ada; mencoba menghapus ID yang tidak ada dapat menyebabkan error 404.
• Gunakan HTTPS - Semua panggilan API harus dilakukan melalui HTTPS untuk melindungi kredensial dan data dokumen Anda.
• Tangani File Besar dengan Unggahan Berpotongan - Untuk PDF yang lebih besar dari 100 MB, pilih endpoint unggahan multipart untuk menghindari timeout.
• Catat Respons API - Simpan ID permintaan dan respons untuk jejak audit serta mempermudah pemecahan masalah.
• Gunakan Kembali Token Akses - Cache token OAuth hingga kedaluwarsa untuk mengurangi beban otentikasi.

Pertanyaan Umum

• Bagaimana cara mengautentikasi dengan GroupDocs.Annotation Cloud API?
  Dapatkan client ID dan secret dari akun GroupDocs Anda, lalu minta token akses melalui endpoint OAuth. Lihat dokumentasi resmi untuk detail.

• Bisakah saya menghapus anotasi tertentu alih-alih semuanya?
  Ya, berikan ID anotasi yang ingin Anda hapus dalam DeleteAnnotationsRequest. SDK mengembalikan daftar ID anotasi setelah panggilan GetAnnotations.

• Bagaimana cara menghapus objek Anotasi dari PDF dengan REST di Node.JS?
  Gunakan GroupDocs.Annotation Cloud SDK for Node.js untuk memanggil endpoint DeleteAnnotations setelah mengambil ID anotasi. Alur kerja lengkap ditunjukkan dalam contoh kode dan bagian cURL panduan ini.

• Lisensi apa yang diperlukan untuk penggunaan produksi?
  Lisensi berbayar diperlukan untuk produksi. Anda dapat memperoleh lisensi sementara dari halaman lisensi sementara saat melakukan evaluasi.

Further Reading

• Ekstrak atau Hapus Anotasi dari PDF menggunakan REST API di Node.js
• Teks Coret dalam PDF dengan Node.js dan REST API
• Hapus Anotasi dari PDF menggunakan REST API di Python

Mengedit File Excel di Node.js melalui REST - Panduan 5 Langkah

1. Instal SDK dan konfigurasikan kredensial: Tetapkan CLIENT_ID dan CLIENT_SECRET Anda sehingga perpustakaan dapat mengautentikasi dengan 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. Muat buku kerja Excel untuk diedit: Gunakan EditDocumentRequest untuk membuka file yang disimpan di penyimpanan cloud Anda.

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

3. Ambil lembar kerja pertama dan temukan sel target: SDK mengembalikan objek document yang berisi lembar kerja dan sel.

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

4. Perbarui atau buat nilai sel: Ubah konten sel A1 (atau tambahkan jika tidak ada).

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. Simpan buku kerja yang telah diedit kembali ke penyimpanan: Berikan outputPath dan panggil 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);

Untuk daftar lengkap kelas dan metode, lihat referensi API.

Edit File Excel di Node.js via REST - Contoh Kode Lengkap

Contoh berikut menunjukkan cara mengedit file Excel di Node.js melalui REST menggunakan 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);
});

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda mengalami masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Perbarui Lembar XLSX Menggunakan REST API di Node.js via cURL

Berikut adalah panduan singkat tentang operasi yang sama menggunakan panggilan HTTP mentah. Ganti nilai placeholder dengan kredensial dan nama file Anda yang sebenarnya.

1. Dapatkan token akses

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"

Respons berisi access_token.

2. Unggah file XLSX sumber

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

3. Edit buku kerja (ubah sel 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. Unduh file yang telah diedit

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

Untuk detail lebih lanjut tentang payload permintaan, lihat dokumentasi API resmi.

Prasyarat dan Penyiapan untuk GroupDocs.Editor Cloud SDK for Node.js

Untuk mulai menggunakan SDK, Anda memerlukan Node.js 14 atau yang lebih baru dan akun GroupDocs Cloud.

npm install groupdocs-editor-cloud

Anda juga dapat mengunduh paket terbaru dari halaman rilis. Setelah instalasi, buat client_id dan client_secret di dasbor GroupDocs Cloud Anda dan simpan dengan aman.

Apa yang Membuat GroupDocs.Editor Cloud SDK for Node.js Ideal untuk Memodifikasi Lembar Kerja Excel

• Full XLSX support - Muat, edit, dan simpan workbook sambil mempertahankan formula, gaya, dan validasi data.
• Cell‑level editing - Akses sel, baris, atau kolom secara individual secara programatik, yang sangat cocok untuk memperbarui laporan atau dasbor.
• Cloud storage integration - Bekerja langsung dengan file yang disimpan di GroupDocs Cloud tanpa mengunduhnya secara lokal.
• Secure REST communication - Semua operasi terjadi melalui HTTPS, dan SDK menangani manajemen token untuk Anda.

Untuk penjelasan lebih mendalam, lihat dokumentasi.

Menyempurnakan Opsi Penyuntingan Excel di GroupDocs.Editor Cloud

SDK menyediakan beberapa opsi yang memungkinkan Anda mengontrol bagaimana workbook yang diedit disimpan.

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

• outputPath - Jalur tujuan di penyimpanan cloud.
• compressionLevel - Kurangi ukuran file untuk buku kerja besar (tersedia di referensi API).
• password - Lindungi file yang dihasilkan dengan kata sandi jika diperlukan.

Sesuaikan pengaturan ini agar sesuai dengan kebutuhan keamanan dan kinerja proyek Anda.

Pertimbangan Kinerja untuk Mengedit Buku Kerja XLSX melalui REST

1. Reuse the configuration object - Membuat Configuration baru untuk setiap permintaan menambah overhead. Simpan satu instance untuk masa hidup aplikasi Anda.
2. Batch cell updates - Jika Anda perlu memodifikasi banyak sel, kumpulkan mereka dalam array dan kirim satu permintaan edit alih-alih beberapa panggilan.
3. Limit worksheet size - Worksheet yang sangat besar meningkatkan konsumsi memori. Pertimbangkan membagi data ke beberapa sheet bila memungkinkan.
4. Avoid unnecessary saves - Hanya panggil saveDocument setelah semua perubahan yang diperlukan diterapkan untuk mengurangi operasi I/O.

Kesimpulan

Mengedit file Excel di Node.js via REST menjadi mudah dengan GroupDocs.Editor Cloud SDK for Node.js. Anda dapat memuat workbook secara programatik, memodifikasi sel, dan menyimpan hasilnya hanya dengan beberapa panggilan API atau perintah cURL sederhana. Arsitektur berbasis cloud SDK menghilangkan kebutuhan akan instalasi Office lokal dan dapat diskalakan sesuai beban kerja aplikasi Anda. Untuk penyebaran produksi, beli lisensi yang sesuai dengan pola penggunaan Anda, dan Anda juga dapat memperoleh lisensi sementara untuk pengujian dari halaman lisensi sementara. Mulailah mengintegrasikan pengeditan Excel hari ini dan sederhanakan pipeline pemrosesan data Anda.

FAQs

Bagaimana cara mengedit file Excel di Node.js melalui REST tanpa menulis kode HTTP khusus?
Gunakan GroupDocs.Editor Cloud SDK for Node.js, yang mengabstraksi panggilan REST dan memungkinkan Anda mengedit file Excel di Node.js melalui REST dengan pemanggilan metode yang sederhana.

Bisakah saya memperbarui lembar XLSX menggunakan REST api Node.js untuk file besar?
Ya. SDK mem‑stream data dan mendukung pembaruan batch, menjadikannya cocok untuk buku kerja besar. Sesuaikan compressionLevel dan perubahan sel batch untuk meningkatkan kinerja.

Apa cara terbaik untuk memodifikasi lembar kerja Excel secara programatis di Node.js?
Gunakan objek worksheet dan cell yang dikembalikan oleh editDocument. Ini memberi Anda kontrol penuh atas baris, kolom, dan nilai sel tanpa meninggalkan lingkungan Node.js.

Di mana saya dapat menemukan informasi harga dan lisensi?
Semua detail lisensi, termasuk tingkatan harga dan lisensi sementara untuk evaluasi, tersedia di halaman lisensi sementara.

Baca Selengkapnya

• Edit Lembar Excel via REST di Java
• Edit Lembar Excel menggunakan REST API di Python
• Praktik Terbaik untuk Pengembangan Editor CSV di Java