使用XMP实用程序 working-with-xmp-utilities

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

Developer

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

关于XMP Utilities服务

PDF文档包含元数据，该元数据是有关文档与文档内容（如文本和图形）区分开的信息。 Adobe可扩展元数据平台(XMP)是处理文档元数据的标准。

XMP Utilities服务可以从PDF文档中检索和保存XMP元数据，并将XMP元数据导入PDF文档。

您可以使用XMP Utilities服务完成这些任务：

将元数据导入PDF文档。 (请参阅将元数据导入PDF文档.)
从PDF文档导出元数据。 (请参阅从PDF文档导出元数据.)

NOTE

有关XMP Utilities服务的详细信息，请参见 AEM Forms的服务参考.

将元数据导入PDF文档 importing-metadata-into-pdf-documents

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

ww_ww_metadatadatalog

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

NOTE

本节讨论如何使用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>

NOTE

有关XMP Utilities服务的详细信息，请参见 AEM Forms的服务参考.

步骤摘要 summary-of-steps

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

包括项目文件。
创建XMPUtilityService客户端。
调用XMP元数据导入操作。

包含项目文件

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

创建XMPUtilityService客户端

必须先创建XMPUtilityService客户端，然后才能以编程方式执行XMP Utilities操作。使用Java API，可通过创建 XMPUtilityServiceClient 对象。使用Web服务API，可使用 XMPUtilityServiceService 对象。

调用XMP元数据导入操作

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

另请参阅

使用Java API导入XMP元数据 import-xmp-metadata-using-the-java-api

使用XMP实用程序API (Java)导入XMP元数据：

包含项目文件

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

note note
NOTE
adobe-pdfutility-client.jar文件包含类，这些类使您能够以编程方式调用XMP实用程序服务。

创建XMPUtilityService客户端

创建 XMPUtilityServiceClient 对象，使用它的构造函数传递 ServiceClientFactory 包含连接属性的对象。
调用XMP元数据导入操作

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

如果您使用 importMetadata 方法，传入以下值：
- A com.adobe.idp.Document 表示PDF文件的对象。
- An XMPUtilityMetadata 包含要导入的元数据的对象。
如果您使用 importXMP 方法，传入以下值：
- A com.adobe.idp.Document 表示PDF文件的对象。
- A com.adobe.idp.Document 表示包含要导入的元数据的XML文件的对象。
在任一情况下，返回值为 com.adobe.idp.Document 表示包含新导入的元数据的PDF文件的对象。然后可将此对象保存到磁盘。

另请参阅

将元数据导入PDF文档

包括AEM Forms Java库文件

设置连接属性

使用Web服务API导入XMP元数据 importing-xmp-metadata-using-the-web-service-api

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

包含项目文件
- 创建使用XMP Utilities服务WSDL文件的Microsoft .NET客户端程序集。 (请参阅使用Base64编码调用AEM Forms.)
- 引用Microsoft .NET客户端程序集。 (请参阅创建使用Base64编码的.NET客户端程序集.)
创建XMPUtilityService客户端

创建 XMPUtilityServiceService 对象。
调用XMP元数据导入操作

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

如果您使用 importMetadata 方法，传入以下值：
- A BLOB 表示PDF文件的对象。
- An XMPUtilityMetadata 包含要导入的元数据的对象。
如果您使用 importXMP 方法，传入以下值：
- A BLOB 表示PDF文件的对象。
- A BLOB 表示包含要导入的元数据的XML文件的对象。
在任一情况下，返回值为 BLOB 表示包含新导入的元数据的PDF文件的对象。然后可将此对象保存到磁盘。

另请参阅

将元数据导入PDF文档

使用Base64编码调用AEM Forms

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

从PDF文档导出元数据 exporting-metadata-from-pdf-documents

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

NOTE

有关XMP Utilities服务的详细信息，请参见 AEM Forms的服务参考.

步骤摘要 summary_of_steps-1

要从PDF文档中导出XMP元数据，请执行以下步骤：

包括项目文件。
创建XMPUtilityService客户端。
调用XMP元数据导出操作。

包含项目文件

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

创建XMPUtilityService客户端

必须先创建XMPUtilityService客户端，然后才能以编程方式执行XMP Utilities操作。使用Java AP，可通过创建 XMPUtilityServiceClient 对象。使用Web服务API，可使用 XMPUtilityServiceService 对象。

调用XMP元数据导出操作

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

另请参阅

使用Java API导出XMP元数据 export-xmp-metadata-using-the-java-api

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

包含项目文件

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

note note
NOTE
adobe-pdfutility-client.jar文件包含一些类，这些类使您能够以编程方式调用XMP实用程序服务。

创建XMPUtilityService客户端

创建 XMPUtilityServiceClient 对象，使用它的构造函数传递 ServiceClientFactory 包含连接属性的对象。
调用XMP元数据导入操作

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

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

另请参阅

从PDF文档导出元数据

包括AEM Forms Java库文件

设置连接属性

使用Web服务API导出XMP元数据 export-xmp-metadata-using-the-web-service-api

使用XMP Utilities API（Web服务）导出XMP元数据：

包含项目文件
- 创建使用XMP Utilities服务WSDL文件的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
创建XMPUtilityService客户端

创建 XMPUtilityServiceService 对象。
调用XMP元数据导入操作

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

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

另请参阅

从PDF文档导出元数据

使用Base64编码调用AEM Forms

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

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2