ویرایش و مدیریت متاداده در برنامه‌های Node.js

مدیریت متا دیتا بخش مهمی از اتوماسیون اسناد است، به ویژه برای برنامه هایی که با فرمت های مختلف سند کار می کنند. در این مقاله، ما به بررسی اینکه چگونه متا دیتا را در برنامه های Node.js مدیریت کنیم، خواهیم پرداخت، با تمرکز بر استخراج، تغییر و حذف متا دیتا.

در این راهنما، ما به بررسی بخش‌های زیر خواهیم پرداخت:

GroupDocs.Metadata چیست و چگونه کمک می کند؟
How to install
راهنمای شروع سریع
ویژگی‌های کلیدی
موارد استفاده رایج
شروع کار با یک آزمایش رایگان
See Also

What is GroupDocs.Metadata and how it helps?

GroupDocs.Metadata for Node.js یک کتابخانه است که به توسعه‌دهندگان کمک می‌کند، متاداده را در قالب‌های مختلف اسناد در برنامه‌های Node.js مدیریت کنند.

با اینکه روش‌های بومی وجود دارد که به توسعه‌دهندگان Node.js اجازه می‌دهد تا متاداده‌های پایه‌ای مانند اندازه فایل، نوع و ویژگی‌ها را استخراج کنند، این روش‌ها شامل متاداده‌های پیچیده‌تری که با فرمت‌های خاص فایل مرتبط هستند، نمی‌شوند.

GroupDocs.Metadata این خلأ را با اجازه دادن به کاربران برای بازیابی، به‌روز‌رسانی و حذف متا‌داده از فایل‌هایی مانند PDFها، فرمت‌های مایکروسافت آفیس، تصاویر، صدا، ویدئو و بسیاری دیگر پر می‌کند. همچنین دسترسی به اطلاعات دقیقی مانند نویسنده، عنوان، ویژگی‌های خاص فرمت‌های فایل، از جمله داده‌های موقعیت جغرافیایی GPS و بسیاری دیگر را امکان‌پذیر می‌سازد. با یک API ساده، GroupDocs.Metadata به شما این امکان را می‌دهد که متا‌داده را به طور مؤثر دستکاری کنید تا بسیاری از سناریوهای اتوماسیون مستندات و پردازش داده را پوشش دهد.

چگونه نصب کنیم

GroupDocs.Metadata for Node.js via Java در NPM میزبانی می‌شود. شما می‌توانید به راحتی API ما را در پروژه Node.js خود با نصب آن با استفاده از دستور زیر ارجاع دهید:

npm install @groupdocs/groupdocs.metadata

راهنمای شروع سریع

Getting started with GroupDocs.Metadata for Node.js is quick and straightforward with our examples project. Here’s a simple guide to help you set up:

کلون کردن مخزن: مخزن مثال را به کامپیوتر محلی خود کلون کنید.
```
git clone https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java.git
```

به پوشه مثال‌ها بروید:

cd ./GroupDocs.Metadata-for-Node.js-via-Java/

نصب بسته‌های ضروری:
```
npm install   
```
Run the Examples:
```
node runExamples.js 
```

این یک سری اسکریپت‌های نمونه را اجرا می‌کند که عملکردهای مختلف کتابخانه GroupDocs.Metadata را نشان می‌دهد.

ویژگی های کلیدی

GroupDocs.Metadata for Node.js دارای طیفی از ویژگی‌ها است که آن را به یک API مفید برای توسعه‌دهندگان در مواجهه با فراداده‌های مدارک تبدیل می‌کند. در اینجا چند ویژگی کلیدی آورده شده است:

