Conecte AEM Forms as a Cloud Service con Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms
Adobe Acrobat Sign activa los flujos de trabajo de firma electrónica para flujos de trabajo adaptables de Forms y de AEM. Las firmas electrónicas mejoran los flujos de trabajo para procesar documentos para el área legal, ventas, nóminas, administración de recursos humanos y muchas más.
Cuando se trabaja con Adobe Acrobat Sign y los formularios adaptables, normalmente los usuarios rellenan un formulario adaptable para solicitar un servicio. Por ejemplo, una solicitud de tarjeta de crédito y un formulario de solicitud para una prestación. Cuando un usuario rellena, envía y firma el formulario de solicitud, este se envía al proveedor de servicios para que realice más acciones. El proveedor de servicios revisa la solicitud y utiliza Adobe Acrobat Sign para marcarla como aprobada. AEM Forms es compatible tanto con Adobe Acrobat Sign como con Adobe Acrobat Sign Solutions para el gobierno. Según la licencia y los requisitos, puede integrar o conectar AEM Forms con cualquiera de las soluciones:
Conectar AEM Forms con Adobe Acrobat Sign adobe-sign
Para conectar AEM Forms con Adobe Acrobat Sign, configure el software y las cuentas enumerados en la sección de requisitos previos y configure Adobe Sign Cloud Service en sus instancias Autor as a Cloud Service y Publicación de Forms:
Requisitos previos para conectar AEM Forms con Adobe Acrobat Sign prerequisites-for-adobe-sign
Para integrar Adobe Acrobat Sign con AEM Forms se requiere la siguiente configuración:
- Una cuenta activa de desarrollador de Adobe Acrobat Sign.
- Una aplicación API de Adobe Acrobat Sign.
- Las credenciales (ID de cliente y Secreto de cliente) de la aplicación API de Adobe Acrobat Sign;
- (solo para la autenticación basada en documentos de identidad del gobierno) Habilitar el método de autenticación para la autenticación de documentos de identidad del gobierno.
Conectar las instancias de autor y publicación de AEM Forms con Adobe Acrobat Sign configure-adobe-sign-with-aem-forms
Una vez cumplidos los requisitos previos, realice los siguientes pasos para configurar Adobe Acrobat Sign con AEM Forms en las instancias de autor.
-
En la instancia de autor de AEM Forms, vaya a Herramientas
-
En la página Explorador de configuración, seleccione Crear.
-
En el cuadro de diálogo Crear configuración, especifique un Título para la configuración, habilite Configuraciones de nube y seleccione Crear. Crea un contenedor de configuración para almacenar servicios en la nube. Asegúrese de que el nombre de la carpeta no contenga ningún espacio.
-
Vaya a Herramientas
note note NOTE Cuando cree un formulario adaptable, especifique el nombre del contenedor en el campo Contenedor de configuración. -
En la página de configuración, seleccione Crear para crear una configuración de Adobe Acrobat Sign en AEM Forms.
-
En la pestaña General de la página Crear configuración de Adobe Acrobat Sign, especifique un Nombre para la configuración y seleccione Siguiente. Si lo desea, puede especificar un Título y examinar los archivos para seleccionar una miniatura para la configuración.
-
Ahora puede Seleccionar solución para seleccionar Adobe Acrobat Sign.
-
Copie la URL presente en la ventana actual del explorador en un bloc de notas y quite la parte
/ui#/aemdesde la URL. La URL modificada es necesaria para configurar la Adobe Acrobat Sign aplicación con AEM Forms, en un paso posterior. Seleccione Siguiente. -
En la pestaña Configuración,
-
el campo URL de OAuth contiene la dirección URL predeterminada que incluye la partición de la base de datos Adobe Sign. El formato de la URL es el siguiente:
https://<shard>/public/oauth/v2Por ejemplo:
https://secure.na1.echosign.com/public/oauth/v2 -
el campo URL de token de acceso contiene la dirección URL predeterminada que incluye la partición de la base de datos Adobe Sign. El formato de la URL es el siguiente:
https://<shard>/oauth/v2/tokenPor ejemplo:
https://api.na1.echosign.com/oauth/v2/token
donde:
na1 hace referencia a la partición predeterminada de la base de datos. Puede modificar el valor de la partición de la base de datos. Asegúrese de que las configuraciones en la nube de Adobe Acrobat Sign apuntan a la partición correcta.
note note NOTE - Mantenga abierta la página Crear la configuración de Adobe Acrobat Sign. No la cierre. Puede recuperar la ID de cliente y el Secreto de cliente después de configurar OAuth para la aplicación Adobe Acrobat Sign como se describe en los pasos siguientes.
- Después de iniciar sesión en su cuenta de Adobe Sign, vaya a la API de Acrobat Sign > Información de API > Documentación de métodos de API de REST > Token de acceso de OAuth para acceder a información relacionada con la URL de OAuth de Adobe Sign y la URL del token de acceso.
-
-
Configure OAuth para la aplicación Adobe Acrobat Sign:
-
Abra una ventana del explorador e inicie sesión en su cuenta de desarrollador de Adobe Acrobat Sign.
-
Seleccione la aplicación configurada para AEM Forms y seleccione Configurar OAuth para aplicación.
-
En el cuadro URL de redireccionamiento, añada la URL copiada en el paso anterior (Paso 8) y haga clic en Guardar.
-
Habilite el siguiente ámbito para la aplicación Adobe Acrobat Sign y haga clic en Guardar.
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
Para obtener información paso a paso sobre cómo configurar OAuth para una aplicación Adobe Acrobat Sign y obtener las claves, consulte la documentación para desarrolladores Configurar OAuth para la aplicación.
-
-
Vuelva a la página Crear configuración de Adobe Acrobat Sign. En la pestaña Configuración, especifique el [ID de cliente (también denominado como ID de aplicación) y el Secreto de cliente]. Utilice el ID de cliente y el Secreto de cliente de la aplicación Adobe Acrobat Sign que creó en el paso anterior.
-
Seleccione la opción Habilitar Adobe Acrobat Sign para archivos adjuntos para anexar los archivos adjuntos a un formulario adaptable al documento de Adobe Acrobat Signcorrespondiente enviado para su firma.
-
Seleccione Conectar a Adobe Acrobat Sign. Cuando se le soliciten credenciales, indique el nombre de usuario y la contraseña de la cuenta utilizada al crear la Adobe Acrobat Signaplicación. Cuando se le pida que confirme, acceda a
your developer account, haga clic en Permitir acceso. Si las credenciales son correctas y permite a AEM Forms acceder a su cuenta de desarrollador de Adobe Acrobat Sign, aparecerá un mensaje de éxito similar al siguiente.
-
Seleccione Crear para crear la configuración de Adobe Acrobat Sign.
-
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.
-
Repita todos los pasos anteriores en las instancias de desarrollador, fase y producción (cualquiera de las restantes) para completar la configuración de Adobe Acrobat Sign con AEM Forms para su entorno.
Ahora puede usar Agregar campos de Adobe Acrobat Sign a un formulario adaptable. Asegúrese de agregar el contenedor de configuración utilizado para Cloud Service a todos los formularios adaptables habilitados para Adobe Acrobat Sign. Puede especificar un contenedor de configuración desde las propiedades de un formulario adaptable.
Solución de problemas resolve-config-error
Cuando se conecta Adobe Acrobat Sign con AEM Forms y buscar un error Unable to authorize access because the client configuration is invalid: invalid_request como se muestra en la siguiente imagen. Para solucionarlo, siga los pasos que se indican a continuación:
- Copie la URL presente en la ventana actual del explorador en un bloc de notas y elimine la parte
/ui#/aemdesde la dirección URL. - Abra una ventana del explorador e inicie sesión en su cuenta de desarrollador de Adobe Acrobat Sign.
- Seleccione la aplicación configurada para AEM Forms y seleccione Configurar OAuth para aplicación.
- En el URL de redireccionamiento , añada la URL copiada en el paso anterior y haga clic en Guardar.
Conectar AEM Forms con Adobe Acrobat Sign Solutions para el gobierno adobe-acrobat-sign-for-government
La conexión de AEM Forms con Adobe Acrobat Sign Solutions para el gobierno es un proceso de varios pasos. Implica:
- La creación de una URL de redireccionamiento para sus casos de AEM
- Uso compartido de la URL de redireccionamiento y los ámbitos con el equipo de Adobe Sign Solutions para el gobierno
- Recibiendo credenciales del equipo de Adobe Sign
- Uso de las credenciales recibidas para conectar AEM Forms con Adobe Acrobat Sign Solutions para el gobierno
AEM Forms as a Cloud Service proporciona entornos de desarrollo, de fase y de producción. Puede comenzar conectando su entorno de desarrollo para con Adobe Acrobat Sign Solutions para el gobierno y conectar los entornos de fase y producción más adelante.
Antes de comenzar prerequisites-for-adobe-sign-for-acrobat-sign-for-government
Antes de empezar a conectar AEM Forms con la solución de Adobe Acrobat Sign, asegúrese de que su cuenta de Adobe Acrobat Sign Solutions para gobierno está aprovisionada.
Conexión de AEM Forms as a Cloud Service con Adobe Acrobat Sign Solutions para el gobierno connect-adobe-acrobat-sign-for-government
Cree una URL de redireccionamiento para la instancia de AEM
- En la instancia de autor as a Cloud Service de Forms, navegue hasta Herramientas
- En la página Explorador de configuración, seleccione Crear.
- En el cuadro de diálogo Crear configuración, especifique un Título para la configuración, habilite Configuraciones de nube y seleccione Crear. Crea un contenedor de configuración para almacenar servicios en la nube. Asegúrese de que el nombre de la carpeta no contenga ningún espacio.
- Navegue hacia Herramientas
- En la página de configuración, seleccione Crear para crear una configuración de Adobe Acrobat Sign en AEM Forms.
- Copie la URL de la ventana del explorador actual en un bloc de notas y quite
/ui#/aemde la URL. Esta URL se denominare-direct URL.
En la siguiente sección, comparta lare-direct URLyScopescon el equipo de Adobe Sign y las credenciales de solicitud (ID de cliente y Secreto de cliente).
Comparta la URL de redireccionamiento y los ámbitos con el equipo de Adobe Sign y reciba las credenciales
El equipo de Adobe Acrobat Sign para soluciones gubernamentales requiere que se habilite la re-direct URL y los determinados ámbitos para su aplicación de Adobe Acrobat Sign (enumerados a continuación) para generar credenciales (ID de cliente y Secreto de cliente) que le permitan conectar AEM Forms con Adobe Acrobat Sign Solutions para el gobierno.
Comparta la scopes (enumeradas a continuación) y cree y anote el último paso de re-direct URL de la sección anterior con su representante de Adobe Acrobat Sign para soluciones gubernamentales (miembro del equipo de Adobe Professional Services).
Ámbitos
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
- offline_access
El representante genera y comparte credenciales con usted. En la siguiente sección, utilice las credenciales (ID de cliente y Secreto de cliente) para conectar AEM Forms con Adobe Acrobat Sign Solutions para el gobierno.
Utilice las credenciales recibidas para conectar AEM Forms con Adobe Acrobat Sign Solutions para el gobierno
-
Abra la
re-direct URLen su explorador. Ha creado y anotado lare-direct URLen el último paso del cree una URL de redireccionamiento en la instancia AEM de la sección. -
En la pestaña General de la página Crear configuración de Adobe Sign, especifique un Nombre para la configuración y seleccione Siguiente. Si lo desea, puede especificar un Título y examinar los archivos para seleccionar una miniatura para la configuración. Haga clic en Siguiente.
-
En la pestaña de Configuración de la página Crear configuración de Adobe Sign, para la opción de Seleccionar solución, seleccione Adobe Acrobat Sign Solutions for Government.
-
En el Correo electrónico completado, especifique la dirección de correo electrónico asociada a su cuenta de Adobe Acrobat Sign Solutions para el gobierno.
-
En la pestaña Configuración,
-
el campo URL de OAuth contiene la dirección URL predeterminada que incluye la partición de la base de datos Adobe Sign. El formato de la URL es el siguiente:
https://<shard>/api/gateway/adobesignauthservice/api/v1/authorizePor ejemplo:
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/authorize -
el campo URL de token de acceso contiene la dirección URL predeterminada que incluye la partición de la base de datos Adobe Sign. El formato de la URL es el siguiente:
https://<shard>/api/gateway/adobesignauthservice/api/v1/tokenPor ejemplo:
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/token
donde:
na1 hace referencia a la partición predeterminada de la base de datos. Puede modificar el valor de la partición de la base de datos. Asegúrese de que las configuraciones en la nube de Adobe Acrobat Sign apuntan a la partición correcta.
note note NOTE - Después de iniciar sesión en su cuenta de Adobe Sign, vaya a API de Acrobat Sign > Información de API > Documentación de métodos de API de REST > Token de acceso de OAuth para acceder a información relacionada con la URL de autenticación de Adobe Sign y la URL del token de acceso.
-
-
Use las credenciales compartidas por Adobe Acrobat Sign para el representante de soluciones gubernamentales ([miembro del equipo de Adobe Professional Services]) en la sección anterior como [ID de cliente y Secreto del cliente].
-
Seleccione la opción Habilitar Adobe Acrobat Sign para archivos adjuntos para anexar los archivos adjuntos a un formulario adaptable al documento de Adobe Acrobat Signcorrespondiente enviado para su firma.
-
Seleccione Conectar con Adobe Sign. Cuando se le soliciten credenciales, indique el nombre de usuario y la contraseña de la cuenta utilizada al crear la aplicación Adobe Acrobat Sign. Cuando se le pida que confirme el acceso de
your developer account, haga clic en Permitir acceso. Si las credenciales son correctas y permite a AEM Forms acceder a su cuenta de desarrollador de Adobe Acrobat Sign, aparecerá un mensaje de éxito similar al siguiente.
-
Seleccione Crear para crear la configuración.
-
Seleccione la configuración y haga clic en Publicar, seleccione la configuración y haga clic en Publicar. Esto reproducirá la configuración en los entornos de publicación correspondientes.
-
Repita todos los pasos anteriores en las instancias de desarrollador, fase y producción (cualquiera de las restantes) para completar la configuración de Adobe Acrobat Sign Solutions for Government con AEM Forms para su entorno.
Ahora puede utilizar agregar campos de Adobe Acrobat Sign en un formulario adaptable o Flujo de trabajo de AEM. Asegúrese de agregar el contenedor de configuración utilizado para Cloud Service a todos los formularios adaptables habilitados para Adobe Acrobat Sign. Puede especificar un contenedor de configuración desde las propiedades de un formulario adaptable.
Configure el planificador Adobe Acrobat Sign para sincronizar el estado de la firma configure-adobe-sign-scheduler-to-sync-the-signing-status
AEM Forms as a Cloud Service, proporciona un servicio de planificador que comprueba el estado de los firmantes a intervalos definidos. Los escenarios en los que se configura el servicio de planificador:
- Si utiliza Enviar el formulario (después de que cada destinatario complete la ceremonia de firma) para firmar un documento, el formulario se enviará solo después de que todos los firmantes hayan firmado el formulario.
- Si usa el Paso Firmar en un flujo de trabajo de AEM para firmar un documento, el paso firmar espera a que todos los firmantes firmen el documento antes de continuar con el siguiente paso del flujo de trabajo.
De forma predeterminada, los servicios del planificador Adobe Acrobat Sign comprueban (sondean) la respuesta de los firmantes cada 24 horas. Puede cambiar el intervalo predeterminado para su entorno.
Para cambiar el intervalo predeterminado, especifique una expresión Cron para la propiedad sign.status.exp de la configuración del servicio de configuración de Adobe Acrobat Sign.
Por ejemplo, para ejecutar el servicio de configuración diariamente a las 00:00 a. m., establezca la propiedad sign.status.exp de la configuración del servicio de configuración de Adobe Acrobat Sign para especificar 0 0 0 1/1 * ? *. El siguiente archivo JSON muestra el ejemplo para ejecutar el servicio de configuración diariamente a las 00:00 a. m.:
{
"sign.status.exp":"0 0 0 1/1 * ? *"
}
Para establecer los valores de una configuración, Generar configuraciones OSGi mediante el SDK de AEM e implemente la configuración a su instancia de Cloud Service.