Bulut Geliştiricileri için bir haber daha! GroupDocs, Document Metadata Manipulation Cloud API’yi başlattı. Bu, GroupDocs’un belge meta veri yönetimi çözümünü zenginleştirir. Çözüm, halihazırda .NET ve Java geliştiricilerine geliştiriciler için Şirket İçi API’ler ve her türlü kullanıcının belgelerin meta verilerini görüntülemesi ve düzenlemesi için Ücretsiz Çevrimiçi Belge Meta Veri Düzenleyici Uygulaması olarak hizmet veriyor.

Meta Veri Manipülasyonu Bulut API’si

Cloud için GroupDocs.Metadata

GroupDocs.Metadata Cloud Geliştiricilerin 50’den fazla dosya biçiminin meta verilerini manipüle etmesine (ekleme, kaldırma, güncelleme, ayıklama ve görüntüleme) olanak tanıyan SDK’larla birlikte API.

GroupDocs.Metadata, dosyaların meta verilerine aşağıdakiler gibi farklı şekillerde erişmeye ve bunlarla ilgilenmeye izin verir:

  • Olası Etiket Adı
  • Mülkiyet adı
  • Mülk değeri
  • Tam İfadeyi Eşleştir
  • Regex’i Eşleştir
  • Tüm Meta Veri Ağacı
  • Etiket

Özellikler ve ürün hakkında çok daha iyi fikir edinmek için her zaman belgeler bölümündeki geliştirici kılavuzunu ziyaret edebilirsiniz.

Desteklenen Belge Biçimleri

Kelime işlem belgeleri, elektronik tablolar, sunumlar, ses ve video dosyaları, resimler, PDF, e-Kitaplar, çizimler ve daha pek çok belge olabilecek belgeler üzerinde işlem yapabilirsiniz. Aşağıda, şu anda GroupDocs API tarafından desteklenen dosya biçimleri listelenmiştir ve umarız gereksinimlerinizi karşılar. Tüm desteklenen belge biçimleri veya her türlü rehberlik hakkında bilgi edinmek için istediğiniz zaman belgeleri ziyaret edebilirsiniz.

Meta veriler - SDK’lar ve Örnekler

GroupDocs, meta veri düzenleme REST API for Cloud’un yanı sıra açık kaynaklı SDK’lar da sağlar, bu nedenle bunlar gereksinimlere göre kendi kendine özelleştirilebilir. Geliştiriciler, GroupDocs.Metadata Cloud API ile etkileşim kurmak için cURL’yi kullanabilir ve ayrıca geliştirmeyi hızlandırmak için ilgili SDK’ları kullanabilir. Bu, geliştiricilerin istekte bulunma ve yanıtları işleme gibi düşük düzeyli ayrıntılar hakkında endişelenmeyi bırakmasına yardımcı olur. Aşağıda belirtilen SDK’lar ve kod örnekleri GitHub’da mevcuttur:

Bu blogda. Belgelerin meta veri özellikleriyle nasıl oynanacağını göstermek için Java kodunu kullanıyorum. Ayrıca, meta verileri ayıklamanın, eklemenin, kaldırmanın ve değiştirmenin yollarından yalnızca birini göstereceğim. Ayrıca dokümantasyon ve ilgili GitHub depolarından C# örneklerini ve diğer yolları ayrıntılı olarak görebilirsiniz.

Java veya .NET’teki Dosyalardan Meta Verileri Çıkarın

API, ayıklamayı içeren farklı seçeneklerle belgelerinizin meta verilerini çıkarmanıza olanak tanır:

  • Tüm meta veri özellikleri ağacı
  • Belirtilen etikete, ada veya değere göre

Yardımınız için, çalışan örnekler GitHub‘da mevcuttur. C# ve Java ile kendi meta veri uygulamalarınızı ne kadar ayıklayabileceğinizi ve oluşturabileceğinizi gösteren bir örnek groupdocs.app yükledim.

Java’da Tüm Meta Veri Özellikleri Ağacını Çıkarın

Bulut depolama alanınızla bağlantıyı ayarladıktan sonra, aşağıda belirtilen birkaç kod satırının yardımıyla tüm meta veri özellikleri ağacını çıkarabilirsiniz. Burada, Java SDK for Cloud kullanarak bir excel elektronik tablosunun özellikler ağacını çıkarıyorum. Mevcut diğer SDK’lardan herhangi birini kullanarak bunu kolayca başarabilirsiniz.

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

