إدارة بيانات التعريف في Node.js

إدارة البيانات الوصفية هي جزء مهم من أتمتة الوثائق، خاصة للتطبيقات التي تعمل مع أنواع مختلفة من الوثائق. في هذه المقالة، سنلقي نظرة على كيفية إدارة البيانات الوصفية في تطبيقات Node.js، مع التركيز على استخراج وتعديل وإزالة البيانات الوصفية.

في هذا الدليل، سوف نستكشف الأقسام التالية:

  1. ما هو GroupDocs.Metadata وكيف يساعد؟
  2. كيفية التثبيت
  3. دليل البدء السريع
  4. ميزات رئيسية
  5. حالات الاستخدام الشائعة
  6. Getting Started with a Free Trial
  7. شاهد أيضاً

What is GroupDocs.Metadata and how it helps?

GroupDocs.Metadata for Node.js هو مكتبة تساعد المطورين على إدارة البيانات الوصفية عبر تنسيقات الوثائق المختلفة في تطبيقات Node.js.

على الرغم من وجود طرق أصلية تتيح لمطوري Node.js استخراج بيانات وصفية أساسية مثل حجم الملف ونوعه وسماته، إلا أن هذه الطرق لا تغطي البيانات الوصفية الأكثر تعقيدًا المرتبطة بأشكال الملفات المحددة.

يملأ GroupDocs.Metadata هذه الفجوة من خلال السماح للمستخدمين باسترجاع وتحديث وإزالة البيانات الوصفية من الملفات مثل PDF ، وصيغ Microsoft Office ، والصور ، والصوت ، والفيديو والعديد من الملفات الأخرى. كما أنه يتيح الوصول إلى معلومات مفصلة مثل المؤلف والعنوان وخصائص محددة من صيغ الملفات ، بما في ذلك بيانات موقع GPS ، والعديد من الأمور الأخرى. مع واجهة برمجة التطبيقات البسيطة ، يسمح لك GroupDocs.Metadata بالتلاعب بالبيانات الوصفية بفعالية لتغطية العديد من سيناريوهات أتمتة الوثائق ومعالجة البيانات.

كيفية التثبيت

GroupDocs.Metadata for Node.js via Java هو مستضاف على NPM. يمكنك بسهولة الإشارة إلى واجهة برمجة التطبيقات الخاصة بنا في مشروع Node.js الخاص بك عن طريق تثبيته باستخدام الأمر التالي:

npm install @groupdocs/groupdocs.metadata

دليل البدء السريع

Getting started with GroupDocs.Metadata for Node.js is quick and straightforward with our examples project. إليك دليل بسيط لمساعدتك في الإعداد:

  1. استنساخ المستودع: استنساخ المستودع التجريبي إلى جهازك المحلي.

    git clone https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java.git
    
  2. انتقل إلى مجلد الأمثلة:

    cd ./GroupDocs.Metadata-for-Node.js-via-Java/
    
  3. تثبيت الحزم الضرورية:

    npm install   
    
  4. تشغيل الأمثلة:

    node runExamples.js 
    

سيقوم هذا بتنفيذ سلسلة من سكريبتات المثال التي توضح وظائف مختلفة لمكتبة GroupDocs.Metadata.

الميزات الرئيسية

GroupDocs.Metadata for Node.js مزود بمجموعة من الميزات التي تجعله واجهة برمجة تطبيقات مفيدة للمطورين الذين يتعاملون مع بيانات التعريف الخاصة بالمستندات. إليك بعض الميزات الرئيسية:

  • مجموعة غنية من ميزات إدارة البيانات الوصفية: قراءة، تحديث، وإزالة البيانات الوصفية من تنسيقات المستندات المختلفة.
  • تلاعب مستهدف بالخصائص: البحث، التحديث، وحذف خصائص البيانات الوصفية المحددة التي تستوفي معايير معينة.
  • إدارة الممتلكات الموحدة: استخدم العلامات لتسهيل التعامل مع خصائص البيانات الوصفية الشائعة بطريقة متسقة.
  • الدعم للمستندات المحمية بكلمة مرور: العمل مع المستندات التي تم تأمينها، مما يضمن المرونة حتى مع البيانات الحساسة.
  • نظرة ثاقبة على خصائص الوثيقة: استخراج معلومات مفصلة حول الصفحات المخفية، التوقيعات الرقمية، تعليقات المستخدم، التعديلات، والمزيد.
  • التوافق مع المعايير الشائعة: العمل مع معايير البيانات الوصفية الرائدة مثل IPTC، XMP، EXIF، و Image Resources.
  • معالجة بيانات التعريف المتعددة الوسائط: التلاعب بخصائص بيانات التعريف الأصلية في تنسيقات متنوعة واستخراج المعلومات التقنية من ملفات الوسائط المتعددة.
  • حساب إحصائيات الوثائق: احسب إحصائيات الوثائق الشائعة مثل عدد الكلمات وعدد الأحرف لوثائقك.
  • اكتشاف تنسيق الملف: تحديد التنسيق ونوع MIME لملف بناءً على هيكله الداخلي.
  • دعم لعلامات الصوت: إدارة علامات الصوت المختلفة، بما في ذلك ID3، و كلمات الأغاني، و APE.

