Usar DocuSign con un formulario adaptable

DocuSign es una solución destacada de firma electrónica. Puede utilizarla para firmar un acuerdo electrónicamente. Puede integrar DocuSign con un formulario adaptable. Le ayuda a enviar un formulario adaptable para firmas electrónicas a varios destinatarios. El uso de firmas electrónicas le ayuda a lo siguiente:

  • Cerrar acuerdos desde cualquier dispositivo con procesos de propuesta, presupuesto y contrato totalmente automatizados.
  • Finalizar los procesos de Recursos Humanos más rápido y ofrecer a sus empleados las experiencias digitales.
  • Reducir los tiempos de ciclo de contrato e incorporar a sus proveedores más rápido.

AEM Forms as a Cloud Service ofrece una acción de envío personalizada para DocuSign. La acción de envío le ayuda a enviar los formularios adaptables para las firmas electrónicas mediante las API de DocuSign.

También puede utilizar la solución de firma electrónica de Adobe, Adobe Sign, para firmar electrónicamente un formulario adaptable. AEM Forms posee una integración mucho más profunda con Adobe Sign y ofrece controles mucho más precisos, como firma secuencial y paralela, varios métodos de autenticación, experiencia de firma en formularios y mucho más. Para obtener más información, consulte Usar Adobe Sign en un formulario adaptable.

Requisitos previos

Se requiere lo siguiente para integrar DocuSign con AEM Forms:

Configurar la acción de envío personalizada y servicio en la nube para DocuSign

AEM Forms as a Cloud Service ofrece una acción de envío personalizada para DocuSign. La acción de envío le ayuda a enviar los formularios adaptables para las firmas electrónicas mediante las API de DocuSign. El código para la acción de envío personalizada está disponible en el repositorio GIT público de muestras de AEM Forms. Puede implementar el código tal como figura en su entorno de AEM Forms o personalizarlo según los requisitos de su organización.

Realice los siguientes pasos para configurar la acción de envío personalizada y el servicio en la nube de DocuSign predeterminados:

  1. Clone su proyecto de AEM Forms as a Cloud Service o cree un Experience Manager Forms como proyecto de Cloud Service basado en el tipo de archivo 27 de AEM o posterior. Para crear un Experience Manager Forms como proyecto de Cloud Service basado en un tipo de archivo de AEM:

    Abra la solicitud de comando y ejecute el siguiente comando para crear un proyecto de Experience Manager Forms 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"
    

    Además, cambie appTitle, appIdy groupId, en el comando anterior para reflejar su entorno.

  2. Clone el repositorio aem-forms-samples. Este repositorio contiene una acción de envío personalizada para los detalles de DocuSign y configuración para conectarse con el servidor de DocuSign.

  3. Abra el proyecto de AEM Forms as a Cloud Service creado en el paso 1 para editarlo en el IDE de su elección.

  4. Abra el archivo [AEM Forms as a Cloud Service project]\pom.xml para editarlo y realice los cambios siguientes:

    1. Añada el siguiente texto al final de la etiqueta <properties>:

      <repository.location>maven_repository</repository.location>
      
    2. Añada el siguiente texto al final de la etiqueta <repositories>:

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

      Si no hay etiqueta <repositories>, cree la etiqueta tras la etiqueta <properties>.

    3. Añada el siguiente texto al final de la etiqueta <dependencyManagement>:

       <dependency>
         <groupId>com.adobe.aemforms.samples</groupId>
         <artifactId>forms.integration.docusign.all</artifactId>
         <type>zip</type>
         <version>1.0.0</version>
       </dependency>
      
  5. Siga estos pasos en el archivo all/pom.xml disponible en la carpeta del proyecto de Cloud Service:

    1. Añada el siguiente texto al final de la etiqueta <embeddeds>:

       <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. Añada el siguiente texto al final de la etiqueta <dependencies>:

       <dependency>
          <groupId>com.adobe.aemforms.samples</groupId>
          <artifactId>forms.integration.docusign.all</artifactId>
          <type>zip</type>
       </dependency>
      
  6. Abra la solicitud de comando y vaya a aem-forms-samples\forms-integration-docusign (clonado en el paso 3) y ejecute el siguiente comando:

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

    <AEM Forms as a Cloud Service project path> hace referencia al nombre de la carpeta creada en el paso 1 de este procedimiento.

  7. Implemente el proyecto en su entorno de desarrollo local. Puede utilizar el siguiente comando para implementarlo en su entorno de desarrollo local

    mvn -PautoInstallPackage clean install

    Tras ejecutar estos pasos, puede ver una nueva acción de envío personalizada Enviar con firmas electrónicas de DocuSign disponible en la lista de opciones de envío para un formulario adaptable y una configuración del servicio en la nube DocuSign en su entorno de desarrollo local.

  8. Compile e implemente el código en su entorno de AEM Forms as a Cloud Service.

