Integrar Adobe Sign com AEM Forms integrate-adobe-sign-with-aem-forms

O Adobe recomenda o uso de Componentes principaisde captura de dados moderna e extensível para criar um novo Forms Adaptávelou adicionar o 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 cenário típico do Adobe Acrobat Sign e do Adaptive Forms, um usuário preenche um Formulário adaptável para se candidatar a 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 revisa o aplicativo e usa Adobe Acrobat Sign para marcar o aplicativo 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 adobe-sign

Para conectar o AEM Forms ao 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 do AEM Forms Author e do Publish:

Pré-requisitos prerequisites

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

Configurar Adobe Sign com AEM Forms configure-adobe-sign-with-aem-forms

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

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

  2. Na página Navegador de Configuração, selecione Criar.

  3. Na caixa de diálogo Criar Configuração, especifique um Título para a configuração, habilite as Configurações de 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 criado na etapa acima.

    note note
    NOTE
    Você pode executar as etapas 1 a 4 para criar um contêiner de configuração e criar uma configuração Adobe Sign no contêiner ou usar a pasta global existente em Ferramentas martelo > Cloud Service > Adobe Sign. Se você criar a configuração no novo contêiner de configuração, certifique-se de especificar o nome do contêiner no campo Contêiner de configuração ao criar um Formulário adaptável.
    note note
    NOTE
    Verifique se a URL da Página de Configuração do Cloud Service começa com HTTPS. Caso contrário, habilite o SSL para o servidor AEM Forms.
  5. Na página de configuração, toque em Criar para criar a configuração Adobe Sign no AEM Forms.

  6. Na guia Geral da página Criar configuração do Adobe Sign, especifique um Nome para a configuração e toque em Avançar. Opcionalmente, é possível especificar um título e procurar para selecionar uma miniatura para a configuração.

  7. Agora você pode Selecionar solução para selecionar Adobe Acrobat Sign.

    Adobe Acrobat Sign Solutions

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

  9. Na guia Configurações,

    • o campo URL do OAuth contém a 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 campo URL do token de acesso contém a 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. Verifique se as Configurações de Nuvem do ​ Adobe Acrobat Sign apontam para o Fragmento correto.

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

    1. Abra uma janela de navegador e entre na conta de desenvolvedor do Adobe Sign.

    2. Selecione o aplicativo configurado para AEM Forms e selecione Configurar OAuth para o Aplicativo.

    3. Copie a ID do Cliente e o Segredo do Cliente em um bloco de notas.

    4. Na caixa Redirecionar URL, adicione o URL HTTPS copiado na etapa anterior.

    5. Habilite as seguintes configurações OAuth para o aplicativo 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 OAuth para um aplicativo Adobe Sign e obter as chaves, consulte Definir configurações oAuth para a documentação do desenvolvedor do aplicativo.

    Configuração do OAuth

  11. Volte para a página Criar configuração do Adobe Sign. Na guia Configurações, especifique a ID do Cliente (também conhecida como ID do Aplicativo) e o Segredo do Cliente. Use a ID do Cliente e o Segredo do Cliente do aplicativo Adobe Sign criado para o AEM Forms.

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

  13. Selecione Conectar ao Adobe Sign. Quando as credenciais forem solicitadas, forneça o nome de usuário e a senha da conta usada ao criar o aplicativo Adobe Sign.

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

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

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

  16. Abra o Serviço de Configuração Comum do Forms.

  17. No campo Permitir, 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. Publish da configuração.

  19. Use a replicação para criar configuração idêntica nas instâncias de publicação correspondentes.

Agora, o Adobe Sign está 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 contêiner de configuração criado acima nas propriedades do formulário adaptável.

