Kolejna wiadomość dla Cloud Developerów! GroupDocs uruchomił interfejs Document Metadata Manipulation Cloud API. Wzbogaca to rozwiązanie do zarządzania metadanymi dokumentów GroupDocs. Rozwiązanie to już służy programistom .NET i Java jako interfejsy API On-Premise dla programistów oraz jako bezpłatna aplikacja Online Document Metadata Editor dla dowolnego użytkownika do przeglądania i edytowania metadanych dokumentów.

Interfejs API chmury do manipulowania metadanymi

GroupDocs.Metadata dla chmury

GroupDocs.Metadata Cloud API wraz z zestawami SDK, które umożliwiają programistom manipulowanie (dodawanie, usuwanie, aktualizowanie, wyodrębnianie i wyświetlanie) metadanymi ponad 50 formatów plików.

GroupDocs.Metadata umożliwia dostęp do metadanych plików i zarządzanie nimi na różne sposoby, takie jak:

  • Możliwa nazwa znacznika
  • Nazwa właściwości
  • Wartość nieruchomości
  • Dopasuj dokładne wyrażenie
  • Dopasuj wyrażenie regularne
  • Całe drzewo metadanych
  • Etykietka

Aby uzyskać znacznie lepsze informacje o funkcjach i produkcie, zawsze możesz odwiedzić przewodnik dla programistów w sekcji dokumentacja.

Obsługiwane formaty dokumentów

Możesz wykonywać operacje na dokumentach, które mogą być dowolnymi dokumentami edytora tekstu, arkuszami kalkulacyjnymi, prezentacjami, plikami audio i wideo, obrazami, plikami PDF, eBookami, rysunkami i wieloma innymi. Poniżej wymieniono formaty plików, które są obecnie obsługiwane przez interfejs API GroupDocs i mamy nadzieję, że spełnią Twoje wymagania. W każdej chwili możesz zapoznać się z dokumentacją, aby poznać wszystkie obsługiwane formaty dokumentów lub wszelkiego rodzaju wskazówki.

Metadane — zestawy SDK i próbki

Wraz z interfejsem REST API do edycji metadanych dla chmury, GroupDocs udostępnia również pakiety SDK typu open source, dzięki czemu można je samodzielnie dostosować do wymagań. Deweloperzy mogą używać cURL do interakcji z GroupDocs.Metadata Cloud API, a także mogą korzystać z odpowiednich zestawów SDK, aby przyspieszyć programowanie. Pomaga to programistom przestać martwić się o niskopoziomowe szczegóły dotyczące składania żądania i obsługi odpowiedzi. Wymienione poniżej SDK wraz z przykładami kodu są dostępne na GitHub:

Na tym blogu. Używam kodu Java, aby pokazać, jak bawić się właściwościami metadanych dokumentów. Ponadto pokażę tylko jeden ze sposobów wyodrębniania, dodawania, usuwania i modyfikowania metadanych. Możesz także zobaczyć szczegółowo przykłady C# i inne sposoby z dokumentacji i odpowiednich repozytoriów GitHub.

Wyodrębnij metadane z plików w Javie lub .NET

Interfejs API umożliwia wyodrębnianie metadanych dokumentów za pomocą różnych opcji, które obejmują wyodrębnianie:

  • Całe drzewo właściwości metadanych
  • Według określonego znacznika, nazwy lub wartości

Aby uzyskać pomoc, uruchomione przykłady są dostępne na GitHub. Przesłałem przykład groupdocs.app, który pokazuje, jak wiele można wyodrębnić i utworzyć własne aplikacje metadanych za pomocą C# i Java.

Wyodrębnij całe drzewo właściwości metadanych w Javie

Po ustawieniu połączenia z magazynem w chmurze możesz wyodrębnić całe drzewo właściwości metadanych za pomocą kilku poniższych linii kodu. Tutaj wyodrębniam drzewo właściwości arkusza kalkulacyjnego programu Excel za pomocą pakietu Java SDK for Cloud. Możesz to łatwo osiągnąć za pomocą dowolnego innego dostępnego zestawu 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);

