Ancora un’altra novità per i Cloud Developers! GroupDocs ha lanciato l’API Document Metadata Manipulation Cloud. Ciò arricchisce la soluzione di gestione dei metadati dei documenti di GroupDocs. La soluzione è già al servizio degli sviluppatori .NET e Java come API on-premise per gli sviluppatori e come app per l’editor di metadati dei documenti online gratuita per qualsiasi tipo di utente per visualizzare e modificare i metadati dei documenti.

API cloud per la manipolazione dei metadati

GroupDocs.Metadata per Cloud

GroupDocs.Metadata Cloud API insieme a SDK che consentono agli sviluppatori di manipolare (aggiungere, rimuovere, aggiornare, estrarre e visualizzare) i metadati di oltre 50 formati di file.

GroupDocs.Metadata consente di accedere e gestire i metadati dei file in diversi modi come:

  • Possibile nome del tag
  • Nome della proprietà
  • Costo dell’immobile
  • Abbina la frase esatta
  • Corrispondenza Regex
  • L’intero albero dei metadati
  • Etichetta

Per avere un’idea molto migliore delle funzionalità e del prodotto, puoi sempre visitare la guida per gli sviluppatori nella sezione documentazione.

Formati di documenti supportati

È possibile eseguire operazioni su documenti che possono essere qualsiasi documento di elaborazione testi, fogli di calcolo, presentazioni, file audio e video, immagini, PDF, eBook, disegni e molti altri. Di seguito sono elencati i formati di file che sono attualmente supportati dall’API GroupDocs e che, si spera, soddisferanno i tuoi requisiti. Puoi visitare la documentazione in qualsiasi momento per conoscere tutti i formati di documenti supportati o qualsiasi tipo di guida.

Metadati: SDK ed esempi

Insieme all’API REST per la modifica dei metadati per Cloud, GroupDocs fornisce anche SDK open source, pertanto questi possono essere personalizzati in base ai requisiti. Gli sviluppatori possono utilizzare cURL per interagire con GroupDocs.Metadata Cloud API e possono anche utilizzare gli SDK pertinenti per accelerare lo sviluppo. Questo aiuta gli sviluppatori a smettere di preoccuparsi dei dettagli di basso livello di fare una richiesta e gestire le risposte. Gli SDK menzionati di seguito insieme agli esempi di codice sono disponibili su GitHub:

In questo blog. Sto usando il codice Java per mostrare come giocare con le proprietà dei metadati dei documenti. Inoltre, mostrerò solo uno dei modi per estrarre, aggiungere, rimuovere e modificare i metadati. Puoi anche vedere gli esempi C# e altri modi in dettaglio dalla documentazione e dai relativi repository GitHub.

Estrai metadati da file in Java o .NET

L’API ti consente di estrarre i metadati dei tuoi documenti con diverse opzioni che includono l’estrazione:

  • L’intero albero delle proprietà dei metadati
  • Per tag, nome o valore specificato

Per il tuo aiuto, gli esempi in esecuzione sono disponibili su GitHub. Ho caricato un esempio di groupdocs.app che mostra quanto puoi estrarre e creare le tue applicazioni di metadati con C# e Java.

Estrai l’intero albero delle proprietà dei metadati in Java

Dopo aver impostato la connessione con il tuo cloud storage, puoi estrarre l’intero albero delle proprietà dei metadati con l’aiuto delle poche righe di codice sotto menzionate. Qui sto estraendo l’albero delle proprietà di un foglio di calcolo Excel utilizzando Java SDK for Cloud. Puoi facilmente ottenere questo risultato utilizzando uno qualsiasi degli altri SDK disponibili.

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

Stampa dell’intero albero dei metadati in 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());
	}
}

Produzione

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

Tutti gli altri diversi modi di estrazione dei metadati possono essere visualizzati in una qualsiasi delle seguenti risorse:

Aggiungi metadati utilizzando Java o .NET

GroupDocs Metadata REST API ti consente di aggiungere metadati ai tuoi documenti con le seguenti funzionalità:

  • Le proprietà dei metadati possono contenere diversi tipi di valori come String, DateTime, Integer, Double, Boolean
  • Le proprietà possono essere aggiunte nei seguenti modi diversi:
    • Aggiungi proprietà metadati per nome:
      • Parte del nome
      • Frase esatta
      • Corrispondenza regolare
    • Aggiungi proprietà metadati per tag:
      • Etichetta esatta
      • Possibile nome del tag

Aggiungi la proprietà dei metadati per tag esatto in Java

Di seguito, puoi vedere l’esempio di codice sorgente per aggiungere la proprietà dei metadati tramite un tag esatto:

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

Output: dopo aver aggiunto i metadati per tag

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

Tutti gli altri modi diversi di aggiungere metadati possono essere visualizzati in una qualsiasi delle seguenti risorse:

Rimuovi i metadati utilizzando Java o .NET

Quasi con opzioni simili per aggiungere le proprietà dei metadati, puoi anche rimuovere le proprietà dei metadati dai tuoi documenti.

  • Le proprietà dei metadati possono contenere diversi tipi di valori come String, DateTime, Integer, Double, Boolean.
  • Le proprietà dei metadati possono essere eliminate/rimosse nei seguenti modi diversi:
    • Rimuovi la proprietà dei metadati per nome:
      • Parte del nome
      • Frase esatta
      • Espressione regolare corrispondente
    • Rimuovi la proprietà dei metadati per tag:
      • Etichetta esatta
      • Possibile nome del tag

Rimuovi i metadati utilizzando l’espressione regolare (Regex) in Java

Di seguito, puoi vedere l’esempio di codice sorgente per rimuovere le proprietà dei metadati che corrispondono all’espressione regolare fornita:

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

Output: dopo aver rimosso i metadati tramite regex

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

Tutti gli altri diversi modi per rimuovere i metadati possono essere visualizzati in una qualsiasi delle seguenti risorse:

Aggiorna i metadati utilizzando Java o .NET

Oltre ad aggiungere, rimuovere ed estrarre i metadati, l’API REST consente di aggiornare le proprietà dei metadati esistenti in diversi modi. Di seguito mostrerò come è possibile aggiornare la proprietà dei metadati di qualsiasi documento utilizzando il codice Java fornendo il possibile nome del tag della proprietà. Ho utilizzato un foglio di calcolo Excel per aggiornare il tag dei metadati del creatore. Puoi ottenere lo stesso risultato in C# usando l’API .NET.

Aggiorna i metadati in base al possibile nome del tag utilizzando 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());

Output: dopo aver modificato i metadati in base al possibile nome del tag

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

È possibile scaricare il documento aggiornato dal percorso restituito nella risposta. Inoltre, puoi aggiornare le proprietà esistenti in modi simili come l’aggiunta e la rimozione di metadati. Esempi e spiegazioni possono essere visualizzati nelle seguenti risorse dell’API GroupDocs.Metadata Cloud.

Parliamo

Questo riassume la panoramica di GroupDocs.Metadata Cloud API. Ora puoi creare la tua applicazione utilizzando le funzionalità sopra evidenziate. Saremo lieti se ci contatti sul forum per discutere, risolvere un problema o condividere il tuo feedback. Grazie.

Risorse