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: Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

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 Uso do 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 projeto do AEM Forms as a Cloud Service ou criar um Experience Manager Forms as a Cloud Service projeto baseado em Arquétipo AEM 27 ou posteriormente. Para criar uma Experience Manager Forms as a Cloud Service projeto baseado no Arquétipo AEM:

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

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

  2. Clonar o aem-forms-samples repositório. 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 projeto AEM Forms as a Cloud Service criado na Etapa 1 para edição no IDE de sua escolha.

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

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

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

    2. Adicione o seguinte texto no final da <repositories> tag:

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

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

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

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

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

      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. Adicione o seguinte texto no final da <dependencies> tag:

      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

    Depois de executar essas etapas, você pode visualizar uma nova ação de envio personalizada Enviar com assinaturas eletrônicas do DocuSign disponíveis na lista de opções de envio para um formulário adaptável e uma Configuração do serviço de nuvem DocuSign no ambiente de desenvolvimento local.

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

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

Depois que os pré-requisitos estiverem em vigor, execute as seguintes etapas para integrar DocuSign com 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 DocuSign configuração no AEM Forms.

  3. No Geral guia do Criar configuração do DocuSign página, especifique um Nome para a configuração e selecione Próxima. Opcionalmente, é possível especificar um Título.

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

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

    1. Abra uma janela do navegador e faça logon no DocuSign conta do desenvolvedor.
    2. Abra o aplicativo configurado para AEM Forms.
    3. No URI de redirecionamento adicione o URL copiado 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 de OAuth para um DocuSign e obter 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 guia URL do 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 do DocuSign).

  8. Selecionar Conectar-se ao DocuSign. Quando as credenciais forem solicitadas, forneça o nome de usuário e a senha da conta usada ao criar DocuSign aplicação. Quando for solicitado que você confirme o acesso de your developer account, clique em Permitir acesso. Se as credenciais estiverem corretas, uma mensagem de sucesso será exibida.

  9. Selecionar Criar para criar o DocuSign 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 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.

Uso DocuSign em um Formulário adaptável enabledocusign

Você pode ativar DocuSign para um Formulário adaptável existente ou criar um DocuSign Formulário adaptável ativado. 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. Selecionar Criar e selecione Formulário adaptável. Uma lista de modelos é exibida. Selecione um modelo e selecione Próxima.

  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 enquanto integração DocuSign com AEM Forms.

    O contêiner de configuração contém o DocuSign Cloud Service configurado 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 a Associar o modelo de formulário como o documento de modelo de registro e selecione um modelo de Documento 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 o 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. Selecionar Criar. Um Formulário adaptável habilitado para assinatura é criado. Você pode adicionar seu DocuSign ao formulário e envie-o para assinatura.

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

  7. No Envio , selecione Enviar com assinaturas eletrônicas do DocuSign do Ação de envio lista suspensa.

  8. No Configuração de ação , selecione Adicionar para adicionar um recipient e especificar o endereço de email do recipient. Selecionar Adicionar novamente para adicionar mais recipients.

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

  10. Selecionar Salvar para salvar as propriedades.

Ativar 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. No Básico , selecione a contêiner de configuração criado durante a integração 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 a Associar o modelo de formulário como o documento de modelo de registro e selecione um modelo de Documento 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 o 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. Selecionar Salvar e fechar. O formulário adaptável está ativado para DocuSign. Agora, você pode adicionar seu DocuSign ao formulário e envie-o para assinatura.

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

  7. No Envio , selecione Enviar com assinaturas eletrônicas do DocuSign do Ação de envio lista suspensa.

  8. No Configuração de ação , selecione Adicionar para adicionar um recipient e especificar o endereço de email do recipient. Selecionar Adicionar novamente para adicionar mais recipients.

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

  10. Selecionar Salvar para salvar as propriedades.

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