En la página de Salesforce Lightning, vaya a la pestaña Administrador de Adobe Acrobat Sign.
Última actualización el
16 oct. 2024
¿No puede enviar acuerdos desde Salesforce? ¿Las asignaciones de datos no actualizan los campos de Salesforce?
Adobe Acrobat Sign para Salesforce: Guía de solución de problemas está diseñada para ayudarle a resolver problemas al enviar acuerdos desde Salesforce, asignaciones de datos o actualizaciones de estado automáticas. Vea cómo:
- Fallo al solucionar problemas de asignaciones de datos
- Solucionar problemas de envío de acuerdos
- Solucionar problemas de actualizaciones de estado automáticas
- Solución de problemas que pueden producirse después de habilitar los dominios mejorados
- La solución de problemas consiste en buscar clientes potenciales en el entorno de la nube gubernamental
- Comuníquese con el servicio de asistencia
Las asignaciones de datos de Acrobat Sign actualizan los objetos de Salesforce cuando se firma un acuerdo con Acrobat Sign, o en alguna fase especificada del flujo de trabajo del acuerdo. Cada asignación de datos se configura por adelantado e incluye reglas de asignación de datos. Cada regla de asignación de datos define la fuente de datos y el campo de destino de Salesforce que debe actualizar. Para obtener más información, consulte Asignación de datos de Salesforce.
Si la asignación de datos no consigue actualizar un campo de Salesforce, ejecute los siguientes pasos de solución de problemas para identificar y corregir el problema:
Para hacerlo, debe seguir estos pasos:
Seleccionar Permitir. Aparece el mensaje ‘Las actualizaciones de estado automáticas están habilitadas para esta organización.’
Asegúrese de que el usuario de actualización de estado automática (normalmente el administrador de la cuenta de Sign que utilizó para configurar la integración) y que el remitente tenga acceso a los objetos que está intentando actualizar con la asignación de datos.
Para comprobar el valor del campo, puede añadir el campo a la vista de lista Acuerdos, utilizar la consola del desarrollador o utilizar el Área de trabajo.
Asegúrate de que el campo 'Resultado de asignación de datos' en el objeto 'Acuerdo' tenga el valor 'Completado' o 'Error'. Si no hay ningún valor, significa que la asignación de datos no se activó en absoluto. Si el valor está vacío y el campo “Asignación de datos” tiene el ID de usuario rellenado, intente volver a activar la asignación de datos de la siguiente manera:
El campo Error de asignación de datos almacena errores de asignación de datos. Puede comprobar el valor del campo añadiéndolo a la vista de lista Acuerdos, mediante la consola del desarrollador o mediante Workbench. A continuación se muestra una lista de errores comunes y los pasos de resolución correspondientes:
| Error | Failed to map data field: System.DmlException Update failed. Primera excepción en la fila 0 con id 00ZxxqwertasdmjVUAR; primer error: STRING_TOO_LONG, Título del propietario: valor de datos demasiado grande: Adobe Acrobat Sign Adobe Inc (longitud máxima=20): [Owner_Title__c] (echosign_dev1) 165 |
Resolución: Este error significa que los datos del campo de formulario del documento actualizado superan el límite de tamaño del campo de Salesforce que está intentando actualizar. Solución:
|
|
| Error |
Se ha intentado asignar a una referencia de objeto relacionado que no estaba establecida en el acuerdo: <api name of field on the Salesforce object you are trying to update>” |
Resolución: Este error significa que no hay ninguna conexión establecida entre el objeto Acuerdo y el objeto Salesforce que está intentando actualizar. Consulte el paso 4 anterior. |
|
| Error |
Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656 |
Resolución Este error indica que la asignación de datos ha fallado porque no ha podido acceder a un objeto necesario. Siga los pasos siguientes para resolver el problema:
|
Ejemplo de usuario:
Juan Martínez
Ejemplo de caso de uso:
Juan quiere:
- Enviar acuerdos desde un objeto personalizado denominado “Demo 1” mediante una plantilla de acuerdo,
- Extraiga información de otro objeto personalizado denominado “Demo 2” que esté asociado al objeto “Demo 1” e inserte en el acuerdo, y
- Inserte información en el registro de objeto “Demo 2” una vez firmado el acuerdo.
Pasos para lograr el caso práctico:
- En el objeto “Acuerdo” de Acrobat Sign, cree un campo de búsqueda para el objeto “Demo 1”.
- En el objeto 'Demo 1', crea un campo de búsqueda para el objeto 'Demo 2'.
No puedes extraer o enviar información desde/hacia una lista relacionada. - Cree una plantilla de asignación de datos de la siguiente manera:
- Indique un nombre único para la plantilla.
- Bajo Asignaciones de campos, seleccione Objeto seleccionado y, a continuación, en el menú desplegable, seleccione Demo 1.
- En el segundo menú desplegable que se carga, seleccione Demo 2 ID.
- En el tercer menú desplegable que se carga, déjelo como “Ninguno”, y elija Seleccionar.
- Para “¿Qué campo de Salesforce desea actualizar?”, elija el nombre del campo que necesita actualizar.
- Para completar la configuración de asignación de datos, siga los pasos que se indican en la sección Utilizar asignaciones de datos para insertar datos y archivos del firmante en los registros de Salesforce en la Guía de asignaciones y plantillas.
- Cree una plantilla de asignación de combinación de la siguiente manera:
- Indique un nombre único para la plantilla.
- Seleccione Añadir asignación de campos.
- Bajo Valor de origen, seleccione Objeto seleccionado, y, a continuación, en el menú desplegable, seleccione Demo 1.
- En el segundo menú desplegable que se carga, seleccione ID de demo 2.
- En el siguiente menú desplegable que se cargue, seleccione el nombre del campo con el valor que necesita extraer y haga clic en Hecho.
- Para completar la configuración de la asignación de combinación, siga esta sección Utilizar asignaciones de combinación para generar documentos con datos de Salesforce en la Guía de asignaciones y plantillas.
- Cree una plantilla de acuerdo siguiendo los pasos en Crear flujos de trabajo de plantilla.
- En la plantilla de acuerdo que creó anteriormente, asegúrese de que las plantillas de asignación de combinación y asignación de datos estén incluidas en la sección “Asignación de datos”.
- En la sección Detalles de plantilla de la plantilla Acuerdo, seleccione el objeto de Salesforce como Demo 1.
- Seleccione Asignar datos a campos de acuerdo y, a continuación, en el cuadro de diálogo que aparece,
- elija la opción Seleccionar desde objeto.
- Bajo Tipo de origen, seleccione ID de demo 1.
- Bajo Campo de acuerdo de destino, seleccione el objeto Demo 1 en el campo de búsqueda.
- Seleccione Guardar.
- En la plantilla de acuerdo, selecciona Guardar.
Crea una plantilla de acuerdo vinculada al objeto 'Demo 1' con asignación de combinación y asignación de datos habilitadas. - Abra un registro de objeto “Demo 1” y seleccione
> Editar página. A continuación, en la sección Personalizado administrado del panel izquierdo, arrastre y suelte AgreementPanel y seleccione Guardar. - Seleccione Activación y asigne la página de registro según sus necesidades. Para realizar pruebas, elija “Asignar como organización predeterminada” que muestra “AgreementPanel” a todos los usuarios.
- Seleccione Siguiente y Guardar.
- Vaya al registro de objeto “Demo 1” y actualice la página. Debería mostrar el panel “AgreementPanel” que ha añadido.
- Seleccione Enviar acuerdo para firmar. Muestra la plantilla de acuerdo que ha creado.
- Seleccione la plantilla del acuerdo y siga los pasos que aparecen en la pantalla para enviar el acuerdo. Verifique que el acuerdo incluya los datos combinados de “Demo 2”.
- Firme el acuerdo. Muestra el registro “Demo 2” actualizado con el valor del acuerdo.
Si no puede enviar acuerdos desde Salesforce, ejecute los siguientes pasos de solución de problemas:
Asegúrese de tener una versión compatible de Adobe Acrobat Sign. Consulte las versiones compatibles.
Asegúrate de que tú, como remitente, tengas los permisos necesarios.
Consulta Cómo conceder el acceso requerido a los usuarios. Además de los objetos y campos mencionados en la guía, el remitente debe tener acceso a otros objetos de Salesforce que se utilizan en el flujo de trabajo.
Compruebe si el objeto “Acuerdo” u otros objetos de Acrobat Sign en Salesforce tienen personalizaciones como activadores, flujos de trabajo o reglas. Si es así, desactiva todas las personalizaciones y envía un acuerdo de prueba para ver si se procesa.
Si el acuerdo se envía correctamente después de desactivar las personalizaciones, consulta nuestra guía para desarrolladores para obtener directrices.
Nota
No proporcionamos compatibilidad para solucionar problemas de personalización.
Utilice una de las siguientes formas de identificar el tipo de error que ha recibido al enviar el acuerdo:
- Abra el registro del acuerdo afectado en Salesforce y busque el titular en rojo con el mensaje de error. Este error debe indicar la causa raíz.
- Marque el campo “Mensaje de error” en el objeto “Notificación del acuerdo”.
- Para comprobarlo a través de Developer Console y ejecutar la siguiente consulta de SOQL:
Select echosign_dev1__Error_Message__c from
echosign_dev1__Agreement_Notification__c where
echosign_dev1__Agreement__c = ‘<enter agreement id>
Consulte la siguiente tabla de errores y pasos para resolverlos:
|
Error |
Solución |
|---|---|
|
Correo electrónico o ID de usuario no válido proporcionado en el encabezado de x-api-user No tienes una cuenta de usuario de Adobe Acrobat Sign válida |
Estos errores indican que el remitente no tiene una licencia válida de Acrobat Sign. Para solucionar los problemas:
|
|
No se admite el formato de archivo |
Este error se produce cuando el documento que está intentando enviar para firmar no está en un formato compatible. Consulte la sección Formatos de documento compatibles en Requisitos del sistema de Acrobat Sign para comprobar qué formatos de archivo se admiten para cargarlos a Acrobat Sign. |
|
Botón ID de objeto incorrecto utilizado en la firma |
Este error se produce cuando el ID de plantilla del botón Enviar en nombre de o el ID principal del objeto no es válido. Te recomendamos introducir el ID de objeto correcto y, a continuación, vuelve a intentar el proceso. |
Si un acuerdo no se actualiza con el estado correcto, ejecute los siguientes pasos de solución de problemas:
Compruebe que ha implementado los requisitos previos y las configuraciones posteriores a la instalación (necesarias) que se indican en la Guía de instalación de Adobe Acrobat Sign para Salesforce.
En la página de Salesforce Lightning, vaya al Administrador de Adobe Acrobat Sign > Habilitar las actualizaciones de estado automáticas, y asegúrese de que aparece el mensaje “Las actualizaciones de estado automáticas están habilitadas para esta organización”.
Si no ve el mensaje, siga estos pasos:
- Cierre la sesión y vuelva a iniciarla como administrador del sistema.
- Vaya a Administrador de Adobe Acrobat Sign > Habilitar las actualizaciones de estado automáticas y seleccione Habilitar.
- En el cuadro de diálogo “Permitir acceso a Acrobat Sign” que aparece:
- Anote la dirección de correo electrónico en la parte inferior del cuadro de diálogo.
- Asegúrese de que esta dirección de correo electrónico tenga una licencia válida de Sign y sea administrador del sistema en Salesforce.
- Asegúrese de que el usuario tenga asignado el conjunto de permisos “Usuario de Adobe Sign Integration”.
- Seleccionar Permitir.
En ella debe aparecer el mensaje “Las actualizaciones de estado automáticas están habilitadas para esta organización”.
En el objeto “Notificación del acuerdo”, compruebe el campo Mensaje de error. Para comprobar el valor del campo, ejecute la siguiente consulta de SOQL en Developer Console:
SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<agreementId>'
Si el acuerdo es un acuerdo de inserción creado fuera del entorno de Salesforce, asegúrese de seguir el Adobe Acrobat Sign para Salesforce: Guía de servicio de documentos grandes y acuerdos push.
Vaya a Configuración > Ajustes personalizados > Configuración de actualización del acuerdo de Adobe Sign > Administrar > Nuevo (o Editar). En la página que se abre, asegúrese de que la casilla de verificación Actualizar estado del acuerdo está activada (ubicada en “Valor predeterminado a nivel de organización”).
Vaya a la pestaña Acuerdos, seleccione todos los acuerdos que no se han actualizado y, a continuación, en la esquina superior derecha, seleccione Actualizar acuerdo.
Compruebe si el estado se actualiza en esos acuerdos. Si se actualizan ahora, compruebe si el problema se sigue reproduciendo con un nuevo acuerdo de prueba. Si es reproducible, continúe con los pasos de solución de problemas que se indican a continuación.
Si el problema no se puede reproducir, puede haber sido una instancia única, por lo que le recomendamos que consulte esta guía de solución de problemas cuando se vuelva a producir el problema.
Compruebe si el objeto “Acuerdo” u otros objetos de Acrobat Sign en Salesforce tienen personalizaciones como activadores, flujos de trabajo o reglas.
En caso afirmativo, desactive todas las personalizaciones y envíe un acuerdo de prueba siguiendo sus pasos habituales y compruebe si se cumple. El estado debe cambiar de “Borrador” a “Enviado para firmar”.
Si el estado del acuerdo cambia a “Enviado para firmar” después de desactivar las personalizaciones, consulte nuestra guía para desarrolladores para obtener directrices.
Si el estado no se actualiza, envíe un acuerdo de prueba directamente desde la pestaña “Acuerdos” con las personalizaciones desactivadas y compruebe si se cumple. Si el estado sigue sin cambiar, compruebe los pasos 1 y 2 mencionados anteriormente.
Nota
No proporcionamos compatibilidad para solucionar problemas de personalización.
| Objetos de Acrobat Sign | ||
|---|---|---|
| Añadir datos adjuntos de archivo | Asignaciones de archivos | Asignar datos en campos de acuerdo |
| Añadir plantillas en los campos del formulario | Importaciones de campo de formulario | Asignaciones de combinación |
| Agregar destinatarios | Asignación secundaria de campos del formulario | Mutexes |
| Acuerdos | Entrada Asignación secundaria de los campos del formulario | Asignaciones de objetos |
| Eventos del acuerdo | Asignaciones de campo de formulario | Destinatarios |
| Plantillas de acuerdo | Entradas de asignación de campos de formulario | Acuerdo firmado |
| Asignaciones de datos | Asignaciones en grupo | Desencadenadores |
| Asignaciones de campo | Plantillas de biblioteca | Resultados de la sincronización de usuario |
| Tipo de acuerdo | ||
Todas las organizaciones tienen activados de forma predeterminada los dominios mejorados de Salesforce, lo que no afecta al paquete Acrobat Sign para Salesforce. Sin embargo, los clientes que configuraron sus sitios para descargar archivos grandes e insertar acuerdos experimentan problemas cuando se habilitan sus dominios mejorados, lo que provoca cambios en las direcciones URL del sitio y acuerdos rotos.
Para garantizar el buen funcionamiento de los acuerdos, los clientes deben actualizar la configuración personalizada para las descargas de archivos grandes de modo que reflejen la URL actualizada del sitio.
Para actualizar la URL de devolución de llamada de acuerdos push, los clientes deben Contactar con asistencia y proporcionar la información requerida. Para obtener más información, consulte cómo Conseguir que los servicios individuales se configuren para su cuenta de Acrobat Sign.
Acrobat Sign para Salesforce permite buscar y añadir posibles clientes como destinatarios del acuerdo cuando se selecciona Posibles clientes como tipo de destinatario. Sin embargo, si los usuarios de la nube gubernamental crean posibles clientes, contactos o usuarios, pero no pueden encontrarlos mediante el campo Buscar, los administradores de la organización de Salesforce pueden seguir estos pasos de resolución:
- Vaya a Configuración > Gestor de objetos y, a continuación, busque Posible cliente.
- En el panel izquierdo, seleccione Campos y relaciones.
- Para todos los campos obligatorios (como Nombre, Correo electrónico, Móvil, etc.), compruebe la accesibilidad de los usuarios. Para hacerlo, debe seguir estos pasos:
- Seleccione cualquier campo que desee comprobar. Por ejemplo, seleccione Móvil.
- Para todos los usuarios para los que desee habilitar el acceso a los campos, seleccione la casilla de verificación Visible.
- Seleccione Guardar.
Si el problema no se resuelve después de seguir los pasos de solución de problemas anteriores, Contacte con asistencia y proporciónenos los siguientes detalles:
- Descripción del problema
- Dirección de correo electrónico del administrador de la cuenta de Acrobat Sign que se utilizó para configurar la integración
- Dirección de correo electrónico del administrador de la cuenta de Acrobat Sign que se utilizó para habilitar las actualizaciones de estado automáticas:
- Versión del paquete de Acrobat Sign instalada en Salesforce
- ID de organización de Salesforce
- Salesforce registra los ID de los acuerdos afectados
- Dirección de correo electrónico del usuario afectado
- ¿Se puede reproducir el problema de forma constante, intermitente o puntual?
- Fecha de la última ocurrencia: <Proporcione la fecha/hora/zona horaria de la última ocurrencia conocida>
- Pasos para reproducir el problema.
- Comportamiento esperado: <Describa el comportamiento que espera cuando se realizan los pasos>
- Notas de solución de problemas: <Proporcione los detalles de la solución de problemas llevada a cabo hasta el momento con esta documentación>
Optimizar tu trabajo con Acrobat Sign
Gestiona y firma documentos online de forma rápida y sencilla.
