使用PDF/A文档 working-with-pdf-a-documents

关于DocConverter服务

DocConverter服务可以将PDF文档转换为PDA/A文档。 您可以使用此服务完成这些任务:

NOTE
有关DocConverter服务的详细信息,请参见 AEM Forms的服务参考.

将文档转换为PDF/A文档 converting-documents-to-pdf-a-documents

您可以使用DocConverter服务将PDF文档转换为PDF/A文档。 由于PDF/A是用于长期保存文档内容的存档格式,因此所有字体都将嵌入,并且文件是未压缩的。 因此,PDF/A 文档通常比标准 PDF 文档大。此外,PDF/文档不包含音频和视频内容。 在将PDF文档转换为PDF/A文档之前,请确保PDF文档不是PDF/A文档。

PDF/A-1规范包含两个一致性级别,即A和B。两者之间的主要区别在于对逻辑结构(辅助功能)的支持,一致性级别B不需要该支持。无论一致性级别如何,PDF/A-1都指示所有字体都嵌入在生成的PDF/A文档中。 目前,验证(和转换)中仅支持PDF/A-1b。

虽然PDF/A是归档PDF文档的标准,但是如果标准PDF文档符合公司的要求,则无需使用PDF/A进行归档。 PDF/A标准的目的是建立一个PDF文件,以满足长期归档和文档保存的需要。

NOTE
有关DocConverter服务的详细信息,请参见 AEM Forms的服务参考.

步骤摘要 summary-of-steps

要将PDF文档转换为PDF/A文档,请执行以下步骤:

  1. 包括项目文件。
  2. 创建DocConvert客户端
  3. 引用要转换为PDF/PDF的文档。
  4. 设置跟踪信息。
  5. 转换文档。
  6. 保存PDF/文档。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-docconverter-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

有关这些JAR文件位置的信息,请参见 包括AEM Forms Java库文件.

创建DocConvert客户端

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

引用要转换为PDF/PDF的文档

检索PDF文档以转换为PDF/A文档。 如果尝试将PDF文档(如Acrobat表单)转换为PDF/A文档,则会导致出现异常。

设置跟踪信息

您可以设置一个运行时选项,以确定在转换过程中要跟踪的信息量。 也就是说,您可以设置九个不同的级别,以指定DocConverter服务在将PDF文档转换为PDF/文档时跟踪的信息量。

转换文档

创建DocConverter服务客户端后,引用要转换的PDF文档,并设置指定跟踪的信息量的运行时选项,可以将PDF文档转换为PDF/A文档。

保存PDF/文档

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

另请参阅

使用Java API将文档转换为PDF/A文档

使用Web服务API将文档转换为PDF/A文档

包括AEM Forms Java库文件

设置连接属性

以编程方式确定PDF/A合规性

使用Java API将文档转换为PDF/A文档 convert-documents-to-pdf-a-documents-using-the-java-api

使用Java API将PDF文档转换为PDF/A文档:

  1. 包含项目文件

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

  2. 创建DocConvert客户端

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 DocConverterServiceClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 引用要转换为PDF/PDF的文档

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

    • 创建 PDFAConversionOptionSpec 对象。
    • 通过调用 PDFAConversionOptionSpec 对象的 setLogLevel 方法,并传递一个指定跟踪级别的字符串值。 例如,传递值 FINE. 有关不同值的信息,请参见 setLogLevel 中的方法 AEM Forms API参考.
  5. 转换文档

    通过调用,将PDF文档转换为PDF/A文档 DocConverterServiceClient 对象的 toPDFA 方法并传递以下值:

    • com.adobe.idp.Document 包含要转换的PDF文档的对象
    • PDFAConversionOptionSpec 指定跟踪信息的对象

    toPDFA 方法返回 PDFAConversionResult 包含PDF/A文档的对象。

  6. 保存PDF/文档

    • 通过调用PDF/文档 PDFAConversionResult 对象的 getPDFA 方法。 此方法会返回 com.adobe.idp.Document 表示PDF/A文档的对象。
    • 创建 java.io.File 表示PDF/A文件的对象。 确保文件扩展名为.pdf。
    • 通过调用PDF/A数据填充文件 com.adobe.idp.Document 对象的 copyToFile 方法和传递 java.io.File 对象。

另请参阅

使用PDF/A文档

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

包括AEM Forms Java库文件

设置连接属性

使用Web服务API将文档转换为PDF/A文档 convert-documents-to-pdf-a-documents-using-the-web-service-api

