Uso do DocuSign com um formulário adaptável

O DocuSign é uma solução proeminente de assinatura eletrônica. Você pode usá-lo para assinar um contrato por e-mail. É possível integrar o DocuSign com um formulário adaptável. Ajuda a enviar um formulário adaptável para assinaturas eletrônicas para vários destinatários. O uso de assinaturas eletrônicas ajuda a:

  • Feche negócios de qualquer dispositivo com processos de proposta, cotação e contrato totalmente automatizados.
  • Termine os processos de recurso humano mais rapidamente e dê aos seus funcionários as experiências digitais.
  • Reduza mais rapidamente os tempos de ciclo do contrato e integre seus fornecedores.

O AEM Forms as a Cloud Service fornece uma ação de envio personalizado para o DocuSign. A ação de envio ajuda a enviar os formulários adaptáveis para assinaturas eletrônicas usando APIs do DocuSign.

Você também pode usar a solução Adobe e-signature, Adobe Sign para assinar automaticamente um formulário adaptável. A AEM Forms tem uma integração muito mais profunda com o Adobe Sign e fornece controles muito mais refinados, como assinatura sequencial e paralela, vários métodos de autenticação, experiência de assinatura no formulário e muito mais. Para obter mais informações, consulte Uso do Adobe Sign em um formulário adaptável.

Pré-requisitos

Os itens a seguir são necessários para integrar o DocuSign com o AEM Forms:

Configurar a ação de envio personalizada e o serviço em nuvem para o DocuSign

O AEM Forms as a Cloud Service fornece uma ação de envio personalizada para o DocuSign. A ação de envio ajuda a enviar os formulários adaptáveis para assinaturas eletrônicas usando APIs do DocuSign. O código para a ação de envio personalizado está disponível em Repositório git público de amostras do AEM Forms. Você pode implantar o código da forma como está no ambiente AEM Forms ou personalizá-lo de acordo com os requisitos de sua organização.

Execute as seguintes etapas para configurar a ação de envio personalizado e o Cloud Service do DocuSign prontos para uso:

  1. Clonar o projeto as a Cloud Service do AEM Forms ou criar uma Experience Manager Forms como Cloud Service projeto baseado em Arquétipo de AEM 27 ou posterior. Para criar um Experience Manager Forms como Cloud Service projeto baseado no Arquétipo de AEM:

    Abra o prompt de comando e execute o comando abaixo para criar um Experience Manager Forms Projeto as a Cloud Service:

    mvn -B archetype:generate -DarchetypeGroupId=com.adobe.aem -DarchetypeArtifactId=aem-project-archetype -DarchetypeVersion=27 -DaemVersion="cloud" -DappTitle="My Site" -DappId="mysite" -DgroupId="com.mysite" -DincludeForms="y"
    

    Além disso, altere appTitle, appIde groupId, no comando acima para refletir seu ambiente.

  2. Clonar o aem-forms-samples repositório. Este repositório contém uma ação de envio personalizada para o DocuSign e detalhes de configuração para se conectar ao servidor do DocuSign.

  3. Abra o projeto as a Cloud Service do AEM Forms criado na Etapa 1 para edição no IDE de sua escolha.

  4. Abra o [AEM Forms as a Cloud Service project]\pom.xml para editar e fazer as seguintes alterações:

    1. Adicione o seguinte texto no final do <properties> tag:

      <repository.location>maven_repository</repository.location>
      
    2. Adicione o seguinte texto no final do <repositories> tag:

       <repository>
          <id>project-repository</id>
          <url>file://${project.basedir}/${repository.location}</url>
       </repository>
      

      Se não houver <repositories> , crie a tag abaixo de <properties> .

    3. Adicione o seguinte texto no final do <dependencyManagement> tag:

       <dependency>
         <groupId>com.adobe.aemforms.samples</groupId>
         <artifactId>forms.integration.docusign.all</artifactId>
         <type>zip</type>
         <version>1.0.0</version>
       </dependency>
      
  5. Execute as seguintes etapas no all/pom.xml arquivo disponível na pasta Cloud Service project:

    1. Adicione o seguinte texto no final do <embeddeds> tag:

       <embedded>
          <groupId>com.adobe.aemforms.samples</groupId>
          <artifactId>forms.integration.docusign.all</artifactId>
          <type>zip</type>
          <target>/apps/moonlightprodprogram-vendor-packages/application/install</target>
       </embedded>
      
    2. Adicione o seguinte texto no final do <dependencies> tag:

       <dependency>
          <groupId>com.adobe.aemforms.samples</groupId>
          <artifactId>forms.integration.docusign.all</artifactId>
          <type>zip</type>
       </dependency>
      
  6. Abra o prompt de comando e navegue até aem-forms-samples\forms-integration-docusign (clonado na etapa 3) e execute o seguinte comando:

    mvn clean install -Dinstall.dir="<AEM Forms as a Cloud Service project path>/maven_repository"
    

    <AEM Forms as a Cloud Service project path> refere-se ao nome da pasta criada na etapa 1 deste procedimento.

  7. Implante o projeto no ambiente de desenvolvimento local. Você pode usar o seguinte comando para implantar em seu ambiente de desenvolvimento local

    mvn -PautoInstallPackage clean install

    Após executar essas etapas, é possível visualizar uma nova ação de envio personalizado Enviar com assinaturas eletrônicas do DocuSign disponível na lista de opções de envio para um formulário adaptável e um Configuração do serviço em nuvem do DocuSign no ambiente de desenvolvimento local.

  8. Compilar e Implante o código no AEM Forms Ambiente as a Cloud Service.

