Conectar AEM Forms as a Cloud Service com Adobe Acrobat Sign

Última atualização em 2024-01-15
  • Criado para:
  • Intermediate
    Admin
    User
Versão Link do artigo
AEM 6.5 Clique aqui
AEM as a Cloud Service Este artigo

Adobe Acrobat Sign permite fluxos de trabalho de assinatura eletrônica para fluxos de trabalho adaptáveis do Forms e AEM. As assinaturas eletrônicas melhoram os fluxos de trabalho para processar documentos para áreas jurídicas, de vendas, de folha de pagamento, de gerenciamento de recursos humanos e muito mais.

Em um Adobe Acrobat Sign e Adaptive Forms, um usuário preenche um Formulário adaptável para solicitar um serviço. Por exemplo, um aplicativo de cartão de crédito e um formulário de benefícios para o cidadão. Quando um usuário preenche, envia e assina o formulário de aplicativo, ele é enviado ao provedor de serviços para que seja tomada uma nova ação. O provedor de serviços analisa o aplicativo e usa Adobe Acrobat Sign para marcar o pedido como aprovado. O AEM Forms é compatível com Adobe Acrobat Sign e Adobe Acrobat Sign Solutions para o governo. Dependendo da sua licença e dos requisitos, você pode integrar ou conectar o AEM Forms a qualquer uma das soluções:

Conectar o AEM Forms com o Adobe Acrobat Sign

Para conectar AEM Forms com Adobe Acrobat Sign, configure o software e as contas listados na seção de pré-requisitos e configure o Adobe Sign Cloud Service nas instâncias do Autor e de Publicação as a Cloud Service do Forms:

Pré-requisitos para conectar o AEM Forms ao Adobe Acrobat Sign

Você precisa da seguinte configuração para integrar Adobe Acrobat Sign com AEM Forms:

  1. Um ativo Conta de desenvolvedor do Adobe Acrobat Sign.
  2. Um aplicativo da API do Adobe Acrobat Sign.
  3. Credenciais (ID do cliente e segredo do cliente) de Adobe Acrobat Sign aplicativo da API.
  4. (Somente para autenticação baseada em ID do governo) Habilitar o método de autenticação para autenticação da ID do governo.

Conectar instâncias do Autor e de publicação do AEM Forms com o Adobe Acrobat Sign