Drukowanie całego drzewa metadanych w Javie

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

Wyjście

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

Wszystkie inne sposoby ekstrakcji metadanych można zobaczyć w dowolnym z następujących zasobów:

Dodaj metadane przy użyciu języka Java lub .NET

GroupDocs Metadata REST API umożliwia dodawanie metadanych do dokumentów za pomocą następujących funkcji:

  • Właściwości metadanych mogą zawierać różne typy wartości, takie jak String, DateTime, Integer, Double, Boolean
  • Właściwości można dodawać na różne sposoby:
    • Dodaj właściwość metadanych według nazwy:
      • Część imienia
      • Dokładna fraza
      • Dopasowanie wyrażenia regularnego
    • Dodaj właściwość metadanych według tagu:
      • Dokładny znacznik
      • Możliwa nazwa znacznika

Dodaj właściwość metadanych według dokładnego znacznika w Javie

Poniżej możesz zobaczyć przykład kodu źródłowego dodawania właściwości metadanych za pomocą dokładnego tagu:

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

Wyjście: Po dodaniu metadanych według tagu

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

Wszystkie inne sposoby dodawania metadanych można znaleźć w następujących zasobach:

Usuń metadane za pomocą Java lub .NET

Prawie z podobnymi opcjami dodawania właściwości metadanych, możesz także usunąć właściwości metadanych ze swoich dokumentów.

  • Właściwości metadanych mogą zawierać różne typy wartości, takie jak String, DateTime, Integer, Double, Boolean.
  • Właściwości metadanych można usuwać/usuwać na różne sposoby:
    • Usuń właściwość metadanych według nazwy:
      • Część imienia
      • Dokładna fraza
      • Dopasowanie wyrażenia regularnego
    • Usuń właściwość metadanych według tagu:
      • Dokładny znacznik
      • Możliwa nazwa znacznika

Usuń metadane za pomocą wyrażeń regularnych (Regex) w Javie

Poniżej możesz zobaczyć przykład kodu źródłowego do usuwania właściwości metadanych pasujących do podanego wyrażenia regularnego:

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

Dane wyjściowe: po usunięciu metadanych przez wyrażenie regularne

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

Wszystkie inne sposoby usuwania metadanych można zobaczyć w dowolnym z następujących zasobów:

Zaktualizuj metadane przy użyciu języka Java lub .NET

Oprócz dodawania, usuwania i wyodrębniania metadanych interfejs API REST umożliwia aktualizowanie istniejących właściwości metadanych na różne sposoby. Poniżej pokażę, jak możesz zaktualizować właściwość metadanych dowolnego dokumentu za pomocą kodu Java, podając nazwę możliwego znacznika właściwości. Użyłem arkusza kalkulacyjnego programu Excel, aby zaktualizować tag metadanych twórcy. Możesz osiągnąć to samo w C# przy użyciu .NET API.

Zaktualizuj metadane według możliwej nazwy znacznika przy użyciu języka 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());

Dane wyjściowe: Po zmodyfikowaniu metadanych według możliwej nazwy znacznika

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

Możesz pobrać zaktualizowany dokument ze ścieżki zwróconej w odpowiedzi. Ponadto możesz aktualizować istniejące właściwości w podobny sposób, jak dodawanie i usuwanie metadanych. Przykład i wyjaśnienia można znaleźć w następujących zasobach GroupDocs.Metadata Cloud API.

Porozmawiajmy

To podsumowanie przeglądu GroupDocs.Metadata Cloud API. Teraz możesz zbudować własną aplikację, korzystając z wyżej wyróżnionych funkcji. Będzie nam niezmiernie miło, jeśli skontaktujesz się z nami na forum w celu omówienia, rozwiązania problemu lub podzielenia się swoją opinią. Dzięki.

Zasoby