Atribuir direitos de uso

Sobre o Serviço de extensões da Acrobat Reader DC

O serviço de extensões Acrobat Reader DC permite que sua organização compartilhe facilmente documentos PDF interativos, estendendo a funcionalidade do Adobe Reader. O serviço de extensões Acrobat Reader DC é totalmente compatível com qualquer documento PDF, até PDF 1.7 inclusive. Ele funciona com o Adobe Reader 7.0 e posterior. O serviço adiciona direitos de uso a um documento PDF, ativando recursos que normalmente não estão disponíveis quando um documento PDF é aberto usando o Adobe Reader. Usuários de terceiros não exigem software ou plug-ins adicionais para trabalhar com os documentos ativados por direitos.

Você pode realizar essas tarefas usando o serviço de extensões do Acrobat Reader DC:

OBSERVAÇÃO

Para obter mais informações sobre o serviço de extensões do Acrobat Reader DC, consulte Referência de serviços para AEM Forms.

Aplicação de direitos de uso a documentos PDF

Você pode aplicar direitos de uso a documentos PDF usando a API do cliente Java do Acrobat Reader DC Extensions e o serviço da Web. 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. Os documentos PDF que têm direitos de uso aplicados a eles são chamados de documentos ativados por direitos. Um usuário que abra um documento com direitos ativados no Adobe Reader pode executar operações ativadas para esse documento específico.

OBSERVAÇÃO

Ao aplicar direitos de uso a documentos PDF usando o método applyUsageRights, que faz parte da API Java, você pode definir o parâmetro isModeFinal do objeto ReaderExtensionsOptionSpec como false. Isso resulta na atualização do contador de formulários processados e em uma melhoria no desempenho. Se não estiver preocupado com a atualização do contador de formulários processados, é recomendável definir o parâmetro isModeFinal como false.

OBSERVAÇÃO

Para obter mais informações sobre o serviço de extensões do Acrobat Reader DC, consulte Referência de serviços para AEM Forms.

Resumo das etapas

Para aplicar direitos de uso a um documento PDF, execute as seguintes etapas:

  1. Inclua arquivos de projeto.
  2. Crie um objeto Cliente de extensões do Acrobat Reader DC.
  3. Recupere um documento PDF.
  4. Especifique os direitos de uso a serem aplicados.
  5. Aplicar direitos de uso ao documento PDF.
  6. Salve o documento PDF habilitado para direitos.

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 Cliente de extensões do Acrobat Reader DC

Para executar programaticamente uma operação do Acrobat Reader DC Extensions Service, você deve criar um objeto cliente do serviço Acrobat Reader DC Extensions . Se estiver usando a API Java das extensões do Acrobat Reader DC, crie um objeto ReaderExtensionsServiceClient . Se estiver usando a API do serviço da Web das extensões do Acrobat Reader DC, crie um objeto ReaderExtensionsServiceService .

Recuperar um documento PDF

Você deve recuperar um documento PDF para aplicar direitos de uso. Documentos PDF habilitados para direitos contêm um dicionário de direitos de uso. Quando o Adobe Reader abre um documento contendo esse dicionário, ele ativa os direitos de uso especificados no dicionário apenas para esse documento. Se o documento não contiver um dicionário de direitos de uso, o serviço de extensões do Acrobat Reader DC criará um. Se já contiver um dicionário, o serviço de extensões do Acrobat Reader DC substituirá os direitos de uso existentes pelos que você especificar. O dicionário especifica quais direitos de uso estão ativados. Quando um usuário abre o documento no Adobe Reader, somente os direitos de uso especificados no dicionário são permitidos.

Especificar direitos de uso a serem aplicados

Os direitos de uso que você pode definir são determinados por uma credencial que você compra no Adobe Systems Incorporated. As credenciais normalmente fornecem permissão para definir um grupo de direitos de uso relacionados, como aqueles pertencentes a formulários interativos. Cada credencial fornece o direito de criar um determinado número de documentos PDF habilitados para direitos. Uma credencial de avaliação dá o direito de criar um número ilimitado de documentos preliminares.