Depois que os pré-requisitos estiverem em vigor, execute as seguintes etapas para configurar Adobe Acrobat Sign com AEM Forms nas instâncias do Autor.

  1. Na instância do autor do AEM Forms, navegue até Ferramentas martelo > Geral > Navegador de configuração.

  2. No Navegador de configuração selecione Criar.

  3. No Criar configuração , especifique um Título para a configuração, ative Configurações da nuvem e selecione Criar. Ele cria um contêiner de configuração para armazenar Cloud Service. Verifique se o nome da pasta não contém nenhum espaço.

  4. Navegue até Ferramentas martelo > Cloud Service > Adobe Acrobat Sign e abra o container de configuração criado na etapa anterior.

    OBSERVAÇÃO

    Ao criar um Formulário adaptável, especifique o nome do contêiner na Contêiner de configuração campo.

  5. Na página de configuração, selecione Criar para criar Adobe Acrobat Sign configuração no AEM Forms.

  6. No Geral guia do Criar configuração do Adobe Acrobat Sign página, especifique um Nome para a configuração e selecione Próxima. Opcionalmente, é possível especificar um Título e navegue para selecionar um Miniatura para a configuração.

  7. Agora é possível Selecionar solução para selecionar Adobe Acrobat Sign.

    Adobe Acrobat Sign Solutions

  8. Copie o URL presente na janela atual do navegador para um bloco de notas e remova a parte /ui#/aem do URL. O URL modificado é então necessário para configurar o Adobe Acrobat Sign aplicativo com AEM Forms, em uma etapa posterior. Selecione Próximo.

  9. No Configurações guia,

    • o URL do OAuth contém o URL padrão que inclui o fragmento de banco de dados do Adobe Sign. O formato do URL é:

      https://<shard>/public/oauth/v2

      Por exemplo:
      https://secure.na1.echosign.com/public/oauth/v2

    • o URL do token de acesso contém o URL padrão que inclui o fragmento de banco de dados do Adobe Sign. O formato do URL é:

      https://<shard>/oauth/v2/token

      Por exemplo:
      https://api.na1.echosign.com/oauth/v2/token

    em que:

    na1 refere-se ao fragmento de banco de dados padrão. Você pode modificar o valor do fragmento de banco de dados. Certifique-se de que o ​ Adobe Acrobat Sign As configurações de nuvem apontam para a variável corrigir fragmento.

    OBSERVAÇÃO
    • Mantenha a Criar configuração do Adobe Acrobat Sign página aberta. Não feche. Você pode recuperar ID do cliente e Segredo do cliente após definir as configurações de OAuth para o Adobe Acrobat Sign conforme descrito nas próximas etapas.
    • Depois de fazer logon na conta da Adobe Sign, navegue até API do Acrobat Sign > Informações da API > Documentação de Métodos da API REST > Token de acesso OAuth para acessar informações relacionadas ao URL do OAuth e ao URL do token de acesso do Adobe Sign.
  10. Defina as configurações de OAuth para o Adobe Acrobat Sign aplicativo:

    1. Abra uma janela do navegador e faça logon no Adobe Acrobat Sign conta de desenvolvedor.
    2. Selecione o aplicativo configurado para AEM Formse selecione Configurar OAuth para Aplicativo.
    3. No URL de redirecionamento adicione o URL copiado em uma etapa anterior (Etapa 8) e clique em Salvar.
    4. Habilite o seguinte Escopo para o Adobe Acrobat Sign e clique em Salvar.
    • aggrement_read
    • aggrement_write
    • aggrement_send
    • widget_read
    • widget_write
    • workflow_read

    Para obter informações passo a passo sobre como definir as configurações de OAuth para um Adobe Acrobat Sign e obter as chaves, consulte Definir configurações de oAuth para o aplicativo documentação do desenvolvedor.

    Configuração do OAuth

  11. Volte para o Criar configuração do Adobe Acrobat Sign página. No Configurações especifique a variável [ID do cliente (também conhecido como ID do aplicativo) e Segredo do cliente]. Use o ID do cliente e segredo do cliente do aplicativo Adobe Acrobat Sign criado na etapa anterior.

  12. Selecione o Ativar Adobe Acrobat Sign para anexos opção para anexar arquivos anexados a um Formulário adaptável aos arquivos correspondentes Adobe Acrobat Sign documento enviado para assinatura.

  13. Selecionar Conectar-se ao Adobe Acrobat Sign. Quando solicitado a fornecer credenciais, forneça nome de usuário e senha da conta usada ao criar Adobe Acrobat Sign aplicação. Quando solicitado a confirmar, acesse para your developer account, Clique em Permitir acesso. Se as credenciais estiverem corretas e você permitir AEM Forms para acessar o Adobe Acrobat Sign conta de desenvolvedor, uma mensagem de sucesso semelhante à seguinte é exibida.

    Êxito na configuração da nuvem do Adobe Acrobat Sign

  14. Selecionar Criar para criar o Adobe Acrobat Sign configuração.

  15. Selecione a configuração e clique em Publish, selecione a configuração e clique em Publish. Ele replica a configuração nos ambientes de publicação correspondentes.

  16. Repita todas as etapas acima nas instâncias de desenvolvedor, preparo e produção (qualquer uma que tenha restado) para concluir a configuração Adobe Acrobat Sign com AEM Forms para o seu ambiente.

Agora, você pode usar adicionar campos do Adobe Acrobat Sign a um formulário adaptável. Adicione o contêiner de configuração usado para o Cloud Service a todo o Forms adaptável que está sendo habilitado para Adobe Acrobat Sign. Você pode especificar um contêiner de configuração nas propriedades de um Formulário adaptável.

OBSERVAÇÃO

Para configurar a sandbox da Adobe Sign, você pode seguir as mesmas etapas de configuração descritas em Adobe Sign.

Conectar o AEM Forms com o Adobe Acrobat Sign Solutions para o governo

