Exemple complet fonctionnel disponible sur GitHub :
read-and-write-xmp-in-psd-ai-files-java

L’ancienne méthode était pénible

Imaginez le nettoyage d’archives auquel personne ne se porte volontaire. Un dossier contenant des maîtres PSD et des sources AI a besoin d’avis de droits et de mots‑clés avant d’entrer dans le DAM. La routine : ouvrir un fichier dans Photoshop, ouvrir les Informations sur le fichier, taper le droit d’auteur, taper les mots‑clés, enregistrer, fermer, fichier suivant. Chaque enregistrement re‑rendu le fichier à calques simplement pour modifier quelques chaînes de métadonnées XMP. L’archive qui m’a enseigné cette leçon était un dossier de fichiers Illustrator non étiquetés que personne ne pouvait rechercher ; nous l’avons corrigé avec une boucle, pas avec plus de patience.

Multipliez cette routine par une archive et elle cesse d’être une tâche pour devenir un projet. Pire, elle devient non auditable : personne ne peut prouver après coup quels fichiers ont été traités, et ceux qui ont été sautés semblent identiques jusqu’à ce qu’une question de licence les révèle. La voie du panneau associe également silencieusement la saisie de données aux outils de conception. Qui que soit chargé de corriger les métadonnées a besoin d’une licence Adobe, d’une station de travail capable d’ouvrir confortablement les maîtres à calques, et de la patience d’attendre des enregistrements qui re‑rendent l’œuvre simplement pour changer des chaînes.

Le vrai coût d’une exécution manuelle : les métadonnées corrigées à la main sont des métadonnées que personne ne peut vérifier plus tard ; le processus ne laisse aucune trace sauf des concepteurs épuisés.

Il existe une meilleure façon

GroupDocs.Metadata for Java lit et écrit le paquet XMP directement. Cast getRootPackage() en IXmp et le paquet, ses schémas et ses tableaux sont des objets Java ordinaires, identiques pour les conteneurs PSD et AI, sans aucun logiciel Adobe impliqué. La documentation répertorie plus de 170 formats derrière la même API.

Avant de commencer, vous aurez besoin de :

Ajoutez la dépendance et le dépôt GroupDocs à votre pom.xml :

mvn dependency:get -Dartifact=com.groupdocs:groupdocs-metadata:24.7

Le dépôt compagnon fournit un pom.xml prêt à l’emploi ainsi que des échantillons des deux formats, et valide chaque étape ci‑dessous.

La nouvelle méthode : quatre opérations en Java

Étape 1 – Voir ce que le fichier transporte

Le snapshot exporte le paquet et chaque schéma dans un seul LinkedHashMap, en préservant l’ordre déclaré par le fichier.

// Snapshot the packet, then sweep for anything the schemes missed
Map<String, String> result = new LinkedHashMap<>();
try (Metadata metadata = new Metadata(adobeFilePath)) {
    IXmp root = (IXmp) metadata.getRootPackage();
    if (root != null && root.getXmpPackage() != null) {
        for (MetadataProperty p : root.getXmpPackage()) {
            put(result, p);
        }
        XmpSchemes schemes = root.getXmpPackage().getSchemes();
        collect(result, schemes.getDublinCore());
        collect(result, schemes.getPhotoshop());
        collect(result, schemes.getXmpBasic());
        collect(result, schemes.getCameraRaw());
    }
    for (MetadataProperty p : metadata.findProperties(new NamedPropertySpec())) {
        if (!result.containsKey(p.getName())) put(result, p);
    }
}
return result;

Les petites fonctions d’assistance put et collect privilégient getInterpretedValue() afin que les dates arrivent lisibles, et le balayage piloté par Specification capture les paquets fournisseurs. La version du dépôt parcourt sept schémas ; la forme reste la même.

Étape 2 – Lire les champs qui répondent aux questions

Les licences interrogent dc:rights. La recherche s’intéresse à dc:subject. Les deux vivent dans Dublin Core, et la lecture ciblée ne coûte que neuf champs, pas une traversée d’arbre.

// dc:* only - the interoperability fields DAM systems agree on
XmpDublinCorePackage dc = root.getXmpPackage().getSchemes().getDublinCore();
if (dc == null) return result;
for (MetadataProperty p : dc) {
    String value = "";
    if (p.getInterpretedValue() != null
            && p.getInterpretedValue().getRawValue() != null) {
        value = String.valueOf(p.getInterpretedValue().getRawValue());
    } else if (p.getValue() != null && p.getValue().getRawValue() != null) {
        value = String.valueOf(p.getValue().getRawValue());
    }
    result.put(p.getName(), value);
}

Le schéma Photoshop fonctionne de la même façon via des getters typés (getCity(), getCredit(), getColorMode() et cinq autres), couvrant les champs de métadonnées PSD lus par Bridge et Lightroom. Dans le dépôt, ce lecteur enveloppe chaque getter d’une aide null‑safe, de sorte qu’un fichier peu rempli renvoie des chaînes vides au lieu de surprises. Ce détail compte plus qu’il n’y paraît : le but de l’automatisation d’une archive est que les fichiers atypiques passent sans interrompre la boucle.

Les deux lectures ciblées partagent un profil de coût qui mérite d’être nommé. Un fichier ouvert, un schéma, aucune traversée d’arbre. Placez‑les dans des gestionnaires de requêtes et des portes ; conservez le snapshot complet pour les jobs d’ingestion qui stockent tout.

Étape 3 – Apposer un sceau et des tags sans ouvrir Adobe

