Forms服务可以呈现对其应用了使用权的表单。 使用权限与默认在Acrobat但在Adobe Reader不可用的功能有关,如向表单添加注释或填写表单字段并保存表单的功能。 对其应用使用权限的Forms称为启用权限的表单。 在Adobe Reader打开启用权限的表单的用户可以执行为该表单启用的操作。
要对表单应用使用权,Acrobat Reader DC扩展服务必须是AEM表单安装的一部分。 此外,您必须具有有效的凭据,才能对PDF文档应用使用权限。 也就是说,必须正确配置Acrobat Reader DC扩展服务,然后才能渲染启用权限的表单。 (请参阅关于Acrobat Reader DC扩展服务。)
要渲染包含使用权限的表单,必须使用XDP文件作为输入,而不是PDF文件。 如果您使用PDF文件作为输入,表单仍会呈现;但是,它不是启用权限的表单。
在指定以下使用权限时,不能用XML数据预填充表单:enableComments
、enableCommentsOnline
、enableEmbeddedFiles
或enableDigitalSignatures
。 (请参阅使用可流动布局预填充Forms。)
有关Forms服务的详细信息,请参见AEM Forms服务参考。
要渲染启用权限的表单,请执行以下任务:
包括项目文件
将必要的文件包含在您的开发项目中。 如果您使用Java创建客户端应用程序,请包含必要的JAR文件。 如果您使用Web服务,请确保包含代理文件。
创建Forms客户端API对象
在以编程方式执行Forms服务客户端API操作之前,必须创建Forms服务客户端。
设置使用权限运行时选项
您必须设置使用权限运行时选项才能呈现启用权限的表单。 还必须指定用于将使用权限应用于表单的凭据别名。 在指定别名值后,您可以指定每个用于表单的权限。
渲染启用权限的表单
要渲染启用权限的表单,请使用与渲染没有使用权限的表单相同的应用程序逻辑。 唯一的区别是必须确保应用程序逻辑中包含使用权限运行时选项。
使用FormsWeb服务API渲染启用权限的表单时,无法将文件附加到表单。
将表单数据流写入客户端Web浏览器
当Forms服务呈现一个启用权限的表单时,它会返回一个表单数据流,您必须将该数据流写入客户端Web浏览器。 一旦写入到客户端Web浏览器,用户就可以看到表单。 在Adobe Reader查看启用权限的表单的用户能够执行为该表单启用的操作。
另请参阅
使用FormsAPI(Java)渲染启用权限的表单:
包括项目文件
在Java项目的类路径中包含客户端JAR文件,如adobe-forms-client.jar。
创建Forms客户端API对象
ServiceClientFactory
对象。FormsServiceClient
对象的构造函数创建ServiceClientFactory
对象。设置使用权限运行时选项
ReaderExtensionSpec
对象的构造函数创建<a0/>对象。ReaderExtensionSpec
对象的setReCredentialAlias
方法指定凭据的别名,并指定表示别名值的字符串值。ReaderExtensionSpec
对象的相应方法来设置每个使用权限。 但是,只有在引用的凭据允许您设置使用权限时,才可设置此权限。 也就是说,如果凭据不允许您设置,则无法设置使用权限。 例如。 要设置允许用户填写表单字段并保存表单的使用权限,请调用ReaderExtensionSpec
对象的setReFillIn
方法并传递true
。无需调用ReaderExtensionSpec
对象的setReCredentialPassword
方法。 Forms服务不使用此方法。
渲染启用权限的表单
调用FormsServiceClient
对象的renderPDFFormWithUsageRights
方法并传递以下值:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
。com.adobe.idp.Document
对象,其中包含要与表单合并的数据。 如果不想合并数据,请传递一个空com.adobe.idp.Document
对象。PDFFormRenderSpec
对象。ReaderExtensionSpec
对象。URLSpec
对象,它包含Forms服务所需的URI值。renderPDFFormWithUsageRights
方法返回一个FormsResult
对象,该对象包含一个必须写入客户端Web浏览器的表单数据流。
将表单数据流写入客户端Web浏览器
FormsResult
对象“s getOutputContent
方法创建com.adobe.idp.Document
对象。getContentType
方法获取com.adobe.idp.Document
对象的内容类型。setContentType
方法并传递com.adobe.idp.Document
对象的内容类型,设置javax.servlet.http.HttpServletResponse
对象的内容类型。javax.servlet.http.HttpServletResponse
对象的getOutputStream
方法,创建一个javax.servlet.ServletOutputStream
对象,用于将表单数据流写入客户端Web浏览器。com.adobe.idp.Document
对象的getInputStream
方法创建java.io.InputStream
对象。InputStream
对象的read
方法并将字节数组作为参数进行传递,创建一个用表单数据流填充它的字节数组。javax.servlet.ServletOutputStream
对象的write
方法,将表单数据流发送到客户端Web浏览器。 将字节数组传递给write
方法。另请参阅
快速开始(SOAP模式):使用Java API渲染支持权限的表单
使用FormsAPI(Web服务)渲染启用权限的表单:
包括项目文件
创建Forms客户端API对象
创建FormsService
对象并设置身份验证值。
设置使用权限运行时选项
ReaderExtensionSpec
对象的构造函数创建<a0/>对象。ReaderExtensionSpec
对象的setReCredentialAlias
方法指定凭据的别名,并指定表示别名值的字符串值。ReaderExtensionSpec
对象的相应方法来设置每个使用权限。 但是,只有在引用的凭据允许您设置使用权限时,才可设置此权限。 也就是说,如果凭据不允许您设置,则无法设置使用权限。 要设置允许用户填写表单字段并保存表单的使用权限,请调用ReaderExtensionSpec
对象的setReFillIn
方法并传递true
。渲染启用权限的表单
调用FormsService
对象的renderPDFFormWithUsageRights
方法并传递以下值:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
。BLOB
对象,其中包含要与表单合并的数据。 如果不想将数据与表单合并,则必须传递一个基于空XML数据源的BLOB
对象。 不能传递BLOB
对象为null;否则,将引发异常。PDFFormRenderSpec
对象。ReaderExtensionSpec
对象。URLSpec
对象,它包含Forms服务所需的URI值。renderPDFFormWithUsageRights
方法返回一个FormsResult
对象,该对象包含一个必须写入客户端Web浏览器的表单数据流。
将表单数据流写入客户端Web浏览器
FormsResult
对象的getOutputContent
方法,创建包含表单数据的BLOB
对象。getContentType
方法获取BLOB
对象的内容类型。setContentType
方法并传递BLOB
对象的内容类型,设置javax.servlet.http.HttpServletResponse
对象的内容类型。javax.servlet.http.HttpServletResponse
对象的getOutputStream
方法,创建一个javax.servlet.ServletOutputStream
对象,用于将表单数据流写入客户端Web浏览器。BLOB
对象的getBinaryData
方法填充它。 此任务将FormsResult
对象的内容分配给字节数组。javax.servlet.http.HttpServletResponse
对象的write
方法,将表单数据流发送到客户端Web浏览器。 将字节数组传递给write
方法。另请参阅