Tam Çalışan Örnek: REST ile Node.JS’de PDF’den Açıklama Nesnelerini Kaldırma

Bu örnek, bir PDF’yi nasıl yükleyeceğinizi, tüm ek açıklamalarını nasıl sileceğinizi ve temizlenmiş dosyayı GroupDocs.Annotation SDK kullanarak nasıl indireceğinizi gösterir.

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

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgelere bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile PDF Açıklamaları Silme

Aşağıda, GroupDocs.Annotation Cloud REST uç noktaları aracılığıyla aynı ek açıklama kaldırma iş akışını gerçekleştiren cURL komutları bulunmaktadır.

# 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

Uç noktalar ve parametrelerin tam listesi için, resmi API belgelerine bakın.

PDF’de REST ile Node.JS’de Açıklama Nesnelerini Kaldırma Nasıl Çalışır

1. Kimlik Doğrulama Ayarı - Configuration sınıfı, clientId ve clientSecret değerlerinizle örneklenir ve sonraki tüm API çağrıları için kimliği doğrulanmış bir bağlam oluşturur.

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

2. Dosya Yükleme - UploadFileRequest, yerel PDF baytlarını GroupDocs Cloud depolamasına gönderir. storageApi.uploadFile yöntemi aktarımı gerçekleştirir.

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

3. Ek Açıklamaları Al - GetAnnotationsRequest, bir FileInfo referansı içeren istek nesnesi oluşturur. annotationsApi.getAnnotations çağrısı, ek açıklama nesnelerinden oluşan bir koleksiyon döndürür ve bu koleksiyondan kimlikler çıkarılır.

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

4. Ek Açıklamaları Sil - Eğer herhangi bir kimlik mevcutsa, DeleteAnnotationsRequest doldurulur ve annotationsApi.deleteAnnotations metoduna gönderilir; bu, depolanan PDF’den ek açıklamaları kalıcı olarak kaldırır.

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

5. Temiz PDF’yi İndir - Son olarak, DownloadFileRequest güncellenmiş dosyayı alır ve fs.writeFileSync bu dosyayı yerel dosya sistemine yazar.

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

Detaylı sınıf ve yöntem tanımları için, API referansına bakın.

Kurulum ve Yapılandırma GroupDocs.Annotation Cloud SDK for Node.js

SDK bir npm paketi olarak dağıtılır. Aşağıdaki komutla kurun ve ardından projenizde require edin.

npm install groupdocs-annotation-cloud

En son paketi doğrudan GitHub sürüm sayfasından veya resmi indirme URL’sinden indirebilirsiniz.

Kurulumdan sonra, kütüphaneyi içe aktarın ve kod örneğinde gösterildiği gibi bir yapılandırma nesnesi oluşturun:

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

Çalışma ortamınızın Node.js sürüm gereksinimlerini karşıladığından ve istemci kimlik bilgilerini alabilmek için geçerli bir GroupDocs hesabına sahip olduğunuzdan emin olun.

Açıklama Kaldırma Seçenekleri ve Ayarlar

SDK, ayarlayabileceğiniz çeşitli parametreler sunar:

• clientId / clientSecret - OAuth kim doğrulaması için kimlik bilgileri. Configuration yapıcısında ayarlayın.
• fileInfo.filePath - PDF’in GroupDocs Cloud depolama alanındaki yolu. Dosyaları farklı bir klasörde saklıyorsanız bunu ayarlayın.
• annotationIds - GetAnnotations tarafından döndürülen kimliklerin bir dizisi. Bir alt küme sağlamak, seçici silme olanağı verir.

İstek zaman aşımı ve proxy yapılandırması gibi ek ayarlar SDK belgelerinde mevcuttur; tam liste için resmi belgeler sayfasına bakın.

REST üzerinden PDF Açıklamaları Kaldırma için En İyi Uygulamalar

• Anotasyon Kimliklerini Doğrula - Her zaman silmeyi düşündüğünüz kimliklerin mevcut olduğundan emin olun; var olmayan kimlikleri silmeye çalışmak 404 hatasına neden olabilir.
• HTTPS Kullan - Tüm API çağrıları, kimlik bilgilerinizin ve belge verilerinizin korunması için HTTPS üzerinden yapılmalıdır.
• Büyük Dosyaları Parçalı Yüklemelerle İşleyin - 100 MB’den büyük PDF’ler için, zaman aşımını önlemek amacıyla çok parçalı yükleme uç noktasını tercih edin.
• API Yanıtlarını Günlüğe Kaydet - Denetim izleri ve daha kolay sorun giderme için istek kimliklerini ve yanıtları saklayın.
• Erişim Token’larını Yeniden Kullan - Kimlik doğrulama yükünü azaltmak için OAuth token’ını süresi dolana kadar önbellekte tutun.