Les écrivains créent de façon sécurisée tout ce qui manque, ce qui les rend sûrs pour les exportations fraîches ne contenant aucun paquet.

// Create missing layers, then write rights, creator, and CreatorTool
if (root.getXmpPackage() == null) {
    root.setXmpPackage(new XmpPacketWrapper());
}
if (root.getXmpPackage().getSchemes().getDublinCore() == null) {
    root.getXmpPackage().getSchemes().setDublinCore(new XmpDublinCorePackage());
}
XmpDublinCorePackage dc = root.getXmpPackage().getSchemes().getDublinCore();
dc.setRights(copyright);
dc.set("dc:creator", XmpArray.from(new String[]{creator}, XmpArrayType.Ordered));

if (root.getXmpPackage().getSchemes().getXmpBasic() == null) {
    root.getXmpPackage().getSchemes().setXmpBasic(new XmpBasicPackage());
}
root.getXmpPackage().getSchemes().getXmpBasic().setCreatorTool(creator);

metadata.save(outputPath);

Les mots‑clés suivent le même schéma avec un seul appel, écrivant l’ensemble du sac comme un tableau non ordonné :

// Replace the dc:subject bag - merge in Java first for additive tagging
root.getXmpPackage().getSchemes().getDublinCore().set(
        "dc:subject", XmpArray.from(keywords, XmpArrayType.Unordered));
metadata.save(outputPath);

Main.java ferme la boucle : il relit les sorties et vérifie que la chaîne de droits d’auteur et le premier mot‑clé ont réellement survécu à l’enregistrement.

Cette assertion finale mérite une phrase de plaidoyer. Les écritures de métadonnées échouent silencieusement lorsqu’elles échouent ; le fichier s’enregistre, les octets changent, et la valeur que vous vouliez écrire n’est tout simplement pas là parce qu’un objet de schéma était périmé ou qu’un chemin pointait vers l’original. Un re‑lecture après chaque écriture coûte une ouverture supplémentaire par fichier et transforme « le script est terminé » en « les valeurs sont présentes », ce qui est exactement ce que veut un propriétaire d’archive. Conservez‑la en production, pas seulement dans la démo.

Comment les mots‑clés rendent réellement les actifs trouvables ?

Les outils de recherche ne lisent pas les pixels ; ils lisent dc:subject. Bridge, les indexeurs DAM et les plateformes de stock traitent ce sac comme le vocabulaire de l’actif, de sorte qu’un fichier sans mots‑clés ne correspond jamais à une requête. Écrire le sac comme un XmpArray non ordonné, comme le fait AddKeywords, est ce qui fait passer un actif de « invisible » à « trouvable », et l’écriture ne coûte qu’un enregistrement.

Comparaison côte à côte : avant vs. après

Avant (édition via panneau) Après (pipeline Java)
Outils Photoshop ou Bridge par fichier Un projet Maven, aucune licence Adobe
Couverture Champs exposés par le panneau Tous les schémas plus les paquets fournisseurs
Répétabilité Dépend de qui a cliqué Même boucle, même résultat, auditable
Fichiers sans XMP Le comportement du panneau varie Les gardes créent le paquet et les schémas
Vérification Confiance Lecture de validation par fichier

La ligne de vérification décide pour les archives : un script qui prouve ses propres écritures fait la différence entre « nous avons tagué les fichiers » et « nous pouvons vous le montrer ».

Exemple réel : la remise d’agence

Un studio reçoit des livraisons mixtes PSD et AI de trois agences, chacune avec sa propre discipline de métadonnées. Leur job d’ingestion exécute maintenant le snapshot à l’arrivée, signale les fichiers dont dc:rights est vide, les scelle avec la ligne de droits contractuels, et écrit l’ensemble de mots‑clés de la campagne. La même boucle sert les deux formats parce que rien dans le code ne nomme un conteneur, et les métadonnées Illustrator arrivant vides laissent l’ingestion taguée et recherchable.

L’effet secondaire est la partie que le studio n’avait pas prévue : les tableaux de bord d’agence. Parce que le job d’ingestion journalise quelles livraisons sont arrivées avec des champs de droits vides, les achats voient maintenant quels fournisseurs livrent des métadonnées propres et lesquels comptent sur le client pour les corriger. La conversation avec le plus gros contrevenant s’est résumée à un seul graphique.

Que pouvez‑vous faire d’autre avec GroupDocs.Metadata ?

  • EXIF et IPTC dans les mêmes fichiers : les PSD contiennent trois normes de métadonnées ; la même bibliothèque lit les deux autres via leurs propres paquets, de sorte qu’un profil complet d’actif n’est qu’à deux lectures supplémentaires.
  • 170 + autres formats : le point d’entrée identique Metadata sert Office, PDF, audio et vidéo, ce qui explique comment un job d’ingestion finit par couvrir une archive totalement hétérogène.
  • Recherche de propriétés : findProperties avec une Specification balaie n’importe quel fichier selon le prédicat que vous définissez, des contrôles de droits aux recherches de champs personnalisés.

Conclusion

Ce qui était autrefois une routine de panneau par fichier est maintenant quatre opérations Java : snapshot, lecture ciblée, apposition de droits, écriture de mots‑clés. Le même code sert les fichiers PSD et AI, les gardes rendent les exportations vides sûres, et le projet d’exemple validé prouve l’ensemble avant que vous ne le pointiez vers une archive réelle.

Prêt à abandonner le panneau Informations sur le fichier ?

Ressources supplémentaires