Renderização do Forms com direitos ativados rendering-rights-enabled-forms
O serviço Forms pode renderizar formulários com direitos de uso aplicados. 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. Os Forms que têm direitos de uso aplicados a eles são chamados de formulários habilitados por direitos. Um usuário que abre um formulário habilitado para direitos no Adobe Reader pode executar operações habilitadas para esse formulário.
Para aplicar direitos de uso a um formulário, o serviço de extensões do Acrobat Reader DC deve fazer parte da instalação do AEM Forms. Além disso, você deve ter uma credencial válida que permita aplicar direitos de uso a documentos do PDF. Ou seja, você deve configurar corretamente o serviço de extensões do Acrobat Reader DC antes de renderizar um formulário habilitado para direitos. (Consulte Sobre o serviço de extensões da Acrobat Reader DC.)
enableComments
, enableCommentsOnline
, enableEmbeddedFiles
ou enableDigitalSignatures
. (Consulte Pré-preenchimento do Forms com layouts fluíveis.)Resumo das etapas summary-of-steps
Para renderizar um formulário habilitado para direitos, execute as seguintes tarefas:
- Incluir arquivos de projeto.
- Crie um objeto da API do cliente do Forms.
- Definir opções de tempo de execução de direitos de uso.
- Renderize um formulário habilitado para direitos.
- Grave o formulário com direitos ativados no navegador web do cliente.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 da API do cliente do Forms
Antes de executar programaticamente uma operação da API do cliente de serviço do Forms, você deve criar um cliente de serviço do Forms.
Definir opções de tempo de execução de direitos de uso
Defina as opções de tempo de execução de direitos de uso para renderizar um formulário habilitado para direitos. Especifique 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 habilitado para direitos, 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.
Gravar o fluxo de dados do formulário no navegador Web 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 visualiza o formulário habilitado para direitos no Adobe Reader pode executar operações habilitadas para esse formulário.
Consulte também
Renderizar formulários com direitos habilitados usando a API Java
Renderizar formulários com direitos habilitados usando a API de serviço Web
Inclusão de arquivos da biblioteca Java do AEM Forms
Definindo propriedades de conexão
Início rápido da API de serviço do Forms
Renderização de PDF forms interativos
Criação de aplicações Web que renderizam o Forms
Renderizar formulários com direitos habilitados usando a API Java render-rights-enabled-forms-using-the-java-api
Renderize um formulário habilitado para direitos usando a API do Forms (Java):
-
Incluir arquivos de projeto
Inclua arquivos JAR do cliente, como adobe-forms-client.jar, no caminho de classe do projeto Java.
-
Criar um objeto da API do cliente do Forms
- Criar um
ServiceClientFactory
objeto que contém propriedades de conexão. - Criar um
FormsServiceClient
usando seu construtor e transmitindo oServiceClientFactory
objeto.
- Criar um
-
Definir opções de tempo de execução de direitos de uso
- Criar um
ReaderExtensionSpec
usando seu construtor. - Especifique o alias da credencial invocando o
ReaderExtensionSpec
do objetosetReCredentialAlias
e especifique um valor de string que represente o valor do alias. - Defina cada direito de uso invocando o método correspondente pertencente ao
ReaderExtensionSpec
objeto. No entanto, você só poderá definir um direito de uso se a credencial à qual você faz referência permitir. Ou seja, você não pode definir um direito de uso se a credencial não permitir sua definição. Por exemplo. para definir o direito de uso que permite ao usuário preencher campos de formulário e salvar o formulário, chame oReaderExtensionSpec
do objetosetReFillIn
e passartrue
.
note note NOTE Não é necessário invocar o princípio ReaderExtensionSpec
do objetosetReCredentialPassword
método. Esse método não é usado pelo serviço Forms. - Criar um
-
Renderizar um formulário habilitado para direitos
Chame o
FormsServiceClient
do objetorenderPDFFormWithUsageRights
e passe os seguintes valores:- Um valor de cadeia de caracteres que especifica o nome de design do formulário, incluindo a extensão de nome de arquivo. Se você fizer referência a um design de formulário que faz parte de um aplicativo do Forms, certifique-se de especificar o caminho completo, como
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. - A
com.adobe.idp.Document
objeto que contém dados a serem mesclados com o formulário. Se não quiser mesclar dados, passe uma tag vaziacom.adobe.idp.Document
objeto. - A
PDFFormRenderSpec
objeto que armazena opções de tempo de execução. - A
ReaderExtensionSpec
objeto que armazena opções de tempo de execução de direitos de uso. - A
URLSpec
objeto que contém valores de URI exigidos pelo serviço do Forms.
A variável
renderPDFFormWithUsageRights
o método retorna umFormsResult
objeto que contém um fluxo de dados de formulário que deve ser gravado no navegador da web do cliente. - Um valor de cadeia de caracteres que especifica o nome de design do formulário, incluindo a extensão de nome de arquivo. Se você fizer referência a um design de formulário que faz parte de um aplicativo do Forms, certifique-se de especificar o caminho completo, como
-
Gravar o fluxo de dados do formulário no navegador Web cliente
- Criar um
com.adobe.idp.Document
ao invocar oFormsResult
do objetogetOutputContent
método. - Obter o tipo de conteúdo do
com.adobe.idp.Document
ao invocar seugetContentType
método. - Defina o
javax.servlet.http.HttpServletResponse
tipo de conteúdo do objeto chamando seusetContentType
e transmitindo o tipo de conteúdo docom.adobe.idp.Document
objeto. - Criar um
javax.servlet.ServletOutputStream
objeto usado para gravar o fluxo de dados de formulário no navegador da web cliente, chamando ojavax.servlet.http.HttpServletResponse
do objetogetOutputStream
método. - Criar um
java.io.InputStream
ao invocar ocom.adobe.idp.Document
do objetogetInputStream
método. - Crie uma matriz de bytes para preenchê-la com o fluxo de dados de formulário, chamando o
InputStream
do objetoread
e transmitindo a matriz de bytes como um argumento. - Chame o
javax.servlet.ServletOutputStream
do objetowrite
para enviar o fluxo de dados de formulário para o navegador web cliente. Passe a matriz de bytes para owrite
método.
- Criar um
Consulte também
Início rápido (modo SOAP): renderização de um formulário habilitado para direitos usando a API Java
Inclusão de arquivos da biblioteca Java do AEM Forms
Definindo propriedades de conexão
Renderizar formulários com direitos habilitados usando a API de serviço Web render-rights-enabled-forms-using-the-web-service-api
Renderize um formulário habilitado para direitos usando a API do Forms (serviço Web):
-
Incluir arquivos de projeto
- Crie classes de proxy Java que consomem o serviço WSDL do Forms.
- Inclua as classes de proxy Java no caminho da classe.
-
Criar um objeto da API do cliente do Forms
Criar um
FormsService
objeto e definir valores de autenticação. -
Definir opções de tempo de execução de direitos de uso
- Criar um
ReaderExtensionSpec
usando seu construtor. - Especifique o alias da credencial invocando o
ReaderExtensionSpec
do objetosetReCredentialAlias
e especifique um valor de string que represente o valor do alias. - Defina cada direito de uso invocando o método correspondente pertencente ao
ReaderExtensionSpec
objeto. No entanto, você só poderá definir um direito de uso se a credencial à qual você faz referência permitir. Ou seja, você não pode definir um direito de uso se a credencial não permitir sua definição. Para definir o direito de uso que permite ao usuário preencher campos de formulário e salvar o formulário, chame oReaderExtensionSpec
do objetosetReFillIn
e passartrue
.
- Criar um
-
Renderizar um formulário habilitado para direitos
Chame o
FormsService
do objetorenderPDFFormWithUsageRights
e passe os seguintes valores:- Um valor de cadeia de caracteres que especifica o nome de design do formulário, incluindo a extensão de nome de arquivo. Se você fizer referência a um design de formulário que faz parte de um aplicativo do Forms, certifique-se de especificar o caminho completo, como
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. - A
BLOB
objeto que contém dados a serem mesclados com o formulário. Se não quiser mesclar dados com o formulário, você deve passar umBLOB
objeto baseado em uma fonte de dados XML vazia. Você não pode passar umBLOB
objeto nulo; caso contrário, uma exceção será lançada. - A
PDFFormRenderSpec
objeto que armazena opções de tempo de execução. - A
ReaderExtensionSpec
objeto que armazena opções de tempo de execução de direitos de uso. - A
URLSpec
objeto que contém valores de URI exigidos pelo serviço do Forms.
A variável
renderPDFFormWithUsageRights
o método retorna umFormsResult
objeto que contém um fluxo de dados de formulário que deve ser gravado no navegador da web do cliente. - Um valor de cadeia de caracteres que especifica o nome de design do formulário, incluindo a extensão de nome de arquivo. Se você fizer referência a um design de formulário que faz parte de um aplicativo do Forms, certifique-se de especificar o caminho completo, como
-
Gravar o fluxo de dados do formulário no navegador Web cliente
- Criar um
BLOB
objeto que contém dados de formulário chamando oFormsResult
do objetogetOutputContent
método. - Obter o tipo de conteúdo do
BLOB
ao invocar seugetContentType
método. - Defina o
javax.servlet.http.HttpServletResponse
tipo de conteúdo do objeto chamando seusetContentType
e transmitindo o tipo de conteúdo doBLOB
objeto. - Criar um
javax.servlet.ServletOutputStream
objeto usado para gravar o fluxo de dados de formulário no navegador da web cliente, chamando ojavax.servlet.http.HttpServletResponse
do objetogetOutputStream
método. - Crie uma matriz de bytes e preencha-a chamando o
BLOB
do objetogetBinaryData
método. Esta tarefa atribui o conteúdo doFormsResult
à matriz de bytes. - Chame o
javax.servlet.http.HttpServletResponse
do objetowrite
para enviar o fluxo de dados de formulário para o navegador web cliente. Passe a matriz de bytes para owrite
método.
- Criar um
Consulte também
Renderização do Forms com direitos ativados
Chamada de AEM Forms usando codificação Base64