Forms com direitos de renderização ativados rendering-rights-enabled-forms
O serviço Forms pode renderizar formulários com direitos de uso aplicados a eles. Os direitos de uso pertencem a uma 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 de preencher campos de formulário e salvar o formulário. Forms que têm direitos de uso aplicados a eles são chamados de formulários ativados por 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 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 adequadamente o serviço de extensões do Acrobat Reader DC antes de renderizar um formulário com direitos ativados. (Consulte Sobre o serviço de extensões do Acrobat Reader DC.)
enableComments
, enableCommentsOnline
, enableEmbeddedFiles
ou enableDigitalSignatures
. (Consulte Pré-preenchimento do Forms com layouts flutuantes.)Resumo das etapas summary-of-steps
Para renderizar um formulário com direitos ativados, execute as seguintes tarefas:
- Inclua 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 com direitos ativados.
- Escreva o formulário com direitos ativados no navegador da Web do cliente.
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 cliente do Forms
Antes de executar programaticamente uma operação de API do cliente de serviço do Forms, é necessário criar um cliente de serviço do Forms.
Definir opções de tempo de execução de direitos de uso
Você deve definir opções de tempo de execução de direitos de uso para renderizar um formulário com direitos ativados. Você também deve especificar o alias da credencial usada para aplicar direitos de uso a um formulário. Após 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 como renderização de um formulário sem direitos de uso. A única diferença é que você deve garantir que as opções de tempo de execução dos direitos de uso sejam incluídas na lógica do aplicativo.
Gravar o fluxo de dados do formulário no navegador da Web cliente
Quando o serviço Forms renderiza um formulário habilitado para direitos, ele retorna um fluxo de dados de formulário que deve ser gravado no navegador da Web 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 ativados por direitos usando a API do serviço da Web
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Início rápido da API do Forms Service
Renderização de PDF forms interativos
Criação de aplicativos Web que renderizam o Forms
Renderizar formulários ativados por direitos 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 seu projeto Java.
-
Criar um objeto de API do cliente do Forms
- Crie um
ServiceClientFactory
objeto que contém propriedades de conexão. - Crie um
FormsServiceClient
usando seu construtor e passando oServiceClientFactory
objeto.
- Crie um
-
Definir opções de tempo de execução de direitos de uso
- Crie um
ReaderExtensionSpec
usando seu construtor. - Especifique o alias da credencial chamando o
ReaderExtensionSpec
do objetosetReCredentialAlias
e especifique um valor de string que represente o valor do alias. - Defina cada direito de uso chamando o método correspondente que pertence ao
ReaderExtensionSpec
objeto. No entanto, você só poderá definir um direito de uso se a credencial referenciada permitir que você faça isso. Ou seja, você não poderá 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 a funçãoReaderExtensionSpec
do objetosetReFillIn
método e passtrue
.
note note NOTE Não é necessário invocar o ReaderExtensionSpec
do objetosetReCredentialPassword
* . Esse método não é usado pelo serviço Forms. * - Crie um
-
Renderizar um formulário habilitado para direitos
Chame o
FormsServiceClient
do objetorenderPDFFormWithUsageRights
e transmita os seguintes valores:- Um valor de string que especifica o nome do design de 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 Forms, especifique o caminho completo, como
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. - A
com.adobe.idp.Document
objeto que contém dados para mesclar com o formulário. Se não quiser mesclar dados, passe um vaziocom.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 Forms.
O
renderPDFFormWithUsageRights
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 string que especifica o nome do design de 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 Forms, especifique o caminho completo, como
-
Gravar o fluxo de dados do formulário no navegador da Web cliente
- Crie um
com.adobe.idp.Document
chamando oFormsResult
objeto "sgetOutputContent
método . - Obtenha o tipo de conteúdo da variável
com.adobe.idp.Document
ao invocar seugetContentType
método . - Defina as
javax.servlet.http.HttpServletResponse
tipo de conteúdo do objeto, chamando seusetContentType
e a transmissão do tipo de conteúdo docom.adobe.idp.Document
objeto. - Crie um
javax.servlet.ServletOutputStream
objeto usado para gravar o fluxo de dados do formulário no navegador da Web cliente, chamando ojavax.servlet.http.HttpServletResponse
do objetogetOutputStream
método . - Crie um
java.io.InputStream
chamando ocom.adobe.idp.Document
do objetogetInputStream
método . - Crie uma matriz de bytes para preenchê-la com o fluxo de dados do 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 do formulário para o navegador da Web cliente. Transmita a matriz de bytes para awrite
método .
- Crie 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
Configuração das propriedades de conexão
Renderizar formulários ativados por direitos usando a API do serviço da Web render-rights-enabled-forms-using-the-web-service-api
Renderize um formulário habilitado para direitos usando a API do Forms (serviço da Web):
-
Incluir arquivos de projeto
- Crie classes proxy Java que consomem o WSDL do serviço Forms.
- Inclua as classes proxy Java no caminho da classe.
-
Criar um objeto de API do cliente do Forms
Crie um
FormsService
e definir valores de autenticação. -
Definir opções de tempo de execução de direitos de uso
- Crie um
ReaderExtensionSpec
usando seu construtor. - Especifique o alias da credencial chamando o
ReaderExtensionSpec
do objetosetReCredentialAlias
e especifique um valor de string que represente o valor do alias. - Defina cada direito de uso chamando o método correspondente que pertence ao
ReaderExtensionSpec
objeto. No entanto, você só poderá definir um direito de uso se a credencial referenciada permitir que você faça isso. Ou seja, você não poderá 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 a funçãoReaderExtensionSpec
do objetosetReFillIn
método e passtrue
.
- Crie um
-
Renderizar um formulário habilitado para direitos
Chame o
FormsService
do objetorenderPDFFormWithUsageRights
e transmita os seguintes valores:- Um valor de string que especifica o nome do design de 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 Forms, especifique o caminho completo, como
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. - A
BLOB
objeto que contém dados para mesclar com o formulário. Se você não quiser mesclar dados com o formulário, é necessário enviar umaBLOB
objeto baseado em uma fonte de dados XML vazia. Não é possível passar umaBLOB
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 Forms.
O
renderPDFFormWithUsageRights
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 string que especifica o nome do design de 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 Forms, especifique o caminho completo, como
-
Gravar o fluxo de dados do formulário no navegador da Web cliente
- Crie um
BLOB
objeto que contém dados de formulário chamando oFormsResult
do objetogetOutputContent
método . - Obtenha o tipo de conteúdo da variável
BLOB
ao invocar seugetContentType
método . - Defina as
javax.servlet.http.HttpServletResponse
tipo de conteúdo do objeto, chamando seusetContentType
e a transmissão do tipo de conteúdo doBLOB
objeto. - Crie um
javax.servlet.ServletOutputStream
objeto usado para gravar o fluxo de dados do 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 a variável
BLOB
do objetogetBinaryData
método . Essa tarefa atribui o conteúdo daFormsResult
para a matriz de bytes. - Chame o
javax.servlet.http.HttpServletResponse
do objetowrite
para enviar o fluxo de dados do formulário para o navegador da Web cliente. Transmita a matriz de bytes para awrite
método .
- Crie um
Consulte também
Forms com direitos de renderização ativados
Chamada de AEM Forms usando codificação Base64