OBSERVAÇÃO

Se você tentar atribuir um direito de uso que não é permitido por sua credencial, ocorrerá uma exceção.

Aplicar direitos de uso ao documento PDF

Para aplicar direitos de uso a um documento PDF, você faz referência ao alias da credencial que está usando para aplicar direitos de uso (uma credencial geralmente é instalada durante a instalação do AEM Forms). Você também deve especificar o documento PDF ao qual os direitos de uso são aplicados. Para obter informações sobre como configurar uma credencial, consulte o guia de instalação e implantação do servidor de aplicativos.

Salvar o documento PDF com direitos habilitados

Depois que o serviço de extensões do Acrobat Reader DC aplica direitos de uso a um documento PDF, é possível salvar o documento PDF habilitado para direitos como um arquivo PDF.

Consulte também:

Aplicar direitos de uso usando a API do Java

Aplicar direitos de uso 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 Acrobat Reader DC Extensions Service

Aplicar direitos de uso usando a API Java

Aplique direitos de uso a um documento PDF usando a API de extensões do Acrobat Reader DC (Java):

  1. Incluir arquivos de projeto

    Inclua arquivos JAR do cliente, como adobe-reader-extensions-client.jar, no caminho de classe do seu projeto Java.

  2. Crie um objeto Cliente de extensões do Acrobat Reader DC.

    • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
    • Crie um objeto ReaderExtensionsServiceClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

  3. Recupere um documento PDF.

    • Crie um objeto java.io.FileInputStream que represente o documento PDF usando seu construtor e passando um valor de string que especifica o local do documento PDF.
    • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.

  4. Especifique os direitos de uso a serem aplicados.

    • Crie um objeto UsageRights que represente direitos de uso usando seu construtor.
    • Para cada direito de uso a ser aplicado, chame um método correspondente que pertença ao objeto UsageRights . Por exemplo, para adicionar o direito de uso enableFormFillIn, chame o método UsageRights do objeto enableFormFillIn e passe true. (Repita essa etapa para cada direito de uso a ser aplicado).

  5. Aplicar direitos de uso ao documento PDF.

    • Crie um objeto ReaderExtensionsOptionSpec usando seu construtor. Esse objeto contém opções de tempo de execução exigidas pelo serviço de extensões do Acrobat Reader DC. Ao invocar esse construtor, você deve especificar os seguintes valores:

      • O objeto UsageRights que contém os direitos de uso a serem aplicados ao documento.
      • Um valor da string que especifica a mensagem que um usuário vê quando o documento PDF habilitado para direitos é aberto no Adobe Reader 7.x. Esta mensagem não é exibida no Adobe Reader 8.0.

    • Aplique direitos de uso ao documento PDF, chamando o método ReaderExtensionsServiceClient do objeto e transmitindo os seguintes valores:applyUsageRights

      • O objeto com.adobe.idp.Document que contém o documento PDF ao qual os direitos de uso são aplicados.
      • Um valor da string que especifica o alias da credencial que permite aplicar direitos de uso.
      • Um valor da string que especifica o valor da senha correspondente. (No momento, esse parâmetro é ignorado. Você pode passar null.)

    • O objeto ReaderExtensionsOptionSpec que contém opções de tempo de execução.

    O método applyUsageRights retorna um objeto com.adobe.idp.Document que contém o documento PDF habilitado para direitos.

  6. Salve o documento PDF habilitado para direitos.

    • Crie um objeto java.io.File e verifique se a extensão de arquivo é .pdf.
    • Chame o método com.adobe.idp.Document do objeto copyToFile para copiar o conteúdo do objeto com.adobe.idp.Document para o arquivo (certifique-se de usar o objeto com.adobe.idp.Document retornado pelo método applyUsageRights).

Consulte também:

Aplicação de direitos de uso a documentos PDF

