Show Menu
SUJETS×

Utilisation des utilitaires XMP

A propos du service XMP Utilities
Les documents PDF contiennent des métadonnées, c’est-à-dire des informations sur le document qui se distinguent du contenu du document, telles que du texte et des graphiques. Adobe Extensible Metadata Platform (XMP) est une norme de gestion des métadonnées de document.
Le service XMP Utilities peut récupérer et enregistrer des métadonnées XMP à partir de documents PDF, et importer des métadonnées XMP dans des documents PDF.
Vous pouvez exécuter ces tâches à l’aide du service XMP Utilities :
For more information about the XMP Utilities service, see Services Reference for AEM Forms .

Importation de métadonnées dans des Documents PDF

Vous pouvez utiliser les API Javascript Utilitaires XMP et les API de service Web pour importer par programmation des métadonnées XMP dans un document PDF. Les métadonnées fournissent des informations sur un document PDF tel que l’auteur du document et les mots-clés associés au document. Les métadonnées se trouvent dans la boîte de dialogue Propriétés du Document du document, comme le montre l’illustration suivante.
Pour importer par programmation des métadonnées dans un document PDF, vous pouvez utiliser un document XML existant qui spécifie les valeurs de métadonnées ou vous pouvez utiliser un objet de type XMPUtilityMetadata . (Voir Référence sur les API AEM Forms.)
Cette section explique comment utiliser un document XML pour importer des métadonnées dans un document PDF.
Le code XML suivant contient des valeurs de métadonnées correspondant à l’illustration précédente. Par exemple, notez les éléments en gras, qui spécifient les mots-clés.
 <?xpacket begin="?" id="W5M0MpCehiHzreSzNTczkc9d"?>
 <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Adobe XMP Core 4.2-jc015 52.349034, 2008 Jun 20 00:30:39-PDT (debug)">
       <rdf:RDF xmlns:rdf="https://www.w3.org/1999/02/22-rdf-syntax-ns#">
          <rdf:Description rdf:about=""
                xmlns:xmp="https://ns.adobe.com/xap/1.0/">
             <xmp:MetadataDate>2008-10-22T10:52:21-04:00</xmp:MetadataDate>
             <xmp:CreatorTool>AEM Forms</xmp:CreatorTool>
             <xmp:ModifyDate>2008-10-22T10:52:21-04:00</xmp:ModifyDate>
             <xmp:CreateDate>2008-02-13T11:00:18-05:00</xmp:CreateDate>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:pdf="https://ns.adobe.com/pdf/1.3/">
             <pdf:Producer>AEM Forms</pdf:Producer>
             <pdf:Keywords>keyword1, keyword2, keyword3,keyword4</pdf:Keywords>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:xmpMM="https://ns.adobe.com/xap/1.0/mm/">
             <xmpMM:DocumentID>uuid:1cce1f84-331e-4d8d-8538-15441c271dd7</xmpMM:DocumentID>
             <xmpMM:InstanceID>uuid:cdda0ca6-7c91-4771-9dc9-796c8fe59350</xmpMM:InstanceID>
          </rdf:Description>
          <rdf:Description rdf:about=""
                >
             <dc:format>application/pdf</dc:format>
             <dc:description>
                <rdf:Alt>
                   <rdf:li xml:lang="x-default">Adobe Designer Sample</rdf:li>
                </rdf:Alt>
             </dc:description>
             <dc:title>
                <rdf:Alt>
                   <rdf:li xml:lang="x-default">Grant Application</rdf:li>
                </rdf:Alt>
             </dc:title>
             <dc:creator>
                <rdf:Seq>
                   <rdf:li>Tony Blue</rdf:li>
                </rdf:Seq>
             </dc:creator>
             <dc:subject>
                <rdf:Bag>
                   <rdf:li>keyword1</rdf:li>
                   <rdf:li>keyword2</rdf:li>
                   <rdf:li>keyword3</rdf:li>
                   <rdf:li>keyword4</rdf:li>
                </rdf:Bag>
             </dc:subject>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:desc="https://ns.adobe.com/xfa/promoted-desc/">
             <desc:version rdf:parseType="Resource">
                <rdf:value>1.0</rdf:value>
                <desc:ref>/template/subform[1]</desc:ref>
             </desc:version>
             <desc:contact rdf:parseType="Resource">
                <rdf:value>Adobe Systems Incorporated</rdf:value>
                <desc:ref>/template/subform[1]</desc:ref>
             </desc:contact>
          </rdf:Description>
       </rdf:RDF>
 </x:xmpmeta>

