文档AEM 6.5用户指南

组合PDFPortfolio assembling-pdf-portfolios

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

创建对象：

  • Developer

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

您可以使用Assembler Java和Web服务API来组合PDFPortfolio。 组合可以组合多种类型的文档，包括word文件、图像文件（例如jpeg文件）和PDF文档。 项目组合的布局可设置为不同的样式，如 带有预览的网格， 在图像上 布局或平均 旋转.

下图是包含如下内容的项目组合的屏幕截图 在图像上 样式布局。

ap_ap_portfolio

创建PDFPortfolio是传递文档集合的无纸化替代方法。 使用AEM Forms，您可以通过使用结构化DDX文档调用Assembler服务来创建项目组合。 以下DDX文档是创建PDFPortfolio的DDX文档的示例。

 <DDX xmlns="https://ns.adobe.com/DDX/1.0/">
     <PDF result="portfolio1.pdf">
         <Portfolio>
             <Navigator source="myNavigator">
                 <Resource name="navigator/image.xxx" source="myImage.png"/>
             </Navigator>
         </Portfolio>
         <PackageFiles source="dog1"  >
              <FieldData name="X">72</FieldData>
             <FieldData name="Y">72</FieldData>
             <File filename="saint_bernard.jpg" mimetype="image/jpeg"/>
         </PackageFiles>
         <PackageFiles source="dog2"  >
             <FieldData name="X">120</FieldData>
             <FieldData name="Y">216</FieldData>
             <File filename="greyhound.pdf"/>
         </PackageFiles>
     </PDF>
 </DDX>

DXX文档必须包含 Portfolio 带有嵌套的标记 Navigator 标记之前。 记下标记 <Resource name="navigator/image.xxx" source="myImage.png"/> 仅在以下情况下需要 myNavigator 被分配为onImage布局导航器： AdobeOnImage.nav. 此标记允许汇编程序服务选择要用作项目组合背景的图像。 包括 PackageFiles 和 File 标签定义打包文件的文件名和MIME类型。

NOTE
有关汇编程序服务的详细信息，请参见 AEM Forms的服务参考.
NOTE
有关DDX文档的详细信息，请参见 汇编程序服务和DDX参考.

步骤摘要 summary-of-steps

要创建PDFPortfolio，请执行以下任务：

  1. 包括项目文件。
  2. 创建PDF汇编程序客户端。
  3. 引用现有DDX文档。
  4. 引用所需的文档。
  5. 设置运行时选项。
  6. 组合项目组合。
  7. 保存组合的项目组合。

包含项目文件

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

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

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-assembler-client.jar
  • adobe-utilities.jar(如果在JBoss上部署了AEM Forms，则此为必填字段)
  • jbossall-client.jar(如果在JBoss上部署了AEM Forms，则此为必填字段)

创建PDF汇编程序客户端

在以编程方式执行汇编程序操作之前，请先创建汇编程序服务客户端。

引用现有DDX文档

必须引用DDX文档才能组合PDFPortfolio。 此DDX文档必须包含 Portfolio， Navigator 和， PackageFiles 元素。

引用所需的文档

要组合PDFPortfolio，请引用表示要组合文档的所有文件。 例如，将DDX文档中指定的所有图像文件传递到Assembler服务。 请注意，以下部分指定的DDX文档引用了这些文件： myImage.png 和 saint_bernard.jpg.

在组合PDFPortfolio时，将NAV文件（导航文件）传递给Assembler服务。 您传递到Assembler服务的NAV文件取决于要创建的PDFPortfolio类型。 例如，要创建 在图像上 布局，传递AdobeOnImage.nav文件。 您可以在以下文件夹中找到NAV文件：

<Install folder>\Acrobat 9.0\Acrobat\Navigators

从Acrobat 9（或更高版本）安装目录复制NAV文件。 将NAV文件放置在客户端应用程序可以访问它的位置。 所有文件都传递到Map集合对象中的Assembler服务。