Integrar DocuSign com AEM Forms

Depois que os pré-requisitos estiverem em vigor, execute as seguintes etapas para integrar DocuSign com AEM Forms nas instâncias de Autor.

  1. Navegar para Ferramentas martelo > Cloud Services > DocuSign e selecione uma pasta para hospedar a configuração.

  2. Na página Configurações , toque em Criar para criar DocuSign na AEM Forms.

  3. No Geral da guia Criar configuração do DocuSign especifique um Nome para a configuração, e toque em Próximo. Como opção, você pode especificar uma Título.

  4. Copie o URL na janela atual do navegador para um bloco de notas. O URL é necessário para configurar DocuSign aplicativo com AEM Forms em uma etapa posterior.

  5. Defina as configurações de OAuth para a variável DocuSign aplicativo:

    1. Abra uma janela do navegador e faça logon em sua DocuSign conta do desenvolvedor.
    2. Abra o aplicativo configurado para AEM Forms.
    3. No Redirecionar URI , adicione o URL copiado na etapa anterior e clique em Salvar.
    4. Anote as Teclas de integração e segredo.

    Para obter informações passo a passo sobre a configuração do OAuth para um DocuSign e obtenha as chaves, consulte Definir configurações de oAuth para o aplicativo documentação do desenvolvedor.

  6. Volte para o Criar configuração do DocuSign página. No Configurações , a variável URL de OAuth menciona o seguinte URL padrão:

    https://account-d.docusign.com/oauth/auth

  7. Especifique a ID do cliente (Chave de integração do DocuSign) e Segredo do cliente (Chave Secreta DocuSign).

  8. Toque Conecte-se ao DocuSign. Quando solicitado a fornecer credenciais, forneça o nome de usuário e a senha da conta usada ao criar DocuSign aplicativo. Quando solicitado a confirmar o acesso para your developer account, clique em Permitir acesso. Se as credenciais estiverem corretas, uma mensagem de sucesso será exibida.

  9. Toque Criar para criar o DocuSign configuração.

  10. Selecione a configuração e clique em Publicar, selecione a configuração e clique em Publicar. Ele replica a configuração em ambientes de publicação correspondentes.

  11. Repita todas as etapas acima nas instâncias de desenvolvedor, estágio e produção (o que restar) para concluir a configuração DocuSign com AEM Forms para seu ambiente.

Agora, seu ambiente AEM Forms está configurado para usar o DocuSign. Certifique-se de adicionar o contêiner de configuração usado para o Cloud Service a todo o Adaptive Forms que está sendo ativado para DocuSign. É possível especificar um contêiner de configuração a partir das propriedades de um formulário adaptável.

