Utilisation de XMP Utilitaires

À propos du service XMP Utilities

Les documents de PDF contiennent des métadonnées, qui sont des informations sur le document qui se distinguent du contenu du document, telles que le texte et les 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 XMP métadonnées à partir de documents PDF, et importer des métadonnées dans des documents PDF.

Vous pouvez accomplir ces tâches à l’aide du service XMP Utilities :

REMARQUE

Pour plus d’informations sur le service XMP Utilities, voir Référence des services pour AEM Forms.

Importation de métadonnées dans des documents PDF

Vous pouvez utiliser les API Java et de service Web de XMP Utilities pour importer par programmation XMP métadonnées dans un document de PDF. Les métadonnées fournissent des informations sur un document de PDF, comme l’auteur du document et les mots-clés associés au document. Les métadonnées peuvent se trouver dans la boîte de dialogue Propriétés du document, comme illustré ci-dessous.

www_www_metadatadialog

Pour importer des métadonnées par programmation dans un document de 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 de l’API AEM Forms.)

REMARQUE

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 qui correspondent à 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>
REMARQUE

Pour plus d’informations sur le service XMP Utilities, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour importer XMP métadonnées dans un document PDF, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez un client XMPUtilityService.
  3. Appelez l’opération d’importation de 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 d’effectuer par programmation une opération XMP Utilities, vous devez créer un client XMPUtilityService . Avec l’API Java, vous pouvez y parvenir en créant une XMPUtilityServiceClient . Avec l’API de service Web, vous pouvez y parvenir en utilisant une XMPUtilityServiceService .

Appeler l’opération d’importation de 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 de PDF spécifié.

Voir également

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

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

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

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

Importez XMP métadonnées à l’aide de l’API XMP Utilities (Java) :

  1. Inclure les fichiers de projet

    Incluez les fichiers JAR client, tels que adobe-pdfutility-client.jar, dans le chemin de classe de votre projet Java.

    REMARQUE

    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 en utilisant son constructeur et en transmettant un objet ServiceClientFactory contenant des propriétés de connexion.

  3. Appeler l’opération d’importation de métadonnées XMP

    Pour modifier les métadonnées XMP, appelez l’une des méthodes suivantes : XMPUtilityServiceClient de importMetadata ou son importXMP .

    Si vous utilisez la variable importMetadata , transmettez les valeurs suivantes :

    • A com.adobe.idp.Document qui représente le fichier du PDF.
    • Un XMPUtilityMetadata contenant les métadonnées à importer.

    Si vous utilisez la variable importXMP , transmettez les valeurs suivantes :

    • A com.adobe.idp.Document qui représente le fichier du PDF.
    • A com.adobe.idp.Document qui représente un fichier XML contenant les métadonnées à importer.

    Dans les deux cas, la valeur renvoyée est une com.adobe.idp.Document qui représente le fichier du 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 dans des documents PDF

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

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

Pour importer par programmation XMP métadonnées à 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 en utilisant votre constructeur de classe proxy.

  3. Appeler l’opération d’importation de métadonnées XMP

    Pour modifier les métadonnées XMP, appelez l’une des méthodes suivantes : XMPUtilityServiceService de importMetadata ou son importXMP .

    Si vous utilisez la variable importMetadata , transmettez les valeurs suivantes :

    • A BLOB qui représente le fichier du PDF.
    • Un XMPUtilityMetadata contenant les métadonnées à importer.

    Si vous utilisez la variable importXMP , transmettez les valeurs suivantes :

    • A BLOB qui représente le fichier du PDF.
    • A BLOB qui représente un fichier XML contenant les métadonnées à importer.

    Dans les deux cas, la valeur renvoyée est une BLOB qui représente le fichier du 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 dans des documents PDF

Appel d’AEM Forms à l’aide du codage Base64

Création d’un assemblage client .NET utilisant le codage Base64

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

Vous pouvez utiliser les API Java et de service Web de XMP Utilities pour récupérer et enregistrer XMP métadonnées par programmation à partir d’un document de PDF.

REMARQUE

Pour plus d’informations sur le service XMP Utilities, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour exporter XMP métadonnées d’un document de PDF, procédez comme suit :

  1. Inclure les 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 d’effectuer par programmation une opération XMP Utilities, vous devez créer un client XMPUtilityService . Avec l’API Java, vous pouvez y parvenir en créant une XMPUtilityServiceClient . Avec l’API de service Web, cette opération s’effectue à l’aide d’une XMPUtilityServiceService .

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 examiner les métadonnées XMP ou les enregistrer sur le disque.

Voir également

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

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

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

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

Exportez XMP métadonnées à l’aide de l’API XMP Utilities (Java) :

  1. Inclure les fichiers de projet

    Incluez les fichiers JAR client, tels que adobe-pdfutility-client.jar, dans le chemin de classe de votre projet Java.

    REMARQUE

    Le fichier adobe-pdfutility-client.jar contient des classes qui vous permettent d’appeler par programmation le service d’utilitaire XMP.

  2. Création d’un client XMPUtilityService

    Créez un XMPUtilityServiceClient en utilisant son constructeur et en transmettant un objet ServiceClientFactory contenant des propriétés de connexion.

  3. Appeler l’opération d’importation de métadonnées XMP

    Pour examiner les métadonnées XMP, appelez la méthode XMPUtilityServiceClient de exportMetadata et transmettre une com.adobe.idp.Document qui représente le fichier du PDF. La méthode renvoie une XMPUtilityMetadata contenant les métadonnées récupérées.

    Pour récupérer et enregistrer les métadonnées XMP, appelez la méthode XMPUtilityServiceClient de exportXMP et transmettre une com.adobe.idp.Document qui représente le fichier du PDF. La méthode renvoie une com.adobe.idp.Document 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 de métadonnées à partir de documents PDF

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

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

Exportez XMP métadonnées à l’aide de l’API XMP Utilities (service Web) :

  1. Inclure les fichiers de projet

    • Créez un assemblage client Microsoft .NET qui utilise le fichier WSDL du service XMP Utilities.
    • Référencez l’assemblage client Microsoft .NET.
  2. Création d’un client XMPUtilityService

    Créez un XMPUtilityServiceService en utilisant votre constructeur de classe proxy.

  3. Appeler l’opération d’importation de métadonnées XMP

    Pour examiner les métadonnées XMP, appelez la méthode XMPUtilityServiceClient de exportMetadata et transmettre une BLOB qui représente le fichier du PDF. La méthode renvoie une XMPUtilityMetadata contenant les métadonnées récupérées.

    Pour récupérer et enregistrer les métadonnées XMP, appelez la méthode XMPUtilityServiceClient de exportXMP et transmettre une BLOB qui représente le fichier du PDF. La méthode renvoie une BLOB 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 de métadonnées à partir de documents PDF

Appel d’AEM Forms à l’aide du codage Base64

Création d’un assemblage client .NET utilisant le codage Base64

Sur cette page