Guía del usuario Cancelar

Acrobat Sign para Salesforce: Guía de solución de problemas

¿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

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:

Uso de la asignación de combinación y asignación de datos para enviar acuerdos: Ejemplo de escenario 

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:

  1. En el objeto “Acuerdo” de Acrobat Sign, cree un campo de búsqueda para el objeto “Demo 1”.
  2. En el objeto “Demo 1”, cree un campo de búsqueda para el objeto “Demo 2”.
    No puede extraer ni insertar información de una lista relacionada. 
  3. Cree una plantilla de asignación de datos de la siguiente manera:
    1. Indique un nombre único para la plantilla.
    2. Bajo Asignaciones de campos, seleccione Objeto seleccionado y, a continuación, en el menú desplegable, seleccione Demo 1
    3. En el segundo menú desplegable que se carga, seleccione Demo 2 ID.
    4. En el tercer menú desplegable que se carga, déjelo como “Ninguno”, y elija Seleccionar.
    5. Para “¿Qué campo de Salesforce desea actualizar?”, elija el nombre del campo que necesita actualizar. 
    6. 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.
  4. Cree una plantilla de asignación de combinación de la siguiente manera:
    1. Indique un nombre único para la plantilla.
    2. Seleccione Añadir asignación de campos
    3. Bajo Valor de origen, seleccione Objeto seleccionado, y, a continuación, en el menú desplegable, seleccione Demo 1
    4. En el segundo menú desplegable que se carga, seleccione ID de demo 2.
    5. En el siguiente menú desplegable que se cargue, seleccione el nombre del campo con el valor que necesita extraer y haga clic en Hecho.
    6. 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.
  5. Cree una plantilla de acuerdo siguiendo los pasos en Crear flujos de trabajo de plantilla.
  6. 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”.
  7. En la sección Detalles de plantilla de la plantilla Acuerdo, seleccione el objeto de Salesforce como Demo 1.
  8. Seleccione Asignar datos a campos de acuerdo y, a continuación, en el cuadro de diálogo que aparece,
    1. elija la opción Seleccionar desde objeto.
    2. Bajo Tipo de origen, seleccione ID de demo 1.
    3. Bajo Campo de acuerdo de destino, seleccione el objeto Demo 1 en el campo de búsqueda.
    4. Seleccione Guardar
  9. En la plantilla del acuerdo, seleccione Guardar.
    Crea una plantilla de acuerdo vinculada al objeto “Demo 1” con la asignación de combinación y la asignación de datos activadas. 
  10. 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.
  11. 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. 
  12. Seleccione Siguiente y Guardar.
  13. Vaya al registro de objeto “Demo 1” y actualice la página. Debería mostrar el panel “AgreementPanel” que ha añadido.
  14. Seleccione Enviar acuerdo para firmar. Muestra la plantilla de acuerdo que ha creado.
  15. 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”. 
  16. Firme el acuerdo. Muestra el registro “Demo 2” actualizado con el valor del acuerdo. 

Error en la solución de problemas al enviar acuerdos desde Salesforce

Si no puede enviar acuerdos desde Salesforce, ejecute los siguientes pasos de solución de problemas:  

  1. Asegúrese de tener una versión compatible de Adobe Acrobat Sign. Consulte las versiones compatibles.

  2. Asegúrese de que, como remitente, dispone de los permisos necesarios.
    Consulte 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.

  3. 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 para ver si se resuelve.
    Si el acuerdo se envía correctamente después de deshabilitar las personalizaciones, consulte nuestra guía para desarrolladores para obtener directrices.

    Nota:

    No proporcionamos compatibilidad para solucionar problemas de personalización.

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

  5. 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
    O

    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:

    1. Marca el campo Remitente registrado en el registro del acuerdo para identificar al remitente del acuerdo.
      Si no se encuentra un usuario en el campo Remitente registrado en Salesforce, el paquete de Acrobat Sign utilizará el campo Creado por como el “remitente” del acuerdo.
    2. Ve a la página Detalles de usuario del remitente en Salesforce y asegúrate de que el campo Correo electrónico tenga una dirección de correo electrónico válida y una licencia de Sign para empresas activa. Para comprobar si la dirección de correo electrónico tiene una licencia de Sign para empresas activa:
      1. Inicia sesión en Acrobat Sign con credenciales de administrador.
      2. Ve a Cuenta > Usuarios y busca la dirección de correo electrónico.
      3. El estado del usuario debe ser activo. Los usuarios que no tengan el estado “activo” no pueden enviar acuerdos. Si el usuario no está activo, descubre cómo Agregar y administrar usuarios y consulta los pasos que se indican en la sección “El correo electrónico está en uso, pero el estado del usuario no es Activo”.
      4. Si se utiliza Enviar en nombre de (SOB), valida la dirección de correo electrónico seleccionando el campo Enviar en nombre de en el objeto Acuerdo. Asegúrate de que la dirección de correo electrónico de este usuario tenga una licencia de Sign válida iniciando sesión en Acrobat Sign. Asegúrate de que el campo Permitir el envío como otros usuarios está habilitado en la página Detalles del usuario del usuario SOB. Este campo puede no estar visible de forma predeterminada en el diseño de página del objeto Usuario.
    3. Comprueba los permisos de usuario como se indica en el Paso 2 anterior. Consulta Cómo conceder el acceso requerido a los usuarios.

    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.

Solución de problemas de errores en la actualización del estado automática 

Si un acuerdo no se actualiza con el estado correcto, ejecute los siguientes pasos de solución de problemas:

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

  2. 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”.

    salesforce-faq-estado-actualización-activado

    Si no ve el mensaje, siga estos pasos:

    1. Cierre la sesión y vuelva a iniciarla como administrador del sistema.
    2. Vaya a Administrador de Adobe Acrobat Sign > Habilitar las actualizaciones de estado automáticas y seleccione Habilitar.
    3. En el cuadro de diálogo “Permitir acceso a Acrobat Sign” que aparece:
      1. Anote la dirección de correo electrónico en la parte inferior del cuadro de diálogo.
      2. 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.
      3. Asegúrese de que el usuario tenga asignado el conjunto de permisos “Usuario de Adobe Sign Integration”. 
      4. Seleccionar Permitir.

    En ella debe aparecer el mensaje “Las actualizaciones de estado automáticas están habilitadas para esta organización”.

  3. 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>'

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

  5. 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”). 

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

    salesforce-faq-actualización-acuerdo

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

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

Solución de problemas que pueden producirse después de habilitar los dominios mejorados 

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.

Solución de problemas al buscar posibles clientes en el entorno de la nube gubernamental

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:

  1. Vaya a Configuración > Gestor de objetos y, a continuación, busque Posible cliente.
  2. En el panel izquierdo, seleccione Campos y relaciones.
  3. 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:
    1. Seleccione cualquier campo que desee comprobar. Por ejemplo, seleccione Móvil.
    2. Para todos los usuarios para los que desee habilitar el acceso a los campos, seleccione la casilla de verificación Visible.
    3. Seleccione Guardar.
Envía acuerdos a sus posibles clientes desde Acrobat Sign para Salesforce en la nube gubernamental.

Envía acuerdos a sus posibles clientes desde Acrobat Sign para Salesforce en la nube gubernamental.

Comuníquese con el servicio de asistencia

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>

Obtén ayuda de forma más rápida y sencilla

¿Nuevo usuario?