使用XMP实用程序 working-with-xmp-utilities
本文档中的示例和示例仅适用于JEE环境上的AEM Forms。
关于XMP Utilities服务
PDF文档包含元数据，该元数据是有关文档与文档内容（如文本和图形）区分开的信息。 Adobe可扩展元数据平台(XMP)是处理文档元数据的标准。
XMP Utilities服务可以从PDF文档中检索和保存XMP元数据，并将XMP元数据导入PDF文档。
您可以使用XMP Utilities服务完成这些任务：
- 将元数据导入PDF文档。 (请参阅将元数据导入PDF文档。)
- 从PDF文档导出元数据。 (请参阅从PDF文档导出元数据。)
将元数据导入PDF文档 importing-metadata-into-pdf-documents
您可以使用XMP实用程序Java和Web服务API以编程方式将XMP元数据导入PDF文档。 元数据提供有关PDF文档的信息，例如文档的作者以及与文档相关的关键字。 元数据可以在文档的文档属性对话框中，如下图所示。
若要以编程方式将元数据导入PDF文档，可以使用指定元数据值的现有XML文档，也可以使用XMPUtilityMetadata类型的对象。 (请参阅AEM Forms API引用。)
以下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>
步骤摘要 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方法，请传入以下值：- 表示PDF文件的
com.adobe.idp.Document对象。 - 包含要导入的元数据的
XMPUtilityMetadata对象。
如果您使用
importXMP方法，请传入以下值：- 表示PDF文件的
com.adobe.idp.Document对象。 - 一个
com.adobe.idp.Document对象，表示包含要导入的元数据的XML文件。
在任一情况下，返回的值都是
com.adobe.idp.Document对象，它表示包含新导入元数据的PDF文件。 然后可将此对象保存到磁盘。 - 表示PDF文件的
另请参阅
使用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方法，请传入以下值：- 表示PDF文件的
BLOB对象。 - 包含要导入的元数据的
XMPUtilityMetadata对象。
如果您使用
importXMP方法，请传入以下值：- 表示PDF文件的
BLOB对象。 - 一个
BLOB对象，表示包含要导入的元数据的XML文件。
在任一情况下，返回的值都是
BLOB对象，它表示包含新导入元数据的PDF文件。 然后可将此对象保存到磁盘。 - 表示PDF文件的
另请参阅
从PDF文档导出元数据 exporting-metadata-from-pdf-documents
您可以使用XMP实用程序Java和Web服务API以编程方式从PDF文档中检索和保存XMP元数据。
步骤摘要 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方法，并传入表示PDF文件的com.adobe.idp.Document对象。 该方法返回包含检索到的元数据的XMPUtilityMetadata对象。要检索和保存XMP元数据，请调用
XMPUtilityServiceClient对象的exportXMP方法，并传入表示PDF文件的com.adobe.idp.Document对象。 该方法返回包含检索到的元数据的com.adobe.idp.Document对象，随后可将该元数据另存为XML文件保存到磁盘。
另请参阅
使用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方法，并传入表示PDF文件的BLOB对象。 该方法返回包含检索到的元数据的XMPUtilityMetadata对象。要检索和保存XMP元数据，请调用
XMPUtilityServiceClient对象的exportXMP方法，并传入表示PDF文件的BLOB对象。 该方法返回包含检索到的元数据的BLOB对象，随后可将该元数据另存为XML文件保存到磁盘。
另请参阅