ویرایش متادیتا فایل‌های PDF با استفاده از REST API در سی شارپ

فراداده سند بخشی از اطلاعات مربوط به سند مانند نویسنده، زمان ویرایش و غیره است که در یک سند ذخیره می شود. به عنوان یک توسعه دهنده سی شارپ، می توانید به راحتی اطلاعات فراداده اسناد PDF را به صورت برنامه نویسی در فضای ابری ویرایش کنید. در این مقاله یاد می گیرید که چگونه Metadata فایل های PDF را با استفاده از REST API در سی شارپ ویرایش کنید.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

Document Metadata Manipulation REST API و NET SDK
ابرداده اسناد PDF را با استفاده از REST API ویرایش کنید

Document Metadata Manipulation REST API و NET SDK

برای ویرایش ابرداده یک سند PDF، من از .NET SDK of GroupDocs.Metadata Cloud API استفاده خواهم کرد. این به شما امکان می دهد که تقریباً از تمام فرمت های فایل استاندارد صنعتی، متادیتا را اضافه، ویرایش، بازیابی و حذف کنید. شما می توانید چنین عملیاتی را بر روی PDF، Microsoft Word، صفحات گسترده Excel، ارائه های پاورپوینت، ایمیل های Outlook، Visio، OneNote، Project، صدا، ویدئو، اتوکد، آرشیو، JPEG، BMP، PNG و TIFF انجام دهید. همچنین جاوا SDK را به عنوان [اعضای خانواده دستکاری فراداده سند3 برای Cloud API ارائه می‌کند.

می‌توانید GroupDocs.Metadata Cloud SDK را برای .NET در پروژه ویژوال استودیو خود از طریق NuGet Package manager نصب کنید.

از طریق NuGet Package Manager، GroupDocs.Metadata Cloud را نصب کنید

همچنین می توانید بسته NuGet را با استفاده از دستور زیر در کنسول Package Manager نصب کنید:

Install-Package GroupDocs.Metadata-Cloud

لطفاً قبل از شروع به دنبال کردن مراحل و نمونه کدهای موجود، شناسه مشتری و راز مشتری خود را از داشبورد دریافت کنید. هنگامی که شناسه مشتری و Secret خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:

string clientID = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string myStorage = "";

Configuration configuration = new Configuration(clientID, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

ویرایش متادیتا فایل های PDF با استفاده از REST API در سی شارپ

با دنبال کردن مراحل ساده زیر می توانید متادیتا اسناد PDF را تنظیم کنید:

آپلود فایل PDF را در Cloud
به‌روزرسانی فراداده اسناد PDF با استفاده از C#
دانلود فایل حاصل

سند را آپلود کنید

ابتدا فایل PDF را با استفاده از نمونه کد زیر در Cloud آپلود کنید:

# مقداردهی اولیه api
FileApi fileApi = new FileApi(configuration);
string path = @"C:\Files";

var file = Directory.GetFiles(path, "input.pdf", SearchOption.AllDirectories).FirstOrDefault();
if (file.Length != 0)
{
    var relativeFilePath = file.Replace(path, string.Empty).Trim(Path.DirectorySeparatorChar);

    var fileStream = File.Open(file, FileMode.Open);

    fileApi.UploadFile(new UploadFileRequest(relativeFilePath, fileStream, myStorage));
    fileStream.Close();
}

در نتیجه، فایل PDF آپلود شده (input.pdf) در بخش فایل ها داشبورد شما در فضای ابری در دسترس خواهد بود.

به روز رسانی متادیتا فایل های PDF با استفاده از سی شارپ

با دنبال کردن مراحل زیر می‌توانید ابرداده یک فایل PDF را به‌صورت برنامه‌نویسی به‌روزرسانی کنید.

یک نمونه از MetadataApi ایجاد کنید
مسیر فایل PDF را در مدل FileInfo تنظیم کنید
SetOptions را تعریف کنید
NewValue و Type را برای SetPropert ارائه دهید
SearchCriteria را تعریف کنید، NameOptions را برای به‌روزرسانی مقدار ارائه دهید
SetRequest را با SetOptions ایجاد کنید
با فراخوانی متد MetadataApi.Set() به نتیجه برسید

نمونه کد زیر نحوه تنظیم فراداده بر اساس نام ویژگی یک سند PDF را با استفاده از REST API نشان می دهد.

# مقداردهی اولیه api
var apiInstance = new MetadataApi(configuration);

try
{
    var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
    {
        FilePath = "input.pdf",
        StorageName = myStorage
    };
    
    // گزینه های تنظیم را تعریف کنید
    var options = new SetOptions
    {
        FileInfo = fileInfo,
        Properties = new List<SetProperty>
        {
            new SetProperty
            {
                NewValue = "hello",
                Type = "String",
                SearchCriteria = new SearchCriteria
                {
                    NameOptions = new NameOptions
                    {
                        Value = "Keywords"
                    }
                },
            }
        }
    };
    
    // تعریف Set Request
    var request = new SetRequest(options);

    var response = apiInstance.Set(request);
    Console.WriteLine($"Count of changes: {response.SetCount}");
    Console.WriteLine("Resultant file path: " + response.Path);
}
catch (Exception e)
{
    Console.WriteLine("Exception while calling MetadataApi: " + e.Message);
}

ویرایش متادیتا اسناد PDF با استفاده از REST API در سی شارپ — متادیتا را بر اساس نام ویژگی تنظیم کنید

قطعه کد زیر نحوه تطبیق نام دقیق ویژگی را با تنظیم ویژگی ExactPhrase روی True نشان می دهد:

# مقداردهی اولیه api
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// Set Options را تعریف کنید
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "This is title",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                NameOptions = new NameOptions
                {
                    Value = "Title",
                    MatchOptions = new MatchOptions
                    {
                        ExactPhrase = true
                    }
                }
            },
        }
    }
};

