Last modified: 2023-11-30

Actualizar campos mediante programación

Después de crear una Convención de OneSpan Sign, los usuarios que creen transacciones manualmente pueden usar la convención para automatizar ciertas tareas. En lugar de tener que realizar esas tareas manualmente, el hecho de que se realicen automáticamente ahorra tiempo a los usuarios.

Concretamente, los usuarios pueden ejecutar programas para hacer lo siguiente automáticamente: 

  • Posicionar campos de OneSpan Sign en varios documentos para varios destinatarios mediante etiquetas de texto
  • Actualizar campos de OneSpan Sign con datos de Salesforce mediante asignaciones de campos (la función Insertar)
  • Actualizar campos de Salesforce con datos de OneSpan Sign mediante asignaciones de campos (la función Reescritura)

En las siguientes secciones, se describe cómo:

Actualizar campos de OneSpan Sign

La función Insertar copia un valor de un campo de Salesforce (por ejemplo, Nombre) en un campo correspondiente de un documento de OneSpan Sign cuando se está preparando una transacción. Después, esos datos pueden recuperarse del documento firmado. Los datos en cuestión pueden ser datos sobre un destinatario o datos sobre un objeto relacionado de Salesforce.

Para utilizar un programa para insertar automáticamente datos de la base de datos de Salesforce en un campo de entrada de un documento de OneSpan Sign:

  1. Escriba un código que: (a) cree la transacción; (b) adjunte a la transacción una convención adecuada, documentos adecuados, destinatarios adecuados, etc.
  2. Si su convención contiene etiquetas de texto, los campos se crearán y posicionarán automáticamente en los documentos de OneSpan Sign.

  3. Agregue a ese código el siguiente parámetro de URL: "Insert=1" O "Insert=true". Su código debe parecerse al siguiente ejemplo:
  4. /apex/esl__package?ParentId={!Account.Id}&Name={!Account.Name}%20Agreement&
    			Documents=00P36000000wwrd&ConventionId=a0836000000nfRo&
    		Signer1=00336000003gBYX&Signer1Label=a0K36000001j8V&Insert=1

En este caso:

  • Signer1Label es el SalesforceId de la etiqueta de destinatario que se aplicará a Signer1.
  • ConventionId es el SalesforceId de la convención que se utilizará.
  1. Cree un botón personalizado que ejecute ese código. Al hacer clic en ese botón, debería ver todos los datos insertados de Salesforce en la transacción creada.

Actualizar campos de Salesforce (Reescritura)

La función Reescritura de una asignación de campos puede actualizar automáticamente los datos de los campos de Salesforce a partir de documentos de OneSpan Sign.

Por ejemplo, imagine que: (1) un destinatario advierte durante la Signer Experience que su dirección es errónea en un documento de la transacción de OneSpan Sign; (2) el destinatario corrige su dirección en ese documento.

Si esa dirección de OneSpan Sign se asignó a un campo de un objeto relacionado de Salesforce y se marcó la opción Reescritura para esa asignación, cuando la transacción de OneSpan Sign se complete, la dirección actualizada se escribirá en el campo de Salesforce.

Los datos que se reescribirán en Salesforce se deben ingresar durante la Signer Experience.

Para usar un programa para actualizar un campo de Salesforce con los datos de un documento de OneSpan Sign cuando la transacción asociada se ha completada:

  1. Escriba un código que: (a) cree la transacción; (b) adjunte a la transacción una convención adecuada, documentos adecuados, destinatarios adecuados, etc.
  2. Si su convención contiene etiquetas de texto, los campos se crearán y posicionarán automáticamente en los documentos de OneSpan Sign.

  3. Agregue a ese código el siguiente parámetro de URL: "Writeback=1" O "Writeback=true". Su código debe parecerse al siguiente ejemplo:

/apex/esl__package?ParentId={!Account.Id}&Name={!Account.Name}%20Agreement&

Documents=00P36000000wwrd&ConventionId=a0836000000nfRo&

Signer1=00336000003gBYX&Signer1Label=a0K36000001j8V&Writeback=1

En este caso:

  • Signer1Label es el SalesforceId de la etiqueta de destinatario que se aplicará a Signer1.
  • ConventionId Es el SalesforceId de la convención que se utilizará.
  1. Cree un botón personalizado que ejecute ese código. Al hacer clic en ese botón una vez completada la transacción de OneSpan Sign, los datos actualizados durante la Signer Experience deberían aparecer en el campo de Salesforce asociado.
Was this information helpful?
X