NOTE
Para configurar a sandbox do 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 adobe-acrobat-sign-for-government

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 prerequisites-for-adobe-sign-for-acrobat-sign-for-government

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 connect-adobe-acrobat-sign-for-government

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. Na página Navegador de Configuração, selecione Criar.

  3. Na caixa de diálogo Criar Configuração, especifique um Título para a configuração, habilite as Configurações de 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 contêiner de configuração criado na etapa anterior. Ao criar um Formulário adaptável, especifique o nome do contêiner no campo Contêiner de configuração.

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

  6. Copie o URL da janela do navegador atual para um bloco de notas do URL. Esta URL é referida como re-direct URL. Na próxima seção, você compartilha o re-direct URL e o Scopes com a equipe da Adobe Sign e solicita credenciais (ID do cliente e Segredo do cliente).

NOTE
  • Um re-direct URL deve conter um domínio de nível superior. Por exemplo, https://adobe.com/libs/adobesign/cloudservices/adobesign/createcloudconfigwizard/cloudservices.html/conf/global
  • Não use uma URL local como um 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 do Adobe Acrobat Sign for Government Solutions exige que o re-direct URL e determinados escopos sejam habilitados para que seu aplicativo Adobe Acrobat Sign (listado abaixo) gere credenciais (ID do cliente e Segredo do cliente) que permitam conectar o AEM Forms ao Adobe Acrobat Sign Solutions for Government.

Compartilhe o scopes (listado abaixo) e o re-direct URL criado e anotado na última etapa da seção anterior com o representante de Soluções para o Governo da Adobe Acrobat Sign membro da equipe da 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 da seção criar uma URL de redirecionamento na sua instância do AEM.

  2. Na guia Geral da página Criar configuração do Adobe Sign, especifique um Nome para a configuração e selecione Avançar. Opcionalmente, você pode especificar um Título e procurar para selecionar uma Miniatura para a configuração. Clique em Avançar.

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

    Adobe Acrobat Sign Solutions para o governo

  4. No campo Email, especifique o endereço de email associado à sua conta do Adobe Acrobat Sign Solutions for Government.

  5. Na guia Configurações,

    • o campo URL do OAuth contém a 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 campo URL do token de acesso contém a 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. Verifique se as Configurações de Nuvem do ​ Adobe Acrobat Sign apontam para o Fragmento correto.

    note note
    NOTE
    • Depois de fazer logon na conta do Adobe Sign, navegue até API do Acrobat Sign > Informações da API > Documentação dos Métodos da API REST > Token de acesso OAuth para acessar as informações relacionadas à URL do Adobe Sign oAuth e à URL do Token de acesso.
  6. Use as credenciais compartilhadas pela Adobe Acrobat Sign para o representante de Solução Governamental ([membro da equipe da Adobe Professional Services]) na seção anterior como [ID do Cliente e Segredo do Cliente].

  7. Selecione a opção Habilitar Adobe Acrobat Sign para anexos para anexar arquivos anexados a um Formulário Adaptável ao documento Adobe Acrobat Sign correspondente enviado para assinatura.

  8. Selecione Conectar ao Adobe Sign. Quando as credenciais forem solicitadas, forneça o nome de usuário e a senha da conta usada ao criar o aplicativo Adobe Acrobat Sign. Quando solicitado a confirmar o acesso para Adobe Acrobat Sign for Government Solutions e , clique em Permitir Acesso. Se as credenciais estiverem corretas e você permitir que o AEM Forms acesse sua conta de desenvolvedor do Adobe Acrobat Sign, uma mensagem de êxito semelhante à seguinte será 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 o aplicativo Adobe Acrobat Sign. Quando solicitado a confirmar o acesso para your account, clique em Permitir Acesso.

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

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

  11. Abra o Serviço de Configuração Comum do Forms.

  12. No campo Permitir, 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. Publish da configuração.

  14. Use a replicação para criar configuração idêntica 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 o Fluxo de Trabalho do AEM. Adicione o contêiner de configuração usado para a configuraçã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.

Configurar o agendador Adobe Sign para sincronizar o status de assinatura configure-adobe-sign-scheduler-to-sync-the-signing-status

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

  1. Faça logon no servidor AEM Forms 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 a opção Serviço de Configuração do Adobe Sign. Especifique uma expressão cron no campo 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 00:00, especifique 0 0 0 1/1 * ? * no campo Expressão do Agendador de Atualização de Status.

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

Artigos relacionados related-articles

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2