حالات الاستخدام الشائعة

فيما يلي بعض حالات الاستخدام الشائعة لـ GroupDocs.Metadata في تطبيقات Node.js، جنبًا إلى جنب مع مقتطفات التعليمات البرمجية المقابلة.

حالة الاستخدام 1: استرجاع البيانات الوصفية من صورة

في هذا المثال، سنقوم بجلب خصائص البيانات الوصفية لملف صورة (على سبيل المثال، image.png) بناءً على معايير محددة.

  1. تهيئة كائن الميتاداتا: أنشئ مثيلًا جديدًا من فئة الميتاداتا باستخدام ملفك.
  2. حدد معايير البحث: استخدم مواصفات البحث للعثور على خصائص معينة، مثل “العرض” أو “الارتفاع”.
  3. استرجع وعرض البيانات الوصفية: استرجع الخصائص المتطابقة وسجل أسمائها وقيمها.
const groupdocsMetadata = require('@groupdocs/groupdocs.metadata');

try {
    // Initialize the Metadata object with the image file
    const metadata = new groupdocsMetadata.Metadata("image.png");

    // Fetch properties based on name criteria: Width or Height
    var searchSpecification = new groupdocsMetadata.WithNameSpecification("Width")
        .or(new groupdocsMetadata.WithNameSpecification("Height"));
    var metadataProperties = metadata.findProperties(searchSpecification);

    console.log(`Total found properties#: ${metadataProperties.getCount()}`);    

    // Iterate and log all found properties
   for (var i = 0; i < metadataProperties.getCount(); i++) {
        console.log(`Property name: ${metadataProperties.get_Item(i).getName()}, 
        Property value: ${metadataProperties.get_Item(i).getValue()}`);
    }
} catch (error) {
    console.error('An error:', error);
}

حالة الاستخدام 2: تنظيف البيانات الوصفية من مستند

هنا سنقوم بتنظيف البيانات الوصفية غير المرغوب فيها من مستند PDF.

  1. قم بتحميل ملف PDF: أنشئ كائن بيانات التعريف لملف PDF.
  2. تنظيف البيانات الوصفية: إزالة حزم البيانات الوصفية المكتشفة.
  3. احتفظ بالمستند المنظف: احفظ المستند المعقم في ملف جديد.
try {
    // Load the PDF file
    const metadata = new groupdocsMetadata.Metadata("input.pdf");

    // Remove detected metadata packages and log the properties removed
    var affected = metadata.sanitize();
    console.log(`Properties removed: ${affected}`);

    // Save the cleaned PDF
    metadata.save("cleaned_output.pdf");
} catch (error) {
    console.error('An error occurred during the sanitization:', error);
}

حالة الاستخدام 3: تحديث بيانات الوثيقة

سيظهر لك هذا المثال كيفية تحديث تواريخ الإنشاء والتعديل لمستند.

  1. قم بتحميل المستند: قم بتهيئة كائن بيانات التعريف لملف المستند.
  2. Set New Properties: Update the creation and modification dates of the document.
  3. احفظ المستند المحدث: احفظ التغييرات في الملف.
try {
    // Load the VSDX file
    const metadata = new groupdocsMetadata.Metadata("input.vsdx");

    // Set the current date for creation and modification properties
    var affected = metadata.setProperties(
        new groupdocsMetadata.ContainsTagSpecification(
                groupdocsMetadata.Tags.getTime().getCreated())
            .or(new groupdocsMetadata.ContainsTagSpecification(
                groupdocsMetadata.Tags.getTime().getModified())),
        new groupdocsMetadata.PropertyValue(new Date())
    );

    console.log(`Properties set: ${affected}`);

    // Save the updated VSDX
    metadata.save("updated_output.vsdx");
} catch (error) {
    console.error('An error occurred:', error);
}

البدء مع تجربة مجانية

بشكل افتراضي، تعمل المكتبة في وضع تجريبي بدون ترخيص، مما يتيح لك استكشاف ميزاتها ووظائفها الأساسية. يمكنك تنزيل GroupDocs.Metadata for Node.js عبر Java من صفحة GroupDocs Releases page.

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

انظر أيضًا

للتعمق أكثر والحصول على مزيد من الأفكار حول GroupDocs.Metadata ووظائفه، يرجى الرجوع إلى الموارد التالية: