验证DDX文档

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

您可以以编程方式验证汇编程序服务使用的DDX文档。 即，使用Assembler服务API，您可以确定DDX文档是否有效。 例如，如果您从以前的AEM Forms版本升级，并且要确保DDX文档有效，则可以使用汇编程序服务API验证它。

步骤摘要

要验证DDX文档，请执行以下任务：

1. 包括项目文件。
2. 创建Assembler客户端。
3. 引用现有DDX文档。
4. 设置运行时选项以验证DDX文档。
5. 执行验证。
6. 将验证结果保存在日志文件中。

包含项目文件

在开发项目中包含必要的文件。 如果使用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，则此为必填字段)

如果AEM Forms部署在除JBoss之外的受支持J2EE应用程序服务器上，则必须将adobe-utilities.jar和jbossall-client.jar文件替换为JAR文件，这些文件特定于部署AEM Forms的J2EE应用程序服务器。

创建PDF汇编程序客户端

您必须先创建一个Assembler服务客户端，然后才能以编程方式执行Assembler操作。

引用现有DDX文档

要验证DDX文档，必须引用现有的DDX文档。

设置运行时选项以验证DDX文档

验证DDX文档时，必须设置特定的运行时选项，以指示Assembler服务验证DDX文档，而不是执行文档。 此外，您还可以增加Assembler服务写入日志文件的信息量。

执行验证

创建Assembler服务客户端、引用DDX文档并设置运行时选项后，可以调用 invokeDDX 验证DDX文档的操作。 验证DDX文档时，您可以传递 null 作为映射参数(此参数通常存储PDF文档，汇编程序需要这些文档来执行DDX文档中指定的操作)。

如果验证失败，则会引发异常，并且日志文件会包含详细信息，以解释为何DDX文档无效。 OperationException 实例。 一旦通过了基本的XML解析和模式检查，就会执行针对DDX规范的验证。 DDX文档中的所有错误都在日志中指定。

将验证结果保存在日志文件中

Assembler服务返回可以写入XML日志文件的验证结果。 Assembler服务写入日志文件的详细信息量取决于您设置的运行时选项。

另请参阅

使用Java API验证DDX文档

使用Web服务API验证DDX文档

包括AEM Forms Java库文件

设置连接属性

以编程方式组合PDF文档

使用Java API验证DDX文档

使用Assembler服务API (Java)验证DDX文档：

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. 设置运行时选项以验证DDX文档。

   • 创建 AssemblerOptionSpec 使用构造函数存储运行时选项的对象。
   • 设置运行时选项，通过调用 AssemblerOptionSpec 对象的setValidateOnly方法和传递 true.
   • 通过调用 AssemblerOptionSpec 对象的 getLogLevel 方法和传递字符串值均符合您的要求。 验证DDX文档时，您需要将更多信息写入日志文件，以帮助验证过程。 因此，您可以传递值 FINE 或 FINER.

5. 执行验证。

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

   • A com.adobe.idp.Document 表示DDX文档的对象。
   • 值 null java.io.Map对象，通常存储PDF文档。
   • A com.adobe.livecycle.assembler.client.AssemblerOptionSpec 指定运行时选项的对象。

   此 invokeDDX 方法返回 AssemblerResult 包含指定DDX文档是否有效的信息的对象。

6. 将验证结果保存在日志文件中。

   • 创建 java.io.File 对象并确保文件扩展名为.xml。
   • 调用 AssemblerResult 对象的 getJobLog 方法。 此方法会返回 com.adobe.idp.Document 包含验证信息的实例。
   • 调用 com.adobe.idp.Document 对象的 copyToFile 用于复制 com.adobe.idp.Document 对象到文件。
   注意

   如果DDX文档无效， OperationException 被抛出。 在catch语句中，可以调用 OperationException 对象的 getJobLog 方法。

另请参阅

验证DDX文档

快速入门（SOAP模式）：使用Java API验证DDX文档 （SOAP模式）

包括AEM Forms Java库文件

设置连接属性

使用Web服务API验证DDX文档

使用Assembler服务API（Web服务）验证DDX文档：

1. 包括项目文件。

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

   注意

   将localhost替换为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. 设置运行时选项以验证DDX文档。

   • 创建 AssemblerOptionSpec 使用构造函数存储运行时选项的对象。
   • 通过将值true赋给，设置运行时选项，指示Assembler服务验证DDX文档 AssemblerOptionSpec 对象的 validateOnly 数据成员。
   • 通过为指定字符串值，设置Assembler服务写入日志文件的信息量 AssemblerOptionSpec 对象的 logLevel 数据成员。 方法验证DDX文档时，您需要将更多信息写入日志文件，以帮助验证过程。 因此，您可以指定值 FINE 或 FINER. 有关可设置的运行时选项的信息，请参见 AssemblerOptionSpec 中的类引用 AEM Forms API参考.

5. 执行验证。

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

   • A BLOB 表示DDX文档的对象。
   • 值 null 对于 Map 通常存储PDF文档的对象。
   • An AssemblerOptionSpec 指定运行时选项的对象。

   此 invokeDDX 方法返回 AssemblerResult 包含指定DDX文档是否有效的信息的对象。

6. 将验证结果保存在日志文件中。

   • 创建 System.IO.FileStream 对象，方法是：调用其构造函数，并传递一个字符串值，该值表示日志文件的文件位置以及用于在中打开文件的模式。 确保文件扩展名为.xml。
   • 创建 BLOB 对象，通过获取 AssemblerResult 对象的 jobLog 数据成员。
   • 创建一个字节数组，用于存储 BLOB 对象。 通过获取的值，填充字节数组 BLOB 对象的 MTOM 字段。
   • 创建 System.IO.BinaryWriter 对象通过调用其构造函数并传递 System.IO.FileStream 对象。
   • PDF通过调用 System.IO.BinaryWriter 对象的 Write 和传递字节数组。
   注意

   如果DDX文档无效， OperationException 被抛出。 在catch语句中，您可以获取 OperationException 对象的 jobLog 成员。

另请参阅

验证DDX文档

使用MTOM调用AEM Forms