Integrar DocuSign con AEM Forms

Una vez cumplidos los requisitos previos, realice los siguientes pasos para integrar DocuSign con AEM Forms en las instancias de autor.

  1. Vaya a Herramientas martillo > Cloud Services > DocuSign y seleccione una carpeta para hospedar la configuración.

  2. En la página de configuraciones, pulse Crear para crear una configuración de DocuSign en AEM Forms.

  3. En la pestaña General de la página Crear la configuración de DocuSign, especifique un Nombre para la configuración y pulse Siguiente. Si lo desea, puede especificar un Título.

  4. Copie la URL de la ventana actual del explorador en un bloc de notas. La URL es necesaria para configurar la aplicación DocuSign con AEM Forms en un paso posterior.

  5. Configure OAuth para la aplicación DocuSign:

    1. Abra una ventana del explorador e inicie sesión en su cuenta de desarrollador de DocuSign.
    2. Abra la aplicación configurada para AEM Forms.
    3. En el cuadro URI de redireccionamiento, añada la URL copiada en el paso anterior y haga clic en Guardar.
    4. Tenga en cuenta la integración y las claves secretas.

    Para obtener información paso a paso sobre cómo configurar OAuth para una aplicación DocuSign y obtener las claves, consulte la documentación para desarrolladores Configurar OAuth para la aplicación.

  6. Vuelva a la página Crear la configuración de DocuSign. En la pestaña Configuración, el campo URL de OAuth menciona la siguiente URL predeterminada:

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

  7. Especifique el ID del cliente (clave de integración de DocuSign) y el secreto del cliente (clave secreta de DocuSign).

  8. Pulse Conectarse a DocuSign. Cuando se le soliciten credenciales, indique el nombre de usuario y la contraseña de la cuenta utilizada al crear la aplicación DocuSign. Cuando se le pida que confirme el acceso para your developer account, haga clic en Permitir acceso. Si las credenciales son correctas, aparecerá un mensaje de éxito.

  9. Pulse Crear para crear la configuración de DocuSign.

  10. Seleccione la configuración y haga clic en Publicar, seleccione la configuración y haga clic en Publicar. Esto replicará la configuración en los entornos de publicación correspondientes.

  11. Repita todos los pasos anteriores en las instancias de desarrollador, fase y producción (cualquiera de las restantes) para completar la configuración de DocuSign con AEM Forms para su entorno.

Ahora, su entorno de AEM Forms está configurado para utilizar DocuSign. Asegúrese de agregar el contenedor de configuración utilizado para Cloud Service a todos los formularios adaptables habilitados para DocuSign. Puede especificar un contenedor de configuración desde las propiedades de un formulario adaptable.

Utilizar DocuSign en un formulario adaptable

Puede habilitar DocuSign para un formulario adaptable existente o crear un formulario adaptable con DocuSign habilitado. Elija una de las acciones siguientes:

Crear un formulario adaptable para DocuSign

