Forzar la captura de firmas

  Signature enforceCaptureSignature = SignatureBuilder.captureFor("[email protected]")   .onPage(0)   .atPosition(100, 200)   .enableEnforceCaptureSignature()   .build();  

Para descargar la muestra de código completa, consulte nuestro sitio Code Share.

En OneSpan Sign, a los firmantes solo se les pedirá que firmen una vez de forma predeterminada. Si la transacción requiere varias firmas en el documento, OneSpan Sign replicará automáticamente la primera firma realizada para las firmas posteriores. Sin embargo, tiene la opción de exigir a su firmante que firme en una determinada captura de firma. Este tema se centrará en la aplicación de la captura de firmas a nivel de firma.

Si desea forzarlo en el nivel de transacción, lo que se encargaría de forzar que todas las firmas de captura se plasmen repetidamente, consulte la Configuración de la experiencia para firmantes.

Forzar la captura de firmas

Para habilitar esta función, simplemente agregue la opción enableEnforceCaptureSignature() a su generador de firmas, como se ve a continuación:

  Signature enforceCaptureSignature = SignatureBuilder.CaptureFor("[email protected]")   .WithId(new SignatureId("Signature1"))   .OnPage(0)   .AtPosition(100, 200)   .EnableEnforceCaptureSignature()   .Build();  

Tenga en cuenta lo siguiente:

• De forma predeterminada, enforceCaptureSignature" se establece en false tanto en el nivel de transacción como en el de firma. Esto significa que no necesita hacer nada si no desea utilizar esta función.

• A diferencia de la configuración true enforceCaptureSignature en el nivel de transacción, que requiere que el firmante capture la firma en cada aprobación de captura, en el nivel de firma enforceCaptureSignature solo obliga al firmante a capturar su firma cuando la aprobación contiene la configuración "true".

Resultados

En este ejemplo, mostramos tres aprobaciones en las que solo la segunda firma fue marcada como "forzar captura". Esto es lo que verá después de la firma de la transacción:

Para la segunda firma, debido a que habilitamos el ajuste enforceCaptureSignature, verá que la firma difiere de la primera y sobrescribe al mismo tiempo los datos de firma almacenados en caché. Por lo tanto, la firma recién capturada se replica automáticamente cuando el firmante firma el tercer campo.

Para descargar la muestra de código completa, consulte nuestro sitio Code Share.

En OneSpan Sign, a los firmantes solo se les pedirá que firmen una vez de forma predeterminada. Si la transacción requiere varias firmas en el documento, OneSpan Sign replicará automáticamente la primera firma realizada para las firmas posteriores. Sin embargo, tiene la opción de exigir a su firmante que firme en una determinada captura de firma. Este tema se centrará en la aplicación de la captura de firmas a nivel de firma.

Si desea forzarlo en el nivel de transacción, lo que se encargaría de forzar que todas las firmas de captura se plasmen repetidamente, consulte la Configuración de la experiencia para firmantes.

Forzar la captura de firmas

La siguiente solicitud de ejemplo le muestra cómo establecer enforceCaptureSignature : true en el nivel de aprobación.

Solicitud HTTP

POST /api/packages

Encabezados HTTP

Accept: application/json   
Content-Type: application/json   
Authorization: Basic api_key 

Carga útil de solicitud

  ------WebKitFormBoundary1bNO60n7FqP5WO4t   Content-Disposition: form-data; name="file"; filename="enforce capture signature.pdf"   Content-Type: application/pdf   %PDF-1.5   %µµµµ   1 0 obj   <>>>   endobj....   ------WebKitFormBoundary1bNO60n7FqP5WO4t   Content-Disposition: form-data; name="payload"   {   "documents": [   {   "approvals": [   {   "fields": [   {   "height": 50,   "id": "Signature1",   "left": 100,   "page": 0,   "subtype": "CAPTURE",   "top": 100,   "type": "SIGNATURE",   "width": 200   }   ],   "id": "Signature1",   "role": "signer1"   },   {   "fields": [   {   "height": 50,   "id": "Signature2",   "left": 100,   "page": 0,   "subtype": "CAPTURE",   "top": 200,   "type": "SIGNATURE",   "width": 200   }   ],   "id": "Signature2",   "role": "signer1",   "enforceCaptureSignature": true   },   {   "fields": [   {   "height": 50,   "id": "Signature3",   "left": 100,   "page": 0,   "subtype": "CAPTURE",   "top": 300,   "type": "SIGNATURE",   "width": 200   }   ],   "id": "Signature3",   "role": "signer1"   }   ],   "name": "Document1",   "id": "Document1"   }   ],   "name": "test Enforce Capture at Signature Level",   "roles": [   {   "id": "signer1",   "signers": [   {   "email": "[email protected]",   "firstName": "John",   "id": "signer1",   "lastName": "Smith"   }   ]   }   ],   "type": "PACKAGE",   "status": "SENT"   }   ------WebKitFormBoundary1bNO60n7FqP5WO4t--  

