Encore une nouvelle pour les Développeurs Cloud ! GroupDocs a lancé l’API Document Metadata Manipulation Cloud. Cela enrichit la solution de gestion des métadonnées de documents de GroupDocs. La solution sert déjà les développeurs .NET et Java en tant qu’API sur site pour les développeurs et en tant qu’application gratuite d’éditeur de métadonnées de documents en ligne pour tout type d’utilisateur pour afficher et modifier les métadonnées des documents.

API Cloud de manipulation des métadonnées

GroupDocs.Metadata pour le cloud

GroupDocs.Metadata Cloud API et SDK permettant aux développeurs de manipuler (ajouter, supprimer, mettre à jour, extraire et afficher) les métadonnées de plus de 50 formats de fichiers.

GroupDocs.Metadata permet d’accéder et de traiter les métadonnées des fichiers de différentes manières, comme :

  • Nom de balise possible
  • Nom de la propriété
  • Valeur de la propriété
  • Faire correspondre l’expression exacte
  • Faire correspondre l’expression régulière
  • Arborescence complète des métadonnées
  • Étiqueter

Pour avoir une bien meilleure idée des fonctionnalités et du produit, vous pouvez toujours consulter le guide du développeur dans la section documentation.

Formats de documents pris en charge

Vous pouvez effectuer des opérations sur des documents qui peuvent être des documents de traitement de texte, des feuilles de calcul, des présentations, des fichiers audio et vidéo, des images, des PDF, des livres électroniques, des dessins et bien d’autres. Vous trouverez ci-dessous la liste des formats de fichiers actuellement pris en charge par l’API GroupDocs et qui, espérons-le, répondront à vos besoins. Vous pouvez consulter la documentation à tout moment pour connaître tous les formats de documents pris en charge ou tout type de conseils.

Métadonnées - SDK et exemples

Outre l’API REST d’édition de métadonnées pour le cloud, GroupDocs fournit également des SDK open source, par conséquent, ceux-ci peuvent être personnalisés en fonction des besoins. Les développeurs peuvent utiliser cURL pour interagir avec l’API GroupDocs.Metadata Cloud et peuvent également utiliser le ou les SDK pertinents pour accélérer le développement. Cela aide les développeurs à ne plus se soucier des détails de bas niveau pour faire une demande et gérer les réponses. Les SDK mentionnés ci-dessous ainsi que les exemples de code sont disponibles sur GitHub :

Dans ce blog. J’utilise le code Java pour montrer comment jouer avec les propriétés de métadonnées des documents. De plus, je ne montrerai qu’une seule des façons d’extraire, d’ajouter, de supprimer et de modifier les métadonnées. Vous pouvez également voir les exemples C# et d’autres méthodes en détail à partir de la documentation et des référentiels GitHub pertinents.

Extraire les métadonnées des fichiers en Java ou .NET

L’API vous permet d’extraire les métadonnées de vos documents avec différentes options qui incluent l’extraction :

  • Toute l’arborescence des propriétés des métadonnées
  • Par balise, nom ou valeur spécifié

Pour vous aider, les exemples d’exécution sont disponibles sur GitHub. J’ai téléchargé un exemple de groupdocs.app qui montre combien vous pouvez extraire et créer vos propres applications de métadonnées avec C# et Java.

Extraire l’arborescence complète des propriétés des métadonnées en Java

Après avoir défini la connexion avec votre stockage cloud, vous pouvez extraire toute l’arborescence des propriétés des métadonnées à l’aide des quelques lignes de code mentionnées ci-dessous. Ici, j’extrait l’arborescence des propriétés d’une feuille de calcul Excel à l’aide de Java SDK for Cloud. Vous pouvez facilement y parvenir en utilisant l’un des autres SDK disponibles.

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

Impression de l’arborescence complète des métadonnées en 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());
	}
}

Sortir

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

Toutes les autres méthodes d’extraction de métadonnées peuvent être consultées sur l’une des ressources suivantes :

Ajouter des métadonnées à l’aide de Java ou .NET

L’API REST GroupDocs Metadata vous permet d’ajouter des métadonnées à vos documents avec les fonctionnalités suivantes :

  • Les propriétés de métadonnées peuvent contenir différents types de valeurs comme String, DateTime, Integer, Double, Boolean
  • Les propriétés peuvent être ajoutées de différentes manières :
    • Ajouter une propriété de métadonnées par nom :
      • Partie du nom
      • Phrase exacte
      • Correspondance d’expression régulière
    • Ajouter une propriété de métadonnées par balise :
      • Balise exacte
      • Nom de balise possible

Ajouter une propriété de métadonnées par balise exacte en Java

Ci-dessous, vous pouvez voir l’exemple de code source pour ajouter la propriété metadata par une balise exacte :

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

Sortie : après avoir ajouté des métadonnées par balise

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

Toutes les autres façons d’ajouter des métadonnées peuvent être consultées sur l’une des ressources suivantes :

Supprimer les métadonnées à l’aide de Java ou .NET

Presque avec des options similaires pour ajouter les propriétés des métadonnées, vous pouvez également supprimer les propriétés des métadonnées de vos documents.

  • Les propriétés de métadonnées peuvent contenir différents types de valeurs comme String, DateTime, Integer, Double, Boolean.
  • Les propriétés de métadonnées peuvent être supprimées/supprimées de différentes manières :
    • Supprimer la propriété de métadonnées par nom :
      • Partie du nom
      • Phrase exacte
      • Expression régulière correspondante
    • Supprimer la propriété de métadonnées par balise :
      • Balise exacte
      • Nom de balise possible

Supprimer les métadonnées à l’aide d’une expression régulière (Regex) en Java

Ci-dessous, vous pouvez voir l’exemple de code source pour supprimer les propriétés de métadonnées qui correspondent à l’expression régulière fournie :

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

Sortie : après suppression des métadonnées par regex

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

Toutes les autres façons différentes de supprimer les métadonnées peuvent être consultées sur l’une des ressources suivantes :

Mettre à jour les métadonnées à l’aide de Java ou .NET

Outre l’ajout, la suppression et l’extraction des métadonnées, l’API REST permet de mettre à jour les propriétés des métadonnées existantes de différentes manières. Ci-dessous, je montrerai comment vous pouvez mettre à jour la propriété metadata de tout document à l’aide de code Java en fournissant le nom de balise possible de la propriété. J’ai utilisé une feuille de calcul Excel pour mettre à jour sa balise de métadonnées de créateur. Vous pouvez obtenir la même chose en C# en utilisant l’API .NET.

Mettre à jour les métadonnées par nom de balise possible à l’aide de 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());

Sortie : après avoir modifié les métadonnées par un nom de balise possible

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

Vous pouvez télécharger le document mis à jour à partir du chemin renvoyé dans la réponse. De plus, vous pouvez mettre à jour les propriétés existantes de la même manière, comme ajouter et supprimer des métadonnées. Des exemples et des explications peuvent être consultés sur les ressources suivantes de GroupDocs.Metadata Cloud API.

Parlons

Ceci résume la vue d’ensemble de GroupDocs.Metadata Cloud API. Vous pouvez maintenant créer votre propre application en utilisant les fonctionnalités décrites ci-dessus. Nous serons ravis si vous nous contactez sur le forum pour discuter, résoudre un problème ou partager vos commentaires. Merci.

Ressources