Conectar AEM Forms as a Cloud Service com Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms
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 adobe-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 prerequisites-for-adobe-sign
Você precisa da seguinte configuração para integrar Adobe Acrobat Sign com AEM Forms:
- Um ativo Conta de desenvolvedor do Adobe Acrobat Sign.
- Um aplicativo da API do Adobe Acrobat Sign.
- Credenciais (ID do cliente e segredo do cliente) de Adobe Acrobat Sign aplicativo da API.
- (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 configure-adobe-sign-with-aem-forms
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.
-
Na instância do autor do AEM Forms, navegue até Ferramentas > Geral > Navegador de configuração.
-
No Navegador de configuração selecione Criar.
-
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.
-
Navegue até Ferramentas > Cloud Service > Adobe Acrobat Sign e abra o container de configuração criado na etapa anterior.
note note NOTE Ao criar um Formulário adaptável, especifique o nome do contêiner na Contêiner de configuração campo. -
Na página de configuração, selecione Criar para criar Adobe Acrobat Sign configuração no AEM Forms.
-
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.
-
Agora é possível Selecionar solução para selecionar Adobe Acrobat Sign.
-
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. -
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.
note note NOTE - 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.
-
-
Defina as configurações de OAuth para o Adobe Acrobat Sign aplicativo:
-
Abra uma janela do navegador e faça logon no Adobe Acrobat Sign conta de desenvolvedor.
-
Selecione o aplicativo configurado para AEM Formse selecione Configurar OAuth para Aplicativo.
-
No URL de redirecionamento adicione o URL copiado em uma etapa anterior (Etapa 8) e clique em Salvar.
-
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.
-
-
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.
-
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.
-
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. -
Selecionar Criar para criar o Adobe Acrobat Sign configuração.
-
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.
-
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.
Resolução de problemas resolve-config-error
Ao se conectar Adobe Acrobat Sign com AEM Forms e encontrar um erro Unable to authorize access because the client configuration is invalid: invalid_request
conforme mostrado na imagem abaixo. Para resolver isso, siga as etapas fornecidas abaixo:
- Copie o URL presente na janela atual do navegador para um bloco de notas e remova a parte
/ui#/aem
do URL. - Abra uma janela do navegador e faça logon no Adobe Acrobat Sign conta de desenvolvedor.
- Selecione o aplicativo configurado para AEM Formse selecione Configurar OAuth para Aplicativo.
- No URL de redirecionamento adicione o URL copiado em uma etapa anterior e clique em Salvar.
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
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 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 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 connect-adobe-acrobat-sign-for-government
Criar um URL de redirecionamento para sua instância do AEM
- Na instância do autor as a Cloud Service do Forms, navegue até Ferramentas > Geral > Navegador de configuração.
- No Navegador de configuração selecione Criar.
- 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.
- Navegue até Ferramentas > 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.
- Na página de configuração, selecione Criar para criar Adobe Acrobat Sign configuração no AEM Forms.
- Copie o URL da janela atual do navegador para um bloco de notas e remova
/ui#/aem
do URL. Esse URL é chamado dere-direct URL
.
Na próxima seção, você compartilhará ore-direct URL
eScopes
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
-
Abra o
re-direct URL
no navegador. Você criou e anotou ore-direct URL
na última etapa do criar um URL de redirecionamento na sua instância do AEM seção. -
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.
-
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.
-
No E-mail especifique o endereço de email associado à sua conta do Adobe Acrobat Sign Solutions for Government.
-
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.
note note NOTE - 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.
-
-
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].
-
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.
-
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. -
Selecionar Criar para criar a configuração.
-
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.
-
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 configure-adobe-sign-scheduler-to-sync-the-signing-status
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:
- Se você usar Enviar o formulário (depois que cada recipient concluir a cerimônia de assinatura) para assinar um documento, o formulário é enviado somente após todos os signatários terem assinado o formulário.
- Se você usar o Etapa de assinatura em um fluxo de trabalho do AEM para assinar um documento, a etapa assinar aguarda todos os signatários assinarem o documento antes de prosseguir para a próxima etapa do fluxo de trabalho.
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.