Início rápido (modo SOAP):Aplicação de direitos de uso usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Aplicar direitos de uso usando a API do serviço da Web

Aplique direitos de uso a um documento PDF usando a API de extensões do Acrobat Reader DC (serviço da Web):

  1. Inclua arquivos de projeto.

    Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1.

    OBSERVAÇÃO

    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

  2. Crie um objeto Cliente de extensões do Acrobat Reader DC.

    • Crie um objeto ReaderExtensionsServiceClient usando seu construtor padrão.

    • Crie um objeto ReaderExtensionsServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom. Certifique-se de especificar ?blob=mtom.)

    • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo ReaderExtensionsServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

    • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

    • Ative a autenticação HTTP básica executando as seguintes tarefas:

      • Atribua o nome de usuário dos formulários AEM ao campo ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName.
      • Atribua o valor correspondente da senha ao campo ReaderExtensionsServiceClient.ClientCredentials.UserName.Password.
      • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

  3. Recupere um documento PDF.

    • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar um documento PDF ao qual os direitos de uso são aplicados.
    • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo será aberto.
    • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
    • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler.
    • Preencha o objeto BLOB atribuindo sua propriedade MTOM ao conteúdo da matriz de bytes.

  4. Especifique os direitos de uso a serem aplicados.

    • Crie um objeto UsageRights que represente direitos de uso usando seu construtor.
    • Para cada direito de uso a ser aplicado, atribua o valor true ao membro de dados correspondente que pertence ao objeto UsageRights. Por exemplo, para adicionar o direito de uso enableFormFillIn, atribua true ao UsageRights membro de dados enableFormFillIn do objeto. (Repita essa etapa para cada direito de uso a ser aplicado).

  5. Aplicar direitos de uso ao documento PDF.

    • Crie um objeto ReaderExtensionsOptionSpec usando seu construtor. Esse objeto contém opções de tempo de execução exigidas pelo serviço de extensões do Acrobat Reader DC.

    • Atribua o objeto UsageRights ao membro de dados ReaderExtensionsOptionSpec do objeto usageRights.

    • Atribua um valor de string que especifica a mensagem que um usuário vê quando o documento PDF habilitado para direitos é aberto no Adobe Reader para o ReaderExtensionsOptionSpec membro de dados message do objeto.

    • Aplique direitos de uso ao documento PDF, chamando o método ReaderExtensionsServiceClient do objeto e transmitindo os seguintes valores:applyUsageRights

      • O objeto BLOB que contém o documento PDF ao qual os direitos de uso são aplicados.
      • Um valor da string que especifica o alias da credencial que permite aplicar direitos de uso.
      • Um valor da string que especifica o valor da senha correspondente. (No momento, esse parâmetro é ignorado. Você pode passar null.)

    • O objeto ReaderExtensionsOptionSpec que contém opções de tempo de execução.

    O método applyUsageRights retorna um objeto BLOB que contém o documento PDF habilitado para direitos.

  6. Salve o documento PDF habilitado para direitos.

    • Crie um objeto System.IO.FileStream chamando seu construtor. Passe um valor de string que representa o local do arquivo do documento PDF com direitos ativados.
    • Crie uma matriz de bytes que armazene o conteúdo de dados do objeto BLOB retornado pelo método applyUsageRights. Preencha a matriz de bytes obtendo o valor do membro de dados BLOB do objeto MTOM.
    • Crie um objeto System.IO.BinaryWriter chamando seu construtor e passando o objeto System.IO.FileStream.
    • Grave o conteúdo da matriz de bytes em um arquivo PDF chamando o método System.IO.BinaryWriter do objeto Write e transmitindo a matriz de bytes.

Consulte também:

Aplicação de direitos de uso a documentos PDF

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Removendo direitos de uso de documentos PDF

