یک خبر دیگر برای توسعه دهندگان ابری! GroupDocs API Cloud Manipulation Metadata Document را راه اندازی کرده است. این راه حل مدیریت ابرداده سند GroupDocs را غنی می کند. این راه حل در حال حاضر به توسعه دهندگان دات نت و جاوا به عنوان API های On-Premise برای توسعه دهندگان و به عنوان برنامه ویرایشگر فراداده سند آنلاین رایگان برای هر نوع کاربری برای مشاهده و ویرایش ابرداده اسناد ارائه می شود.

API Cloud Manipulation Metadata

GroupDocs.Metadata برای Cloud

GroupDocs.Metadata Cloud API همراه با SDK که به توسعه دهندگان امکان دستکاری (افزودن، حذف، به روز رسانی، استخراج و مشاهده) فراداده های بیش از 50 فرمت فایل را می دهد.

GroupDocs.Metadata اجازه می دهد تا به روش های مختلف به ابرداده فایل ها دسترسی داشته باشید و با آنها برخورد کنید:

  • نام تگ احتمالی
  • نام ملک
  • ارزش ملک
  • عبارت دقیق را مطابقت دهید
  • Regex را مطابقت دهید
  • درخت کل فراداده
  • برچسب بزنید

برای دریافت ایده بسیار بهتر در مورد ویژگی ها و محصول، همیشه می توانید از راهنمای توسعه دهنده در بخش مستندات دیدن کنید.

فرمت های سند پشتیبانی شده