Para obtener una descripción completa de cada campo, consulte la tabla Carga útil de solicitud siguiente.

Carga útil de respuesta

 {   "id": "Q6v0Tn_v62G5tfRY43VBE-TEbU4="   } 

Tenga en cuenta lo siguiente:

• De forma predeterminada, enforceCaptureSignature" se establece en false tanto en el nivel de transacción como en el de firma. Esto significa que no necesita hacer nada si no desea utilizar esta función.

• A diferencia de la configuración true enforceCaptureSignature en el nivel de transacción, que requiere que el firmante capture la firma en cada aprobación de captura, en el nivel de firma enforceCaptureSignature solo obliga al firmante a capturar su firma cuando la aprobación contiene la configuración "true".

Resultados

En este ejemplo, mostramos tres aprobaciones en las que solo la segunda firma fue marcada como "forzar captura". Esto es lo que verá después de la firma de la transacción:

Para la segunda firma, debido a que habilitamos el ajuste enforceCaptureSignature, verá que la firma difiere de la primera y sobrescribe al mismo tiempo los datos de firma almacenados en caché. Por lo tanto, la firma recién capturada se replica automáticamente cuando el firmante firma el tercer campo.

Tabla de carga útil de solicitud

Propiedad	Tipo	Editable	Obligatorio	Predeterminado	Valores de ejemplo
Propiedad	Tipo	Editable	Obligatorio	Predeterminado	Valores de ejemplo
status	string	Sí	No	BORRADOR	BORRADOR / ENVIADO / COMPLETADO / ARCHIVADO / RECHAZADO / ELEGIR NO HACERLO / CADUCÓ
type	string	Sí	No	PAQUETE	PAQUETE / FORMULARIO / FORMATO
name	string	Sí	Sí	n/a	Ejemplo de forzar la captura de la firma
documents
name	string	Sí	No	n/a	sample doc
approvals
fields
subtype	string	Sí	No	n/a	NOMBRE COMPLETO / INICIALES / CAPTURA / CAPTURA_MÓVIL / ETIQUETA / CAMPO DE TEXTO / ÁREA DE TEXTO / CASILLA DE VERIFICACIÓN / FECHA / RADIO / LISTA
type	string	Sí	No	n/a	FIRMA / ENTRADA
extract	boolean	Sí	No	false	true / false
height	integer	Sí	No	50	50 / 100 / 150 ...
left	integer	Sí	No	0	50 / 100 / 150 ...
page	integer	Sí	No	0	0 / 1 / 2 ...
top	integer	Sí	No	0	50 / 100 / 150 ...
width	integer	Sí	No	200	50 / 100 / 150 ...
role	string	Sí	No	n/a	Client1
enforceCaptureSignature	boolean	Sí	No	false	true / false
roles
id	string	Sí	No	n/a	Client1
name	string	Sí	No	n/a	Client1
type	string	Sí	No	FIRMANTE	FIRMANTE / REMITENTE
signers
email	string	Sí	Sí	n/a	[email protected]
firstName	string	Sí	Sí	n/a	Ernesto
lastName	string	Sí	Sí	n/a	Puente
phone	string	Sí	No	n/a	514-555-8888
id	string	Sí	No	n/a	Client1
company	string	Sí	No	n/a	Acme Inc.
title	string	Sí	No	n/a	Directora General