使用XMP实用程序

本文档中的示例和示例仅适用于JEE环境上的AEM Forms。

关于XMP Utilities服务

PDF文档包含元数据,元数据是关于文档与文档内容区分的信息,如文本和图形。 Adobe Extensible Metadata Platform(XMP)是处理文档元数据的标准。

XMP实用程序服务可以从PDF文档检索和保存XMP元数据,并将XMP元数据导入PDF文档。

您可以使用XMP实用程序服务完成以下任务:

注意

有关XMP Utilities服务的详细信息,请参阅AEM Forms的服务参考。

将元数据导入PDF文档

您可以使用XMP实用程序Java和Web服务API以编程方式将XMP元数据导入PDF文档。 元数据提供有关PDF文档的信息,如文档的作者和与文档相关的关键字。 元数据可以位于文档的“文档属性”对话框中,如下图所示。

ww_ww_metadatadialog

要以编程方式将元数据导入PDF文档中,可以使用指定元数据值的现有XML文档,也可以使用类型为XMPUtilityMetadata的对象。 (请参阅AEM Forms API参考。)

注意

本节讨论如何使用XML文档将元数据导入PDF文档。

以下XML代码包含与上图对应的元数据值。 例如,请注意指定关键字的粗体项目。

 <?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>
注意

有关XMP Utilities服务的详细信息,请参阅AEM Forms的服务参考。

步骤的摘要

要将XMP元数据导入PDF文档,请执行以下步骤:

  1. 包括项目文件。
  2. 创建XMPUlityService客户端。
  3. 调用XMP元数据导入操作。

包括项目文件

在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序,请包含必要的JAR文件。 如果您使用Web服务,请确保包含代理文件。

创建XMPUtilityService客户端

在以编程方式执行XMP实用程序操作之前,必须创建XMPUtilityService客户端。 使用Java API,可通过创建XMPUtilityServiceClient对象来实现此目的。 使用Web服务API,可通过使用XMPUtilityServiceService对象来完成此操作。

调用XMP元数据导入操作

创建服务客户端后,可以调用某个XMP元数据导入操作,以将XMP元数据导入指定的PDF文档。

另请参阅

使用Java API导入XMP元数据

使用Web服务API导入XMP元数据

包括AEM Forms Java库文件

设置连接属性

使用Java API导入XMP元数据

使用XMP Utilities API(Java)导入XMP元数据:

  1. 包括项目文件

    在Java项目的类路径中包含客户端JAR文件,如adobe-pdfutility-client.jar。

    注意

    adobe-pdfutility-client.jar文件包含允许您以编程方式调用XMP Utilities服务的类。

  2. 创建XMPUtilityService客户端

    使用XMPUtilityServiceClient对象的构造函数并传递包含连接属性的ServiceClientFactory对象,创建对象。

  3. 调用XMP元数据导入操作

    要修改XMP元数据,请调用XMPUtilityServiceClient对象的importMetadata方法或其importXMP方法。

    如果使用importMetadata方法,请传递以下值:

    • 表示PDF文件的com.adobe.idp.Document对象。
    • 包含要导入的元数据的XMPUtilityMetadata对象。

    如果使用importXMP方法,请传递以下值:

    • 表示PDF文件的com.adobe.idp.Document对象。
    • 一个com.adobe.idp.Document对象,它表示包含要导入的元数据的XML文件。

    无论哪种情况,返回的值都是一个com.adobe.idp.Document对象,它表示包含新导入的元数据的PDF文件。 然后,可以将此对象保存到磁盘。

另请参阅

将元数据导入PDF文档

包括AEM Forms Java库文件

设置连接属性

使用Web服务API导入XMP元数据