// تعریف Set Request
var request = new SetRequest(options);

var response = apiInstance.Set(request);

با استفاده از REST API در سی شارپ، متادیتا را با تطبیق نام دقیق ویژگی در اسناد PDF ویرایش کنید. — متادیتا را با تطبیق نام دقیق مشخصه تنظیم کنید

قطعه کد زیر نحوه تعریف معیارهای جستجو را با استفاده از عبارات منظم برای ارائه MatchOptions نشان می دهد:

# مقداردهی اولیه api
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// گزینه های تنظیم را تعریف کنید
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "new value",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                NameOptions = new NameOptions
                {
                    Value = "^Tit.*",
                    MatchOptions = new MatchOptions
                    {
                        IsRegex = true
                    }
                }
            },
        }
    }
};

// تعریف Set Request
var request = new SetRequest(options);

var response = apiInstance.Set(request);

ویرایش متادیتا با تطبیق نام ویژگی با استفاده از بیان منظم در اسناد PDF با استفاده از REST API در C# — متادیتا را با تطبیق نام ویژگی با عبارت منظم تنظیم کنید

قطعه کد زیر نحوه به روز رسانی ابرداده را با ارائه مقدار ویژگی نشان می دهد:

# مقداردهی اولیه api
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// گزینه های تنظیم را تعریف کنید
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "Simply set by Property Value",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                ValueOptions = new ValueOptions
                {
                    Value = "Windows User",
                    Type = "String"
                }
            },
        }
    }
};

// تعریف Set Request
var request = new SetRequest(options);

var response = apiInstance.Set(request);

با استفاده از REST API در سی شارپ، ابرداده را با تطبیق مقدار ویژگی در اسناد PDF ویرایش کنید. — با تطبیق ارزش ویژگی، متادیتا را تنظیم کنید

فایل به روز شده را دانلود کنید

نمونه کد بالا فایل PDF به روز شده را در فضای ابری ذخیره می کند و با استفاده از نمونه کد زیر قابل دانلود است:

# مقداردهی اولیه api
var fileApi = new FileApi(configuration);
var file = "metadata\\set_metadata\\input_pdf\\input.pdf";
var downloadRequest = new DownloadFileRequest(file, myStorage);

Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
using (var fileStream = File.Create("C:\\Files\\sample_input.pdf"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

آنلاین را امتحان کنید

لطفاً ابزار آنلاین رایگان دستکاری PDF Metadata زیر را که با استفاده از API فوق توسعه یافته است، امتحان کنید.

https://products.groupdocs.app/metadata/pdf

نتیجه

در این مقاله نحوه ویرایش Metadata اسناد PDF در فضای ابری را یاد گرفتید. در این مقاله همچنین نحوه آپلود برنامه‌نویسی یک فایل پی‌دی‌اف در فضای ابری و سپس دانلود فایل به‌روز شده از ابر توضیح داده شده است. با استفاده از مستندات می‌توانید درباره GroupDocs.Metadata Manipulation Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [فروم 13 تماس بگیرید.

همچنین ببینید

مدیریت فراداده اسناد با استفاده از جاوا و دات نت

Document Metadata Manipulation REST API و NET SDK#

ویرایش متادیتا فایل های PDF با استفاده از REST API در سی شارپ#

سند را آپلود کنید#

به روز رسانی متادیتا فایل های PDF با استفاده از سی شارپ#

فایل به روز شده را دانلود کنید#

آنلاین را امتحان کنید#

نتیجه#

همچنین ببینید#