For more information about the XMP Utilities service, see Services Reference for AEM Forms .

Résumé des étapes

Pour importer des métadonnées XMP dans un document PDF, procédez comme suit :
  1. Incluez des fichiers de projet.
  2. Créez un client XMPUtilityService.
  3. Appelez l’opération d’importation des métadonnées XMP.
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.
Création d’un client XMPUtilityService
Avant de pouvoir exécuter une opération XMP Utilities par programmation, vous devez créer un client XMPUtilityService. Avec l’API Java, cela se fait en créant un XMPUtilityServiceClient objet. Avec l’API du service Web, cela se fait en utilisant un XMPUtilityServiceService objet.
Appeler l’opération d’importation des métadonnées XMP
Après avoir créé le client de service, vous pouvez appeler l’une des opérations d’importation de métadonnées XMP pour importer les métadonnées XMP dans le document PDF spécifié.
Voir également

Importation de métadonnées XMP à l’aide de l’API Java

Importez des métadonnées XMP à l’aide de l’API XMP Utilities (Java) :
  1. Inclure les fichiers de projet
    Incluez des fichiers JAR client, tels que adobe-pdfutility-client.jar, dans le chemin de classe de votre projet Java.
    Le fichier adobe-pdfutility-client.jar contient des classes qui vous permettent d’appeler par programmation le service XMP Utilities.
  2. Création d’un client XMPUtilityService
    Créez un XMPUtilityServiceClient objet en utilisant son constructeur et en transmettant un ServiceClientFactory objet contenant des propriétés de connexion.
  3. Appeler l’opération d’importation des métadonnées XMP
    Pour modifier les métadonnées XMP, appelez la XMPUtilityServiceClient méthode de l’objet ou sa importMetadata importXMP méthode.
    Si vous utilisez la importMetadata méthode, transmettez les valeurs suivantes :
    • Objet com.adobe.idp.Document représentant le fichier PDF.
    • Objet XMPUtilityMetadata contenant les métadonnées à importer.
    Si vous utilisez la importXMP méthode, transmettez les valeurs suivantes :
    • Objet com.adobe.idp.Document représentant le fichier PDF.
    • Objet com.adobe.idp.Document représentant un fichier XML contenant les métadonnées à importer.
    Dans les deux cas, la valeur renvoyée est un com.adobe.idp.Document objet qui représente le fichier PDF avec les métadonnées nouvellement importées. Vous pouvez ensuite enregistrer cet objet sur le disque.
Voir également

Importation de métadonnées XMP à l’aide de l’API du service Web

Pour importer par programmation des métadonnées XMP à l’aide de l’API du service Web XMP Utilities, effectuez les tâches suivantes :
  1. Inclure les fichiers de projet
  2. Création d’un client XMPUtilityService
    Créez un XMPUtilityServiceService objet en utilisant votre constructeur de classe proxy.
  3. Appeler l’opération d’importation des métadonnées XMP
    Pour modifier les métadonnées XMP, appelez la XMPUtilityServiceService méthode de l’objet ou sa importMetadata importXMP méthode.
    Si vous utilisez la importMetadata méthode, transmettez les valeurs suivantes :
    • Objet BLOB représentant le fichier PDF.
    • Objet XMPUtilityMetadata contenant les métadonnées à importer.
    Si vous utilisez la importXMP méthode, transmettez les valeurs suivantes :
    • Objet BLOB représentant le fichier PDF.
    • Objet BLOB représentant un fichier XML contenant les métadonnées à importer.
    Dans les deux cas, la valeur renvoyée est un BLOB objet qui représente le fichier PDF avec les métadonnées nouvellement importées. Vous pouvez ensuite enregistrer cet objet sur le disque.
