Para descargar la muestra de código completa, consulte nuestro sitio Code Share.
Una vez enviada una transacción para su firma, puede recuperar todas las firmas en un documento específico, para un firmante específico. Use el siguiente código para hacerlo:
Si necesita una comparación con el procedimiento básico de creación de objetos o si es la primera vez que crea una transacción, consulte Crear y enviar una transacción.
Firs, recupera su objeto DocumentPackage. Use el siguiente código para hacerlo:
DocumentPackage sentPackage = client.getPackage(packageId);
Entonces, utilizando el OneSpan SignApprovalService, puede recuperar todas las firmas. Utilice los objetos DocumentPackage, SignatureID y documentID como parámetros. Use el siguiente código para hacerlo:
List<Signature> signer1SignableSignatures = client.getApprovalService().getAllSignableSignatures(sentPackage, documentId, signer1Id);
Finalmente, puede recorrer cada firma para recuperar cualquier información adicional, como el posicionamiento de la firma, la fecha aceptada y así sucesivamente.
for (Signature signature : signer1SignableSignatures){ System.out.println("Position of signature " + i + ": (" + signature.getX() + ", " + signature.getY() + ") on page " + signature.getPage()); i++; }
Si el paquete contiene un documento "Aceptar únicamente", el nodo de Aprobaciones no tendrá ninguna firma en él.
Resultados
A continuación, se muestra un ejemplo de lo que puede ver una vez que haya ejecutado su código.
Para descargar la muestra de código completa, consulte nuestro sitio Code Share.
Una vez enviada una transacción para su firma, puede recuperar todas las firmas en un documento específico, para un firmante específico. Use el siguiente código para hacerlo:
Si necesita una comparación con el procedimiento básico de creación de objetos o si es la primera vez que crea una transacción, consulte Crear y enviar una transacción.
Firs, recupera su objeto DocumentPackage. Use el siguiente código para hacerlo:
DocumentPackage sentPackage = client.GetPackage(packageId);
Entonces, utilizando el OneSpan SignApprovalService, puede recuperar todas las firmas. Utilice los objetos DocumentPackage, SignatureID y documentID como parámetros. Use el siguiente código para hacerlo:
IList<Signature> signer1SignableSignatures = client.ApprovalService.GetAllSignableSignatures(sentPackage, documentId, signer1Id);
Finalmente, puede recorrer cada firma para recuperar cualquier información adicional, como el posicionamiento de la firma, la fecha aceptada y así sucesivamente.
foreach (Signature signature in signer1SignableSignatures){ Debug.WriteLine("Position of signature " + i + ": (" + signature.X + ", " + signature.Y + ") on page " + signature.Page); i++; }
Si el paquete contiene un documento "Aceptar únicamente", el nodo de Aprobaciones no tendrá ninguna firma en él.
Resultados
A continuación, se muestra un ejemplo de lo que puede ver una vez que haya ejecutado su código.
Para descargar la muestra de código completa, consulte nuestro sitio Code Share.
Una vez que haya enviado la transacción para su firma, puede usar el siguiente código para recuperar todas las firmas de todos los firmantes de un documento y usar PackageID y documentID como parámetros.
Si necesita una comparación con el procedimiento básico de creación de objetos o si es la primera vez que crea una transacción, consulte Crear y enviar una transacción.
Solicitud HTTP
GET /api/packages/{packageId}/documents/{documentId}
Encabezados HTTP
Accept: application/json; esl-api-version=11.21 Authorization: Basic api_key
Carga útil de respuesta
{ "description": "", "id": "ddcad715b41ed28d0d8b16580c829501f35d5ed836d800c0", "index": 0, "name": "purchase_order", "approvals": [ { "id": "UMxe8ClLfEYK", "role": "15be0c69-b672-4314-9ffd-d3da69770caa", "signed": null, "accepted": null, "fields": [...], "name": "" }, { ... } ], ... }
Para obtener una descripción completa de cada campo, consulte la tabla Carga útil de solicitud siguiente.
Entonces, puede recorrer cada firma para recuperar cualquier información adicional, como el posicionamiento de la firma, la fecha aceptada y así sucesivamente.
También puede recuperar todas las firmas de un firmante específico en uno o varios documentos. Para recuperar firmas de un solo documento, utilice el siguiente código:
Solicitud HTTP
GET /api/packages/{packageId}/documents/{documentId}/signers/{signerId}/approvals
Encabezados HTTP
Accept: application/json; esl-api-version=11.21 Authorization: Basic api_key
Carga útil de respuesta
[ { "id": "eZDydIrS1XQV", "optional": false, "name": "", "enforceCaptureSignature": false, "accepted": "2019-08-12T16:01:00Z", "signed": "2019-08-12T16:01:02Z", "role": "50a3431e-04e2-49b1-81c8-a5e2bc550932", "fields": [...], ... }, { ... } ]
Para recuperar todas las firmas de la transacion, elimine el /documents/{documentId}" de la ruta URL. Use el siguiente código para hacerlo:
Solicitud HTTP
GET /api/packages/{packageId}/signers/{signerId}/approvals
Encabezados HTTP
Accept: application/json; esl-api-version=11.21 Authorization: Basic api_key
Carga útil de respuesta
[ { "documentId": "efc058bf9f0c261947c62a8d199be5d5ea6495ca102c8076", "approvals": [ ... ] }, { "documentId": "default-consent", "approvals": [ { "id": "339df19b-e8ee-4dd0-bdb8-d4f38bc368c5", "enforceCaptureSignature": false, "accepted": "2019-08-12T16:00:56Z", "signed": "2019-08-12T16:00:56Z", "role": "50a3431e-04e2-49b1-81c8-a5e2bc550932", "optional": false, "fields": [], "name": "", "data": null } ] }, { "documentId": "91a88db05a2f122ab214ef6f5933219658ade8d81b7f1035", "approvals": [] } ]
En la carga útil de respuesta, se enumeran todos los ID de documento con las firmas asignadas al firmante. Si el destinatario no tiene ninguna firma en un documento, la matriz de aprobaciones estará vacía.
Resultados
A continuación, se muestra un ejemplo de lo que puede ver una vez que haya ejecutado su código.
Tabla de carga útil de solicitud
Propiedad | Tipo | Editable | Obligatorio | Predeterminado | Valores de ejemplo |
---|---|---|---|---|---|
description | string | Sí | No | n/a | documento de consentimiento de muestra |
id | string | Sí | No | n/a | ddcad715b41ed28d0d8b16580c829501f35d5ed836d800c0 |
extract | boolean | Sí | No | false | true / false |
index | integer | Sí | No | 0 | 0 / 1 / 2 ... |
name | string | Sí | No | n/a | purchase_order |
data | |||||
ese_document_texttag_extract_needed | boolean | Sí | No | false | false / true |
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 |
pages | |||||
id | string | No | No | n/a | n/a |
top | integer | No | No | 0 | n/a |
height | integer | No | No | 1030 | n/a |
width | integer | No | No | 796 | n/a |
left | integer | No | No | 0 | n/a |
index | integer | No | No | 0 | n/a |
version | integer | No | No | 0 | n/a |
Para descargar la muestra de código completa, consulte nuestro sitio Code Share.
Una vez enviada una transacción para su firma, puede recuperar todas las firmas en un documento específico, para un firmante específico. Use el siguiente código para hacerlo:
Si necesita una comparación con el procedimiento básico de creación de objetos o si es la primera vez que crea una transacción, consulte Crear y enviar una transacción.
Firs, recupera su PackageID. Use el siguiente código para hacerlo:
Entonces, puede recuperar todas las firmas. Utilice PackageID SignatureID y documentID como parámetros. Use el siguiente código para hacerlo:
public List<ESignLiveAPIObjects.Approval> getAllSignableSignatures(String packageId, String documentId, String signerId)
Finalmente, puede recorrer cada firma para recuperar cualquier información adicional, como el posicionamiento de la firma, la fecha aceptada y así sucesivamente.
List<ESignLiveAPIObjects.Approval> allSignableSignatures = getAllSignableSignatures(packageId, documentId, signerId); for(ESignLiveAPIObjects.Approval approval: allSignableSignatures){ System.debug('Approval ID: ' + approval.id); if(approval.fields != null && approval.fields.size() > 0){ for(ESignLiveAPIObjects.Field field: approval.fields){ System.debug('----Field ID:' + field.id + ', TYPE: ' + field.type + ' ' + field.subtype); } } }
Si el paquete contiene un documento "Aceptar únicamente", el nodo de Aprobaciones no tendrá ninguna firma en él.
Resultados
A continuación, se muestra un ejemplo de lo que puede ver una vez que haya ejecutado su código.