می‌توانید عملیاتی را روی اسنادی انجام دهید که می‌توانند هر یک از اسناد پردازش کلمه، صفحات گسترده، ارائه‌ها، فایل‌های صوتی و تصویری، تصاویر، PDF، کتاب‌های الکترونیکی، نقاشی‌ها و بسیاری موارد دیگر باشند. در زیر فرمت‌های فایلی که در حال حاضر توسط API GroupDocs پشتیبانی می‌شوند و امیدواریم نیازهای شما را برآورده کنند، فهرست شده‌اند. برای اطلاع از همه [قالب‌های سند پشتیبانی‌شده6 یا هر نوع راهنمایی، می‌توانید در هر زمان از اسناد بازدید کنید.

فراداده - SDK ها و نمونه ها

همراه با ویرایش ابرداده REST API برای Cloud، GroupDocs همچنین SDK های منبع باز را ارائه می دهد، بنابراین، می توان آنها را مطابق با الزامات شخصی سازی کرد. توسعه دهندگان می توانند از cURL برای تعامل با GroupDocs.Metadata Cloud API استفاده کنند و همچنین می توانند از SDK(های) مربوطه برای سرعت بخشیدن به توسعه استفاده کنند. این به توسعه دهندگان کمک می کند تا نگران جزئیات سطح پایین درخواست و رسیدگی به پاسخ ها نباشند. SDK های ذکر شده در زیر به همراه نمونه کد در GitHub در دسترس هستند:

در این وبلاگ من از کد جاوا برای نشان دادن نحوه بازی با ویژگی های ابرداده اسناد استفاده می کنم. علاوه بر این، من تنها یکی از راه‌های استخراج، افزودن، حذف و اصلاح متادیتا را نشان خواهم داد. همچنین می‌توانید نمونه‌های C# و روش‌های دیگر را از اسناد و مخازن مربوطه GitHub مشاهده کنید.

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

API به شما این امکان را می دهد که ابرداده اسناد خود را با گزینه های مختلف استخراج کنید که شامل استخراج می شود:

  • کل درخت خواص فراداده
  • با برچسب، نام یا مقدار مشخص شده

برای کمک شما، نمونه های در حال اجرا در GitHub موجود است. من یک مثال از groupdocs.app را آپلود کرده‌ام که نشان می‌دهد چقدر می‌توانید برنامه‌های ابرداده خود را با C# و Java استخراج و ایجاد کنید.

درخت خواص فراداده کل را در جاوا استخراج کنید

پس از تنظیم اتصال با فضای ذخیره‌سازی ابری خود، می‌توانید کل درخت ویژگی‌های ابرداده را با کمک چند خط کد زیر استخراج کنید. در اینجا، من درخت خواص یک صفحه گسترده اکسل را با استفاده از Java SDK for Cloud استخراج می کنم. با استفاده از سایر SDK های موجود می توانید به راحتی به این امر دست یابید.

// Set File Path
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents"+ File.separator +"input.xlsx");
// Set Options to extract the metadata from any file.
ExtractOptions options = new ExtractOptions();
options.setFileInfo(fileInfo);
// Send a Request with options to extract metadata and received the response.
ExtractRequest request = new ExtractRequest(options);
ExtractResult response = apiInstance.extract(request);

چاپ کل درخت فراداده در جاوا

// That's it. You have received the whole Metadata Tree. Now you can use it the way you like.
for (MetadataProperty entry : response.getMetadataTree().getInnerPackages().get(0).getPackageProperties()){
	System.out.println("\\n" + entry.getName() + ": " + entry.getValue());
	if (entry.getTags() == null)
		continue;
	// Print Tags
	for (Tag tagItem : entry.getTags()) {
		System.out.println("=== Tag for Property ===");
		System.out.println("Name :" + tagItem.getName());
		System.out.println("Category: " + tagItem.getCategory());
	}
}

خروجی

FileFormat: 2
=== Tag for Property ===
Name :FileFormat
Category: Content

MimeType: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
=== Tag for Property ===
Name :FileFormat
Category: Content
 
SpreadsheetFileFormat: 3
=== Tag for Property ===
Name :FileFormat
Category: Content

سایر روش های مختلف استخراج فراداده را می توان در هر یک از منابع زیر مشاهده کرد:

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

GroupDocs Metadata REST API به شما این امکان را می‌دهد تا با ویژگی‌های زیر متادیتا را به اسناد خود اضافه کنید:

  • خواص فراداده ممکن است حاوی انواع مختلفی از مقادیر مانند String، DateTime، Integer، Double، Boolean باشد.
  • ویژگی ها را می توان به روش های زیر اضافه کرد:
    • افزودن ویژگی فراداده بر اساس نام:
      • بخشی از نام
      • عبارت دقیق
      • Regex Match
    • افزودن ویژگی فراداده بر اساس برچسب:
      • تگ دقیق
      • نام تگ احتمالی

ویژگی متادیتا را با تگ دقیق در جاوا اضافه کنید

در زیر، می توانید نمونه کد منبع برای افزودن ویژگی ابرداده توسط یک برچسب دقیق را مشاهده کنید:

AddOptions options = new AddOptions();
ArrayList<AddProperty> properties = new ArrayList<AddProperty>();
AddProperty property = new AddProperty();
SearchCriteria searchCriteria = new SearchCriteria();
TagOptions tagOptions = new TagOptions();
// Set Tag name and category
Tag tag = new Tag();
tag.setName("Printed");
tag.setCategory("Time");
// Set Tag
tagOptions.setExactTag(tag);
searchCriteria.setTagOptions(tagOptions);
//Set Date for Value
Date date = new Date();
DateFormat dateFormat = new SimpleDateFormat("MM-dd-yyyy hh:mm:ss");
// Setting the Add Property
property.setSearchCriteria(searchCriteria);
property.setValue(dateFormat.format(date));
property.setType("datetime");
properties.add(property);
// Set Properties of AddOptions
options.setProperties(properties);
// Select the document to add metadata property
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/input.docx");
options.setFileInfo(fileInfo);
// Sending the request and fetch response after adding the metadata property
AddRequest request = new AddRequest(options);
AddResult response = apiInstance.add(request);
// Printing the Changes Count and Path of changed file.
System.out.println("Count of changes: " + response.getAddedCount());
System.out.println("Resultant file path: " + response.getPath());

خروجی: پس از افزودن متادیتا توسط برچسب

Count of changes: 1
Resultant file path: metadata/add\_metadata/documents/input\_docx/input.docx

تمام روش های مختلف دیگر برای افزودن ابرداده را می توان در هر یک از منابع زیر مشاهده کرد:

با استفاده از جاوا یا دات نت ابرداده را حذف کنید

تقریباً با گزینه‌های مشابه برای افزودن ویژگی‌های فراداده، می‌توانید ویژگی‌های ابرداده را نیز از اسناد خود حذف کنید.

  • خواص فراداده ممکن است حاوی انواع مختلفی از مقادیر مانند String، DateTime، Integer، Double، Boolean باشد..
  • ویژگی های ابرداده را می توان به روش های زیر حذف/حذف کرد:
    • حذف ویژگی فراداده بر اساس نام:
      • بخشی از نام
      • عبارت دقیق
      • تطبیق عبارت منظم
    • حذف ویژگی فراداده بر اساس برچسب:
      • تگ دقیق
      • نام تگ احتمالی

Metadata را با استفاده از Regular Expression (Regex) در جاوا حذف کنید

در زیر، می‌توانید نمونه کد منبع را برای حذف ویژگی‌های ابرداده‌ای که با عبارت منظم ارائه شده مطابقت دارند، ببینید:

// Name Options
NameOptions nameOptions = new NameOptions();
nameOptions.setValue("^\[N\]ame\[A-Z\].\*");
// Match Options
MatchOptions matchOptions = new MatchOptions();
matchOptions.setIsRegex(true);
nameOptions.setMatchOptions(matchOptions);
// Remove Metadata Options and Search Criteria
RemoveOptions options = new RemoveOptions();
SearchCriteria searchCriteria = new SearchCriteria();
// Search Criteria
searchCriteria.setNameOptions(nameOptions);
options.setSearchCriteria(searchCriteria);
// Set fileInfo for the source document
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/input.docx");
options.setFileInfo(fileInfo);
// Send request to remove and receive the response
RemoveRequest request = new RemoveRequest(options);
RemoveResult response = apiInstance.remove(request);
// In response, you can get the path of the updated document with the removed properies.
System.out.println("Count of changes: " + response.getRemovedCount());
System.out.println("Resultant file path: " + response.getPath());

خروجی: پس از حذف متادیتا توسط regex

Count of changes: 1
Resultant file path: metadata/remove\_metadata/documents/input\_docx/input.docx

تمام روش های مختلف دیگر برای حذف ابرداده را می توان در هر یک از منابع زیر مشاهده کرد:

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

همراه با افزودن، حذف و استخراج ابرداده، REST API امکان به‌روزرسانی ویژگی‌های ابرداده موجود را به روش‌های مختلف می‌دهد. در زیر نشان می‌دهم که چگونه می‌توانید با استفاده از کد جاوا، ویژگی ابرداده هر سند را با ارائه نام تگ ممکن به‌روزرسانی کنید. من از یک صفحه گسترده اکسل برای به روز رسانی تگ ابرداده سازنده آن استفاده کرده ام. شما می توانید در سی شارپ با استفاده از .NET API به همین نتیجه برسید.

با استفاده از جاوا، متادیتا را بر اساس نام تگ احتمالی به روز کنید

SetOptions options = new SetOptions();
ArrayList<SetProperty> properties = new ArrayList<SetProperty>();
SetProperty property = new SetProperty();
SearchCriteria searchCriteria = new SearchCriteria();
// Set Tag Options and Possible Tag Name
TagOptions tagOptions = new TagOptions();
tagOptions.setPossibleName("creator");
searchCriteria.setTagOptions(tagOptions);
//Set the new Value and Type and then add the property
property.setSearchCriteria(searchCriteria);
property.setNewValue("GroupDocs");
property.setType("string");
properties.add(property);
options.setProperties(properties);
// Select the file to update its metadata properties
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/input.xlsx");
options.setFileInfo(fileInfo);
// Send Request and catch the Response
SetRequest request = new SetRequest(options);
SetResult response = apiInstance.set(request);
// Print the Response Fields
System.out.println("Changes count: " + response.getSetCount());
System.out.println("Resultant file path: " + response.getPath());

خروجی: پس از اصلاح ابرداده با نام تگ احتمالی

 Count of changes: 1
 Resultant file path: metadata/set\_metadata/documents/input\_xlsx/input.xlsx

شما می توانید سند به روز شده را از مسیر برگشت داده شده در پاسخ دانلود کنید. علاوه بر این، می‌توانید ویژگی‌های موجود را به روش‌های مشابهی مانند افزودن و حذف ابرداده به‌روزرسانی کنید. مثال و توضیحات را می توان در منابع زیر GroupDocs.Metadata Cloud API مشاهده کرد.

بیایید صحبت کنیم

این خلاصه‌ای از نمای کلی GroupDocs.Metadata Cloud API است. اکنون می توانید اپلیکیشن خود را با استفاده از ویژگی های برجسته شده بالا بسازید. خوشحال می شویم اگر در [فروم 20 برای بحث، حل مشکل یا به اشتراک گذاشتن بازخورد خود با ما تماس بگیرید. با تشکر.

منابع