使用XMP实用程序

关于XMP Utilities服务

PDF文档包含元数据，该元数据是关于文档与文档内容区分的信息，如文本和图形。 Adobe可扩展元数据平台(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 FormsAPI参考。)

注意

本节讨论如何使用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. 创建XMPUtilityService客户端。
  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 FormsJava库文件

设置连接属性

使用Java API导入XMP元数据

使用XMP实用程序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 FormsJava库文件

设置连接属性

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

要使用XMP实用程序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. 创建XMPUtilityService客户端。
  3. 调用XMP元数据导出操作。

包括项目文件

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

创建XMPUtilityService客户端

在以编程方式执行XMP实用程序操作之前，必须创建XMPUtilityService客户端。 对于Java AP，如果这是通过创建XMPUtilityServiceClient对象来完成的。 借助Web服务API，这是使用XMPUtilityServiceService对象实现的。

调用XMP元数据导出操作

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

另请参阅

使用Java API导入XMP元数据

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

包括AEM FormsJava库文件

设置连接属性

使用Java API导出XMP元数据

通过使用XMP实用程序API(Java)导出XMP元数据：

  1. 包括项目文件

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

    注意

    adobe-pdfutile-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 FormsJava库文件

设置连接属性

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

使用XMP实用程序API（Web服务）导出XMP元数据：

  1. 包括项目文件

    • 创建一个Microsoft .NET客户端程序集，它使用XMP实用程序服务WSDL文件。
    • 引用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