使用PDF实用程序 working-with-pdf-utilities
本文档中的示例和示例仅适用于JEE环境上的AEM Forms。
关于PDF实用工具服务
PDF实用程序服务可以在PDF和XDP文件格式之间进行转换,设置和检索PDF文档属性,以及处理XMP元数据。 例如,在将PDF文档转换为另一种格式之前,检查其属性以确定要为转换调用哪个服务操作很有用。
您可以使用“PDF实用程序”服务完成这些任务:
- 将PDF文档转换为XDP文档。
- 将XDP文档转换为PDF文档。 (请参阅将XDP文档转换为PDF文档。)
- 检索PDF文档属性。 (请参阅检索PDF文档属性。)
- 保存PDF文档并优化该文档,以便快速进行Web查看。 (请参阅设置PDF文档保存模式。)
将PDF文档转换为XDP文档 converting-pdf-documents-into-xdp-documents
您可以使用PDF实用程序Java和Web服务API以编程方式将PDF文档转换为XDP文档。
步骤摘要 summary-of-steps
要将PDF文档转换为XDP文档,请执行以下步骤:
- 包括项目文件。
- 创建PDFUtilityService客户端。
- 调用PDF到XDP的转换操作。
包含项目文件
在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序,请包含必要的JAR文件。 如果使用Web服务,请确保包含代理文件。
创建PDFUtilityService客户端
必须先创建PDFUtilityService客户端,然后才能以编程方式执行PDF实用程序操作。 使用Java API,可通过创建PDFUtilityServiceClient
对象来实现这一点。 使用Web服务API,可使用PDFUtilityServiceService
对象实现此目的。
调用PDF到XDP的转换操作
创建服务客户端后,可以调用PDF到XDP的转换操作。
另请参阅
使用Java API将PDF文档转换为XDP文档 convert-pdf-documents-into-xdp-documents-using-the-java-api
使用PDF实用程序API(Java)将PDF文档转换为XDP文档:
-
包含项目文件
将客户端JAR文件(如adobe-pdfutility-client.jar)包含在Java项目的类路径中。
-
创建PDFUtilityService客户端
使用对象的构造函数创建
PDFUtilityServiceClient
对象,并传递包含连接属性的ServiceClientFactory
对象。 -
调用PDF到XDP的转换操作
要执行转换,请调用
PDFUtilityServiceClient
对象的convertPDFtoXDP
方法,并传入表示PDF文件的com.adobe.idp.Document
对象。 该方法返回表示新创建的XDP文件的com.adobe.idp.Document
对象。
另请参阅
使用Web服务API将PDF文档转换为XDP文档 convert-pdf-documents-into-xdp-documents-using-the-web-service-api
使用PDF实用程序API(Web服务)将PDF文档转换为XDP文档:
-
包含项目文件
- 创建使用PDF实用程序服务WSDL文件的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
-
创建PDFUtilityService客户端
使用代理类构造函数创建
PDFUtilityServiceService
对象。 -
调用PDF到XDP的转换操作
调用
PDFUtilityServiceService
对象的convertPDFtoXDP
方法,并传入表示PDF文件的BLOB
对象。 该方法返回表示新创建的XDP文件的BLOB
对象。
另请参阅
将XDP文档转换为PDF文档 converting-xdp-documents-into-pdf-documents
您可以使用PDF实用程序Java和Web服务API以编程方式将XDP文档转换为PDF文档。
步骤摘要 summary_of_steps-1
要将XDP文档转换为PDF文档,请执行以下步骤:
- 包括项目文件。
- 创建PDFUtilityService客户端。
- 调用XDP以PDF转换操作。
包含项目文件
在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序,请包含必要的JAR文件。 如果使用Web服务,请确保包含代理文件。
创建PDFUtilityService客户端
必须先创建PDFUtilityService客户端,然后才能以编程方式执行PDF实用程序操作。 使用Java API,可通过创建PDFUtilityServiceClient
对象来实现这一点。 使用Web服务API,可使用PDFUtilityServiceService
对象实现此目的。
调用XDP以PDF转换操作
创建服务客户端后,可以调用XDP以PDF转换操作。
另请参阅
使用Java API将XDP文档转换为PDF文档 convert-xdp-documents-into-pdf-documents-using-the-java-api
使用PDF实用程序API (Java)将XDP文档转换为PDF文档:
-
包含项目文件
将客户端JAR文件(如adobe-pdfutility-client.jar)包含在Java项目的类路径中。
-
创建PDFUtilityService客户端
使用对象的构造函数创建
PDFUtilityServiceClient
对象,并传递包含连接属性的ServiceClientFactory
对象。 -
调用XDP以PDF转换操作
要执行转换,请调用
PDFUtilityServiceClient
对象的convertXDPtoPDF
方法,并传入表示XDP文件的com.adobe.idp.Document
对象。 该方法返回表示新创建的PDF文件的com.adobe.idp.Document
对象。
另请参阅
使用Web服务API将XDP文档转换为PDF文档 converting-xdp-documents-into-pdf-documents-using-the-web-service-api
使用PDF实用程序API(Web服务API)将XDP文档转换为PDF文档:
-
包含项目文件
- 创建使用PDF实用程序服务WSDL文件的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
-
创建PDFUtilityService客户端
使用代理类构造函数创建
PDFUtilityServiceService
对象。 -
调用XDP以PDF转换操作
要执行转换,请调用
PDFUtilityServiceService
对象的convertXDPtoPDF
方法,并传入表示XDP文件的BLOB
对象。 该方法返回表示新创建的PDF文件的BLOB
对象。
另请参阅
检索PDF文档属性 retrieving-pdf-document-properties
您可以使用PDF实用程序Java和Web服务API以编程方式检索PDF文档属性,例如文档是可填写表单还是读取文档所需的最低Acrobat版本。
步骤摘要 summary_of_steps-2
要检索PDF文档属性,请执行以下步骤:
- 包括项目文件。
- 创建PDFUtilityService客户端。
- 调用属性检索操作。
包含项目文件
在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序,请包含必要的JAR文件。 如果使用Web服务,请确保包含代理文件。
创建PDFUtilityService客户端
必须先创建PDFUtilityService客户端,然后才能以编程方式执行PDF实用程序操作。 使用Java API,可通过创建PDFUtilityServiceClient
对象来实现这一点。 使用Web服务API,可使用PDFUtilityServiceService
对象完成此操作。
调用属性检索操作
创建服务客户端后,可以调用属性检索操作。
另请参阅
使用Java API检索PDF文档属性 retrieve-pdf-document-properties-using-the-java-api
使用PDF实用程序API (Java)检索PDF文档属性:
-
包含项目文件
将客户端JAR文件(如adobe-pdfutility-client.jar)包含在Java项目的类路径中。
-
创建PDFUtilityService客户端
使用对象的构造函数创建
PDFUtilityServiceClient
对象,并传递包含连接属性的ServiceClientFactory
对象。 -
调用属性检索操作
要执行转换,请调用
PDFUtilityServiceClient
对象的getPDFProperties
方法,并传入以下内容:- 表示PDF文档的
com.adobe.idp.Document
对象。 - 包含要计算的属性的
PDFPropertiesOptionSpec
对象。
该方法返回包含查询结果的
PDFPropertiesResult
对象。 - 表示PDF文档的
另请参阅
使用Web服务API检索PDF文档属性 retrieve-pdf-document-properties-using-the-web-service-api
使用PDF实用程序Web服务API检索PDF文档属性:
-
包含项目文件
- 创建使用PDF实用程序服务WSDL文件的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
-
创建PDFUtilityService客户端
使用代理类构造函数创建
PDFUtilityServiceService
对象。 -
调用属性检索操作
要执行转换,请调用
PDFUtilityServiceService
对象的getPDFProperties
方法,并传入以下内容:- 表示PDF文档的
BLOB
对象。 - 包含要计算的属性的
PDFPropertiesOptionSpec
对象。
该方法返回包含查询结果的
PDFPropertiesResult
对象。 - 表示PDF文档的
另请参阅
设置PDF文档保存模式 setting-pdf-document-save-modes
您可以使用PDF实用程序服务Java和Web服务API以编程方式设置PDF文档的保存模式。 使用“PDF实用程序”服务设置保存模式时,“PDF实用程序”服务仅设置保存模式,实际上并不保存PDF文档。 PDF文档在传递到另一个服务操作时进行保存。 例如,您可以使用“PDF实用工具”服务设置特定的保存模式,并将其传递给“加密”服务,PDF文档将在此进行实际保存和加密。
步骤摘要 summary_of_steps-3
要为PDF文档设置保存选项,请执行以下步骤:
- 包括项目文件。
- 创建PDFUtilityService客户端。
- 设置保存模式。
- 调用保存操作。
- 将PDF文档传递到另一个操作。
包含项目文件
在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序,请包含必要的JAR文件。 如果使用Web服务,请确保包含代理文件。
创建PDFUtilityService客户端
必须先创建PDFUtilityService客户端,然后才能以编程方式执行PDF实用程序操作。 使用Java API,可通过创建PDFUtilityServiceClient
对象来实现这一点。 使用Web服务API,可使用PDFUtilityServiceService
对象完成此操作。
设置保存模式
您可以选择以下保存选项之一:
INCREMENTAL
:递增保存以缩短保存所需的时间FAST_WEB_VIEW
:保存以快速Web查看FULL
:使用完全保存(无优化)进行保存
调用保存样式操作
创建服务客户端后,可以调用属性检索操作。
将PDF文档传递到另一个AEM Forms操作
一旦PDF实用程序服务设置了指定的保存模式,请将PDF文档传递给另一个AEM Forms操作。 从操作返回后,PDF文档将以指定模式保存。 例如,如果您使用PDF实用程序服务设置FAST_WEB_VIEW
模式,然后将PDF文档传递到加密服务的encryptUsingPassword
操作,则返回的PDF文档将用密码加密,并保存为FAST_WEB_VIEW
模式。
FAST_WEB_VIEW
模式,然后将PDF文档传递到加密服务的encryptUsingPassword
操作。另请参阅
使用Java API设置PDF文档保存选项 set-pdf-document-save-options-using-the-java-api
使用PDF实用程序API (Java)设置PDF文档保存选项:
-
包含项目文件
将客户端JAR文件(如adobe-pdfutility-client.jar)包含在Java项目的类路径中。
-
创建PDFUtilityService客户端
使用对象的构造函数创建
PDFUtilityServiceClient
对象,并传递包含连接属性的ServiceClientFactory
对象。 -
设置保存模式
- 使用构造函数创建
PDFUtilitySaveMode
对象。 - 通过调用
PDFUtilitySaveMode
对象的setSaveStyle
方法并传递指定保存模式的字符串值来设置保存模式。 例如,若要保存以快速Web查看,请传递FAST_WEB_VIEW
。
- 使用构造函数创建
-
调用保存样式操作
调用
PDFUtilityServiceClient
对象的setSaveMode
方法并传递以下值:- 表示PDF文档的
com.adobe.idp.Document
对象。 - 包含要使用的保存样式的
PDFUtilitySaveMode
对象。 - 一个布尔值,用于确定是否覆盖任何以前的设置。
该方法返回使用指定保存样式格式化的
com.adobe.idp.Document
对象。 - 表示PDF文档的
-
将PDF文档传递到另一个AEM Forms操作
- 将返回的
com.adobe.idp.Document
对象传递到另一个AEM Forms操作。
- 将返回的
另请参阅
使用Web服务API设置PDF文档保存选项 set-pdf-document-save-options-using-the-web-service-api
使用PDF实用程序AP(Web服务)设置PDF文档保存选项:
-
包含项目文件
- 创建使用PDF实用程序服务WSDL文件的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
-
创建PDFUtilityService客户端
使用代理类构造函数创建
PDFUtilityServiceService
对象。 -
设置保存模式
- 使用构造函数创建
PDFUtilitySaveMode
对象。 - 通过为
PDFUtilitySaveMode
对象的saveStyle
方法指定字符串值来设置保存模式,该方法指定保存模式。 例如,要保存以快速Web查看,请指定FAST_WEB_VIEW
。
- 使用构造函数创建
-
调用保存样式操作
调用
PDFUtilityServiceService
对象的setSaveMode
方法并传递以下值:- 表示PDF文档的
BLOB
对象。 - 包含要使用的保存样式的
PDFUtilitySaveMode
对象。 - 一个布尔值,用于确定是否覆盖任何以前的设置。
该方法返回使用指定保存样式格式化的
BLOB
对象。 然后可将该对象另存为PDF文档。 - 表示PDF文档的
-
将PDF文档传递到另一个Forms操作
- 将返回的
BLOB
对象传递到另一个AEM Forms操作。
- 将返回的
另请参阅
清理PDF文档 sanitizing-pdf-documents
您可以使用PDF实用程序Java API以编程方式将PDF文档转换为XDP文档。
步骤摘要 summary_of_steps-4
要整理PDF文档,请执行以下步骤:
- 包括项目文件。
- 创建PDFUtilityService客户端。
- 调用清理操作。
包含项目文件
在开发项目中包含必要的文件。 要使用Java创建客户端应用程序,请包含必要的JAR文件。
创建PDFUtilityService客户端
必须先创建PDFUtilityService客户端,然后才能以编程方式执行清理操作。 使用Java API,可通过创建PDFUtilityServiceClient
对象来实现这一点。
调用PDF到XDP的转换操作
创建服务客户端后,可以调用清理操作。
另请参阅
使用Java API整理PDF文档 sanitize-pdf-documents-using-the-java-api
使用PDF实用程序API (Java)整理文档:
-
包含项目文件
将客户端JAR文件(如adobe-pdfutility-client.jar)包含在Java项目的类路径中。
-
创建PDFUtilityService客户端
使用对象的构造函数创建
PDFUtilityServiceClient
对象,并传递包含连接属性的ServiceClientFactory
对象。 -
调用PDF到XDP的转换操作
要执行转换,请调用
PDFUtilityServiceClient
对象的convertPDFtoXDP
方法,并传入表示PDF文件的com.adobe.idp.Document
对象。 该方法返回表示新创建的XDP文件的com.adobe.idp.Document
对象。
另请参阅