DocumentaçãoAEM as a Cloud ServiceGuia do usuário

Conectar AEM Forms as a Cloud Service com Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

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

Adobe Acrobat Sign habilita fluxos de trabalho de assinatura eletrônica para Forms adaptável e fluxos de trabalho 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 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 configure o Adobe Sign Cloud Service nas instâncias do as a Cloud Service e do Publish 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 o Adobe Acrobat Sign com o AEM Forms:

  1. Uma conta de desenvolvedor do Adobe Acrobat Sign ativa.
  2. Um aplicativo de API do Adobe Acrobat Sign.
  3. Credenciais (ID do Cliente e Segredo do Cliente) do aplicativo da API Adobe Acrobat Sign.
  4. (Somente para autenticação baseada em ID do Governo) Habilite o método de autenticação para autenticação de 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 etapas a seguir para configurar o 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. 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 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 contêiner de configuração criado na etapa anterior.

    note note
    NOTE
    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. Na guia Geral da página Criar configuração do Adobe Acrobat 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.

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

    Adobe Acrobat Sign Solutions

  8. Copie a URL presente 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. Selecione 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 Acrobat Sign:

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

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

    3. Na caixa Redirecionar URL, adicione a URL copiada em uma etapa anterior (Etapa 8) e clique em Salvar.

    4. Habilite o seguinte Escopo para o aplicativo 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 OAuth para um aplicativo Adobe Acrobat 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 Acrobat 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 Acrobat Sign criados na etapa anterior.

  12. 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.

  13. Selecione Conectar ao Adobe Acrobat Sign. Quando as credenciais forem solicitadas, forneça nome de usuário e senha da conta usada ao criar o aplicativo Adobe Acrobat Sign. Quando for solicitada a confirmação, acesse para your developer account, 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

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

  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 do Adobe Acrobat Sign com AEM Forms para o seu ambiente.

Agora, você pode usar a opção 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.

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

Resolução de problemas resolve-config-error

Ao conectar Adobe Acrobat Sign com AEM Forms e encontrar um erro Unable to authorize access because the client configuration is invalid: invalid_request, como mostrado na imagem abaixo. Para resolver isso, siga as etapas fornecidas abaixo:

Erro de configuração

  1. Copie a URL presente na janela do navegador atual para um bloco de notas e remova a parte /ui#/aem da URL.
  2. Abra uma janela de navegador e entre na sua conta de desenvolvedor do Adobe Acrobat Sign.
  3. Selecione o aplicativo configurado para AEM Forms e selecione Configurar OAuth para o Aplicativo.
  4. Na caixa Redirecionar URL, adicione a URL copiada 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

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 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.

Conecte o AEM Forms as a Cloud Service ao Adobe Acrobat Sign Solutions for Government connect-adobe-acrobat-sign-for-government

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

  1. Na instância do as a Cloud Service do 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 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 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 a URL da janela do navegador atual para um bloco de notas e remova /ui#/aem da 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).

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 seu representante Adobe Acrobat Sign for Government Solution (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 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 your developer account, 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

  9. Selecione 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 do 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 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 Acrobat Sign 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 assinantes em intervalos definidos. Os cenários nos quais você configura o serviço scheduler:

Por padrão, os serviços do Agendador do Adobe Acrobat Sign verificam 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 uma expressão cron para a propriedade sign.status.exp da configuração do Serviço de Configuração do Adobe Acrobat Sign.

Por exemplo, para executar o serviço de configuração diariamente às 00:00, defina a propriedade sign.status.exp da configuração do Serviço de Configuração do Adobe Acrobat Sign para especificar 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, Gere Configurações OSGi usando o SDK do AEM e implante a configuração na instância do Cloud Service.

Related Articles
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab