Importing Metadata into PDF Documents

You can use the XMP Utilities Java and web service APIs to programmatically import XMP metadata into a PDF document. Metadata provides information about a PDF document such as the document’s author and keywords related to the document. Metadata can be located in the document’s Document Properties dialog, as shown in the following illustration.

To programmatically import metadata into a PDF document, you can use an existing XML document that specifies the metadata values or you can use an object of type XMPUtilityMetadata. (See LiveCycle API Reference.)

Remarque : This section discusses how to use an XML document to import metadata into a PDF document.

The following XML code contains metadata values that correspond to the previous illustration. For example, notice the bold items, which specify keywords.

<?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="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> 
         <rdf:Description rdf:about="" 
               xmlns:xmp="http://ns.adobe.com/xap/1.0/"> 
            <xmp:MetadataDate>2008-10-22T10:52:21-04:00</xmp:MetadataDate> 
            <xmp:CreatorTool>Adobe LiveCycle Output 8.2</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="http://ns.adobe.com/pdf/1.3/"> 
            <pdf:Producer>Adobe LiveCycle Output 8.2</pdf:Producer> 
            <pdf:Keywords>keyword1, keyword2, keyword3,keyword4</pdf:Keywords> 
         </rdf:Description> 
         <rdf:Description rdf:about="" 
               xmlns:xmpMM="http://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="" 
               xmlns:dc="http://purl.org/dc/elements/1.1/"> 
            <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="http://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 : For more information about the XMP Utilities service, see Services Reference for LiveCycle.

Summary of steps

To import XMP metadata into a PDF document, perform the following steps:

  1. Include project files.

  2. Create an XMPUtilityService client.

  3. Invoke the XMP metadata import operation.

Include project files

Include necessary files into your development project. If you are creating a client application using Java, include the necessary JAR files. If you are using web services, ensure that you include the proxy files.

Create an XMPUtilityService client

Before you can programmatically perform an XMP Utilities operation, you must create an XMPUtilityService client. With the Java API, this is accomplished by creating an XMPUtilityServiceClient object. With the web service API, this is accomplished by using an XMPUtilityServiceService object.

Invoke the XMP metadata import operation

After you create the service client, you can invoke one of the XMP metadata import operations to import the XMP metadata into the specified PDF document.

Import XMP metadata using the Java API

Import XMP metadata by using the XMP Utilities API (Java):

  1. Include project files

    Include client JAR files, such as adobe-pdfutility-client.jar, in your Java project’s class path.

    Remarque : The adobe-pdfutility-client.jar file contains classes that enable you to programmatically invoke the XMP Utilities service.
  2. Create an XMPUtilityService client

    Create an XMPUtilityServiceClient object by using its constructor and passing a ServiceClientFactory object that contains connection properties.

  3. Invoke the XMP metadata import operation

    To modify the XMP metadata, invoke either the XMPUtilityServiceClient object’s importMetadata method or its importXMP method.

    If you use the importMetadata method, pass in the following values:

    • A com.adobe.idp.Document object that represents the PDF file.

    • An XMPUtilityMetadata object that contains the metadata to be imported.

    If you use the importXMP method, pass in the following values:

    • A com.adobe.idp.Document object that represents the PDF file.

    • A com.adobe.idp.Document object that represents an XML file that contains the metadata to be imported.

    In either case, the returned value is a com.adobe.idp.Document object that represents the PDF file with the newly imported metadata. You can then save this object to disk.

Importing XMP metadata using the web service API

To programmatically import XMP metadata using the XMP Utilities web service API, perform the following tasks:

  1. Include project files

  2. Create an XMPUtilityService client

    Create an XMPUtilityServiceService object by using your proxy class constructor.

  3. Invoke the XMP metadata import operation

    To modify the XMP metadata, invoke either the XMPUtilityServiceService object’s importMetadata method or its importXMP method.

    If you use the importMetadata method, pass in the following values:

    • A BLOB object that represents the PDF file.

    • An XMPUtilityMetadata object that contains the metadata to be imported.

    If you use the importXMP method, pass in the following values:

    • A BLOB object that represents the PDF file.

    • A BLOB object that represents an XML file that contains the metadata to be imported.

    In either case, the returned value is a BLOB object that represents the PDF file with the newly imported metadata. You can then save this object to disk.