Sık Sorulan Sorular

• GroupDocs.Annotation Cloud API ile nasıl kimlik doğrulaması yapabilirim?
  GroupDocs hesabınızdan bir istemci kimliği ve gizli anahtar alın, ardından OAuth uç noktası üzerinden bir erişim belirteci isteyin. Ayrıntılar için resmi belgeleri inceleyin.

• Tümünü silmek yerine belirli yorumları silebilir miyim?
  Evet, silmek istediğiniz yorumların kimliklerini DeleteAnnotationsRequest içinde sağlayın. SDK, bir GetAnnotations çağrısından sonra yorum kimliklerinin listesini döndürür.

• PDF’den Annotation nesnelerini REST ile Node.JS’de nasıl kaldırabilirim?
  Annotation kimliklerini aldıktan sonra DeleteAnnotations uç noktasını çağırmak için GroupDocs.Annotation Cloud SDK for Node.js’i kullanın. Tam iş akışı bu kılavuzun kod örneği ve cURL bölümünde gösterilmiştir.

• Üretim kullanımı için hangi lisans gereklidir?
  Üretim için ücretli bir lisans gereklidir. Değerlendirme sırasında geçici bir lisansı geçici lisans sayfasından alabilirsiniz.

Daha Fazla Okuma

• Node.js’te REST API kullanarak PDF’den Açıklamaları Çıkarma veya Kaldırma
• Node.js ve REST API ile PDF’de Üstü Çizili Metin
• Python’da REST API kullanarak PDF’den Açıklamaları Kaldırma

Node.js üzerinden REST ile Excel Dosyasını Düzenleme - 5 Adımlı Kılavuz

1. SDK’yı kurun ve kimlik bilgilerini yapılandırın: Kütüphanenin GroupDocs Cloud ile kimlik doğrulaması yapabilmesi için CLIENT_ID ve CLIENT_SECRET değerlerinizi ayarlayın.

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. Excel çalışma kitabını düzenleme için yükleyin: EditDocumentRequest kullanarak bulut depolamanızda saklanan dosyayı açın.

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

3. İlk çalışma sayfasını al ve hedef hücreyi bulun: SDK, çalışma sayfaları ve hücreler içeren bir document nesnesi döndürür.

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

4. Hücre değerini güncelleyin veya oluşturun: A1 hücresinin içeriğini değiştirin (var değilse ekleyin).

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. Düzenlenmiş çalışma kitabını depolamaya kaydedin: Bir outputPath sağlayın ve saveDocument metodunu çağırın.

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

Sınıflar ve yöntemlerin tam listesi için, API referansına bakın.

REST üzerinden Node.js ile Excel Dosyasını Düzenleme - Tam Kod Örneği

Aşağıdaki örnek, GroupDocs.Editor Cloud SDK kullanarak REST üzerinden Node.js’te Excel dosyasını nasıl düzenleyeceğinizi gösterir.

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

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğini doğruladığınızdan ve geliştirme ortamınızda kapsamlı bir şekilde test ettiğinizden emin olun. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

Node.js ile cURL üzerinden REST API kullanarak XLSX Sayfasını Güncelle

Aşağıda, aynı işlemi ham HTTP çağrılarıyla hızlı bir şekilde nasıl yapacağınızı gösteren bir yürütme bulunmaktadır. Yer tutucu değerleri gerçek kimlik bilgileriniz ve dosya adlarınızla değiştirin.

1. Erişim belirteci alın

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"

Yanıt access_token içerir.

2. Kaynak XLSX dosyasını yükleyin

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

3. Çalışma kitabını düzenle (A1 hücresini değiştir)

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. Düzenlenmiş dosyayı indirin

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

İstek yükleri hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

Gereksinimler ve Kurulum için GroupDocs.Editor Cloud SDK for Node.js

SDK’yı kullanmaya başlamak için Node.js 14 ve üzeri bir sürüm ve bir GroupDocs Cloud hesabına ihtiyacınız var.

npm install groupdocs-editor-cloud

En son paketi sürüm sayfası üzerinden de indirebilirsiniz. Kurulumdan sonra, GroupDocs Cloud panonuzda bir client_id ve client_secret oluşturun ve güvenli bir şekilde saklayın.

GroupDocs.Editor Cloud SDK for Node.js’i Excel Çalışma Sayfalarını Değiştirmek İçin İdeal Kılan Özellikler

