خبر آخر لمطوري السحابة! أطلقت GroupDocs واجهة API السحابية لمعالجة البيانات الوصفية للمستندات. هذا يثري حل إدارة البيانات الوصفية للمستند من GroupDocs. يخدم الحل بالفعل مطوري .NET و Java كـ On-Premise APIs للمطورين ، وباعتباره Free Online Document Metadata Editor App لأي نوع من المستخدمين لعرض البيانات الوصفية للوثائق وتحريرها.

واجهة برمجة التطبيقات السحابية لمعالجة البيانات الوصفية

GroupDocs.Metadata for Cloud

GroupDocs.Metadata Cloud API جنبًا إلى جنب مع SDKs التي تسمح للمطورين بمعالجة (إضافة وإزالة وتحديث واستخراج وعرض) البيانات الوصفية لأكثر من 50 تنسيقًا للملف.

تسمح GroupDocs.Metadata بالوصول إلى البيانات الوصفية للملفات والتعامل معها بطرق مختلفة مثل:

  • اسم العلامة الممكنة
  • اسم الخاصية
  • قيمة العقار
  • مطابقة العبارة بالضبط
  • تطابق Regex
  • شجرة البيانات الوصفية الكاملة
  • بطاقة شعار

للحصول على فكرة أفضل عن الميزات والمنتج ، يمكنك دائمًا زيارة دليل المطور في قسم التوثيق.

تنسيقات المستندات المدعومة

يمكنك إجراء عمليات على المستندات التي يمكن أن تكون أيًا من مستندات معالجة النصوص وجداول البيانات والعروض التقديمية وملفات الصوت والفيديو والصور وملفات PDF والكتب الإلكترونية والرسومات وغير ذلك الكثير. فيما يلي قائمة بتنسيقات الملفات المدعومة حاليًا بواسطة GroupDocs API ونأمل أن تفي بمتطلباتك. يمكنك زيارة الوثائق في أي وقت للتعرف على جميع تنسيقات المستندات المدعومة أو أي نوع من الإرشادات.

البيانات الوصفية - مجموعات تطوير البرامج والعينات

إلى جانب تحرير البيانات الوصفية REST API لـ Cloud ، يوفر GroupDocs أيضًا مجموعات SDK مفتوحة المصدر ، وبالتالي ، يمكن تخصيصها ذاتيًا وفقًا للمتطلبات. يمكن للمطورين استخدام cURL للتفاعل مع GroupDocs.Metadata Cloud API ويمكنهم أيضًا استخدام SDK (s) ذات الصلة لتسريع عملية التطوير. يساعد هذا المطورين على التوقف عن القلق بشأن التفاصيل المنخفضة المستوى لتقديم طلب والتعامل مع الردود. تتوفر حزم SDK المذكورة أدناه جنبًا إلى جنب مع أمثلة التعليمات البرمجية على GitHub:

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

استخراج البيانات الوصفية من الملفات في Java أو .NET

تسمح لك واجهة برمجة التطبيقات (API) باستخراج البيانات الوصفية لمستنداتك بخيارات مختلفة تشمل الاستخراج:

  • شجرة خصائص واصفات البيانات بأكملها
  • حسب العلامة أو الاسم أو القيمة المحددة

للحصول على مساعدتك ، تتوفر الأمثلة الجارية على GitHub. لقد قمت بتحميل مثال من groupdocs.app يوضح مقدار ما يمكنك استخراج وإنشاء تطبيقات البيانات الوصفية الخاصة بك باستخدام C# و Java.

استخراج شجرة خصائص البيانات الوصفية بالكامل في Java

بعد إعداد الاتصال بالتخزين السحابي الخاص بك ، يمكنك استخراج الشجرة الكاملة لخصائص البيانات الوصفية بمساعدة الأسطر القليلة المذكورة أدناه من التعليمات البرمجية. هنا ، أقوم باستخراج شجرة الخصائص لجدول بيانات Excel باستخدام 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);

طباعة شجرة البيانات الوصفية بالكامل في Java

// 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

يمكن رؤية جميع الطرق المختلفة الأخرى لاستخراج البيانات الوصفية في أي من الموارد التالية:

أضف البيانات الوصفية باستخدام Java أو .NET

تسمح لك GroupDocs Metadata REST API بإضافة بيانات وصفية إلى مستنداتك بالميزات التالية:

  • قد تحتوي خصائص البيانات الوصفية على أنواع مختلفة من القيم مثل String و DateTime و Integer و Double و Boolean
  • يمكن إضافة الخصائص باتباع طرق مختلفة:
    • إضافة خاصية البيانات الوصفية حسب الاسم:
      • جزء من الاسم
      • العبارة بالضبط
      • تطابق Regex
    • إضافة خاصية البيانات الوصفية عن طريق العلامة:
      • علامة بالضبط
      • اسم العلامة الممكنة

أضف خاصية بيانات التعريف عن طريق علامة بالضبط في Java

أدناه ، يمكنك مشاهدة مثال شفرة المصدر لإضافة خاصية البيانات الوصفية بواسطة علامة دقيقة:

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

يمكن رؤية جميع الطرق المختلفة الأخرى لإضافة البيانات الوصفية في أي من الموارد التالية:

إزالة البيانات الوصفية باستخدام Java أو .NET

تقريبًا مع خيارات مماثلة لإضافة خصائص البيانات الأولية ، يمكنك أيضًا إزالة خصائص البيانات الأولية من مستنداتك.

  • قد تحتوي خصائص البيانات الوصفية على أنواع مختلفة من القيم مثل String و DateTime و Integer و Double و Boolean.
  • يمكن حذف / إزالة خصائص البيانات الوصفية باتباع طرق مختلفة:
    • إزالة خاصية البيانات الوصفية حسب الاسم:
      • جزء من الاسم
      • العبارة بالضبط
      • مطابقة التعبير العادي
    • إزالة خاصية البيانات الوصفية بواسطة العلامة:
      • علامة بالضبط
      • اسم العلامة الممكنة

إزالة البيانات الوصفية باستخدام التعبير العادي (Regex) في Java

يمكنك الاطلاع أدناه على مثال شفرة المصدر لإزالة خصائص البيانات الوصفية التي تطابق التعبير العادي المقدم:

// 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

يمكن رؤية جميع الطرق المختلفة الأخرى لإزالة البيانات الوصفية في أي من الموارد التالية:

قم بتحديث البيانات الوصفية باستخدام Java أو .NET

إلى جانب إضافة البيانات الوصفية وإزالتها واستخراجها ، تسمح واجهة برمجة تطبيقات REST بتحديث خصائص البيانات الوصفية الحالية بطرق مختلفة. سأوضح أدناه كيف يمكنك تحديث خاصية البيانات الوصفية لأي مستند باستخدام كود Java من خلال توفير اسم العلامة المحتمل للخاصية. لقد استخدمت جدول بيانات Excel لتحديث علامة البيانات الوصفية لمنشئ المحتوى. يمكنك تحقيق نفس الشيء في C# باستخدام .NET API.

قم بتحديث البيانات الوصفية حسب اسم العلامة المحتملة باستخدام Java

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. يمكنك الآن إنشاء تطبيقك الخاص باستخدام الميزات الموضحة أعلاه. سنكون سعداء إذا اتصلت بنا على المنتدى لمناقشة أو حل مشكلة أو مشاركة ملاحظاتك. شكرًا.

موارد