Você pode remover direitos de uso de um documento habilitado para direitos. A remoção de direitos de uso de um documento PDF habilitado para direitos também é necessária para executar outras operações do AEM Forms nele. Por exemplo, você deve assinar digitalmente (ou certificar) um documento PDF antes de definir direitos de uso. Portanto, se você deseja executar operações em um documento com direitos ativados, é necessário remover direitos de uso do documento PDF, executar as outras operações, como assinar digitalmente o documento e, em seguida, reaplicar direitos de uso ao documento.

OBSERVAÇÃO

Para obter mais informações sobre o serviço de extensões do Acrobat Reader DC, consulte Referência de serviços para AEM Forms.

Resumo das etapas

Para remover direitos de uso de um documento PDF habilitado para direitos, execute as seguintes etapas:

  1. Inclua arquivos de projeto.
  2. Crie um objeto Cliente de extensões do Acrobat Reader DC.
  3. Recupere um documento PDF habilitado para direitos.
  4. Remova direitos de uso do documento PDF.
  5. Salve o documento PDF.

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 Cliente de extensões do Acrobat Reader DC

Antes de executar programaticamente uma operação de serviço de extensões do Acrobat Reader DC, é necessário criar um objeto cliente do serviço de extensões do Acrobat Reader DC. Se estiver usando a API do Java, crie um objeto ReaderExtensionsServiceClient . Se estiver usando a API do serviço da Web das extensões do Acrobat Reader DC, crie um objeto ReaderExtensionsServiceService .

Recuperar um documento PDF habilitado para direitos

Recupere um documento PDF habilitado para direitos para remover direitos de uso.

Remover direitos de uso do documento PDF

Depois de recuperar um documento PDF com direitos ativados, você pode remover direitos de uso. Após remover os direitos de uso, o documento PDF não terá nenhuma funcionalidade adicional enquanto for visualizado no Adobe Reader.

Salvar o documento PDF

Você pode salvar o documento PDF que não contém mais direitos de uso como um arquivo PDF. Depois de salvo como um arquivo PDF, o documento PDF pode ser exibido no Adobe Reader ou no Acrobat.

Consulte também:

Remova os direitos de uso usando a API do Java

Remover direitos de uso usando a API de 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 Acrobat Reader DC Extensions Service

Aplicação de direitos de uso a documentos PDF

Remova os direitos de uso usando a API Java

Remova direitos de uso de um documento PDF habilitado para direitos usando a API de extensões do Acrobat Reader DC (Java):

  1. Inclua arquivos de projeto.

    Inclua arquivos JAR do cliente, como adobe-reader-extensions-client.jar, no caminho de classe do seu projeto Java.

  2. Crie um objeto Cliente de extensões do Acrobat Reader DC.

    Crie um objeto ReaderExtensionsServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.

  3. Recupere um documento PDF.

    • Crie um objeto java.io.FileInputStream que represente o documento PDF habilitado para direitos usando seu construtor e transmitindo um valor de string que especifique o local do documento PDF.
    • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.

  4. Remova direitos de uso do documento PDF.

    Remova os direitos de uso do documento PDF chamando o método ReaderExtensionsServiceClient do objeto e transmitindo o objeto com.adobe.idp.Document que contém o documento PDF habilitado para direitos. removeUsageRights Esse método retorna um objeto com.adobe.idp.Document que contém um documento PDF que não tem direitos de uso.

  5. Aplicar direitos de uso ao documento PDF.

    • Crie um objeto java.io.File e verifique se a extensão de arquivo é .PDF.
    • Chame o método Document do objeto copyToFile para copiar o conteúdo do objeto Document para o arquivo (certifique-se de usar o objeto Document retornado pelo método removeUsageRights).

Consulte também:

Removendo direitos de uso de documentos PDF

Início rápido (modo SOAP): Remoção de direitos de uso de um documento PDF usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Remova os direitos de uso usando a API do serviço da Web