• Tam XLSX desteği - Formülleri, stilleri ve veri doğrulamayı koruyarak çalışma kitaplarını yükleyin, düzenleyin ve kaydedin.
• Hücre‑düzeyinde düzenleme - Bireysel hücrelere, satırlara veya sütunlara programlı olarak erişin; bu raporları veya panoları güncellemek için mükemmeldir.
• Bulut depolama entegrasyonu - Dosyaları doğrudan GroupDocs Cloud’da depolanmış şekilde indirmeden çalışın.
• Güvenli REST iletişimi - Tüm işlemler HTTPS üzerinden gerçekleşir ve SDK sizin için token yönetimini gerçekleştirir.

Daha derin bir inceleme için, belgelere bakın.

GroupDocs.Editor Cloud’da Excel Düzenleme Seçeneklerini İnce Ayarlama

SDK, düzenlenen çalışma kitabının nasıl kaydedileceğini kontrol etmenizi sağlayan çeşitli seçenekler sunar.

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

• outputPath - Bulut depolama alanındaki hedef yol.
• compressionLevel - Büyük çalışma kitapları için dosya boyutunu azaltın (API referansında mevcuttur).
• password - Gerekirse, oluşturulan dosyayı bir şifreyle koruyun.

Bu ayarları, projenizin güvenlik ve performans ihtiyaçlarına uygun şekilde ayarlayın.

REST üzerinden XLSX Çalışma Kitaplarını Düzenleme için Performans Hususları

1. Yapılandırma nesnesini yeniden kullanın - Her istek için yeni bir Configuration oluşturmak ek yük getirir. Uygulamanızın ömrü boyunca tek bir örnek tutun.
2. Hücre güncellemelerini toplu yapın - Birçok hücreyi değiştirmeniz gerekiyorsa, onları bir dizi içinde toplayın ve birden çok çağrı yerine tek bir düzenleme isteği gönderin.
3. Çalışma sayfası boyutunu sınırlayın - Çok büyük çalışma sayfaları bellek tüketimini artırır. Mümkün olduğunda verileri birden çok sayfaya bölmeyi düşünün.
4. Gereksiz kaydetmelerden kaçının - Giriş/çıkış işlemlerini azaltmak için tüm gerekli değişiklikler uygulandıktan sonra saveDocument metodunu çağırın.

Sonuç

Node.js üzerinden REST ile bir Excel dosyasını düzenlemek, GroupDocs.Editor Cloud SDK for Node.js sayesinde çok basit hale gelir. Bir çalışma kitabını programlı olarak yükleyebilir, hücreleri değiştirebilir ve sadece birkaç API çağrısı ya da basit cURL komutlarıyla sonucu kaydedebilirsiniz. SDK’nın bulut‑tabanlı mimarisi, yerel Office kurulumlarına olan ihtiyacı ortadan kaldırır ve uygulamanızın iş yüküyle ölçeklenir. Üretim dağıtımları için kullanım modelinize uygun bir lisans satın alın; ayrıca geçici lisans sayfasından test amaçlı geçici bir lisans da edinebilirsiniz. Excel düzenlemeyi bugün entegre etmeye başlayın ve veri‑işleme hatlarınızı sadeleştirin.

SSS

Node.js üzerinden REST ile özel HTTP kodu yazmadan bir Excel dosyasını nasıl düzenlerim?
GroupDocs.Editor Cloud SDK for Node.js, REST çağrılarını soyutlayan ve basit yöntem çağrılarıyla Node.js üzerinden REST ile Excel dosyasını düzenlemenizi sağlar.

XLSX sayfasını büyük dosyalar için REST api Node.js kullanarak güncelleyebilir miyim?
Evet. SDK veri akışı sağlar ve toplu güncellemeleri destekler, bu da büyük çalışma kitapları için uygundur. Performansı artırmak için compressionLevel ve toplu hücre değişikliklerini ayarlayın.

Excel çalışma sayfasını programlı olarak Node.js’de değiştirmek için en iyi yol nedir?
editDocument tarafından döndürülen worksheet ve cell nesneleriyle çalışın. Bu, Node.js ortamından çıkmadan satırlar, sütunlar ve hücre değerleri üzerinde tam kontrol sağlar.

Fiyatlandırma ve lisans bilgilerini nereden bulabilirim?
Fiyatlandırma katmanları ve değerlendirme için geçici lisans dahil olmak üzere tüm lisans detayları, geçici lisans sayfasında mevcuttur.

Daha Fazla Oku

• Java ile REST üzerinden Excel Sayfasını Düzenleme
• Python ile REST API kullanarak Excel Sayfasını Düzenleme
• Java’da CSV Düzenleyici Geliştirme için En İyi Uygulamalar