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.
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:
- Uma conta de desenvolvedor Adobe Sign ativa.
- Um servidor habilitado para SSL AEM Forms.
- Um aplicativo de API do Adobe Sign.
- Credenciais (ID do Cliente e Segredo do Cliente) do aplicativo da API Adobe Sign.
- Ao reconfigurar, remova a configuração Adobe Sign existente das instâncias do autor e de publicação.
- Use chave de criptografia idêntica para as instâncias de autor e publicação.
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:
-
Na instância do autor do AEM Forms, navegue até Ferramentas > Geral > Navegador de Configuração.
-
Na página Navegador de Configuração, selecione Criar.
- Consulte a documentação do Navegador de Configuração para obter mais informações.
-
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.
-
Navegue até Ferramentas > 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 > 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. -
Na página de configuração, toque em Criar para criar a configuração Adobe Sign no AEM Forms.
-
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.
-
Agora você pode Selecionar solução para selecionar Adobe Acrobat Sign.
-
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. -
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.
-
-
Defina as configurações de OAuth para o aplicativo Adobe Sign:
-
Abra uma janela de navegador e entre na conta de desenvolvedor do Adobe Sign.
-
Selecione o aplicativo configurado para AEM Forms e selecione Configurar OAuth para o Aplicativo.
-
Copie a ID do Cliente e o Segredo do Cliente em um bloco de notas.
-
Na caixa Redirecionar URL, adicione o URL HTTPS copiado na etapa anterior.
-
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.
-
-
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.
-
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.
-
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.
-
Toque em Criar para criar a configuração Adobe Sign.
-
Abra o console da Web AEM. A URL é
https://'[server]:[port]'/system/console/configMgr
-
Abra o Serviço de Configuração Comum do Forms.
-
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.
-
Publish da configuração.
-
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.
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
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,
- Verifique se a sua conta do Adobe Acrobat Sign Solutions for Government foi provisionada.
- Seus servidores AEM Forms estão habilitados para SSL.
- Seus servidores AEM Forms estão usando chave criptográfica idêntica para as instâncias de autoria e publicação.
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
-
Na sua instância do AEM Forms, navegue até Ferramentas > Geral > Navegador de Configuração.
-
Na página Navegador de Configuração, selecione Criar.
-
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.
-
Navegue até Ferramentas > 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.
-
Na página de configuração, selecione Criar para criar a configuração Adobe Acrobat Sign no AEM Forms.
-
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 ore-direct URL
e oScopes
com a equipe da Adobe Sign e solicita credenciais (ID do cliente e Segredo do cliente).
- 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
-
Abra o
re-direct URL
no navegador. Você criou e anotou ore-direct URL
na última etapa da seção criar uma URL de redirecionamento na sua instância do AEM. -
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.
-
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.
-
No campo Email, especifique o endereço de email associado à sua conta do Adobe Acrobat Sign Solutions for Government.
-
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.
-
-
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].
-
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.
-
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.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. -
Selecione Criar para criar a configuração.
-
Abra o console da Web AEM. A URL é
https://'[server]:[port]'/system/console/configMgr
-
Abra o Serviço de Configuração Comum do Forms.
-
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.
-
Publish da configuração.
-
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:
-
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
-
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.