A conexão do AEM Forms com o Adobe Acrobat Sign Solutions para o governo é um processo de várias etapas. Envolve:

  • Criação de um URL de redirecionamento para suas instâncias do AEM
  • Compartilhamento do URL de redirecionamento e escopos com a equipe do Adobe Sign Solutions for Government
  • Recebimento de credenciais da equipe do Adobe Sign
  • Usar as credenciais recebidas para conectar o AEM Forms ao Adobe Acrobat Sign Solutions for Government

Fluxo de trabalho do Adobe Sign Government

O AEM Forms as a Cloud Service fornece ambientes de desenvolvimento, preparo e produção. Você pode começar com a conexão do seu ambiente de desenvolvimento para com o Adobe Acrobat Sign Solutions for Government e conectar os ambientes de preparo e produção posteriormente.

Antes de começar

Antes de começar a conectar o AEM Forms com a solução da Adobe Acrobat Sign, verifique se Adobe Acrobat Sign Solutions para o governo conta provisionada.

Conecte o AEM Forms as a Cloud Service com o Adobe Acrobat Sign Solutions for Government

Criar um URL de redirecionamento para sua instância do AEM

  1. Na instância do autor as a Cloud Service do Forms, navegue até Ferramentas martelo > Geral > Navegador de configuração.
  2. No Navegador de configuração selecione Criar.
  3. No Criar configuração , especifique um Título para a configuração, ative Configurações da nuvem e selecione Criar. Ele cria um contêiner de configuração para armazenar Cloud Service. Verifique se o nome da pasta não contém nenhum espaço.
  4. Navegue até Ferramentas martelo > Cloud Service > Adobe Acrobat Sign e abra o container de configuração criado na etapa anterior. Ao criar um Formulário adaptável, especifique o nome do contêiner na Contêiner de configuração campo.
  5. Na página de configuração, selecione Criar para criar Adobe Acrobat Sign configuração no AEM Forms.
  6. Copie o URL da janela atual do navegador para um bloco de notas e remova /ui#/aem do URL. Esse URL é chamado de re-direct URL.
    Na próxima seção, você compartilhará o re-direct URL e Scopes com a equipe do Adobe Sign e solicite credenciais (ID do cliente e Segredo do cliente).

Compartilhar a URL de redirecionamento e os escopos com a equipe do Adobe Sign e receber credenciais

A equipe de soluções da Adobe Acrobat Sign para o governo exige a re-direct URL e os escopos específicos a serem ativados para que o aplicativo Adobe Acrobat Sign (listado abaixo) gere credenciais (ID do cliente e Segredo do cliente) que permitem conectar o AEM Forms ao Adobe Acrobat Sign Solutions for Government.

Compartilhe o scopes (listadas abaixo) e o re-direct URL criou e anotou a última etapa da seção anterior com seu representante de soluções para o governo da Adobe Acrobat Sign (Membro da equipe do Adobe Professional Services).

Escopos

  • aggrement_read
  • aggrement_write
  • aggrement_send
  • widget_read
  • widget_write
  • workflow_read
  • offline_access

O representante gera e compartilha credenciais com você. Na próxima seção, use as credenciais (ID do cliente e Segredo do cliente) para conectar o AEM Forms ao Adobe Acrobat Sign Solutions for Government.