Remova os direitos de uso de um documento PDF habilitado para direitos usando a API de extensões do Acrobat Reader DC (serviço da Web):

  1. Inclua arquivos de projeto.

    Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1.

    OBSERVAÇÃO

    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

  2. Crie um objeto Cliente de extensões do Acrobat Reader DC.

    • Crie um objeto ReaderExtensionsServiceClient usando seu construtor padrão.

    • Crie um objeto ReaderExtensionsServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom. Certifique-se de especificar ?blob=mtom.)

    • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo ReaderExtensionsServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

    • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

    • Ative a autenticação HTTP básica executando as seguintes tarefas:

      • Atribua o nome de usuário dos formulários AEM ao campo ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName.
      • Atribua o valor correspondente da senha ao campo ReaderExtensionsServiceClient.ClientCredentials.UserName.Password.
      • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

  3. Recupere um documento PDF.

    • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar o documento PDF habilitado para direitos, do qual os direitos de uso são removidos.
    • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo será aberto.
    • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
    • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
    • Preencha o objeto BLOB atribuindo sua propriedade MTOM ao conteúdo da matriz de bytes.

  4. Remova direitos de uso do documento PDF.

    Remova os direitos de uso do documento PDF chamando o método ReaderExtensionsServiceClient do objeto e transmitindo o objeto BLOB que contém o documento PDF habilitado para direitos. removeUsageRights Esse método retorna um objeto BLOB que contém um documento PDF que não tem direitos de uso.

  5. Aplicar direitos de uso ao documento PDF.

    • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo PDF.
    • Crie uma matriz de bytes que armazene o conteúdo de dados do objeto BLOB retornado pelo método removeUsageRights. Preencha a matriz de bytes obtendo o valor do membro de dados BLOB do objeto MTOM.
    • Crie um objeto System.IO.BinaryWriter chamando seu construtor e passando o objeto System.IO.FileStream.

Consulte também:

Removendo direitos de uso de documentos PDF

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Recuperando Informações de Credenciais

Você pode recuperar informações sobre a credencial usada para aplicar direitos de uso a um documento PDF habilitado para direitos. Ao recuperar informações sobre uma credencial, é possível obter informações como a data após a qual o certificado não é mais válido.

OBSERVAÇÃO

Para obter mais informações sobre o serviço de extensões do Acrobat Reader DC, consulte Referência de serviços para AEM Forms.

Resumo das etapas

Para recuperar informações sobre a credencial usada para aplicar direitos de uso a um documento PDF, execute as seguintes etapas:

  1. Inclua arquivos de projeto.
  2. Crie um objeto Cliente de extensões do Acrobat Reader DC.
  3. Recupere um documento PDF habilitado para direitos.
  4. Recupere informações sobre a credencial.

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 Cliente de extensões do Acrobat Reader DC

Antes de executar programaticamente uma operação de serviço de extensões do Acrobat Reader DC, é necessário criar um objeto cliente do serviço de extensões do Acrobat Reader DC. Se estiver usando a API do Java, crie um objeto ReaderExtensionsServiceClient . Se estiver usando a API do serviço da Web das extensões do Acrobat Reader DC, crie um objeto ReaderExtensionsServiceService .

Recuperar um documento PDF habilitado para direitos

Você deve recuperar um documento PDF com direitos ativados para recuperar informações sobre a credencial. Também é possível recuperar informações sobre uma credencial especificando seu alias; no entanto, se você quiser recuperar informações sobre uma credencial que foi usada para aplicar direitos de uso a um documento PDF habilitado para direitos específicos, deverá recuperar o documento.

Recuperar informações sobre a credencial

Depois de recuperar um documento PDF com direitos ativados, você pode obter informações sobre a credencial usada para aplicar direitos de uso a ela. Você pode obter as seguintes informações sobre a credencial:

  • A mensagem que é exibida no Adobe Reader quando o documento PDF habilitado para direitos é aberto.
  • A data após a qual a credencial não é mais válida.
  • A data antes da qual a credencial não é válida.
  • Os direitos de uso que foram definidos para este documento PDF habilitado para direitos.
  • O número de vezes que a credencial foi usada.

Consulte também:

Remova os direitos de uso usando a API do Java