Para crear un formulario adaptable habilitado para firmar:

  1. Vaya a Adobe Experience Manager > Forms > Formularios y documentos.

  2. Pulse Crear y seleccione Formulario adaptable. Aparece una lista de plantillas. Seleccione una plantilla y toque Siguiente.

  3. En la pestaña Básico:

    1. Especifique el Nombre y el Título para el formulario adaptable.

    2. Seleccione el contenedor de configuración creado al integrarse DocuSign con AEM Forms.
      El contenedor de configuración contiene DocuSign Cloud Service configurado para su entorno. Estos servicios están disponibles para su selección en el editor de formularios adaptables.

  4. En la pestaña Modelo de formulario, seleccione una de las siguientes opciones:

    • Si tiene una plantilla de formulario personalizada y necesita un documento de registro basado en la plantilla de formulario, seleccione la opción Asociar plantilla de formulario como la plantilla de documento de registro y elija una plantilla de documento de registro. Cuando se utiliza la opción, los documentos enviados para firmar solo muestran los campos basados en la plantilla de formulario asociada. No muestra todos los campos del formulario adaptable.

    • Si no cuenta con una plantilla de formulario personalizada, seleccione la opción Generar documento de registro. Cuando se utiliza la opción, el documento enviado para firmar muestra todos los campos del formulario adaptable.

  5. Pulse Crear. Se crea un formulario adaptable con firma habilitada. Puede agregar campos de DocuSign al formulario y enviarlo para su firma.

  6. Abra el formulario adaptable en modo de edición. En la pestaña Contenido, pulse Contenedor del formulario y pulse Configurar.

  7. En la sección Envío, seleccione Enviar con firmas electrónicas de DocuSign de la lista desplegable Enviar acción.

  8. En la sección Configuración de la acción, pulse Añadir para agregar un destinatario y especificar la dirección de correo electrónico del destinatario. Pulse Añadir para agregar más destinatarios.

  9. Especifique el asunto del mensaje de correo electrónico en el campo Asunto del correo electrónico. Seleccione Incluir archivos adjuntos para incluir archivos adjuntos en el mensaje de correo electrónico.

  10. Pulse Guardar para guardar las propiedades.

Habilitar DocuSign para un formulario adaptable

Para usar DocuSign en un formulario adaptable existente:

  1. Vaya a Adobe Experience Manager > Forms > Formularios y documentos.

  2. Seleccione el formulario adaptable y pulse Propiedades.

  3. En la pestaña Básico, seleccione el contenedor de configuración creado al integrarse DocuSign con AEM Forms.

  4. En la pestaña Modelo de formulario, seleccione una de las siguientes opciones:

    • Si tiene una plantilla de formulario personalizada y necesita un documento de registro basado en la plantilla de formulario, seleccione la opción Asociar plantilla de formulario como la plantilla de documento de registro y elija una plantilla de documento de registro. Cuando se utiliza la opción, los documentos enviados para firmar solo muestran los campos basados en la plantilla de formulario asociada. No muestra todos los campos del formulario adaptable.

    • Si no cuenta con una plantilla de formulario personalizada, seleccione la opción Generar documento de registro. Cuando se utiliza la opción, el documento enviado para firmar muestra todos los campos del formulario adaptable.

  5. Pulse Guardar y cerrar. El formulario adaptable está habilitado para DocuSign. Ahora, puede agregar campos de DocuSign al formulario y enviarlo para su firma.

  6. Abra el formulario adaptable en modo de edición. En la pestaña Contenido, pulse Contenedor del formulario y pulse Configurar.

  7. En la sección Envío, seleccione Enviar con firmas electrónicas de DocuSign de la lista desplegable Enviar acción.

  8. En la sección Configuración de la acción, pulse Añadir para agregar un destinatario y especificar la dirección de correo electrónico del destinatario. Pulse Añadir para agregar más destinatarios.

  9. Especifique el asunto del mensaje de correo electrónico en el campo Asunto del correo electrónico. Seleccione Incluir archivos adjuntos para incluir archivos adjuntos en el mensaje de correo electrónico.

  10. Pulse Guardar para guardar las propiedades.

En esta página