将Postscript转换为PDF文档 converting-postscript-to-pdf-documents

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

关于Distiller服务 about-the-distiller-service

Distiller®服务可将PostScript®、封装的PostScript (EPS)和PRN文件转换为小巧、可靠且更安全的PDF文件。 Distiller服务通常用于将大量打印文档转换为电子文档,如发票和报表。 将文档转换为PDF还允许企业向客户发送文档的纸质版本和电子版本。

NOTE
有关Distiller服务的更多信息,请参阅 AEM Forms的服务参考.

将PostScript转换为PDF文档 converting-postscript-to-pdf-documents-inner

本主题介绍如何使用Distiller服务API(Java和Web服务)以编程方式将PostScript (PS)、封装的PostScript (EPS)和PRN文件转换为PDF文档。

NOTE
有关Distiller服务的更多信息,请参阅 AEM Forms的服务参考.
NOTE
要将PostScript文件转换为PDF文档,需要在托管AEM Forms的服务器上安装以下项之一: Acrobat 9或Microsoft Visual C++ 2005可再发行软件包。

步骤摘要 summary-of-steps

要将任何受支持的类型转换为PDF文档,请执行以下步骤:

  1. 包括项目文件。
  2. 创建Distiller服务客户端。
  3. 检索要转换的文件。
  4. 调用PDF创建操作。
  5. 保存PDF文档。

包含项目文件

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

创建Distiller服务客户端

您必须先创建Distiller服务客户端,然后才能以编程方式执行Distiller服务操作。 如果您使用的是Java API,请创建 DistillerServiceClient 对象。 如果您使用的是Web服务API,请创建 DistillerServiceService 对象。

检索要转换的文件

检索要转换的文件。 例如,要将PS文件转换为PDF文档,必须检索PS文件。

调用PDF创建操作

创建服务客户端后,可以调用PDF创建操作。 此操作将需要有关要转换的文档的信息,包括目标文档的路径。

保存PDF文档

可以将PDF文档另存为PDF文件。

另请参阅

使用Java API将PostScript文件转换为PDF

使用Web服务API将PostScript文件转换为PDF

包括AEM Forms Java库文件

设置连接属性

输出服务API快速启动

使用Java API将PostScript文件转换为PDF convert-a-postscript-file-to-pdf-using-the-java-api

使用Distiller服务API (Java)将PostScript文件转换为PDF文档:

  1. 包括项目文件。

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

  2. 创建Distiller服务客户端。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 DistillerServiceClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 检索要转换的文件。

    • 创建 java.io.FileInputStream 对象,表示要转换的文件,转换方法是使用其构造函数并传递一个指定文件位置的字符串值。
    • 创建 com.adobe.idp.Document 对象,使用它的构造函数传递 java.io.FileInputStream 对象。
  4. 调用PDF创建操作。

    调用 DistillerServiceClient 对象的 createPDF 方法并传递以下值:

    • com.adobe.idp.Document 表示要转换的PS、EPS或PRN文件的对象
    • A java.lang.String 包含要转换的文件名的对象
    • A java.lang.String 包含要使用的Adobe PDF设置名称的对象
    • A java.lang.String 包含要使用的安全设置的名称的对象
    • 可选 com.adobe.idp.Document 包含生成PDF文档时要应用的设置的对象
    • 可选 com.adobe.idp.Document 包含要应用于PDF文档的元数据信息的对象

    createPDF 方法返回 CreatePDFResult 包含新PDF文档和可生成的日志文件的对象。 日志文件通常包含转换请求生成的错误或警告消息。

  5. 保存PDF文档。

    要获取新创建的PDF文档,请执行下列操作:

    • 调用 CreatePDFResult 对象的 getCreatedDocument 方法。 这会返回 com.adobe.idp.Document 对象。
    • 调用 com.adobe.idp.Document 对象的 copyToFile 用于提取PDF文档的方法。

    同样,要获取日志文档,请执行下列操作。

    • 调用 CreatePDFResult 对象的 getLogDocument 方法。 这会返回 com.adobe.idp.Document 对象。
    • 调用 com.adobe.idp.Document 对象的 copyToFile 提取日志文档的方法。

