O serviço Forms pode renderizar formulários com direitos de uso aplicados a eles. Os direitos de uso pertencem à funcionalidade que está disponível por padrão no Acrobat, mas não no Adobe Reader, como a capacidade de adicionar comentários a um formulário ou preencher campos de formulário e salvar o formulário. O Forms que tem direitos de uso aplicados a eles são chamados de formulários habilitados para direitos. Um usuário que abre um formulário com direitos ativados no Adobe Reader pode executar operações ativadas para esse formulário.
Para aplicar direitos de uso a um formulário, o serviço de extensões da Acrobat Reader DC deve fazer parte da instalação de formulários AEM. Além disso, você deve ter uma credencial válida que permita aplicar direitos de uso a documentos PDF. Ou seja, você deve configurar corretamente o serviço de extensões do Acrobat Reader DC antes de poder renderizar um formulário com direitos ativados. (Consulte Sobre o Serviço de extensões do Acrobat Reader DC.)
Para renderizar um formulário que contenha direitos de uso, é necessário usar um arquivo XDP como entrada, não como um arquivo PDF. Se um arquivo PDF for usado como entrada, o formulário ainda será renderizado; no entanto, não será um formulário com direitos ativados.
Não é possível pré-preencher um formulário com dados XML ao especificar os seguintes direitos de uso: enableComments
, enableCommentsOnline
, enableEmbeddedFiles
ou enableDigitalSignatures
. (Consulte Pré-preencher o Forms com layouts flutuantes.)
Para obter mais informações sobre o serviço Forms, consulte Referência de serviços para AEM Forms.
Para renderizar um formulário com direitos ativados, execute as seguintes tarefas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Forms Client
Antes de executar programaticamente uma operação de API do cliente de serviço da Forms, você deve criar um cliente de serviço da Forms.
Definir opções de tempo de execução de direitos de uso
É necessário definir opções de tempo de execução de direitos de uso para renderizar um formulário habilitado para direitos. Você também deve especificar o alias da credencial usada para aplicar direitos de uso a um formulário. Depois de especificar o valor do alias, especifique cada direito de uso a ser aplicado ao formulário.
Renderizar um formulário habilitado para direitos
Para renderizar um formulário com direitos ativados, use a mesma lógica de aplicativo que renderizar um formulário sem direitos de uso. A única diferença é que você deve garantir que as opções de tempo de execução de direitos de uso sejam incluídas na lógica do aplicativo.
Ao renderizar um formulário habilitado para direitos usando a API de serviço da Web da Forms, não é possível anexar arquivos ao formulário.
Gravar o fluxo de dados do formulário no navegador da Web do cliente
Quando o serviço Forms renderiza um formulário com direitos ativados, ele retorna um fluxo de dados de formulário que você deve gravar no navegador da Web do cliente. Depois de gravado no navegador da Web do cliente, o formulário fica visível para o usuário. Um usuário que exibe o formulário com direitos ativados no Adobe Reader pode executar operações ativadas para esse formulário.
Consulte também:
Renderizar formulários ativados por direitos usando a API Java
Renderizar formulários habilitados por direitos usando a API de serviço da Web
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Start rápidos da API de serviço da Forms
Renderização de PDF forms interativos
Criação de Aplicações web que renderizam o Forms
Renderize um formulário habilitado para direitos usando a API da Forms (Java):
Incluir arquivos de projeto
Inclua arquivos JAR do cliente, como adobe-forms-client.jar, no caminho de classe do seu projeto Java.
Criar um objeto de API do Forms Client
ServiceClientFactory
que contenha propriedades de conexão.FormsServiceClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Definir opções de tempo de execução de direitos de uso
ReaderExtensionSpec
usando seu construtor.ReaderExtensionSpec
do objeto setReCredentialAlias
e especifique um valor de string que representa o valor do alias.ReaderExtensionSpec
. No entanto, você só pode definir um direito de uso se a credencial que você menciona permitir que você o faça. Ou seja, você não pode definir um direito de uso se a credencial não permitir que você o defina. Por exemplo. para definir o direito de uso que permite ao usuário preencher campos de formulário e salvar o formulário, chame o método ReaderExtensionSpec
do objeto setReFillIn
e passe true
.Não é necessário invocar o método ReaderExtensionSpec
do objeto setReCredentialPassword
. Este método não é usado pelo serviço Forms.
Renderizar um formulário habilitado para direitos
Chame o método FormsServiceClient
do objeto renderPDFFormWithUsageRights
e passe os seguintes valores:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.com.adobe.idp.Document
que contém dados a serem unidos ao formulário. Se você não quiser unir dados, passe um objeto com.adobe.idp.Document
vazio.PDFFormRenderSpec
que armazena opções de tempo de execução.ReaderExtensionSpec
que armazena opções de tempo de execução de direitos de uso.URLSpec
que contém valores de URI exigidos pelo serviço Forms.O método renderPDFFormWithUsageRights
retorna um objeto FormsResult
que contém um fluxo de dados de formulário que deve ser gravado no navegador da Web do cliente.
Gravar o fluxo de dados do formulário no navegador da Web do cliente
com.adobe.idp.Document
chamando o método FormsResult
object 's getOutputContent
.com.adobe.idp.Document
chamando seu método getContentType
.javax.servlet.http.HttpServletResponse
chamando seu método setContentType
e transmitindo o tipo de conteúdo do objeto com.adobe.idp.Document
.javax.servlet.ServletOutputStream
usado para gravar o fluxo de dados do formulário no navegador da Web do cliente, chamando o método javax.servlet.http.HttpServletResponse
do objeto getOutputStream
.java.io.InputStream
invocando o método com.adobe.idp.Document
do objeto getInputStream
.InputStream
do objeto read
e transmitindo a matriz de bytes como um argumento.javax.servlet.ServletOutputStream
do objeto write
para enviar o fluxo de dados do formulário para o navegador da Web do cliente. Passe a matriz de bytes para o método write
.Consulte também:
Start rápido (modo SOAP): Como renderizar um formulário habilitado para direitos usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Renderize um formulário habilitado para direitos usando a API da Forms (serviço da Web):
Incluir arquivos de projeto
Criar um objeto de API do Forms Client
Crie um objeto FormsService
e defina os valores de autenticação.
Definir opções de tempo de execução de direitos de uso
ReaderExtensionSpec
usando seu construtor.ReaderExtensionSpec
do objeto setReCredentialAlias
e especifique um valor de string que representa o valor do alias.ReaderExtensionSpec
. No entanto, você só pode definir um direito de uso se a credencial que você menciona permitir que você o faça. Ou seja, você não pode definir um direito de uso se a credencial não permitir que você o defina. Para definir o direito de uso que permite ao usuário preencher campos de formulário e salvar o formulário, chame o método ReaderExtensionSpec
do objeto setReFillIn
e passe true
.Renderizar um formulário habilitado para direitos
Chame o método FormsService
do objeto renderPDFFormWithUsageRights
e passe os seguintes valores:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.BLOB
que contém dados a serem unidos ao formulário. Se você não quiser unir dados ao formulário, é necessário enviar um objeto BLOB
que seja baseado em uma fonte de dados XML vazia. Não é possível transmitir um objeto BLOB
nulo; caso contrário, uma exceção será lançada.PDFFormRenderSpec
que armazena opções de tempo de execução.ReaderExtensionSpec
que armazena opções de tempo de execução de direitos de uso.URLSpec
que contém valores de URI exigidos pelo serviço Forms.O método renderPDFFormWithUsageRights
retorna um objeto FormsResult
que contém um fluxo de dados de formulário que deve ser gravado no navegador da Web do cliente.
Gravar o fluxo de dados do formulário no navegador da Web do cliente
BLOB
que contenha dados de formulário chamando o método FormsResult
do objeto getOutputContent
.BLOB
chamando seu método getContentType
.javax.servlet.http.HttpServletResponse
chamando seu método setContentType
e transmitindo o tipo de conteúdo do objeto BLOB
.javax.servlet.ServletOutputStream
usado para gravar o fluxo de dados do formulário no navegador da Web do cliente, chamando o método javax.servlet.http.HttpServletResponse
do objeto getOutputStream
.BLOB
do objeto getBinaryData
. Essa tarefa atribui o conteúdo do objeto FormsResult
à matriz de bytes.javax.servlet.http.HttpServletResponse
do objeto write
para enviar o fluxo de dados do formulário para o navegador da Web do cliente. Passe a matriz de bytes para o método write
.Consulte também: