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服务客户端,然后才能以编程方式执行Forms服务客户端API操作。
设置使用权限运行时选项
必须设置使用权限运行时选项才能渲染启用了权限的表单。 您还必须指定用于将使用权限应用到表单的凭据的别名。 指定别名值后,您可以指定每个用于表单的使用权限。
渲染启用权限的表单
要渲染启用了权限的表单,请使用与渲染没有使用权限的表单相同的应用程序逻辑。 唯一的区别在于,您必须确保应用程序逻辑中包含使用权限运行时选项。
使用Forms Web服务API渲染启用权限的表单时,无法将文件附加到表单。
将表单数据流写入客户端Web浏览器
当Forms服务呈现启用了权限的表单时,它会返回一个必须写入客户端Web浏览器的表单数据流。 一旦写入客户端Web浏览器,用户便可看到该表单。 在Adobe Reader中查看启用了权限的表单的用户能够执行为该表单启用的操作。
另请参阅
使用Forms API(Java)呈现启用权限的表单:
包含项目文件
在Java项目的类路径中包含客户端JAR文件,如adobe-forms-client.jar。
创建Forms客户端API对象
ServiceClientFactory
对象。FormsServiceClient
对象,并传递ServiceClientFactory
对象。设置使用权限运行时选项
ReaderExtensionSpec
对象的构造函数创建对象。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渲染启用权限的表单
使用Forms API(Web服务)呈现启用权限的表单:
包含项目文件
创建Forms客户端API对象
创建FormsService
对象并设置身份验证值。
设置使用权限运行时选项
ReaderExtensionSpec
对象的构造函数创建对象。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
方法。另请参阅