DocumentaciónAEM as a Cloud ServiceGuía del usuario

Usar DocuSign con un formulario adaptable integrate-aem-forms-with-DocuSign

Last update: Wed Feb 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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 prerequisites

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 deploy-custom-submit-action

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:

    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"

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

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

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

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

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

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

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

    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> 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 configure-docusign-with-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, seleccione  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 seleccione 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. Seleccione  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. Seleccione  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 enabledocusign

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 create-an-adaptive-form-for-docusign

Para crear un formulario adaptable habilitado para firmar:

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

  2. Seleccione  Crear y seleccione Formulario adaptable. Aparece una lista de plantillas. Seleccione una plantilla y seleccione  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. Seleccione  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, seleccione  Contenedor del formulario y seleccione 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, seleccione Añadir para agregar un destinatario y especificar la dirección de correo electrónico del destinatario. Seleccione  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. Seleccione  Guardar para guardar las propiedades.

Habilitar DocuSign para un formulario adaptable editafsign

Para usar DocuSign en un formulario adaptable existente:

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

  2. Seleccione el formulario adaptable y seleccione  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. Seleccione  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, seleccione Contenedor del formulario  y seleccione 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, seleccione Añadir  para agregar un destinatario y especificar la dirección de correo electrónico del destinatario. Seleccione  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. Seleccione  Guardar para guardar las propiedades.

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