Remover direitos de uso usando a API de 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 Acrobat Reader DC Extensions Service

Recupere informações de credenciais usando a API do Java

Recupere informações de credenciais usando a API de extensões do Acrobat Reader DC (Java):

  1. Inclua arquivos de projeto.

    Inclua arquivos JAR do cliente, como adobe-reader-extensions-client.jar, no caminho de classe do seu projeto Java.

  2. Crie um objeto Cliente de extensões do Acrobat Reader DC.

    Crie um objeto ReaderExtensionsServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.

  3. Recupere um documento PDF.

    • Crie um objeto java.io.FileInputStream que represente o documento PDF habilitado para direitos usando seu construtor e transmitindo um valor de string que especifique o local do documento PDF habilitado para direitos.
    • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.

  4. Remova direitos de uso do documento PDF.

    • Recupere informações sobre a credencial usada para aplicar direitos de uso ao documento PDF, chamando o método ReaderExtensionsServiceClient do objeto getDocumentUsageRights e transmitindo o objeto com.adobe.idp.Document que contém o documento PDF habilitado para direitos. Este método retorna um objeto GetUsageRightsResult que contém informações de credenciais.
    • Recupere a data após a qual a credencial não é mais válida, chamando o método GetUsageRightsResult do objeto getNotAfter. Este método retorna um objeto java.util.Date que representa a data após a qual a credencial não é mais válida.
    • Recupere a mensagem que é exibida no Adobe Reader quando o documento PDF habilitado para direitos é aberto, chamando o método GetUsageRightsResult do objeto getMessage. Esse método retorna um valor de string que representa a mensagem.

Consulte também:

Recuperando Informações de Credenciais

Início rápido (modo SOAP): Recuperação de informações de credencial usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Recuperar informações de credenciais usando a API do serviço da Web

Recupere informações de credenciais usando a API de extensões do Acrobat Reader DC (serviço da Web):

  1. Inclua arquivos de projeto.

    Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1.

    OBSERVAÇÃO

    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

  2. Crie um objeto Cliente de extensões do Acrobat Reader DC.

    • Crie um objeto ReaderExtensionsServiceClient usando seu construtor padrão.

    • Crie um objeto ReaderExtensionsServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom. Certifique-se de especificar ?blob=mtom.)

    • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo ReaderExtensionsServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

    • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

    • Ative a autenticação HTTP básica executando as seguintes tarefas:

      • Atribua o nome de usuário dos formulários AEM ao campo ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName.
      • Atribua o valor correspondente da senha ao campo ReaderExtensionsServiceClient.ClientCredentials.UserName.Password.
      • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

  3. Recupere um documento PDF.

    • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar um documento PDF habilitado para direitos.
    • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF habilitado para direitos e o modo no qual o arquivo será aberto.
    • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
    • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
    • Preencha o objeto BLOB atribuindo sua propriedade MTOM ao conteúdo da matriz de bytes.

  4. Remova direitos de uso do documento PDF.

    • Recupere informações sobre a credencial usada para aplicar direitos de uso ao documento PDF, chamando o método ReaderExtensionsServiceClient do objeto getDocumentUsageRights e transmitindo o objeto com.adobe.idp.Document que contém o documento PDF habilitado para direitos. Este método retorna um objeto GetUsageRightsResult que contém informações de credenciais.
    • Recupere a data após a qual a credencial não é mais válida obtendo o valor do membro de dados GetUsageRightsResult do objeto. notAfter O tipo de dados desse membro de dados é System.DateTime.
    • Recupere a mensagem que é exibida quando o documento PDF habilitado para direitos é aberto no Adobe Reader obtendo o valor do membro de dados GetUsageRightsResult do objeto message. O tipo de dados desse membro de dados é uma string.
    • Recupere o número de vezes que a credencial é usada obtendo o valor do membro de dados GetUsageRightsResult do objeto useCount. O tipo de dados desse membro de dados é um número inteiro.

Consulte também:

Recuperando Informações de Credenciais

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Nesta página