Integrar Adobe Sign com AEM Forms

Última atualização em 2023-12-21

O Adobe recomenda o uso da captura de dados moderna e extensível Componentes principais para criação de um novo Forms adaptável ou adição de Forms adaptável às páginas do AEM Sites. Esses componentes representam um avanço significativo na criação do Forms adaptável, garantindo experiências de usuário impressionantes. Este artigo descreve a abordagem mais antiga para criar o Forms adaptável usando componentes de base.

Versão Link do artigo
AEM as a Cloud Service Clique aqui
AEM 6.5 Este artigo

Adobe Sign habilita fluxos de trabalho de assinatura eletrônica para formulários adaptáveis. 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 conecte o Adobe Sign a todas as instâncias de Autor e Publicação do AEM Forms:

Pré-requisitos

Você precisa do seguinte para integrar Adobe Sign com AEM Forms:

Configurar Adobe Sign com AEM Forms

Depois que os pré-requisitos estiverem em vigor, execute as seguintes etapas para configurar Adobe Sign com AEM Forms na instância do Autor:

  1. No AEM Forms instância do autor, 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.

  4. Navegue até Ferramentas martelo > Cloud Service > Adobe Sign e selecione o contêiner de configuração que você criou na etapa acima.

    OBSERVAÇÃO

    Você pode executar as etapas 1 a 4 para criar um contêiner de configuração e criar um Adobe Sign no contêiner ou use o existente global pasta em Ferramentas martelo > Cloud Service > Adobe Sign. Se você criar a configuração no novo container de configuração, certifique-se de especificar o nome do container no Contêiner de configuração ao criar um Formulário adaptável.

    OBSERVAÇÃO

    Verifique se o URL da página de configuração do Cloud Service começa com HTTPS. Caso contrário, ativar SSL para AEM Forms servidor.

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

  6. No Geral guia do Criar configuração do Adobe Sign página, especifique um Nome para a configuração e toque em Próxima. Opcionalmente, é possível especificar um título e procurar para selecionar uma 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 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. Toque Próxima.

  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 Sign aplicativo:

    1. Abra uma janela do navegador e faça logon na Adobe Sign conta de desenvolvedor.
    2. Selecione o aplicativo configurado para AEM Formse selecione Configurar OAuth para Aplicativo.
    3. Copie o ID do cliente e Segredo do cliente em um bloco de notas.
    4. No URL de redirecionamento adicione o URL HTTPS copiado na etapa anterior.
    5. Ative as seguintes configurações do OAuth para o Adobe Sign e clique em Salvar.
    • agreement_read
    • agreement_write
    • agreement_send
    • widget_write
    • workflow_read

    Para obter informações passo a passo sobre como definir as configurações de OAuth para um Adobe 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 Sign página. No Configurações especifique a 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 Sign criado para o AEM Forms.

  12. Selecione o Ativar Adobe Sign também para anexos opção para anexar arquivos anexados a um formulário adaptável ao formulário correspondente Adobe Sign documento enviado para assinatura.

  13. 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 Sign aplicação.

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

  14. Toque Criar para criar o Adobe Sign configuração.

  15. Abra o console da Web AEM. O URL é https://'[server]:[port]'/system/console/configMgr

  16. Abertura Serviço de configuração comum do Forms.

  17. No Permitir campo, selecionar Todos os usuários - Todos os usuários, anônimos ou conectados, podem visualizar anexos, verificar e assinar formulários e clicar em Salvar. A instância do autor está configurada para usar Adobe Sign.

  18. Publique a configuração.

  19. Uso replicação para criar configurações idênticas nas instâncias de publicação correspondentes.

Agora, Adobe Sign é integrado ao AEM Forms e pronto para uso em formulários adaptáveis. Para usar o serviço Adobe Sign em um formulário adaptável, especifique o container de configuração criado acima nas propriedades do 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

adobe-acrobat-sign-govt-workflow

Antes de começar

Antes de começar a conectar o AEM Forms com a solução da Adobe Acrobat Sign,

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

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

  1. Na sua instância 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. Certifique-se de que o nome do contêiner/pasta não contenha 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 do navegador atual para um bloco de notas 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).

OBSERVAÇÃO
  • A re-direct URL deve conter uma Nível superior domínio. Por exemplo, https://adobe.com/libs/adobesign/cloudservices/adobesign/createcloudconfigwizard/cloudservices.html/conf/global
  • Não use um URL local como re-direct URL. Por exemplo, https://localhost:4502/libs/adobesign/cloudservices/adobesign/createcloudconfigwizard/cloudservices.html/conf/global.

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

  • agreement_read
  • agreement_write
  • agreement_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 Adobe Acrobat Sign for Government Solutions e , 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

    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 accounte clique em Permitir acesso.

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

  10. Abra o console da Web AEM. O URL é https://'[server]:[port]'/system/console/configMgr

  11. Abertura Serviço de configuração comum do Forms.

  12. No Permitir campo, selecionar Todos os usuários - Todos os usuários, anônimos ou conectados, podem visualizar anexos, verificar e assinar formulários e clicar em Salvar. A instância do autor está configurada para usar Adobe Sign.

  13. Publique a configuração.

  14. Uso replicação para criar configurações idênticas nas instâncias de publicação correspondentes.

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 Sign scheduler para sincronizar o status de assinatura

Um Adobe Sign o formulário adaptável ativado é enviado somente depois que todos os signatários concluírem o processo de assinatura. Por padrão, a variável Adobe Sign Os serviços do agendador estão agendados para verificar (enquete) a resposta do assinante a cada 24 horas. Você pode alterar o intervalo padrão do seu ambiente. Execute as seguintes etapas para alterar o intervalo padrão:

  1. Fazer logon no AEM Forms servidor com credenciais de administrador e navegue até Ferramentas > Operações > Console da Web.

    Você também pode abrir o seguinte URL em uma janela do navegador:
    https://[localhost]:'port'/system/console/configMgr

  2. Localize e abra o Serviço de configuração do Adobe Sign opção. Especificar um expressão CRON no Expressão do Agendador de Atualização de Status e clique em Salvar. Por exemplo, para executar o serviço de configuração diariamente às 0h, especifique 0 0 0 1/1 * ? * no Expressão do Agendador de Atualização de Status campo.

Intervalo padrão para sincronizar o status de Adobe Sign foi alterado.

Nesta página