مثال عملي كامل لإزالة كائنات التعليقات التوضيحية من PDF باستخدام REST في Node.JS

يوضح هذا المثال كيفية تحميل ملف PDF، حذف جميع التعليقات التوضيحية الخاصة به، وتنزيل الملف المنظف باستخدام 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}`);
})();

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث أي مسارات ملفات وقيم التكوين لتتناسب مع بيئتك الفعلية، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

حذف تعليقات PDF عبر REST API باستخدام cURL

فيما يلي أوامر cURL التي تنفّذ نفس سير عمل إزالة التعليقات التوضيحية عبر نقاط النهاية REST لسحابة GroupDocs.Annotation.

# 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

للحصول على قائمة كاملة بنقاط النهاية والمعلمات، راجع وثائق API الرسمية.

كيف تعمل إزالة كائنات التعليقات التوضيحية من PDF باستخدام REST في Node.JS

1. إعداد المصادقة - يتم إنشاء فئة Configuration باستخدام clientId و clientSecret الخاصين بك، مما ينشئ سياقًا موثوقًا لجميع استدعاءات API اللاحقة.

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

2. رفع الملف - يرسل UploadFileRequest بايتات ملف PDF المحلي إلى تخزين GroupDocs Cloud. تتولى طريقة storageApi.uploadFile عملية النقل.

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

3. استرجاع التعليقات التوضيحية - يبني GetAnnotationsRequest كائن طلب يحتوي على مرجع FileInfo. تُعيد استدعاء annotationsApi.getAnnotations مجموعة من كائنات التعليقات التوضيحية، يتم استخراج المعرفات منها.

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

4. حذف التعليقات التوضيحية - إذا كانت هناك أي معرفات، يتم ملء DeleteAnnotationsRequest وتمريره إلى annotationsApi.deleteAnnotations، الذي يزيل التعليقات التوضيحية بشكل دائم من ملف PDF المخزن.

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

5. تنزيل ملف PDF نظيف - أخيرًا، يقوم DownloadFileRequest بجلب الملف المحدث، وتكتب fs.writeFileSyncه إلى نظام الملفات المحلي.

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

للحصول على تعريفات مفصلة للفئات والطرق، راجع مرجع API.

التثبيت والتهيئة GroupDocs.Annotation Cloud SDK for Node.js

يتم توزيع SDK كحزمة npm. قم بتثبيتها باستخدام الأمر أدناه ثم استخدم require في مشروعك.

npm install groupdocs-annotation-cloud

يمكنك أيضًا تنزيل أحدث حزمة مباشرةً من صفحة إصدارات GitHub أو من عنوان URL للتنزيل.

بعد التثبيت، استورد المكتبة وأنشئ كائن التكوين كما هو موضح في مثال الشيفرة التالي:

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

تأكد من أن بيئة التشغيل الخاصة بك تلبي متطلبات إصدار Node.js وأن لديك حساب GroupDocs صالح للحصول على بيانات اعتماد العميل.

خيارات وإعدادات إزالة التعليقات التوضيحية

يعرض SDK عدة معلمات يمكنك ضبطها:

• clientId / clientSecret - بيانات الاعتماد لمصادقة OAuth. قم بتعيينها في مُنشئ Configuration.
• fileInfo.filePath - مسار ملف PDF في تخزين GroupDocs Cloud. عدّل ذلك إذا كنت تخزن الملفات في مجلد مختلف.
• annotationIds - مصفوفة من المعرفات التي تم إرجاعها بواسطة GetAnnotations. توفير مجموعة فرعية يسمح بالحذف الانتقائي.

الإعدادات الإضافية مثل مهلات الطلب وتكوين الوكيل متاحة في وثائق SDK؛ راجع الوثائق الرسمية للحصول على القائمة الكاملة.

أفضل الممارسات لإزالة تعليقات PDF عبر REST

• تحقق من معرفات التعليقات التوضيحية - دائمًا تحقق من أن المعرفات التي تنوي حذفها موجودة؛ محاولة حذف معرفات غير موجودة قد تتسبب في حدوث خطأ 404.
• استخدام HTTPS - يجب إجراء جميع مكالمات API عبر HTTPS لحماية بيانات الاعتماد وبيانات المستند.
• معالجة الملفات الكبيرة باستخدام التحميل المجزأ - بالنسبة لملفات PDF التي يزيد حجمها عن 100 ميغابايت، يفضَّل استخدام نقطة النهاية للتحميل المتعدد لتجنب انتهاء المهلة.
• تسجيل استجابات API - احفظ معرفات الطلبات والاستجابات لسجلات التدقيق وتسهيل استكشاف الأخطاء.
• إعادة استخدام رموز الوصول - خزن رمز OAuth في الذاكرة المؤقتة حتى انتهاء صلاحيته لتقليل عبء المصادقة.

الأسئلة الشائعة

• كيف يمكنني المصادقة مع GroupDocs.Annotation Cloud API? احصل على معرف عميل وسر من حسابك في GroupDocs، ثم اطلب رمز وصول عبر نقطة النهاية OAuth. راجع الوثائق الرسمية للحصول على التفاصيل.

• هل يمكنني حذف تعليقات توضيحية محددة بدلاً من جميعها؟
  نعم، قدم معرفات التعليقات التوضيحية التي تريد إزالتها في DeleteAnnotationsRequest. تُعيد SDK قائمة بمعرفات التعليقات التوضيحية بعد استدعاء GetAnnotations.

• كيف يمكنني إزالة كائنات التعليق التوضيحي من PDF باستخدام REST في Node.JS؟
  استخدم GroupDocs.Annotation Cloud SDK for Node.js لاستدعاء نقطة النهاية DeleteAnnotations بعد استرجاع معرفات التعليقات التوضيحية. يتم عرض سير العمل الكامل في مثال الشيفرة وقسم cURL في هذا الدليل.

• ما هو الترخيص المطلوب للاستخدام في الإنتاج؟
  يلزم الحصول على ترخيص مدفوع للإنتاج. يمكنك الحصول على ترخيص مؤقت من صفحة صفحة الترخيص المؤقت أثناء التقييم.

قراءة إضافية

• استخراج أو إزالة التعليقات التوضيحية من PDF باستخدام REST API في Node.js
• نص مشطوب في PDF باستخدام Node.js و REST API
• إزالة التعليقات التوضيحية من PDF باستخدام REST API في Python

تحرير ملف Excel في Node.js عبر REST - دليل من 5 خطوات

1. تثبيت SDK وتكوين بيانات الاعتماد: قم بتعيين CLIENT_ID و CLIENT_SECRET حتى يتمكن المكتبة من المصادقة مع 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. تحميل دفتر عمل Excel للتحرير: استخدم EditDocumentRequest لفتح الملف المخزن في سحابة التخزين الخاصة بك.

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

3. استرجاع ورقة العمل الأولى وتحديد الخلية المستهدفة: تُعيد مجموعة تطوير البرمجيات (SDK) كائن document يحتوي على أوراق العمل والخلايا.

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

4. تحديث أو إنشاء قيمة الخلية: تغيير محتوى الخلية A1 (أو إضافتها إذا لم تكن موجودة).

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. احفظ المصنف المعدل مرة أخرى في التخزين: قدم outputPath واستدعِ 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);

للحصول على قائمة كاملة بالفئات والطرق، راجع مرجع API.

تحرير ملف Excel في Node.js عبر REST - مثال كامل للكود

يوضح المثال التالي كيفية تحرير ملف Excel في Node.js عبر REST باستخدام 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);
});

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث أي مسارات ملفات وقيم التكوين لتتناسب مع بيئتك الفعلية، وتحقق من تثبيت جميع الاعتمادات المطلوبة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحديث ورقة XLSX باستخدام REST API في Node.js عبر cURL

فيما يلي دليل سريع للعملية نفسها باستخدام استدعاءات HTTP الخام. استبدل القيم النائبة ببيانات الاعتماد الفعلية وأسماء الملفات الخاصة بك.

1. الحصول على رمز وصول

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"

الاستجابة تحتوي على access_token.

2. تحميل ملف 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. تحرير دفتر العمل (تعديل الخلية 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. تنزيل الملف المعدل

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

لمزيد من التفاصيل حول حمولة الطلبات، راجع الوثائق الرسمية لواجهة برمجة التطبيقات.

المتطلبات والإعداد لـ GroupDocs.Editor Cloud SDK for Node.js

لبدء استخدام SDK، تحتاج إلى Node.js 14 أو أحدث وحساب GroupDocs Cloud.

npm install groupdocs-editor-cloud

يمكنك أيضًا تنزيل أحدث حزمة من صفحة الإصدار. بعد التثبيت، أنشئ client_id و client_secret في لوحة تحكم GroupDocs Cloud الخاصة بك واحفظهما بأمان.

ما الذي يجعل GroupDocs.Editor Cloud SDK for Node.js مثالياً لتعديل أوراق عمل Excel

• دعم كامل لـ XLSX - تحميل، تعديل، وحفظ دفاتر العمل مع الحفاظ على الصيغ، الأنماط، والتحقق من صحة البيانات.
• تحرير على مستوى الخلية - الوصول إلى خلايا، صفوف، أو أعمدة فردية برمجياً، وهو مثالي لتحديث التقارير أو لوحات المعلومات.
• تكامل تخزين السحابة - العمل مباشرةً مع الملفات المخزنة في GroupDocs Cloud دون تنزيلها محلياً.
• اتصال REST آمن - جميع العمليات تتم عبر HTTPS، ويتولى SDK إدارة الرموز المميزة لك.

للحصول على مزيد من التفاصيل، راجع الوثائق.

تحسين خيارات تحرير Excel في GroupDocs.Editor Cloud

يُظهر SDK عدة خيارات تتيح لك التحكم في كيفية حفظ المصنف المُعدَّل.

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

• outputPath - مسار الوجهة في التخزين السحابي.
• compressionLevel - تقليل حجم الملف لأوراق العمل الكبيرة (متاح في مرجع API).
• password - حماية الملف الناتج بكلمة مرور إذا لزم الأمر.

قم بضبط هذه الإعدادات لتتناسب مع احتياجات الأمان والأداء لمشروعك.

اعتبارات الأداء عند تحرير دفاتر عمل XLSX عبر REST

1. إعادة استخدام كائن التكوين - إنشاء Configuration جديد لكل طلب يضيف عبئًا. احتفظ بنسخة واحدة طوال عمر تطبيقك.
2. تحديث الخلايا على دفعات - إذا كنت بحاجة إلى تعديل العديد من الخلايا، اجمعها في مصفوفة وأرسل طلب تعديل واحد بدلاً من عدة استدعاءات.
3. تقليل حجم ورقة العمل - الأوراق الكبيرة جدًا تزيد من استهلاك الذاكرة. فكر في تقسيم البيانات عبر عدة أوراق عندما يكون ذلك ممكنًا.
4. تجنب عمليات الحفظ غير الضرورية - استدعِ saveDocument فقط بعد تطبيق جميع التغييرات المطلوبة لتقليل عمليات الإدخال/الإخراج.

الخلاصة

تحرير ملف Excel في Node.js عبر REST يصبح بسيطًا مع GroupDocs.Editor Cloud SDK for Node.js. يمكنك برمجيًا تحميل دفتر عمل، تعديل الخلايا، وحفظ النتيجة باستخدام عدد قليل فقط من استدعاءات API أو أوامر cURL بسيطة. تُلغي بنية SDK السحابية الحاجة إلى تثبيتات Office محلية وتتكيف مع عبء عمل تطبيقك. بالنسبة للنشر في بيئات الإنتاج، اشترِ ترخيصًا يتناسب مع نمط الاستخدام الخاص بك، ويمكنك أيضًا الحصول على ترخيص مؤقت للاختبار من صفحة الترخيص المؤقت. ابدأ بدمج تحرير Excel اليوم وسهّل خطوط معالجة البيانات الخاصة بك.

الأسئلة الشائعة

كيف يمكنني تعديل ملف Excel في Node.js عبر REST دون كتابة كود HTTP مخصص؟
استخدم GroupDocs.Editor Cloud SDK for Node.js، الذي يُجرد استدعاءات REST ويسمح لك بتعديل ملف Excel في Node.js عبر REST باستخدام استدعاءات طرق بسيطة.

هل يمكنني تحديث ورقة XLSX باستخدام REST api Node.js للملفات الكبيرة؟
نعم. يقوم SDK ببث البيانات ويدعم التحديثات الدفعية، مما يجعله مناسبًا للدفاتر الكبيرة. اضبط compressionLevel وتغييرات الخلايا الدفعية لتحسين الأداء.

ما هي أفضل طريقة لتعديل ورقة عمل Excel برمجيًا باستخدام Node.js؟
اعمل مع كائنات worksheet و cell التي تُرجعها الدالة editDocument. هذا يمنحك التحكم الكامل في الصفوف والأعمدة وقيم الخلايا دون مغادرة بيئة Node.js.

أين يمكنني العثور على معلومات التسعير والترخيص؟
جميع تفاصيل الترخيص، بما في ذلك مستويات التسعير ورخصة مؤقتة للتقييم، متاحة على صفحة الرخصة المؤقتة.

اقرأ المزيد

• تحرير ورقة Excel عبر REST في Java
• تحرير ورقة Excel باستخدام REST API في Python
• أفضل الممارسات لتطوير محرر CSV في Java