Voir également

Exportation de métadonnées à partir de Documents PDF

Vous pouvez utiliser les API Javascript Utilitaires XMP et les API de service Web pour récupérer et enregistrer par programmation des métadonnées XMP à partir d’un document PDF.
For more information about the XMP Utilities service, see Services Reference for AEM Forms .

Résumé des étapes

Pour exporter des métadonnées XMP à partir d’un document PDF, procédez comme suit :
  1. Incluez des fichiers de projet.
  2. Créez un client XMPUtilityService.
  3. Appelez l’opération d’exportation des métadonnées XMP.
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.
Création d’un client XMPUtilityService
Avant de pouvoir exécuter une opération XMP Utilities par programmation, vous devez créer un client XMPUtilityService. Avec l’API Java, cela se fait en créant un XMPUtilityServiceClient objet. Avec l’API du service Web, cela se fait à l’aide d’un XMPUtilityServiceService objet.
Appeler l’opération d’exportation des métadonnées XMP
Après avoir créé le client de service, vous pouvez appeler l’une des opérations d’exportation de métadonnées XMP, qui peut être utilisée pour inspecter les métadonnées XMP ou les enregistrer sur le disque.
Voir également

Exportation des métadonnées XMP à l’aide de l’API Java

Exportez les métadonnées XMP à l’aide de l’API XMP Utilities (Java) :
  1. Inclure les fichiers de projet
    Incluez des fichiers JAR client, tels que adobe-pdfutility-client.jar, dans le chemin de classe de votre projet Java.
    Le fichier adobe-pdfutility-client.jar contient des classes qui vous permettent d’appeler par programmation le service XMP Utility.
  2. Création d’un client XMPUtilityService
    Créez un XMPUtilityServiceClient objet en utilisant son constructeur et en transmettant un ServiceClientFactory objet contenant des propriétés de connexion.
  3. Appeler l’opération d’importation des métadonnées XMP
    Pour inspecter les métadonnées XMP, appelez la XMPUtilityServiceClient méthode de l’objet et transmettez un exportMetadata com.adobe.idp.Document objet qui représente le fichier PDF. La méthode renvoie un XMPUtilityMetadata objet contenant les métadonnées récupérées.
    Pour récupérer et enregistrer les métadonnées XMP, appelez la XMPUtilityServiceClient méthode de l’objet et transmettez un exportXMP com.adobe.idp.Document objet qui représente le fichier PDF. La méthode renvoie un com.adobe.idp.Document objet qui contient les métadonnées récupérées, que vous pouvez ensuite enregistrer sur le disque en tant que fichier XML.
Voir également

Exportation des métadonnées XMP à l’aide de l’API du service Web

Exportez les métadonnées XMP à l’aide de l’API XMP Utilities (service Web) :
  1. Inclure les fichiers de projet
    • Créez un assembly client Microsoft .NET qui consomme le fichier WSDL du service XMP Utilities.
    • Référencez l'assembly client Microsoft .NET.
  2. Création d’un client XMPUtilityService
    Créez un XMPUtilityServiceService objet en utilisant votre constructeur de classe proxy.
  3. Appeler l’opération d’importation des métadonnées XMP
    Pour inspecter les métadonnées XMP, appelez la XMPUtilityServiceClient méthode de l’objet et transmettez un exportMetadata BLOB objet qui représente le fichier PDF. La méthode renvoie un XMPUtilityMetadata objet contenant les métadonnées récupérées.
    Pour récupérer et enregistrer les métadonnées XMP, appelez la XMPUtilityServiceClient méthode de l’objet et transmettez un exportXMP BLOB objet qui représente le fichier PDF. La méthode renvoie un BLOB objet qui contient les métadonnées récupérées, que vous pouvez ensuite enregistrer sur le disque en tant que fichier XML.
Voir également