Use DocuSign em um formulário adaptável

Você pode ativar DocuSign para um formulário adaptável existente ou criar um DocuSign formulário adaptável habilitado. Escolha uma das opções a seguir:

Criar um formulário adaptável para o DocuSign

Para criar um formulário adaptável habilitado para assinatura:

  1. Navegar para Adobe Experience Manager > Forms > Forms & Documents.

  2. Toque Criar e selecione Formulário adaptável. Uma lista de modelos é exibida. Selecione um modelo e toque em Próximo.

  3. No Básico guia :

    1. Especifique a Nome e Título para o formulário adaptável.

    2. Selecione o contêiner de configuração criado ao integração DocuSign com AEM Forms.

    O contêiner de configuração contém a variável DocuSign Cloud Services configurados para o seu ambiente. Esses serviços estão disponíveis para seleção no editor de formulário adaptável.

  4. No Modelo de formulário selecione uma das seguintes opções:

    • Se você tiver um modelo de formulário personalizado e exigir um Documento de registro com base no modelo de formulário, selecione o Associar modelo de formulário como o modelo Documento de registro e selecione um modelo Document of Record . Ao usar a opção , os documentos enviados para assinatura exibem apenas os campos que se baseiam no modelo de formulário associado. Não exibe todos os campos do Formulário adaptável.

    • Se não tiver um modelo de formulário personalizado, selecione Gerar Documento de Registro opção. Quando você usa a opção , o documento enviado para assinatura exibe todos os campos do Formulário adaptável.

  5. Toque Criar. É criado um formulário adaptável habilitado para assinatura. Você pode adicionar DocuSign campos para o formulário e enviá-lo para assinatura.

  6. Abra o formulário adaptável no modo de edição. No Conteúdo toque na guia Contêiner de formulário e tocar Configurar.

  7. No Submissão seção , selecione Enviar com assinaturas eletrônicas do DocuSign do Enviar ação lista suspensa.

  8. No Configuração de ação seção, toque em Adicionar para adicionar um recipient e especificar o endereço de email do recipient. Toque Adicionar novamente para adicionar mais recipients.

  9. Especifique o assunto da mensagem de email no Assunto do email campo. Selecionar Incluir anexos para incluir anexos na mensagem de email.

  10. Toque Salvar para salvar as propriedades.

Habilitar DocuSign para um formulário adaptável

Para usar DocuSign em um formulário adaptável existente:

  1. Navegar para Adobe Experience Manager > Forms > Forms & Documents.

  2. Selecione o formulário adaptável e toque em Propriedades.

  3. No Básico selecione a guia contêiner de configuração criado ao integrar DocuSign com AEM Forms.

  4. No Modelo de formulário selecione uma das seguintes opções:

    • Se você tiver um modelo de formulário personalizado e exigir um Documento de registro com base no modelo de formulário, selecione o Associar modelo de formulário como o modelo Documento de registro e selecione um modelo Document of Record . Ao usar a opção , os documentos enviados para assinatura exibem apenas os campos que se baseiam no modelo de formulário associado. Não exibe todos os campos do Formulário adaptável.

    • Se não tiver um modelo de formulário personalizado, selecione Gerar Documento de Registro opção. Quando você usa a opção , o documento enviado para assinatura exibe todos os campos do Formulário adaptável.

  5. Toque Salvar e fechar. O formulário adaptável está ativado para DocuSign. Agora, você pode adicionar seu DocuSign campos para o formulário e enviá-lo para assinatura.

  6. Abra o formulário adaptável no modo de edição. No Conteúdo toque na guia Contêiner de formulário e tocar Configurar.

  7. No Submissão seção , selecione Enviar com assinaturas eletrônicas do DocuSign do Enviar ação lista suspensa.

  8. No Configuração de ação seção, toque em Adicionar para adicionar um recipient e especificar o endereço de email do recipient. Toque Adicionar novamente para adicionar mais recipients.

  9. Especifique o assunto da mensagem de email no Assunto do email campo. Selecionar Incluir anexos para incluir anexos na mensagem de email.

  10. Toque Salvar para salvar as propriedades.

Nesta página