مجموعه غنی از ویژگی‌های مدیریت متادیتا: خواندن، به‌روزرسانی و حذف متادیتا از فرمت‌های مختلف مدارک.
مدیریت هدفمند ویژگی: جستجو، به‌روزرسانی و حذف ویژگی‌های metadata خاص که معیارهای معینی را برآورده می‌کنند.
مدیریت املاک یکپارچه: از تگ‌ها برای دسترسی آسان به ویژگی‌های متادیتای مشترک به شکلی یکسان استفاده کنید.
پشتیبانی از اسناد محافظت‌شده با رمز عبور: با اسنادی کار کنید که ایمن شده‌اند و حتی با داده‌های حساس انعطاف‌پذیری را تضمین کنید.
بینش درباره ویژگی‌های سند: اطلاعات دقیق در مورد صفحات پنهان، امضاهای دیجیتال، نظرات کاربران، بازنگری‌ها و بیشتر استخراج کنید.
تطابق با استانداردهای محبوب: با استانداردهای فراداده پیشرو مانند IPTC، XMP، EXIF و Image Resources کار کنید.
مدیریت متاداده چندرسانه‌ای: دستکاری خواص متاداده بومی در فرمت‌های مختلف و استخراج اطلاعات فنی از فایل‌های چندرسانه‌ای.
محاسبه آمار سند: آمار متداول سندها مانند شمارش کلمات و شمارش کاراکترها را برای اسناد خود محاسبه کنید.
تشخیص فرمت فایل: شناسایی فرمت و نوع MIME یک فایل بر اساس ساختار داخلی آن.
Support for Audio Tags: Manage various audio tags, including ID3, Lyrics, and APE.

موارد رایج استفاده

در زیر برخی از موارد استفاده رایج برای GroupDocs.Metadata در برنامه‌های Node.js ذکر شده است، به همراه کدهای مربوطه.

مورد استفاده ۱: بازیابی متادیتا از یک تصویر

در این مثال، ما خواص فراداده یک فایل تصویری (به عنوان مثال، image.png) را بر اساس معیارهای خاصی بازیابی خواهیم کرد.

مقداردهی اولیه آبجکت متا دیتا: یک نمونه جدید از کلاس متا دیتا را با فایل خود ایجاد کنید.
تعریف معیار جستجو: از یک مشخصه جستجو برای پیدا کردن خواص خاص، مانند “عرض” یا “ارتفاع” استفاده کنید.
متا داده‌ها را بازیابی و نمایش دهید: خواص مطابقت را بازیابی کرده و نام‌ها و مقادیر آن‌ها را ثبت کنید.

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

Use Case 2: پاک کردن متادیتا از یک سند

در اینجا ما متاداده‌های ناخواسته را از یک سند PDF پاک خواهیم کرد.

فایل PDF را بارگذاری کنید: یک شیء متادیتا برای فایل PDF ایجاد کنید.
Sanitize Metadata: Remove detected metadata packages.
Save the Cleaned Document: Save the sanitized document to a new file.

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

Use Case 3: به‌روز رسانی فراداده مستند

این مثال به شما نشان می‌دهد که چگونه تاریخ‌های ایجاد و ویرایش یک سند را به‌روزرسانی کنید.

Load the Document: Initialize a Metadata object for the document file.
Set New Properties: Update the creation and modification dates of the document.
ذخیره سند به‌روز شده: تغییرات را در فایل ذخیره کنید.

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 را برای Node.js از طریق Java از GroupDocs Releases page دانلود کنید.

علاوه بر این، می‌توانید یک مجوز موقت از این لینک دریافت کنید. مجوز موقت به شما اجازه می‌دهد تا از کتابخانه بدون هیچ محدودیتی استفاده کرده و قابلیت‌های آن را به‌طور کامل بررسی کنید.

به علاوه

برای بررسی عمیق‌تر و کسب اطلاعات بیشتر در مورد GroupDocs.Metadata و عملکردهای آن، به منابع زیر مراجعه کنید:

What is GroupDocs.Metadata and how it helps?#

چگونه نصب کنیم#

راهنمای شروع سریع#

ویژگی های کلیدی#

موارد رایج استفاده#

مورد استفاده ۱: بازیابی متادیتا از یک تصویر#

Use Case 2: پاک کردن متادیتا از یک سند#

Use Case 3: به‌روز رسانی فراداده مستند#

آغاز کار با دوره آزمایشی رایگان#

به علاوه#