要使用XMP Utilities Web服务API以编程方式导入XMP元数据,请执行以下任务:

  1. 包括项目文件

  2. 创建XMPUtilityService客户端

    使用代理类构造函数创建XMPUtilityServiceService对象。

  3. 调用XMP元数据导入操作

    要修改XMP元数据,请调用XMPUtilityServiceService对象的importMetadata方法或其importXMP方法。

    如果使用importMetadata方法,请传递以下值:

    • 表示PDF文件的BLOB对象。
    • 包含要导入的元数据的XMPUtilityMetadata对象。

    如果使用importXMP方法,请传递以下值:

    • 表示PDF文件的BLOB对象。
    • 一个BLOB对象,它表示包含要导入的元数据的XML文件。

    无论哪种情况,返回的值都是一个BLOB对象,它表示包含新导入的元数据的PDF文件。 然后,可以将此对象保存到磁盘。

另请参阅

将元数据导入PDF文档

使用Base64编码调用AEM Forms

创建使用Base64编码的.NET客户端程序集

从PDF文档导出元数据

您可以使用XMP实用程序Java和Web服务API以编程方式从PDF文档检索和保存XMP元数据。

注意

有关XMP Utilities服务的详细信息,请参阅AEM Forms的服务参考。

步骤的摘要

要从PDF文档导出XMP元数据,请执行以下步骤:

  1. 包括项目文件。
  2. 创建XMPUlityService客户端。
  3. 调用XMP元数据导出操作。

包括项目文件

在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序,请包含必要的JAR文件。 如果您使用Web服务,请确保包含代理文件。

创建XMPUtilityService客户端

在以编程方式执行XMP实用程序操作之前,必须创建XMPUtilityService客户端。 使用Java AP,如果通过创建XMPUtilityServiceClient对象来完成此操作。 使用Web服务API,可以使用XMPUtilityServiceService对象完成此操作。

调用XMP元数据导出操作

创建服务客户端后,可以调用某个XMP元数据导出操作,该操作可用于检查XMP元数据或将其保存到磁盘。

另请参阅

使用Java API导入XMP元数据

使用Web服务API导入XMP元数据

包括AEM Forms Java库文件

设置连接属性

使用Java API导出XMP元数据

使用XMP Utilities API(Java)导出XMP元数据:

  1. 包括项目文件

    在Java项目的类路径中包含客户端JAR文件,如adobe-pdfutility-client.jar。

    注意

    adobe-pdfutility-client.jar文件包含允许您以编程方式调用XMP Utility服务的类。

  2. 创建XMPUtilityService客户端

    使用XMPUtilityServiceClient对象的构造函数并传递包含连接属性的ServiceClientFactory对象,创建对象。

  3. 调用XMP元数据导入操作

    要检查XMP元数据,请调用XMPUtilityServiceClient对象的exportMetadata方法并传入表示PDF文件的com.adobe.idp.Document对象。 该方法返回一个XMPUtilityMetadata对象,该对象包含检索到的元数据。

    要检索和保存XMP元数据,请调用XMPUtilityServiceClient对象的exportXMP方法并传入表示PDF文件的com.adobe.idp.Document对象。 该方法返回一个com.adobe.idp.Document对象,该对象包含检索到的元数据,您随后可以将该元数据另存为XML文件保存到磁盘。

另请参阅

从PDF文档导出元数据

包括AEM Forms Java库文件

设置连接属性

使用Web服务API导出XMP元数据

使用XMP Utilities API(Web服务)导出XMP元数据:

  1. 包括项目文件

    • 创建一个使用XMP实用程序服务WSDL文件的Microsoft .NET客户端程序集。
    • 引用Microsoft .NET客户端程序集。
  2. 创建XMPUtilityService客户端

    使用代理类构造函数创建XMPUtilityServiceService对象。

  3. 调用XMP元数据导入操作

    要检查XMP元数据,请调用XMPUtilityServiceClient对象的exportMetadata方法并传入表示PDF文件的BLOB对象。 该方法返回一个XMPUtilityMetadata对象,该对象包含检索到的元数据。

    要检索和保存XMP元数据,请调用XMPUtilityServiceClient对象的exportXMP方法并传入表示PDF文件的BLOB对象。 该方法返回一个BLOB对象,该对象包含检索到的元数据,您随后可以将该元数据另存为XML文件保存到磁盘。

另请参阅

从PDF文档导出元数据

使用Base64编码调用AEM Forms

创建使用Base64编码的.NET客户端程序集

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free