Tüm Meta Veri Ağacını Java’da Yazdırma

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

Çıktı

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

Meta veri çıkarmanın diğer tüm farklı yolları aşağıdaki kaynakların herhangi birinde görülebilir:

Java veya .NET kullanarak Meta Veri ekleyin

GroupDocs Metadata REST API, aşağıdaki özelliklerle belgelerinize meta veriler eklemenizi sağlar:

  • Meta veri özellikleri, String, DateTime, Integer, Double, Boolean gibi farklı türde değerler içerebilir.
  • Özellikler aşağıdaki farklı şekillerde eklenebilir:
    • Ada Göre Meta Veri Özelliği Ekle:
      • Adın bir parçası
      • Tam tabiri
      • Normal İfade Eşleşmesi
    • Etikete Göre Meta Veri Özelliği Ekleme:
      • Tam Etiket
      • Olası Etiket Adı

Java’da Tam Etikete Göre Meta Veri Özelliği Ekleme

Aşağıda, metadata özelliğini kesin bir etiketle eklemek için kaynak kodu örneğini görebilirsiniz:

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

Çıktı: Etikete göre meta veri ekledikten sonra

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

Meta veri eklemenin diğer tüm farklı yolları aşağıdaki kaynakların herhangi birinde görülebilir:

Java veya .NET kullanarak Meta Verileri Kaldırma

Metadata özelliklerini eklemek için hemen hemen benzer seçeneklerle, metadata özelliklerini belgelerinizden de kaldırabilirsiniz.

  • Meta veri özellikleri, String, DateTime, Integer, Double, Boolean gibi farklı türde değerler içerebilir..
  • Meta veri özellikleri aşağıdaki farklı şekillerde silinebilir/kaldırılabilir:
    • Meta Veri Özelliğini Ada Göre Kaldır:
      • Adın bir parçası
      • Tam tabiri
      • Eşleşen Normal İfade
    • Meta Veri Özelliğini Etikete Göre Kaldır:
      • Tam Etiket
      • Olası Etiket Adı

Java’da Normal İfade (Regex) kullanarak Meta Verileri Kaldırma

Sağlanan normal ifadeyle eşleşen meta veri özelliklerini kaldırmak için kaynak kodu örneğini aşağıda görebilirsiniz:

// 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());

Çıktı: Normal ifadeyle meta verileri kaldırdıktan sonra

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

Meta verileri kaldırmanın diğer tüm farklı yolları aşağıdaki kaynakların herhangi birinde görülebilir:

Java veya .NET kullanarak Meta Verileri Güncelleyin

REST API, meta verileri ekleme, kaldırma ve çıkarmanın yanı sıra, mevcut meta veri özelliklerinin farklı şekillerde güncellenmesine olanak tanır. Aşağıda, olası etiket adı özelliğini sağlayarak Java kodunu kullanarak herhangi bir belgenin meta veri özelliğini nasıl güncelleyebileceğinizi göstereceğim. Oluşturucu meta veri etiketini güncellemek için bir excel elektronik tablosu kullandım. Aynısını .NET API kullanarak C#’ta elde edebilirsiniz.

Java kullanarak Olası Etiket Adına göre Meta Verileri Güncelleyin

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

Çıktı: Olası etiket adına göre meta verileri değiştirdikten sonra

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

Yanıtta döndürülen yoldan güncellenen belgeyi indirebilirsiniz. Ayrıca, meta veri ekleme ve kaldırma gibi benzer yollarla mevcut özellikleri güncelleyebilirsiniz. Örnek ve açıklamalar GroupDocs.Metadata Cloud API’nin aşağıdaki kaynaklarında görülebilir.

Hadi Konuşalım

Bu, GroupDocs.Metadata Cloud API genel bakışını özetlemektedir. Artık yukarıda vurgulanan özellikleri kullanarak kendi uygulamanızı oluşturabilirsiniz. Tartışmak, bir sorunu çözmek veya geri bildiriminizi paylaşmak için forum üzerinden bizimle iletişime geçerseniz çok seviniriz. Teşekkürler.

Kaynaklar