另请参阅

步骤摘要

快速入门(SOAP模式):使用Java API将PostScript文件转换为PDF文档

包括AEM Forms Java库文件

设置连接属性

使用Web服务API将PostScript文件转换为PDF converting-a-postscript-file-to-pdf-using-the-web-service-api

使用Distiller服务API(Web服务)将PostScript文件转换为PDF文档:

  1. 包括项目文件。

    创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义: http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    替换 localhost ,其中包含托管AEM Forms的服务器的IP地址。
  2. 创建Distiller服务客户端。

    • 创建 DistillerServiceClient 对象使用默认构造函数。

    • 创建 DistillerServiceClient.Endpoint.Address 对象 System.ServiceModel.EndpointAddress 构造函数。 将指定WSDL的字符串值传递给AEM Forms服务(例如, http://localhost:8080/soap/services/DistillerService?blob=mtom.) 您无需使用 lc_version 属性。 此属性在创建服务引用时使用。 但是,请指定 ?blob=mtom 使用MTOM。

    • 创建 System.ServiceModel.BasicHttpBinding 对象,方法是获取 DistillerServiceClient.Endpoint.Binding 字段。 将返回值强制转换为 BasicHttpBinding.

    • 设置 System.ServiceModel.BasicHttpBinding 对象的 MessageEncoding 字段至 WSMessageEncoding.Mtom. 此值可确保使用MTOM。

    • 通过执行以下任务启用基本HTTP身份验证:

      • 将AEM表单用户名分配给字段 DistillerServiceClient.ClientCredentials.UserName.UserName.
      • 将相应的密码值分配给字段 DistillerServiceClient.ClientCredentials.UserName.Password.
      • 分配常量值 HttpClientCredentialType.Basic 到字段 BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • 分配常量值 BasicHttpSecurityMode.TransportCredentialOnly 到字段 BasicHttpBindingSecurity.Security.Mode.
  3. 检索要转换的文件。

    • 创建 BLOB 对象。 此 BLOB 对象用于存储要转换为PDF文档的文件。
    • 创建 System.IO.FileStream 对象,方法是:调用其构造函数,并传递一个字符串值,该值表示文件位置和打开文件的模式。
    • 创建一个字节数组,用于存储 System.IO.FileStream 对象。 您可以通过获取 System.IO.FileStream 对象的 Length 属性。
    • 通过调用 System.IO.FileStream 对象的 Read 方法,并传递字节数组、起始位置和要读取的流长度。
    • 填充 BLOB 对象,通过指定其 MTOM 属性与字节数组的内容。
  4. 调用PDF创建操作。

    调用 DistillerServiceService 对象的 CreatePDF2 方法,并传递以下必需值:

    • BLOB 表示要转换的PS文件的对象
    • 一个字符串,其中包含要转换的文件的路径名称
    • 包含要使用的Adobe PDF设置的字符串对象(例如, Standard)
    • 包含要使用的安全设置的字符串对象(例如, No Security)
    • 可选 BLOB 包含生成PDF文档时要应用的设置的对象
    • 可选 BLOB 包含要应用于PDF文档的元数据信息的对象
    • A BLOB 用于存储PDF文档的输出参数
    • A BLOB 用于存储日志的输出参数
  5. 保存PDF文档。

    • 创建 System.IO.FileStream 对象通过调用其构造函数。 传递一个字符串值,该值表示已签名PDF文档的文件位置以及打开文件的模式。
    • 创建一个字节数组,用于存储 BLOB 返回的对象 CreatePDF2 方法(输出参数)。 通过获取的值,填充字节数组 BLOB 对象的 MTOM 数据成员。
    • 创建 System.IO.BinaryWriter 对象通过调用其构造函数并传递 System.IO.FileStream 对象。
    • PDF通过调用 System.IO.BinaryWriter 对象的 Write 和传递字节数组。

另请参阅

步骤摘要

使用MTOM调用AEM Forms

使用SwaRef调用AEM Forms

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2