NOTE
与组装PDFPortfolio关联的快速入门使用AdobeOnImage.nav。

设置运行时选项

您可以设置运行时选项，以控制Assembler服务执行作业时的行为。 例如，您可以设置一个选项，在遇到错误时指示Assembler服务继续处理作业。

组合项目组合

要组装PDFPortfolio，您需要调用 invokeDDX 操作。 Assembler服务返回集合对象中的PDFPortfolio。

保存组合的项目组合

PDFPortfolio在集合对象中返回。 循环访问收藏集对象并将PDFPortfolio另存为PDF文件。

另请参阅

使用Java API组合PDFPortfolio

使用Web服务API组合PDFPortfolio

包括AEM Forms Java库文件

设置连接属性

以编程方式组合PDF文档

使用Java API组合PDFPortfolio assemble-a-pdf-portfolio-using-the-java-api

使用Assembler服务API (Java)组合PDFPortfolio：

  1. 包括项目文件。

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

  2. 创建PDF汇编程序客户端。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 AssemblerServiceClient 对象，使用它的构造函数传递 ServiceClientFactory 对象。

  3. 引用现有DDX文档。

    • 创建 java.io.FileInputStream 通过使用其构造函数并传递指定DDX文件位置的字符串值来表示DDX文档的对象。
    • 创建 com.adobe.idp.Document 对象，使用它的构造函数传递 java.io.FileInputStream 对象。

  4. 引用所需的文档。

    • 创建 java.util.Map 通过使用PDF存储输入文档的对象 HashMap 构造函数。

    • 创建 java.io.FileInputStream 对象。 传递所需NAV文件的位置（对创建项目组合所需的每个文件重复此任务）。

    • 创建 com.adobe.idp.Document 对象并传递 java.io.FileInputStream 包含NAV文件的对象（对创建项目组合所需的每个文件重复此任务）。

    • 将条目添加到 java.util.Map 对象(通过调用其 put 方法并传递以下参数：

      • 表示键名的字符串值。 此值必须与DDX文档中指定的源元素的值匹配。 （对创建项目组合所需的每个文件重复此任务）。
      • A com.adobe.idp.Document 包含PDF文档的对象。 （对创建项目组合所需的每个文件重复此任务）。

  5. 设置运行时选项。

    • 创建 AssemblerOptionSpec 使用构造函数存储运行时选项的对象。
    • 通过调用属于 AssemblerOptionSpec 对象。 例如，要指示Assembler服务在发生错误时继续处理作业，请调用 AssemblerOptionSpec 对象的 setFailOnError 方法和路径 false.

  6. 组合项目组合。

    调用 AssemblerServiceClient 对象的 invokeDDX 方法，并传递以下必需值：

    • A com.adobe.idp.Document 表示要使用的DDX文档的对象
    • A java.util.Map 包含构建PDFPortfolio所需文件的对象。
    • A com.adobe.livecycle.assembler.client.AssemblerOptionSpec 指定运行时选项（包括默认字体和作业日志级别）的对象

    此 invokeDDX 方法返回 com.adobe.livecycle.assembler.client.AssemblerResult 包含组合的PDFPortfolio和发生的任何异常的对象。

  7. 保存组合的项目组合。

    要获取PDFPortfolio，请执行以下步骤：

    • 调用 AssemblerResult 对象的 getDocuments 方法。 此方法会返回 java.util.Map 对象。
    • 循环访问 java.util.Map 对象，直到找到结果为止 com.adobe.idp.Document 对象。
    • 调用 com.adobe.idp.Document 对象的 copyToFile 方法提取PDFPortfolio。

另请参阅

快速入门（SOAP模式）：使用Java API组合PDFPortfolio

包括AEM Forms Java库文件

设置连接属性

使用Web服务API组合PDFPortfolio assemble-a-pdf-portfolio-using-the-web-service-api

使用Assembler服务API（Web服务）组合PDFPortfolio：

  1. 包括项目文件。

    创建使用MTOM的Microsoft .NET项目。 在设置服务引用时，请确保使用以下WSDL定义： http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。

  2. 创建PDF汇编程序客户端。

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

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

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

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

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

      • 将AEM表单用户名分配给字段 AssemblerServiceClient.ClientCredentials.UserName.UserName.
      • 将相应的密码值分配给字段 AssemblerServiceClient.ClientCredentials.UserName.Password.
      • 分配常量值 HttpClientCredentialType.Basic 到字段 BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • 分配常量值 BasicHttpSecurityMode.TransportCredentialOnly 到字段 BasicHttpBindingSecurity.Security.Mode.

  3. 引用现有DDX文档。

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

  4. 引用所需的文档。

    • 对于每个输入文件，创建 BLOB 对象。 此 BLOB 对象用于存储输入文件。
    • 创建 System.IO.FileStream 对象，方法是调用其构造函数并传递一个字符串值，该字符串值表示输入文件的文件位置以及打开文件的模式。
    • 创建一个字节数组，用于存储 System.IO.FileStream 对象。 您可以通过获取 System.IO.FileStream 对象的 Length 属性。
    • 通过调用 System.IO.FileStream 对象的 Read 方法。 传递字节数组、起始位置和要读取的流长度。
    • 填充 BLOB 对象，通过指定其 MTOM 包含字节数组内容的字段。
    • 创建 MyMapOf_xsd_string_To_xsd_anyType 对象。 此集合对象用于存储创建PDFPortfolio所需的输入文件。
    • 对于每个输入文件，创建 MyMapOf_xsd_string_To_xsd_anyType_Item 对象。
    • 将代表键名的字符串值分配给 MyMapOf_xsd_string_To_xsd_anyType_Item 对象的 key 字段。 此值必须匹配DDX文档中指定元素的值。 （为每个输入文件执行此任务。）
    • 分配 BLOB 将输入文件存储到的对象 MyMapOf_xsd_string_To_xsd_anyType_Item 对象的 value 字段。 (为每个输入PDF文档执行此任务。)
    • 添加 MyMapOf_xsd_string_To_xsd_anyType_Item 对象 MyMapOf_xsd_string_To_xsd_anyType 对象。 调用 MyMapOf_xsd_string_To_xsd_anyType 对象的 Add 方法并传递 MyMapOf_xsd_string_To_xsd_anyType 对象。 (为每个输入PDF文档执行此任务。)

  5. 设置运行时选项。

    • 创建 AssemblerOptionSpec 使用构造函数存储运行时选项的对象。
    • 通过为属于以下对象的数据成员分配值，设置运行时选项以满足您的业务要求 AssemblerOptionSpec 对象。 例如，要指示Assembler服务在发生错误时继续处理作业，请分配 false 到 AssemblerOptionSpec 对象的 failOnError 数据成员。

  6. 组合项目组合。

    调用 AssemblerServiceClient 对象的 invokeDDX 方法并传递以下值：

    • A BLOB 表示DDX文档的对象
    • 此 MyMapOf_xsd_string_To_xsd_anyType 包含所需文件的对象
    • An AssemblerOptionSpec 指定运行时选项的对象

    此 invokeDDX 方法返回 AssemblerResult 包含作业结果和发生的任何异常的对象。

  7. 保存组合的项目组合。

    要获取新创建的PDFPortfolio，请执行以下步骤：

    • 访问 AssemblerResult 对象的 documents 字段，即 Map 包含结果PDF文档的对象。
    • 循环访问 Map 对象以获取每个结果文档。 然后，强制转换该数组成员的 value 到 BLOB.
    • 通过访问代表PDF文档的二进制数据 BLOB 对象的 MTOM 属性。 这会返回一个字节数组，您可以将该字节写出到PDF文件中。

另请参阅

使用MTOM调用AEM Forms

使用SwaRef调用AEM Forms

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