使用DocConverter API(Web服务)将PDF文档转换为PDF/A文档:

  1. 包含项目文件

    • 创建使用DocConverter WSDL的Microsoft .NET客户端程序集。
    • 引用Microsoft .NET客户端程序集。
  2. 创建DocConvert客户端

    • 使用Microsoft .NET客户端程序集,创建 DocConverterServiceService 对象。
    • 设置 DocConverterServiceService 对象的 Credentials 具有的数据成员 System.Net.NetworkCredential 指定用户名和密码值的值。
  3. 引用要转换为PDF/PDF的文档

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

    • 创建 PDFAConversionOptionSpec 对象。
    • 通过分配一个值来设置信息跟踪级别,该值将指定跟踪级别 PDFAConversionOptionSpec 对象的 logLevel 数据成员。 例如,分配值 FINE 至此数据成员。
  5. 转换文档

    通过调用,将PDF文档转换为PDF/A文档 DocConverterServiceService 对象的 toPDFA 方法并传递以下值:

    • BLOB 包含要转换的PDF文档的对象
    • PDFAConversionOptionSpec 指定跟踪信息的对象

    toPDFA 方法返回 PDFAConversionResult 包含PDF/A文档的对象。

  6. 保存PDF/文档

    • 创建 BLOB 通过获取PDF/文档的值来存储文档/文档的对象 PDFAConversionResult 对象的 PDFADocument 数据成员。
    • 创建一个字节数组,用于存储 BLOB 使用返回的对象 PDFAConversionResult 对象。 通过获取的值,填充字节数组 BLOB 对象的 binaryData 数据成员。
    • 创建 System.IO.FileStream 对象,方法是调用其构造函数并传递一个表示PDF/文档的文件位置的字符串值。
    • 创建 System.IO.BinaryWriter 对象通过调用其构造函数并传递 System.IO.FileStream 对象。
    • PDF通过调用 System.IO.BinaryWriter 对象的 Write 和传递字节数组。

另请参阅

使用PDF/A文档

使用Base64编码调用AEM Forms

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

以编程方式确定PDF/A合规性 programmatically-determining-pdf-a-compliancy

您可以使用DocConverter服务来确定PDF文档是否符合PDF/A标准。 有关PDF/文档以及如何将PDF文档转换为PDF/文档的信息,请参阅 将文档转换为PDF/A文档.

NOTE
有关DocConverter服务的详细信息,请参见 AEM Forms的服务参考.

步骤摘要 summary_of_steps-1

要确定PDF/A合规性,请执行以下步骤:

  1. 包括项目文件。
  2. 创建DocConvert客户端
  3. 引用用于确定PDF/A合规性的PDF文档。
  4. 设置运行时选项。
  5. 检索有关PDF文档的信息。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-docconverter-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

有关这些JAR文件位置的信息,请参见 包括AEM Forms Java库文件.

创建DocConvert客户端

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

引用用于确定PDF/A合规性的PDF文档

必须引用PDF文档并将其传递到DocConverter服务,以确定PDF文档是否符合PDF/A标准。

设置运行时选项

您可以设置一个运行时选项,以确定在转换过程中要跟踪的信息量。 也就是说,您可以设置九个不同的级别,以指定DocConverter服务在将PDF文档转换为PDF/文档时跟踪的信息量。

检索有关PDF文档的信息

创建DocConverter服务客户端、引用PDF文档并设置运行时选项后,可以确定PDF文档是否为符合PDF/A标准的文档。

另请参阅

使用Java API确定PDF合规性

使用Web服务API确定PDF/A合规性

包括AEM Forms Java库文件

设置连接属性

使用Java API确定PDF合规性 determine-pdf-a-compliancy-using-the-java-api

使用Java API确定PDF合规性:

  1. 包含项目文件

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

  2. 创建DocConvert客户端

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 DocConverterServiceClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 引用用于确定PDF/A合规性的PDF文档

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

    • 创建 PDFAValidationOptionSpec 对象。
    • 通过调用 PDFAValidationOptionSpec 对象的 setCompliance 方法和传递 PDFAValidationOptionSpec.Compliance.PDFA_1B.
    • 通过调用 PDFAValidationOptionSpec 对象的 setLogLevel 方法,并传递一个指定跟踪级别的字符串值。 例如,传递值 FINE. 有关不同值的信息,请参见 setLogLevel 中的方法 AEM Forms API参考.
  5. 检索有关PDF文档的信息

    PDF通过调用 DocConverterServiceClient 对象的 isPDFA 方法并传递以下值:

    • com.adobe.idp.Document 包含PDF文档的对象。
    • PDFAValidationOptionSpec 指定运行时选项的对象。

    isPDFA 方法返回 PDFAValidationResult 包含此操作结果的对象。

另请参阅

使用PDF/A文档

快速入门(SOAP模式):使用Java API确定PDF/A合规性

包括AEM Forms Java库文件

设置连接属性

使用Web服务API确定PDF/A合规性 determine-pdf-a-compliancy-using-the-web-service-api

使用Web服务API确定PDF/A合规性:

  1. 包含项目文件

    • 创建使用DocConverter WSDL的Microsoft .NET客户端程序集。
    • 引用Microsoft .NET客户端程序集。
  2. 创建DocConvert客户端

    • 使用Microsoft .NET客户端程序集,创建 DocConverterServiceService 对象。
    • 设置 DocConverterServiceService 对象的 Credentials 具有的数据成员 System.Net.NetworkCredential 指定用户名和密码值的值。
  3. 引用用于确定PDF/A合规性的PDF文档

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

    • 创建 PDFAValidationOptionSpec 对象。
    • 通过分配 PDFAValidationOptionSpec 对象的 compliance 具有值的数据成员 PDFAConversionOptionSpec_Compliance.PDFA_1B.
    • 通过分配 PDFAValidationOptionSpec 对象的 resultLevel 具有值的数据成员 PDFAValidationOptionSpec_ResultLevel.DETAILED.
  5. 检索有关PDF文档的信息

    PDF通过调用 DocConverterServiceService 对象的 isPDFA 方法并传递以下值:

    • BLOB 包含PDF文档的对象。
    • PDFAValidationOptionSpec 包含运行时选项的对象。

    isPDFA 方法返回 PDFAValidationResult 包含此操作结果的对象。

另请参阅

使用PDF/A文档

使用Base64编码调用AEM Forms

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

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