Para descargar la muestra de código completa, consulte nuestro sitio Code Share.
Una vez completada una transacción, puede recuperar los valores ingresados en los campos por los firmantes.
Crear y enviar una transacción con campos
El primer paso es crear y enviar una transacción que tenga campos de texto. Para obtener más información, consulte Agregar campos.
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.
Una vez firmada la transacción, puede recuperar los valores del campo.
Recuperar valores de campos
Para recuperar valores de campo, recupere el ID de su transacción completada y cree un objeto PackageId. Use el siguiente código para hacerlo:
PackageId packageId = new PackageId( "-flBLByWAFTxTKAM54ywiOgeOnI=" );
Una vez hecho esto, utilice su cliente OneSpan Sign para recuperar los resúmenes de campo de su transacción completada. Los resúmenes de campos se le devuelven como una lista. El siguiente código de ejemplo recorrerá cada resumen de campo e imprimirá el ID del firmante, el ID del documento, el ID del campo y el valor del campo.
List<FieldSummary> fieldSummaries = eslClient.getFieldValues( packageId );
System.out.println( "SignerId || DocumentId || FieldId: Value\n" );
for ( FieldSummary fieldSummary : fieldSummaries ) {
System.out.println( fieldSummary.getSignerId() + " || " + fieldSummary.getDocumentId() + " || " +
fieldSummary.getFieldId() + ": " + fieldSummary.getFieldValue() );
}
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 completada una transacción, puede recuperar los valores ingresados en los campos por los firmantes.
Crear y enviar una transacción con campos
El primer paso es crear y enviar una transacción que tenga campos de texto. Para obtener más información, consulte Agregar campos.
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.
Una vez firmada la transacción, puede recuperar los valores del campo.
Recuperar valores de campos
Para recuperar valores de campo, recupere el ID de su transacción completada y cree un objeto PackageId. Use el siguiente código para hacerlo:
PackageId packageId = new PackageId( "-flBLByWAFTxTKAM54ywiOgeOnI=" );
Una vez hecho esto, utilice su cliente OneSpan Sign para recuperar los resúmenes de campo de su transacción completada. Los resúmenes de campos se le devuelven como una lista. El siguiente código de ejemplo recorrerá cada resumen de campo e imprimirá el ID del firmante, el ID del documento, el ID del campo y el valor del campo.
List<FieldSummary> fieldSummaries = eslClient.FieldSummaryService.GetFieldSummary( packageId );
Console.WriteLine( "SignerId || DocumentId || FieldId: Value" );
foreach ( FieldSummary fieldSummary in fieldSummaries )
{
Console.WriteLine( fieldSummary.SignerId + " || " + fieldSummary.DocumentId + " || " +
fieldSummary.FieldId + ": " + fieldSummary.FieldValue );
}
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 completada una transacción, puede recuperar los valores ingresados en los campos por los firmantes.
Crear y enviar una transacción con campos
El primer paso es crear y enviar una transacción que tenga campos de texto. Para obtener más información, consulte Agregar campos.
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.
Una vez firmada la transacción, puede recuperar los valores del campo.
Recuperar valores de campos
Actualmente, hay dos enfoques para recuperar los valores de los campos. Uno de ellos es llamar directamente a la siguiente API:
Solicitud HTTP
GET /api/packages/{packageId}/fieldSummary?documentId={documentId}
Encabezados HTTP
Accept: application/json Content-Type: application/json Authorization: Basic api_key
Carga útil de respuesta
[
{
"signerId": "4b4714f7-3a28-45c4-9358-ef7dc8b86b20",
"documentId": "574df947cae73f63ebfc07626e20b931e59e4cb90efadcdc",
"fieldId": "AAoJoUVf3r8J",
"fieldName": "",
"fieldValue": "2019-01-18T16:39:39Z"
},
{
"signerId": "4b4714f7-3a28-45c4-9358-ef7dc8b86b20",
"documentId": "574df947cae73f63ebfc07626e20b931e59e4cb90efadcdc",
"fieldId": "3jEcVDlEmC4E",
"fieldName": "",
"fieldValue": "this is a text area"
},
{
"signerId": "4b4714f7-3a28-45c4-9358-ef7dc8b86b20",
"documentId": "574df947cae73f63ebfc07626e20b931e59e4cb90efadcdc",
"fieldId": "CGceQcEa38oN",
"fieldName": "",
"fieldValue": "this is a text field"
},
{
"signerId": "4b4714f7-3a28-45c4-9358-ef7dc8b86b20",
"documentId": "574df947cae73f63ebfc07626e20b931e59e4cb90efadcdc",
"fieldId": "sYjj7qPHPP0Y",
"fieldName": "",
"fieldValue": "X"
}
]
Tenga en cuenta lo siguiente:
El parámetro de consulta documentId es opcional. Si no se especifica, se devolverán los valores de los campos de todos los documentos.
Para cada nodo en JSON de respuesta, signerId se refiere en realidad al ID de la función. Esto permanecerá como "nulo" hasta que el firmante haya firmado.
Alternativamente, puede recuperar primero los metadatos del documento específico utilizando la siguiente API y, a continuación, analizar la respuesta y recorrer todos los campos.
Solicitud HTTP
GET /api/packages/{packageId}/documents/{documentId}Encabezados HTTP
Accept: application/json Content-Type: application/json Authorization: Basic api_key
Carga útil de respuesta
{
"status": "",
"description": "",
"id": "sample-contract",
"signerVerificationToken": null,
"signedHash": null,
"extractionTypes": [
"TEXT_TAGS"
],
"data": {
"ese_document_texttag_autofielddateformat": "dd/MM/yyyy 'GMT'",
"ese_document_texttag_json_0": "[{\"height\":6,\"left\":162.95,\"name\":\"{{esl:signer1:initials:size(200,50)}}\",\"page\":0,\"pageHeight\":792,\"pageWidth\":612,\"top\":135.87,\"width\":1.88397},{\"height\":6,\"left\":72.1,\"name\":\"{{esl:signer2:initials:size(200,50)}}\",\"page\":0,\"pageHeight\":792,\"pageWidth\":612,\"top\":197.45,\"width\":1.88397}]",
"ese_document_texttag_extract_needed": "true",
"ese_document_texttag_handled_roles": "[\"signer2\",\"signer1\"]"
},
"approvals": [
{
"role": "signer1",
"id": "5d98a944-1499-4e89-a91c-a90516a382fa",
"data": null,
"signed": "2017-11-07T20:25:13Z",
"accepted": "2017-11-07T20:25:12Z",
"fields": [
{
"binding": null,
"validation": null,
"id": "5d98a944-1499-4e89-a91c-a90516a382fa",
"page": 0,
"data": null,
"subtype": "INITIALS",
"height": 50,
"width": 200,
"left": 211,
"top": 176,
"extract": false,
"extractAnchor": null,
"value": "",
"name": "5d98a944-1499-4e89-a91c-a90516a382fa",
"type": "SIGNATURE"
}
],
"name": "5d98a944-1499-4e89-a91c-a90516a382fa"
},
{
"role": "signer2",
"id": "09b320a7-1ae5-4ce4-8d29-93822a10287b",
"data": null,
"signed": "2017-11-07T20:19:47Z",
"accepted": "2017-11-07T20:19:46Z",
"fields": [
{
"binding": null,
"validation": null,
"id": "09b320a7-1ae5-4ce4-8d29-93822a10287b",
"page": 0,
"data": null,
"subtype": "INITIALS",
"height": 50,
"width": 200,
"left": 94,
"top": 256,
"extract": false,
"extractAnchor": null,
"value": "",
"name": "09b320a7-1ae5-4ce4-8d29-93822a10287b",
"type": "SIGNATURE"
}
],
"name": "09b320a7-1ae5-4ce4-8d29-93822a10287b"
}
],
"pages": [
{
"id": "",
"height": 1030,
"width": 796,
"left": 0,
"top": 0,
"index": 0,
"version": 0
}
],
"external": null,
"extract": true,
"index": 0,
"fields": [],
"name": "Test Document",
"size": 189550
}A continuación, deberá analizar la respuesta a JObject y recorrer cada objeto de campo e imprimir el ID del firmante, el ID del documento, el ID del campo y el valor del campo.
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 completada una transacción, puede recuperar los valores ingresados en los campos por los firmantes.
Crear y enviar una transacción con campos
El primer paso es crear y enviar una transacción que tenga campos de texto. Para obtener más información, consulte Agregar campos.
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.
Una vez firmada la transacción, puede recuperar los valores del campo.
Recuperar valores de campos
Para recuperar los valores de campo, recupere el ID de su transacción completada y use la siguiente función encapsulada para recuperar los resúmenes de campo de su transacción completada.
public List<TestFieldValues.FieldSummary> getFieldValues(String packageId)
Una vez hecho esto, utilice su cliente OneSpan Sign para recuperar los resúmenes de campo de su transacción completada. Los resúmenes de campos se le devuelven como una lista. El siguiente código de ejemplo recorrerá cada resumen de campo e imprimirá el ID del firmante, el ID del documento, el ID del campo y el valor del campo.
List<TestFieldValues.FieldSummary> fieldSummarys = getFieldValues('ZkFpiKRSLubIVJFyFC3jezR-084=');
for(TestFieldValues.FieldSummary fieldSummary: fieldSummarys){
System.debug(fieldSummary.signerId + ' || ' + fieldSummary.documentId + ' || ' + fieldSummary.fieldId + ' || ' + fieldSummary.fieldValue);
}
Resultados
A continuación, se muestra un ejemplo de lo que puede ver una vez que haya ejecutado su código.