Use as credenciais recebidas para conectar o AEM Forms ao Adobe Acrobat Sign Solutions for Government

  1. Abra o re-direct URL no navegador. Você criou e anotou o re-direct URL na última etapa do criar um URL de redirecionamento na sua instância do AEM seção.

  2. No Geral guia do Criar configuração do Adobe Sign página, especifique um Nome para a configuração e selecione Próxima. Opcionalmente, é possível especificar um Título e navegue para selecionar um Miniatura para a configuração. Clique em Avançar.

  3. No Configurações guia do Criar configuração do Adobe Sign página, para o Selecionar solução selecione Adobe Acrobat Sign Solutions for Government.

    Adobe Acrobat Sign Solutions para o governo

  4. No E-mail especifique o endereço de email associado à sua conta do Adobe Acrobat Sign Solutions for Government.

  5. No Configurações guia,

    • o URL do OAuth contém o URL padrão que inclui o fragmento de banco de dados do Adobe Sign. O formato do URL é:

      https://<shard>/api/gateway/adobesignauthservice/api/v1/authorize

      Por exemplo:
      https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/authorize

    • o URL do token de acesso contém o URL padrão que inclui o fragmento de banco de dados do Adobe Sign. O formato do URL é:

      https://<shard>/api/gateway/adobesignauthservice/api/v1/token

      Por exemplo:
      https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/token

    em que:

    na1 refere-se ao fragmento de banco de dados padrão. Você pode modificar o valor do fragmento de banco de dados. Certifique-se de que o ​ Adobe Acrobat Sign As configurações de nuvem apontam para a variável corrigir fragmento.

    OBSERVAÇÃO
    • Depois de fazer logon na conta da Adobe Sign, navegue até API do Acrobat Sign > Informações da API > Documentação de Métodos da API REST > Token de acesso OAuth para acessar informações relacionadas ao URL do Adobe Sign oAuth e ao URL do token de acesso.
  6. Usar as credenciais compartilhadas pela Adobe Acrobat Sign para o representante de soluções do governo ([Membro da equipe do Adobe Professional Services]) na seção anterior como [ID do cliente e Segredo do cliente].

  7. Selecione o Ativar Adobe Acrobat Sign para anexos opção para anexar arquivos anexados a um Formulário adaptável aos arquivos correspondentes Adobe Acrobat Sign documento enviado para assinatura.

  8. Selecionar Conectar-se ao Adobe Sign. Quando as credenciais forem solicitadas, forneça o nome de usuário e a senha da conta usada ao criar Adobe Acrobat Sign aplicação. Quando for solicitado que você confirme o acesso de your developer account, Clique em Permitir acesso. Se as credenciais estiverem corretas e você permitir AEM Forms para acessar o Adobe Acrobat Sign conta de desenvolvedor, uma mensagem de sucesso semelhante à seguinte é exibida.

    Êxito na configuração da nuvem do Adobe Acrobat Sign

  9. Selecionar Criar para criar a configuração.

  10. Selecione a configuração e clique em Publish, selecione a configuração e clique em Publish. Ele replica a configuração nos ambientes de publicação correspondentes.

  11. Repita todas as etapas acima nas instâncias de desenvolvedor, preparo e produção (qualquer uma que tenha restado) para concluir a configuração Adobe Acrobat Sign Solutions for Government com AEM Forms para o seu ambiente.

Agora, você pode usar a opção adicionar campos do Adobe Acrobat Sign em um Formulário adaptável ou Fluxo de trabalho do AEM. Adicione o contêiner de configuração usado para a configuração do Cloud Service a todo o Forms adaptável que está sendo habilitado para Adobe Acrobat Sign. Você pode especificar um contêiner de configuração nas propriedades de um Formulário adaptável.

Configurar Adobe Acrobat Sign scheduler para sincronizar o status de assinatura

O AEM Forms as a Cloud Service fornece um serviço de scheduler que verifica o status dos signatários em intervalos definidos. Os cenários nos quais você configura o serviço scheduler:

Por padrão, a variável Adobe Acrobat Sign Os serviços do scheduler verificam (pesquisa) a resposta do assinante a cada 24 horas. Você pode alterar o intervalo padrão do seu ambiente.

Para alterar o intervalo padrão, especifique um expressão CRON para o sign.status.exp propriedade do Serviço de configuração do Adobe Acrobat Sign configuração.

Por exemplo, para executar o serviço de configuração diariamente às 00:00, defina a sign.status.exp propriedade do Serviço de configuração do Adobe Acrobat Sign configuração a ser especificada 0 0 0 1/1 * ? *. O arquivo JSON a seguir exibe a amostra para executar o serviço de configuração diariamente às 00:00:

{
  "sign.status.exp":"0 0 0 1/1 * ? *"
}

Para definir valores de uma configuração, Gerar configurações de OSGi usando o SDK do AEM, e implantar a configuração para a instância do Cloud Service.

Nesta página