在文件格式和PDF之间转换
- 适用对象：
- Experience Manager 6.5
创建对象：
- 开发人员
本文档中的示例和示例仅适用于JEE环境上的AEM Forms。
关于生成PDF服务
生成PDF服务将本机文件格式转换为PDF。 它还会将PDF转换为其他文件格式并优化PDF文档的大小。
生成PDF服务使用本机应用程序将以下文件格式转换为PDF。 除非另有说明，否则仅支持这些应用程序的德语、法语、英语和日语版本。 仅Windows 表示仅支持Windows Server® 2003和Windows Server 2008。
- Microsoft Office 2003和2007转换DOC、DOCX、RTF、TXT、XLS、XLSX、PPT、PPTX、VSD、MPP、MPPX、XPS和PUB（仅限Windows）
注意- Autodesk AutoCAD 2005、2006、2007、2008和2009转换DWF、DWG和DXW（仅限英文）
- Corel WordPerfect 12和X4用于转换WPD、QPW和SHW（仅限英语）
- OpenOffice 2.0、2.4、3.0.1和3.1用于转换ODT、ODS、ODP、ODP、ODG、ODF、SXW、SXI、SXC、SXD、DOC、DOCX、RTF、TXT、XLS、XLSX、PPT、PPPTX、VSD、MPP、MPX和PUB
注意- Adobe Photoshop® CS2转换PSD（仅限Windows）
注意- Adobe FrameMaker® 7.2和8用于转换FM（仅限Windows）
- AdobePageMaker® 7.0，用于转换PMD、PM6、P65和PM（仅限Windows）
- 第三方应用程序支持的本机格式（需要开发特定于应用程序的设置文件）（仅限Windows）
生成PDF服务可将以下基于标准的文件格式转换为PDF。
- 视频格式：SWF、FLV（仅限Windows）
- 图像格式：JPEG、JPG、JP2、J2Kí、JPC、J2C、GIF、BMP、TIFF、TIF、PNG、JPF
- HTML(Windows™Sun™Solaris和Linux®)
生成PDF服务将PDF转换为以下文件格式（仅限Windows）：
- 封装式PostScript (EPS)
- HTML3.2
- 带CSS 1.0的HTML4.01
- DOC(Microsoft Word格式)
- RTF
- 文本（可访问和纯文本）
- XML
- 仅使用DeviceRGB色彩空间的PDF/A-1a
- 仅使用DeviceRGB色彩空间的PDF/A-1b
生成PDF服务要求您执行以下管理任务：
- 在托管AEM Forms的计算机上安装所需的本机应用程序
- 在托管Adobe Acrobat的计算机上安装AEM Forms Professional或Acrobat Pro Extended 9.2
- 执行安装后设置任务
使用JBoss Turnkey安装和部署AEM Forms中介绍了这些任务。
您可以使用生成PDF服务完成以下任务：
- 从本机文件格式转换为PDF。
- 将HTML文档转换为PDF文档。
- 将PDF文档转换为文件格式。
注意将Word文档转换为PDF文档
本节介绍如何使用生成PDFAPI以编程方式将Microsoft Word文档转换为PDF文档。
注意 注意步骤摘要
要将Microsoft Word文档转换为PDF文档，请执行以下任务：
- 包括项目文件。
- 创建生成PDF客户端。
- 检索要转换为PDF文档的文件。
- 将文件转换为PDF文档。
- 检索结果。
包含项目文件
在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序，请包含必要的JAR文件。 如果使用Web服务，请确保包含代理文件。
创建生成PDF客户端
在以编程方式执行生成PDF操作之前，请先创建生成PDF服务客户端。 如果您使用的是Java API，请创建一个GeneratePdfServiceClient对象。 如果您使用的是Web服务API，请创建一个GeneratePDFServiceService对象。
检索要转换为PDF文档的文件
检索Microsoft Word文档以转换为PDF文档。
将文件转换为PDF文档
创建生成PDF服务客户端后，可以调用createPDF2方法。 此方法需要有关要转换的文档的信息，包括文件扩展名。
检索结果
将文件转换为PDF文档后，可以检索结果。 例如，将Word文件转换为PDF文档后，可以检索并保存PDF文档。
另请参阅
使用Java API将Word文档转换为PDF文档
使用生成PDFAPI (Java)将Microsoft Word文档转换为PDF文档：
-
包括项目文件。
在您的Java项目的类路径中包含客户端JAR文件，例如adobe-generatepdf-client.jar。
-
创建生成PDF客户端。
- 创建包含连接属性的
ServiceClientFactory对象。 - 使用对象的构造函数创建
GeneratePdfServiceClient对象并传递ServiceClientFactory对象。
- 创建包含连接属性的
-
检索要转换为PDF文档的文件。
- 创建一个
java.io.FileInputStream对象，该对象表示要使用其构造函数转换的Word文件。 传递一个指定文件位置的字符串值。 - 使用对象的构造函数创建
com.adobe.idp.Document对象并传递java.io.FileInputStream对象。
- 创建一个
-
将文件转换为PDF文档。
通过调用
GeneratePdfServiceClient对象的createPDF2方法并传递以下值，将文件转换为PDF文档：- 表示要转换的文件的
com.adobe.idp.Document对象。 - 包含文件扩展名的
java.lang.String对象。 - 包含转换中使用的文件类型设置的
java.lang.String对象。 文件类型设置为不同的文件类型(如.doc或.xls)提供转换设置。 - 包含要使用的PDF设置的名称的
java.lang.String对象。 例如，您可以指定Standard。 - 包含要使用的安全设置的名称的
java.lang.String对象。 - 包含要在生成PDF文档时应用的设置的可选
com.adobe.idp.Document对象。 - 包含要应用于PDF文档的元数据信息的可选
com.adobe.idp.Document对象。
createPDF2方法返回包含新PDF文档和日志信息的CreatePDFResult对象。 日志文件通常包含转换请求生成的错误或警告消息。 - 表示要转换的文件的
-
检索结果。
要获取PDF文档，请执行以下步骤：
- 调用
CreatePDFResult对象的getCreatedDocument方法，该方法返回com.adobe.idp.Document对象。 - 调用
com.adobe.idp.Document对象的copyToFile方法以从上一步中创建的对象提取PDF文档。
如果使用
createPDF2方法获取日志文件(不适用于HTML转换)，请执行以下步骤：- 调用
CreatePDFResult对象的getLogDocument方法。 这将返回com.adobe.idp.Document对象。 - 调用
com.adobe.idp.Document对象的copyToFile方法来提取日志文档。
- 调用
使用Web服务API将Word文档转换为PDF文档
使用生成PDFAPI（Web服务）将Microsoft Word文档转换为PDF文档：
-
包括项目文件。
创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义：
http://localhost:8080/soap/services/GeneratePDFService?WSDL&lc_version=9.0.1。NOTE将localhost替换为承载AEM Forms的服务器的IP地址。 -
创建生成PDF客户端。
-
使用默认构造函数创建
GeneratePDFServiceClient对象。 -
使用
System.ServiceModel.EndpointAddress构造函数创建GeneratePDFServiceClient.Endpoint.Address对象。 将指定WSDL的字符串值传递给AEM Forms服务（例如，http://localhost:8080/soap/services/GeneratePDFService?blob=mtom）。 您无需使用lc_version属性。 但是，请指定?blob=mtom。 -
通过获取
GeneratePDFServiceClient.Endpoint.Binding字段的值创建一个System.ServiceModel.BasicHttpBinding对象。 将返回值强制转换为BasicHttpBinding。 -
将
System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。 此值可确保使用MTOM。 -
通过执行以下任务启用基本HTTP身份验证：
- 将AEM表单用户名分配给字段
GeneratePDFServiceClient.ClientCredentials.UserName.UserName。 - 将相应的密码值分配给字段
GeneratePDFServiceClient.ClientCredentials.UserName.Password。 - 将常量值
HttpClientCredentialType.Basic分配给字段BasicHttpBindingSecurity.Transport.ClientCredentialType。 - 将常量值
BasicHttpSecurityMode.TransportCredentialOnly分配给字段BasicHttpBindingSecurity.Security.Mode。
- 将AEM表单用户名分配给字段
-
-
检索要转换为PDF文档的文件。
- 使用构造函数创建
BLOB对象。BLOB对象用于存储要转换为PDF文档的文件。 - 通过调用其构造函数创建
System.IO.FileStream对象。 传递一个字符串值，该值表示要转换的文件位置以及打开文件的模式。 - 创建用于存储
System.IO.FileStream对象的内容的字节数组。 您可以通过获取System.IO.FileStream对象的Length属性来确定字节数组的大小。 - 通过调用
System.IO.FileStream对象的Read方法并传递要读取的字节数组、起始位置和流长度，使用流数据填充字节数组。 - 通过为其
MTOM属性分配字节数组的内容来填充BLOB对象。
- 使用构造函数创建
-
将文件转换为PDF文档。
通过调用
GeneratePDFServiceService对象的CreatePDF2方法并传递以下值，将文件转换为PDF文档：- 表示要转换的文件的
BLOB对象。 - 包含文件扩展名的字符串。
- 包含转换中使用的文件类型设置的
java.lang.String对象。 文件类型设置为不同的文件类型(如.doc或.xls)提供转换设置。 - 包含要使用的PDF设置的字符串对象。 您可以指定
Standard。 - 包含要使用的安全设置的字符串对象。 您可以指定
No Security。 - 包含要在生成PDF文档时应用的设置的可选
BLOB对象。 - 包含要应用于PDF文档的元数据信息的可选
BLOB对象。 CreatePDF2方法填充的BLOB类型的输出参数。CreatePDF2方法使用转换的文档填充此对象。 （只有Web服务调用才需要此参数值）。CreatePDF2方法填充的BLOB类型的输出参数。CreatePDF2方法使用日志文档填充此对象。 （只有Web服务调用才需要此参数值）。
- 表示要转换的文件的
-
检索结果。
- 通过将
BLOB对象的MTOM字段分配给字节数组来检索转换后的PDF文档。 字节数组表示转换后的PDF文档。 确保使用用作createPDF2方法的输出参数的BLOB对象。 - 通过调用其构造函数并传递表示已转换PDF文档的文件位置的字符串值来创建
System.IO.FileStream对象。 - 通过调用其构造函数并传递
System.IO.FileStream对象来创建System.IO.BinaryWriter对象。 - 通过调用
System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。
- 通过将
将HTML文档转换为PDF文档
本节介绍如何使用生成PDFAPI以编程方式将HTML文档转换为PDF文档。
NOTE步骤摘要
要将HTML文档转换为PDF文档，请执行以下任务：
- 包括项目文件。
- 创建生成PDF客户端。
- 检索HTML内容以转换为PDF文档。
- 将HTML内容转换为PDF文档。
- 检索结果。
包含项目文件
在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序，请包含必要的JAR文件。 如果使用Web服务，请确保包含代理文件。
创建生成PDF客户端
您必须先创建生成PDF服务客户端，然后才能以编程方式执行生成PDF操作。 如果您使用的是Java API，请创建一个GeneratePdfServiceClient对象。 如果您使用的是Web服务API，请创建GeneratePDFServiceService。
检索HTML内容以转换为PDF文档
引用要转换为PDFHTML的文档内容。 您可以引用HTML内容，例如HTML文件或可使用URL访问的HTML内容。
将HTML内容转换为PDF文档
创建服务客户端后，可以调用相应的PDF创建操作。 此操作需要有关要转换的文档的信息，包括目标文档的路径。
检索结果
将HTML内容转换为PDF文档后，您可以检索结果并保存PDF文档。
另请参阅
使用Java API将HTML内容转换为PDF文档
使用生成HTMLAPI (Java)将PDF文档转换为PDF文档：
-
包括项目文件。
在您的Java项目的类路径中包含客户端JAR文件，例如adobe-generatepdf-client.jar。
-
创建生成PDF客户端。
使用对象的构造函数创建
GeneratePdfServiceClient对象，并传递包含连接属性的ServiceClientFactory对象。 -
检索HTML内容以转换为PDF文档。
通过创建字符串变量并分配指向HTML内容的URL来检索HTML内容。
-
将HTML内容转换为PDF文档。
调用
GeneratePdfServiceClient对象的htmlToPDF2方法并传递以下值：- 包含要转换的HTML文件的URL的
java.lang.String对象。 - 包含转换中使用的文件类型设置的
java.lang.String对象。 文件类型设置可包含居高临下的级别。 - 包含要使用的安全设置的名称的
java.lang.String对象。 - 包含要在生成PDF文档时应用的设置的可选
com.adobe.idp.Document对象。 如果未提供此信息，则会根据前三个参数自动选择设置。 - 包含要应用于PDF文档的元数据信息的可选
com.adobe.idp.Document对象。
- 包含要转换的HTML文件的URL的
-
检索结果。
htmlToPDF2方法返回包含已生成的新PDF文档的HtmlToPdfResult对象。 要获取新创建的PDF文档，请执行下列操作：- 调用
HtmlToPdfResult对象的getCreatedDocument方法。 这将返回com.adobe.idp.Document对象。 - 调用
com.adobe.idp.Document对象的copyToFile方法以从上一步中创建的对象提取PDF文档。
- 调用
使用Web服务API将HTML内容转换为PDF文档
使用生成HTMLAPI（Web服务）将PDF内容转换为PDF文档：
-
包括项目文件。
创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义：
http://localhost:8080/soap/services/GeneratePDFService?WSDL&lc_version=9.0.1。NOTE将localhost替换为承载AEM Forms的服务器的IP地址。 -
创建生成PDF客户端。
-
使用默认构造函数创建
GeneratePDFServiceClient对象。 -
使用
System.ServiceModel.EndpointAddress构造函数创建GeneratePDFServiceClient.Endpoint.Address对象。 将指定WSDL的字符串值传递给AEM Forms服务（例如，http://localhost:8080/soap/services/GeneratePDFService?blob=mtom）。 您无需使用lc_version属性。 但是，请指定?blob=mtom。 -
通过获取
GeneratePDFServiceClient.Endpoint.Binding字段的值创建一个System.ServiceModel.BasicHttpBinding对象。 将返回值强制转换为BasicHttpBinding。 -
将
System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。 此值可确保使用MTOM。 -
通过执行以下任务启用基本HTTP身份验证：
- 将AEM表单用户名分配给字段
GeneratePDFServiceClient.ClientCredentials.UserName.UserName。 - 将相应的密码值分配给字段
GeneratePDFServiceClient.ClientCredentials.UserName.Password。 - 将常量值
HttpClientCredentialType.Basic分配给字段BasicHttpBindingSecurity.Transport.ClientCredentialType。 - 将常量值
BasicHttpSecurityMode.TransportCredentialOnly分配给字段BasicHttpBindingSecurity.Security.Mode。
- 将AEM表单用户名分配给字段
-
-
检索HTML内容以转换为PDF文档。
通过创建字符串变量并分配指向HTML内容的URL来检索HTML内容。
-
将HTML内容转换为PDF文档。
通过调用
GeneratePDFServiceService对象的HtmlToPDF2方法，将HTML内容转换为PDF文档，并传递以下值：- 一个字符串，其中包含要转换的HTML内容。
- 包含转换中使用的文件类型设置的
java.lang.String对象。 - 包含要使用的安全设置的字符串对象。
- 包含要在生成PDF文档时应用的设置的可选
BLOB对象。 - 包含要应用于PDF文档的元数据信息的可选
BLOB对象。 CreatePDF2方法填充的BLOB类型的输出参数。CreatePDF2方法使用转换的文档填充此对象。 （只有Web服务调用才需要此参数值）。
-
检索结果。
- 通过将
BLOB对象的MTOM字段分配给字节数组来检索转换后的PDF文档。 字节数组表示转换后的PDF文档。 确保使用用作HtmlToPDF2方法的输出参数的BLOB对象。 - 通过调用其构造函数并传递表示已转换PDF文档的文件位置的字符串值来创建
System.IO.FileStream对象。 - 通过调用其构造函数并传递
System.IO.FileStream对象来创建System.IO.BinaryWriter对象。 - 通过调用
System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。
- 通过将
将PDF文档转换为非图像格式
本节介绍如何使用生成PDFJava API和Web服务API以编程方式将PDF文档转换为RTF文件，这是非图像格式的一个示例。 其他非图像格式包括HTML、文本、DOC和EPS。 将PDF文档转换为RTF时，请确保PDF文档不包含表单元素，如提交按钮。 不会转换表单元素。
NOTE步骤摘要
要将PDF文档转换为任何支持的类型，请执行以下步骤：
- 包括项目文件。
- 创建生成PDF客户端。
- 检索要转换的PDF文档。
- 转换PDF文档。
- 保存转换后的文件。
包含项目文件
在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序，请包含必要的JAR文件。 如果使用Web服务，请确保包含代理文件。
创建生成PDF客户端
您必须先创建生成PDF服务客户端，然后才能以编程方式执行生成PDF操作。 如果您使用的是Java API，请创建一个GeneratePdfServiceClient对象。 如果您使用的是Web服务API，请创建一个GeneratePDFServiceService对象。
检索要转换的PDF文档
检索要转换为非图像PDF的格式文档。
转换PDF文档
创建服务客户端后，可以调用PDF导出操作。 此操作需要有关要转换的文档的信息，包括目标文档的路径。
保存转换后的文件
保存转换后的文件。 例如，如果将PDF文档转换为RTF文件，则将转换后的文档保存到RTF文件。
另请参阅
使用Java API将PDF文档转换为RTF文件
使用生成PDFAPI (Java)将PDF文档转换为RTF文件：
-
包括项目文件。
在您的Java项目的类路径中包含客户端JAR文件，例如adobe-generatepdf-client.jar。
-
创建生成PDF客户端。
使用对象的构造函数创建
GeneratePdfServiceClient对象，并传递包含连接属性的ServiceClientFactory对象。 -
检索要转换的PDF文档。
- 创建一个
java.io.FileInputStream对象，该对象表示要使用其构造函数转换的PDF文档。 传递一个指定PDF文档位置的字符串值。 - 使用对象的构造函数创建
com.adobe.idp.Document对象并传递java.io.FileInputStream对象。
- 创建一个
-
转换PDF文档。
调用
GeneratePdfServiceClient对象的exportPDF2方法并传递以下值：- 表示要转换的PDF文件的
com.adobe.idp.Document对象。 - 包含要转换的文件名称的
java.lang.String对象。 - 包含Adobe PDF设置名称的
java.lang.String对象。 - 指定转换的目标文件类型的
ConvertPDFFormatType对象。 - 包含要在生成PDF文档时应用的设置的可选
com.adobe.idp.Document对象。
exportPDF2方法返回包含转换文件的ExportPDFResult对象。 - 表示要转换的PDF文件的
-
转换PDF文档。
要获取新创建的文件，请执行以下步骤：
- 调用
ExportPDFResult对象的getConvertedDocument方法。 这将返回com.adobe.idp.Document对象。 - 调用
com.adobe.idp.Document对象的copyToFile方法来提取新文档。
- 调用
使用Web服务API将PDF文档转换为RTF文件
使用生成PDFAPI（Web服务）将PDF文档转换为RTF文件：
-
包括项目文件。
创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义：
http://localhost:8080/soap/services/GeneratePDFService?WSDL&lc_version=9.0.1。NOTE将localhost替换为承载AEM Forms的服务器的IP地址。 -
创建“生成PDf”客户端。
-
使用默认构造函数创建
GeneratePDFServiceClient对象。 -
使用
System.ServiceModel.EndpointAddress构造函数创建GeneratePDFServiceClient.Endpoint.Address对象。 将指定WSDL的字符串值传递给AEM Forms服务（例如，http://localhost:8080/soap/services/GeneratePDFService?blob=mtom）。 您无需使用lc_version属性。 但是，请指定?blob=mtom。 -
通过获取
GeneratePDFServiceClient.Endpoint.Binding字段的值创建一个System.ServiceModel.BasicHttpBinding对象。 将返回值强制转换为BasicHttpBinding。 -
将
System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。 此值可确保使用MTOM。 -
通过执行以下任务启用基本HTTP身份验证：
- 将AEM表单用户名分配给字段
GeneratePDFServiceClient.ClientCredentials.UserName.UserName。 - 将相应的密码值分配给字段
GeneratePDFServiceClient.ClientCredentials.UserName.Password。 - 将常量值
HttpClientCredentialType.Basic分配给字段BasicHttpBindingSecurity.Transport.ClientCredentialType。 - 将常量值
BasicHttpSecurityMode.TransportCredentialOnly分配给字段BasicHttpBindingSecurity.Security.Mode。
- 将AEM表单用户名分配给字段
-
-
检索要转换的PDF文档。
- 使用构造函数创建
BLOB对象。BLOB对象用于存储已转换的PDF文档。 - 通过调用其构造函数并传递一个字符串值来创建一个
System.IO.FileStream对象，该字符串值表示PDF文档的文件位置以及打开文件的模式。 - 创建用于存储
System.IO.FileStream对象的内容的字节数组。 您可以通过获取System.IO.FileStream对象的Length属性来确定字节数组的大小。 - 通过调用
System.IO.FileStream对象的Read方法并传递要读取的字节数组、起始位置和流长度，使用流数据填充字节数组。 - 通过为其
MTOM属性分配字节数组的内容来填充BLOB对象。
- 使用构造函数创建
-
转换PDF文档。
调用
GeneratePDFServiceServiceWse对象的ExportPDF2方法并传递以下值：- 表示要转换的PDF文件的
BLOB对象。 - 一个字符串，其中包含要转换的文件的路径名称。
- 指定文件位置的
java.lang.String对象。 - 一个字符串对象，它指定转换的目标文件类型。 指定
RTF。 - 包含要在生成PDF文档时应用的设置的可选
BLOB对象。 ExportPDF2方法填充的BLOB类型的输出参数。ExportPDF2方法使用转换的文档填充此对象。 （只有Web服务调用才需要此参数值）。
- 表示要转换的PDF文件的
-
保存转换后的文件。
- 通过将
BLOB对象的MTOM字段分配给字节数组来检索转换后的RTF文档。 字节数组表示转换后的RTF文档。 确保使用用作ExportPDF2方法的输出参数的BLOB对象。 - 通过调用其构造函数创建
System.IO.FileStream对象。 传递表示RTF文件位置的字符串值。 - 通过调用其构造函数并传递
System.IO.FileStream对象来创建System.IO.BinaryWriter对象。 - 通过调用
System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入RTF文件。
- 通过将
添加对其他本机文件格式的支持
本节介绍如何添加对其他本机文件格式的支持。 它概述了“生成PDF”服务与此服务用于将本机文件格式转换为PDF的本机应用程序之间的交互。
本节还介绍以下内容：
- 如何修改生成PDF服务向本机应用程序提供的响应，该产品已使用该响应将本机文件格式转换为PDF
- 生成PDF服务、生成PDF服务应用程序监视器(AppMon)组件与本机应用程序(如Microsoft Word)之间的交互
- XML语法在这些交互中所扮演的角色
组件交互
生成PDF服务通过调用与文件格式关联的应用程序，然后与应用程序交互以使用默认打印机打印文档，来转换本机文件格式。 默认打印机必须设置为Adobe PDF打印机。
此插图显示了与本机应用程序支持相关的组件和驱动程序。 它还提到了影响交互的XML语法。
用于本机文件转换的组件交互
本文档使用术语 本机应用程序 来表示用于生成本机文件格式的应用程序，如Microsoft Word。
AppMon 是一个企业组件，该组件与本机应用程序交互的方式与用户浏览该应用程序提供的对话框的方式相同。 AppMon用于指示应用程序(如Microsoft Word)打开和打印文件的XML语法涉及以下顺序任务：
- 通过选择“文件”>“打开”打开文件
- 确保显示“打开”对话框；如果没有，则处理错误
- 在文件名字段中提供文件名，然后单击打开按钮
- 确保文件实际打开
- 通过选择“文件”>“打印”打开“打印”对话框
- 确保显示“打印”对话框
AppMon使用标准的Win32 API与第三方应用程序进行交互，以传输UI事件（如按键和鼠标点击），这有助于控制这些应用程序从它们生成PDF文件。
由于这些Win32 API的限制，AppMon无法将这些UI事件调度到某些特定类型的窗口，例如浮动菜单栏（可在某些应用程序，如TextPad中找到）和某些无法使用Win32 API检索其内容的对话框。
直观地识别浮动菜单栏很容易；但仅仅通过视觉检查不可能识别特殊类型的对话框。 您需要使用第三方应用程序(例如Microsoft Spy++(Microsoft Visual C++开发环境的一部分)或其等效的WinID(可从https://www.dennisbabkin.com/php/download.php?what=WinID免费下载)来检查对话框，以确定AppMon是否能够使用标准Win32 API与其交互。
如果WinID能够提取对话框内容（如文本、子窗口、窗口类ID等），则AppMon也能够提取对话框内容。
此表列出了打印本机文件格式时使用的信息类型。
包括PDF设置、安全设置和文件类型设置。
文件类型设置将文件扩展名与相应的本机应用程序相关联。 文件类型设置还指定用于打印本地文件的本地应用程序设置。
要更改已支持的本机应用程序的设置，系统管理员在管理控制台中设置文件类型设置。
要添加对新的本机文件格式的支持，必须手动编辑该文件。 （请参阅添加或修改对本机文件格式的支持。）
指定生成PDF服务和本机应用程序之间的交互。 此类交互通常指示应用程序将文件打印到Adobe PDF驱动程序。
该脚本包含指导本机应用程序打开特定对话框以及为这些对话框中的字段和按钮提供特定响应的说明。
生成PDF服务包括所有支持的本机应用程序的脚本文件。 您可以使用XML编辑应用程序修改这些文件。
要添加对新的本机应用程序的支持，必须创建一个脚本文件。 （请参阅为本机应用程序创建或修改其他对话框XML文件。）
指定如何响应多个应用程序共有的对话框。 此类对话框由操作系统、辅助应用程序（如PDFMaker）和驱动程序生成。
包含此信息的文件是appmon.global.en_US.xml。
指定如何响应特定于应用程序的对话框。
包含此信息的文件为appmon。'[appname]'.dialog。'[locale]'.xml（例如，appmon.word.en_US.xml）。
请勿修改此文件。
要为新的本机应用程序添加对话框说明，请参阅为本机应用程序创建或修改其他对话框XML文件。
指定特定于应用程序的对话框说明的覆盖和添加。 部分介绍了此类信息的示例。
包含此信息的文件为appmon。“[appname]”.addition.'[区域设置]'.xml。 例如appmon.addition.en_US.xml。
可以使用XML编辑应用程序创建和修改此类型的文件。 （请参阅为本机应用程序创建或修改其他对话框XML文件。）
重要信息：为服务器将支持的每个本机应用程序创建其他特定于应用程序的对话框说明。
关于脚本和对话框XML文件
脚本XML文件指示生成PDF服务以与用户浏览应用程序对话框相同的方式浏览应用程序对话框。 脚本XML文件还指示生成PDF服务通过执行按按钮、选择或取消选择复选框或选择菜单项等操作来响应对话框。
相反，对话框XML文件仅对对话框作出响应，其操作类型与在脚本XML文件中使用的操作类型相同。
对话框和窗口元素术语
本节和下一节根据所描述的透视，为对话框及其包含的组件使用不同的术语。 对话框组件是按钮、字段和组合框等项。
当本节和下一节从用户的角度描述对话框及其组件时，使用了 对话框、按钮、字段 和 组合框 等术语。
当本节和下一节从对话框的内部表示角度描述对话框及其组件时，使用术语 窗口元素。 窗口元素的内部表示是一个层次结构，其中每个窗口元素实例由标签标识。 窗口元素实例还描述了其物理特性和行为。
从用户的角度来看，对话框及其组件显示不同的行为，其中某些对话框元素在激活之前是隐藏的。 从内部呈现的角度来看，不存在此类行为问题。 例如，对话框的内部表示与它所包含的元件类似，只是这些元件嵌套在对话框内。
本节介绍为AppMon提供说明的XML元素。 这些元素的名称包括dialog元素和window元素。 本文档使用等宽字体来区分XML元素。 dialog元素标识XML脚本文件可能导致显示（有意或无意）的对话框。 window元素标识一个窗口元素（对话框或对话框的组件）。
层级
此图显示了脚本和对话框XML的层次结构。 脚本XML文件符合script.xsd架构，该架构包括（在XML意义上）window.xsd架构。 同样，对话框XML文件符合dialogs.xsd架构，其中还包括window.xsd架构。
脚本和对话框XML的层次结构
编写XML文件的脚本
脚本XML文件 指定了一系列步骤，这些步骤指示本机应用程序导航到某些窗口元素，然后提供对这些元素的响应。 大多数响应是文本或按键，对应于用户提供给相应对话框中的字段、组合框或按钮的输入。
生成PDF服务支持脚本XML文件的目的是指示本机应用程序打印本机文件。 但是，脚本XML文件可用于完成用户在与本机应用程序的对话框交互时可以执行的任何任务。
脚本XML文件中的步骤按顺序执行，没有任何分支机会。 唯一支持的条件测试是针对超时/重试的测试，如果某个步骤在特定时间段内未能成功完成并且经过了特定次数的重试，该测试会导致脚本终止。
除了顺序步骤之外，步骤中的指令也按顺序执行。 确保步骤和说明反映了用户执行这些相同步骤的顺序。
脚本XML文件中的每个步骤都标识了成功执行该步骤的说明时预期出现的窗口元素。 如果在执行脚本步骤时出现意外对话框，生成PDF服务将按下一节所述搜索对话框XML文件。
对话框XML文件
运行本机应用程序将显示不同的对话框，无论本机应用程序处于可见模式还是不可见模式，都会显示这些对话框。 这些对话框可以由操作系统或应用程序本身生成。 当本机应用程序在生成PDF服务的控制下运行时，系统和本机应用程序对话框会显示在不可见的窗口中。
对话框XML文件 指定生成PDF服务如何响应系统或本机应用程序对话框。 对话框XML文件允许生成PDF服务以有助于转换过程的方式响应未提示的对话框。
当系统或本机应用程序显示当前执行的脚本XML文件未处理的对话框时，生成PDF服务将按此顺序搜索对话框XML文件，并在找到匹配项时停止：
- 阿普蒙。
[appname].其他。[locale].xml - 阿普蒙。
[appname]。[locale].xml （不修改此文件。） - appmon.global.
[locale].xml （不修改此文件。）
如果生成PDF服务找到对话框的匹配项，它将通过向它发送键击或为该对话框指定的其他操作来解除该匹配项。 如果对话框的说明指定中止消息，则生成PDF服务将终止当前执行的作业并生成错误消息。 将在脚本XML语法的abortMessage元素中指定此类中止消息。
如果生成PDF服务遇到的对话框未在之前列出的任何文件中描述，则生成PDF服务将该对话框的标题并入日志文件条目。 当前正在执行的作业最终超时。 然后，可以使用日志文件中的信息在用于本机应用程序的附加对话框XML文件中编写新说明。
添加或修改对本机文件格式的支持
本节介绍为支持其他本机文件格式或修改对已支持的本机文件格式的支持而必须执行的任务。
在添加或修改支持之前，必须完成以下任务。
选择用于标识窗口元素的工具
对话框和脚本XML文件要求您标识对话框或脚本元素所响应的窗口元素（对话框、字段或其他对话框组件）。 例如，在脚本调用本机应用程序的菜单后，脚本必须标识要对其应用击键或操作的菜单上的窗口元素。
您可以通过对话框标题栏中显示的标题轻松识别对话框。 但是，必须使用Microsoft Spy++等工具来标识较低级别的窗口元素。 低层窗口元素可以通过多种属性进行识别，这些属性并不明显。 此外，每个本机应用程序可以不同地标识其窗口元素。 因此，可通过多种方法来识别窗口元素。 下面是考虑窗口元素标识的建议顺序：
- 标题本身是唯一的
- 控件ID，对于给定的对话框可能唯一，也可能不唯一
- 类名，它可能是唯一的，也可能不是唯一的
可以使用这三个属性的任意一个或组合来标识窗口。
如果属性无法识别字幕，您可以改为使用窗口元素相对于其父项的索引来识别窗口元素。 index 指定窗口元素相对于其同级窗口元素的位置。 通常，索引是识别组合框的唯一方法。
请注意以下问题：
- Microsoft Spy使用与号(&)显示字幕，以标识字幕的热键。 例如，Spy将一个“打印”对话框的标题显示为
Pri&nt，这表示热键为 n。 脚本和对话框XML文件中的字幕标题必须省略&符号。 - 某些字幕包括换行符。 生成PDF服务无法识别换行符。 如果标题包含换行符，请包含足够的标题以将其与其他菜单项区分开，然后为省略的部分使用正则表达式。 例如(
^Long caption title$)。 （请参阅在标题属性中使用正则表达式。） - 为保留的XML字符使用字符实体（也称为转义序列）。 例如，将
&用于&符号，将<和>用于小于和大于符号，将'用于撇号，将"用于引号。
如果计划处理对话框或脚本XML文件，则应安装应用程序Microsoft Spy++。
解包对话框和脚本文件
对话框和脚本文件位于appmondata.jar文件中。 在修改任何这些文件或者添加新脚本或对话框之前，必须取消封装此JAR文件。 例如，假设您要添加对EditPlus应用程序的支持。 创建两个XML文件，名为appmon.editplus.script.en_US.xml和appmon.editplus.script.addition.en_US.xml。 必须将这些XML脚本添加到位于以下两个位置的adobe-appmondata.jar文件中：
- adobe-livecycle-native-jboss-x86_win32.ear > adobe-Native2PDFSvc.war\WEB-INF\lib > adobe-native.jar > Native2PDFSvc-native.jar\bin > adobe-appmondata.jar\com\adobe\appmon. adobe-livecycle-native-jboss-x86_win32.ear文件位于
[AEM forms install directory]\configurationManager的导出文件夹中。 (如果AEM Forms部署在另一个J2EE应用程序服务器上，请将adobe-livecycle-native-jboss-x86_win32.ear文件替换为与您的J2EE应用程序服务器对应的EAR文件。) - adobe-generatepdf-dsc.jar > adobe-appmondata.jar\com\adobe\appmon （adobe-appmondata.jar文件位于adobe-generatepdf-dsc.jar文件中）。 adobe-generatepdf-dsc.jar文件位于
[AEM forms install directory]\deploy文件夹中。
将这些XML文件添加到adobe-appmondata.jar文件后，必须重新部署GeneratePDF组件。 要将对话框和脚本XML文件添加到adobe-appmondata.jar文件中，请执行以下任务：
- 使用WinZip或WinRAR之类的工具，打开adobe-livecycle-native-jboss-x86_win32.earfile > adobe-Native2PDFSvc.war\WEB-INF\lib > adobe-native.jar > Native2PDFSvc-native.jar\bin > adobe-appmondata.jar文件。
- 将对话框和脚本XML文件添加到appmondata.jar文件中，或修改此文件中的现有XML文件。 （请参阅为本机应用程序创建或修改脚本XML文件和为本机应用程序创建或修改其他对话框XML文件。）
- 使用WinZip或WinRAR等工具，打开adobe-generatepdf-dsc.jar > adobe-appmondata.jar 。
- 将对话框和脚本XML文件添加到appmondata.jar文件中，或修改此文件中的现有XML文件。 （请参阅为本机应用程序创建或修改脚本XML文件和为本机应用程序创建或修改其他对话框XML文件。） 将XML文件添加到adobe-appmondata.jar文件后，将新的adobe-appmondata.jar文件放置到adobe-generatepdf-dsc.jar文件中。
- 如果您添加了对其他本机文件格式的支持，请创建一个提供应用程序路径的系统环境变量（请参阅创建环境变量以定位本机应用程序）。
重新部署GeneratePDF组件
- 登录到Workbench。
- 选择 窗口 > 显示视图 > 组件。 此操作会将“组件”视图添加到Workbench。
- 右键单击“生成PDF”组件，然后选择 停止组件。
- 组件停止后，右键单击并选择“卸载组件”将其删除。
- 右键单击 组件 图标并选择 安装组件。
- 浏览并选择修改的adobe-generatepdf-dsc.jar文件，然后单击“打开”。 请注意，GeneratePDF组件旁边会显示一个红色方块。
- 展开GeneratePDF组件，选择“服务描述符”，右键单击“生成PDF服务”，然后选择“激活服务”。
- 在出现的配置对话框中，输入适用的配置值。 如果将这些值留空，则使用默认配置值。
- 右键单击“生成PDF”并选择“启动组件”。
- 展开Active Services。 如果服务正在运行，其名称旁边会显示绿色箭头。 否则，服务将处于停止状态。
- 如果服务处于停止状态，请右键单击服务名称并选择启动服务。
创建或修改本机应用程序的脚本XML文件
如果要将文件定向到新的本机应用程序，则必须为该应用程序创建脚本XML文件。 如果要修改“生成PDF”服务与已受支持的本机应用程序的交互方式，则必须修改该应用程序的脚本。
该脚本包含浏览本机应用程序的窗口元素以及提供对这些元素的特定响应的说明。 包含此信息的文件是appmon.[appname]“.script.[区域设置].xml”。 例如，appmon.notepad.script.en_US.xml。
确定脚本必须执行的步骤
使用本机应用程序，确定必须导航的窗口元素，以及打印文档时必须执行的每个响应。 请注意任何响应产生的对话框。 这些步骤将类似于以下步骤：
- 选择“文件”>“打开”。
- 指定路径，然后单击“打开”。
- 在菜单栏上选择“文件”>“打印”。
- 指定打印机所需的属性。
- 选择打印，然后等待另存为对话框出现。 “生成PDF”服务需要“另存为”对话框来指定PDF文件的目标。
标识题注属性中指定的对话框
使用Microsoft Spy++获取本机应用程序中窗口元素属性的标识。 您必须具有这些身份才能编写脚本。
在标题属性中使用正则表达式
您可以在题注规范中使用正则表达式。 生成PDF服务使用java.util.regex.Matcher类支持正则表达式。 该实用程序支持java.util.regex.Pattern中描述的正则表达式。
包含记事本横幅中前置于记事本的文件名的正则表达式
<!-- The regular expression ".*Notepad" means any number of non-terminating characters followed by Notepad. -->
<step>
<expectedWindow>
<window caption=".*Notepad"/>
</expectedWindow>
</step>
用于区分打印与打印设置的正则表达式
<!-- This regular expression differentiates the Print dialog box from the Print Setup dialog box. The "^" specifies the beginning of the line, and the "$" specifies the end of the line. -->
<windowList>
<window controlID="0x01" caption="^Print$" action="press"/>
</windowList>
对window和windowList元素排序
按如下方式排序window和windowList元素：
- 当多个
window元素在windowList或dialog元素中显示为子级时，请以降序对这些window元素进行排序，其中caption个名称的长度表示按顺序排列的位置。 - 当多个
windowList元素出现在window元素中时，请以降序对这些windowList元素进行排序，第一个indexes/元素的caption属性的长度指示该顺序中的位置。
在对话框中排序窗口元素
<!-- The caption attribute in the following window element is 40 characters long. It is the longest caption in this example, so its parent window element appears before the others. -->
<window caption="Unexpected Failure in DebugActiveProcess">
<…>
</window>
<!-- Caption length is 33 characters. -->
<window caption="Adobe Acrobat - License Agreement">
<…>
</window>
<!-- Caption length is 33 characters. -->
<window caption="Microsoft Visual.*Runtime Library">
<…>
</window>
<!-- The caption attribute in the following window element is 28 characters long. It is the shortest caption in this example, so its parent window element appears after the others. -->
<window caption="Adobe Acrobat - Registration">
<…>
</window>
在windowList元素中对窗口元素排序
<!-- The caption attribute in the following indexes element is 56 characters long. It is the longest caption in this example, so its parent window element appears before the others. -->
<windowList>
<window caption="Can't exit design mode because.* cannot be created"/>
<window className="Button" caption="OK" action="press"/>
</windowList>
<windowList>
<window caption="Do you want to continue loading the project?"/>
<window className="Button" caption="No" action="press"/>
</windowList>
<windowList>
<window caption="The macros in this project are disabled"/>
<window className="Button" caption="OK" action="press"/>
</windowList>
为本机应用程序创建或修改其他对话框XML文件
如果为以前不受支持的本机应用程序创建脚本，则还必须为该应用程序创建一个附加的对话框XML文件。 AppMon使用的每个本机应用程序只能有一个额外的对话框XML文件。 即使不需要未经请求的对话框，也需要其他对话框XML文件。 附加对话框必须至少有一个window元素，即使该window元素只是占位符。
NOTEappmon.[applicationname].addition.[locale].xml文件的内容。 此类文件指定对对话框XML文件的覆盖和添加。您还可以为本机应用程序修改其他对话框XML文件，其目的如下：
- 为具有不同响应的应用程序覆盖对话框XML文件
- 将响应添加到该应用程序的对话框XML文件中未寻址的对话框
标识附加dialogXML文件的文件名为appmon.[appname].addition.[locale].xml。 例如，appmon.excel.addition.en_US.xml。
其他对话框XML文件的名称必须使用格式appmon.[applicationname].addition.[locale].xml，其中 applicationname 必须与XML配置文件和脚本中使用的应用程序名称完全匹配。
NOTE对在window元素中显示为子项的windowList元素进行排序。 （请参阅对窗口和windowList元素进行排序。）
修改常规对话框XML文件
可以修改常规对话框XML文件，以响应系统生成的对话框，或响应多个应用程序共有的对话框。
在XML配置文件中添加文件类型条目
此过程说明如何更新生成PDF服务配置文件以将文件类型与本地应用程序相关联。 要更新此配置文件，必须使用管理控制台将配置数据导出到文件。 配置数据的默认文件名是native2pdfconfig.xml。
更新生成PDF服务配置文件
- 选择 主页 > 服务 > Adobe PDF生成器 > 配置文件，然后选择 导出配置。
- 根据需要修改native2pdfconfig.xml文件中的
filetype-settings元素。 - 选择 主页 > 服务 > Adobe PDF生成器 >配置文件，然后选择 导入配置。 配置数据将导入生成PDF服务，并替换以前的设置。
NOTEGenericApp元素的name属性的值。 此值必须与您为该应用程序开发的脚本中指定的相应名称完全匹配。 同样，GenericApp元素的displayName属性应与相应脚本的expectedWindow窗口标题完全匹配。 在解析displayName或caption属性中出现的任何正则表达式后，将计算此类等价。在此示例中，生成PDF服务提供的默认配置数据已修改，以指定应使用记事本(而不是Microsoft Word)处理文件扩展名为.txt的文件。 在此修改之前，已将Microsoft Word指定为应该处理此类文件的本机应用程序。
用于将文本文件定向到记事本(native2pdfconfig.xml)的修改
<filetype-settings>
<!-- Some native app file types were omitted for brevity. -->
<!-- The following GenericApp element specifies Notepad as the native application that should be used to process files that have a txt file name extension. -->
<GenericApp
extensions="txt"
name="Notepad" displayName=".*Notepad"/>
<GenericApp
extensions="wpd"
name="WordPerfect" displayName="Corel WordPerfect"/>
<GenericApp extensions="pmd,pm6,p65,pm"
name="PageMaker" displayName="Adobe PageMaker"/>
<GenericApp extensions="fm"
name="FrameMaker" displayName="Adobe FrameMaker"/>
<GenericApp extensions="psd"
name="Photoshop" displayName="Adobe Photoshop"/>
</settings>
</filetype-settings>
创建环境变量以定位本机应用程序
创建一个环境变量，该变量指定本机应用程序可执行文件的位置。 变量必须使用格式[applicationname]_PATH，其中 applicationname 必须与XML配置文件和脚本中使用的应用程序名称完全匹配，并且路径包含以双引号表示的可执行文件的路径。 此类环境变量的示例为Photoshop_PATH。
创建新的环境变量后，必须重新启动部署生成PDF服务的服务器。
NOTE在Windows XP环境中创建系统变量
- 选择 控制面板>系统。
- 在“系统属性”对话框中，单击 高级 选项卡，然后单击 环境变量。
- 在“环境变量”对话框的“系统变量”下，单击 新建。
- 在“新建系统变量”对话框的 变量名称 框中，键入使用格式
[applicationname]_PATH的名称。 - 在 变量值 框中，键入应用程序可执行文件的完整路径和文件名，然后单击 确定。 例如，类型：
c:\windows\Notepad.exe - 在“环境变量”对话框中，单击 确定。
从命令行创建系统变量
-
在命令行窗口中，使用以下格式键入变量定义：
[applicationname]_PATH=[Full path name]例如，类型：
NotePad_PATH=C:\WINDOWS\NOTEPAD.EXE -
启动新的命令行提示符以使系统变量生效。
XML文件
AEM Forms包含示例XML文件，这些文件导致“生成PDF”服务使用记事本处理任何文件扩展名为.txt的文件。 此代码包含在此部分中。 此外，您必须进行本节中描述的其他修改。
附加对话框XML文件
此示例包含记事本应用程序的其他对话框。 这些对话框可以是“生成PDF”服务指定的对话框之外的对话框。
记事本对话框(appmon.notepad.addition.en_US.xml)
<dialogs app="Notepad" locale="en_US" version="7.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="dialogs.xsd">
<window caption="Caption Title">
<windowList>
<window className="Button" caption="OK" action="press"/>
</windowList>
</window>
</dialogs>
编写XML文件的脚本
此示例指定生成PDF服务应如何与记事本交互以使用Adobe PDF打印机打印文件。
记事本脚本XML文件(appmon.notepad.script.en_US.xml)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!--
*
* ADOBE CONFIDENTIAL
* ___________________
* Copyright 2004 - 2005 Adobe Systems Incorporated
* All Rights Reserved.
*
* NOTICE: All information contained herein is, and remains
* the property of Adobe Systems Incorporated and its suppliers,
* if any. The intellectual and technical concepts contained
* herein are proprietary to Adobe Systems Incorporated and its
* suppliers and may be covered by U.S. and Foreign Patents,
* patents in process, and are protected by trade secret or copyright law.
* Dissemination of this information or reproduction of this material
* is strictly forbidden unless prior written permission is obtained
* from Adobe Systems Incorporated.
*-->
<!-- This file automates printing of text files via notepad to Adobe PDF printer. To see the complete hierarchy Adobe recommends using the Microsoft Spy++ which details the properties of windows necessary to write scripts. In this sample there are total of eight steps-->
<application name="Notepad" version="9.0" locale="en_US" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="scripts.xsd">
<!-- In this step we wait for the application window to appear -->
<step>
<expectedWindow>
<window caption=".*Notepad"/>
</expectedWindow>
</step>
<!-- In this step, we acquire the application window and send File->Open menu bar, menu item commands and the expectation is the windows Open dialog-->
<step>
<acquiredWindow>
<window caption=".*Notepad">
<virtualInput>
<menuBar>
<selection>
<name>File</name>
</selection>
<selection>
<name>Open...</name>
</selection>
</menuBar>
</virtualInput>
</window>
</acquiredWindow>
<expectedWindow>
<window caption="Open"/>
</expectedWindow>
</step>
<!-- In this step, we acquire the Open window and then select the 'Edit' widget and input the source path followed by clicking on the 'Open' button . The expectation of this 'action' is that the Open dialog will disappear -->
<step>
<acquiredWindow>
<window caption="Open">
<windowList>
<window className="ComboBoxEx32">
<windowList>
<window className="ComboBox">
<windowList>
<window className="Edit" action="inputSourcePath"/>
</windowList>
</window>
</windowList>
</window>
</windowList>
<windowList>
<window className="Button" caption="Open" action="press"/>
</windowList>
</window>
</acquiredWindow>
<expectedWindow>
<window caption="Open" action="disappear"/>
</expectedWindow>
<pause value="30"/>
</step>
<!-- In this step, we acquire the application window and send File->Print menu bar, menu item commands and the expectation is the windows Print dialog-->
<step>
<acquiredWindow>
<window caption=".*Notepad">
<virtualInput>
<menuBar>
<selection>
<name>File</name>
</selection>
<selection>
<name>Print...</name>
</selection>
</menuBar>
</virtualInput>
</window>
</acquiredWindow>
<expectedWindow>
<window caption="Print">
</window>
</expectedWindow>
</step>
<!-- In this step, we acquire the Print dialog and click the 'Preferences' button and the expected window in this case is the dialog with the caption '"Printing Preferences' -->
<step>
<acquiredWindow>
<window caption="Print">
<windowList>
<window caption="General">
<windowList>
<window className="Button" caption="Preferences" action="press"/>
</windowList>
</window>
</windowList>
</window>
</acquiredWindow>
<expectedWindow>
<window caption="Printing Preferences"/>
</expectedWindow>
</step>
<!-- In this step, we acquire the dialog "Printing Preferences' and select the combo box which is the 10th child of window with caption '"Adobe PDF Settings' and select the first index. (Note: All indeces start with 0.) Besides this we uncheck the box which has the caption '"View Adobe PDF results' and we click the button OK. The expectation is that 'Printing Preferences' dialog disappears. -->
<step>
<acquiredWindow>
<window caption="Printing Preferences">
<windowList>
<window caption="Adobe PDF Settings">
<windowList>
<window className="Button" caption="View Adobe PDF results" action="uncheck"/>
</windowList>
<windowList>
<window className="Button" caption="Ask to Replace existing PDF file" action="uncheck"/>
</windowList>
</window>
</windowList>
<windowList>
<window className="Button" caption="OK" action="press"/>
</windowList>
</window>
</acquiredWindow>
<expectedWindow>
<window caption="Printing Preferences" action="disappear"/>
</expectedWindow>
</step>
<!-- In this step, we acquire the 'Print' dialog and click the Print button. The expectation is that the dialog with caption 'Print' disappears. In this case we use the regular expression '^Print$' for specifying the caption given there could be multiple dialogs with caption that includes the word Print. -->
<step>
<acquiredWindow>
<window caption="Print">
<windowList>
<window caption="General"/>
<window className="Button" caption="^Print$" action="press"/>
</windowList>
</window>
</acquiredWindow>
<expectedWindow>
<window caption="Print" action="disappear"/>
</expectedWindow>
</step>
<step>
<expectedWindow>
<window caption="Save PDF File As"/>
</expectedWindow>
</step>
<!-- Finally in this step, we acquire the dialog with caption "Save PDF File As" and in the Edit widget type the destination path for the output PDF file and click the Save button. The expectation is that the dialog disappears-->
<step>
<acquiredWindow>
<window caption="Save PDF File As">
<windowList>
<window className="Edit" action="inputDestinationPath"/>
</windowList>
<windowList>
<window className="Button" caption="Save" action="press"/>
</windowList>
</window>
</acquiredWindow>
<expectedWindow>
<window caption="Save PDF File As" action="disappear"/>
</expectedWindow>
</step>
<!-- We can always set a retry count or a maximum time for a step. In case we surpass these limitations, PDF Generator generates this abort message and terminates processing. -->
<abortMessage msg="15078"/>
</application>