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

Uso do DocuSign com um formulário adaptável integrate-aem-forms-with-DocuSign

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

Criado para:

  • undefined
  • undefined

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

  • Feche negócios de qualquer dispositivo com processos totalmente automatizados de propostas, cotações e contratos.
  • Conclua os processos de Recursos humanos com mais rapidez e ofereça aos seus funcionários as experiências digitais.
  • Reduza os tempos de ciclo do contrato e integre seus fornecedores mais rapidamente.

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 as APIs do DocuSign.

Você também pode usar a solução de assinatura eletrônica do Adobe, Adobe Sign, para assinar eletronicamente um formulário adaptável. O AEM Forms tem uma integração muito mais profunda com o Adobe Sign e fornece controles muito mais finos, 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 Usando o Adobe Sign em um Formulário Adaptável.

Pré-requisitos prerequisites

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

Configurar a ação de envio personalizada e o serviço em nuvem para o DocuSign deploy-custom-submit-action

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 as APIs do DocuSign. O código para ação de envio personalizada está disponível em repositório Git público de amostras do AEM Forms. Você pode implantar o código da maneira que ele está no ambiente do AEM Forms ou personalizá-lo de acordo com os requisitos da sua organização.

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

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

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

    code language-shell 
    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, appId e groupId no comando acima para refletir seu ambiente.

  2. Clonar o repositório aem-forms-samples. Esse repositório contém ações de envio personalizadas para o DocuSign e detalhes de configuração para se conectar com o servidor DocuSign.

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

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

    1. Adicionar o seguinte texto ao final da marca <properties>:

      code language-shell 
      <repository.location>maven_repository</repository.location>

    2. Adicionar o seguinte texto ao final da marca <repositories>:

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

      Se não houver uma marca <repositories>, crie a marca abaixo da marca <properties>.

    3. Adicionar o seguinte texto ao final da marca <dependencyManagement>:

      code language-shell 
       <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 arquivo all/pom.xml disponível na pasta do projeto Cloud Service:

    1. Adicionar o seguinte texto ao final da marca <embeddeds>:

      code language-shell 
       <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. Adicionar o seguinte texto ao final da marca <dependencies>:

      code language-shell 
       <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:

    code language-shell 
    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 comando a seguir para implantar no ambiente de desenvolvimento local

    mvn -PautoInstallPackage clean install

    Após executar essas etapas, você poderá exibir uma nova ação de envio personalizada Enviar com assinaturas eletrônicas do DocuSign, disponível na lista de opções de envio para um formulário adaptável e uma configuração do serviço de nuvem do DocuSign em seu ambiente de desenvolvimento local.

  8. Compile e implante o código no seu AEM Forms ambiente as a Cloud Service.

Integrar DocuSign a AEM Forms configure-docusign-with-aem-forms

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

  1. Navegue até Ferramentas martelo > Cloud Service > DocuSign e selecione uma pasta para hospedar a configuração.

  2. Na página de configurações, selecione Criar para criar a configuração DocuSign no AEM Forms.

  3. Na guia Geral da página Criar configuração do DocuSign, especifique um Nome para a configuração e selecione Avançar. Você pode especificar um Título.

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

  5. Defina as configurações de OAuth para o aplicativo DocuSign:

    1. Abra uma janela de navegador e entre na sua DocuSign conta de desenvolvedor.
    2. Abra o aplicativo configurado para AEM Forms.
    3. Na caixa Redirecionar URI, adicione a URL copiada na etapa anterior e clique em Salvar.
    4. Anote as chaves de integração e segredo.

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

  6. Volte para a página Criar configuração do DocuSign. Na guia Configurações, o campo URL do OAuth menciona a seguinte URL padrão:

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

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

  8. Selecione Conectar ao DocuSign. Quando as credenciais forem solicitadas, forneça o nome de usuário e a senha da conta usada ao criar o aplicativo DocuSign. 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. Selecione Criar para criar a configuração DocuSign.

  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 DocuSign com AEM Forms para o seu ambiente.

Agora, seu ambiente do AEM Forms está configurado para usar o DocuSign. Adicione o contêiner de configuração usado para o Cloud Service a todo o Forms adaptável que está sendo habilitado para DocuSign. Você pode especificar um contêiner de configuração nas propriedades de um Formulário adaptável.

Usar DocuSign em um formulário adaptável enabledocusign

Você pode habilitar DocuSign para um Formulário adaptável existente ou criar um Formulário adaptável habilitado para DocuSign. Escolha uma das seguintes opções:

Criar um formulário adaptável para o DocuSign create-an-adaptive-form-for-docusign

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

  1. Navegue até Adobe Experience Manager > Forms > Forms e Documentos.

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

  3. Na guia Básico:

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

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

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

  4. Na guia Modelo de Formulário, selecione uma das seguintes opções:

    • Se você tiver um modelo de formulário personalizado e precisar de um Documento de registro com base no modelo de formulário, selecione a opção Associar modelo de formulário como Documento de modelo de Registro e selecione um Documento de modelo de Registro. Quando você usa a opção, os documentos enviados para assinatura exibem apenas os campos que são baseados no modelo de formulário associado. Ele não exibe todos os campos do Formulário adaptável.

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

  5. Selecione Criar. Um Formulário adaptável habilitado para assinatura foi criado. Você pode adicionar os campos do DocuSign ao formulário e enviá-lo para assinatura.

  6. Abra o formulário adaptável no modo de edição. Na guia Conteúdo, selecione o Contêiner de Formulário e selecione Configurar .

  7. Na seção Envio, selecione Enviar com assinaturas eletrônicas DocuSign na lista suspensa Ação de Envio.

  8. Na seção Configuração de ação, selecione Adicionar para adicionar um destinatário e especificar o endereço de email dele. Selecione Adicionar novamente para adicionar mais destinatários.

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

  10. Selecione Salvar para salvar as propriedades.

Habilitar DocuSign para um Formulário adaptável editafsign

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

  1. Navegue até Adobe Experience Manager > Forms > Forms e Documentos.

  2. Selecione o Formulário adaptável e selecione Propriedades.

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

  4. Na guia Modelo de Formulário, selecione uma das seguintes opções:

    • Se você tiver um modelo de formulário personalizado e precisar de um Documento de registro com base no modelo de formulário, selecione a opção Associar modelo de formulário como Documento de modelo de Registro e selecione um Documento de modelo de Registro. Quando você usa a opção, os documentos enviados para assinatura exibem apenas os campos que são baseados no modelo de formulário associado. Ele não exibe todos os campos do Formulário adaptável.

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

  5. Selecione Salvar e fechar. O Formulário adaptável está habilitado para DocuSign. Agora, você pode adicionar os campos do DocuSign ao formulário e enviá-lo para assinatura.

  6. Abra o formulário adaptável no modo de edição. Na guia Conteúdo, selecione o Contêiner de Formulário e selecione Configurar .

  7. Na seção Envio, selecione Enviar com assinaturas eletrônicas DocuSign na lista suspensa Ação de Envio.

  8. Na seção Configuração de ação, selecione Adicionar para adicionar um destinatário e especificar o endereço de email dele. Selecione Adicionar novamente para adicionar mais destinatários.

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

  10. Selecione Salvar para salvar as propriedades.

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