Para descargar la muestra de código completa, consulte nuestro sitio Code Share.
Agregar una firma a un documento
Para agregar una firma a un documento, primero deberá crear el objeto Signature con OneSpan Sign SignatureBuilder. Use el siguiente código para hacerlo:
//Fullname signature style Signature signature1 = SignatureBuilder.signatureFor("[email protected]") .onPage(0) .atPosition(215, 510) .withSize(200, 50) .withId(new SignatureId("signature1")) .build(); //Handwritten signature style Signature signature2 = SignatureBuilder.captureFor("[email protected]") .onPage(0) .atPosition(215, 510) .withSize(200, 50) .withId(new SignatureId("signature2")) .build(); //Initials signature style Signature signature3 = SignatureBuilder.initialsFor("[email protected]") .onPage(0) .atPosition(215, 510) .withSize(200, 50) .withId(new SignatureId("signature3")) .build(); DocumentPackage createdPackage = client.getPackageService().getPackage(packageId);
Una vez que haya creado su objeto Signature , recupere su transacción utilizando el cliente OneSpan Sign. Entonces, con OneSpan Sign ApprovalService, agregue su firma al documento. Utilice los objetos DocumentPackage, Signature y documentID como parámetros. Use el siguiente código para hacerlo:
client.getApprovalService().addSignature(createdPackage, documentId, signature1);
Actualizar una firma en un documento
Puede actualizar una firma que ya se haya asociado a un documento. Use el siguiente código para hacerlo:
Signature updatedSignature = SignatureBuilder.captureFor("[email protected]") .onPage(0) .atPosition(215, 510) .withSize(300, 50) .withId(new SignatureId("signature1")) .build(); List<Signature> signatures = new ArrayList(); signatures.add(updatedSignature); DocumentPackage updatedPackage = client.getPackageService().getPackage(packageId); client.getApprovalService().updateSignatures(updatedPackage, documentId, signatures);
Al actualizar una firma, el nuevo objeto Signature debe tener el mismo id que la firma que desea actualizar.
Borrar una firma de un documento
La eliminación de una firma de un documento se realiza con OneSpan Sign ApprovalService. Utilice el PackageID, SignatureID y documentID como parámetros. Use el siguiente código para hacerlo:
client.getApprovalService().deleteSignature(packageId, documentId, new SignatureId("signature1"));
Resultados
Una vez que haya ejecutado su código, sus firmas aparecerán en los documentos de su transacción.
Para descargar la muestra de código completa, consulte nuestro sitio Code Share.
Agregar una firma a un documento
Para agregar una firma a un documento, primero deberá crear el objeto Signature con OneSpan Sign SignatureBuilder. Use el siguiente código para hacerlo:
//Fullname signature style Signature signature1 = SignatureBuilder.SignatureFor("[email protected]") .OnPage(0) .AtPosition(215, 510) .WithSize(200, 50) .WithId(new SignatureId("signature1")) .Build(); //Handwritten signature style Signature signature2 = SignatureBuilder.CaptureFor("[email protected]") .OnPage(0) .AtPosition(215, 510) .WithSize(200, 50) .WithId(new SignatureId("signature2")) .Build(); //Initials signature style Signature signature3 = SignatureBuilder.InitialsFor("[email protected]") .OnPage(0) .AtPosition(215, 510) .WithSize(200, 50) .WithId(new SignatureId("signature3")) .Build(); DocumentPackage createdPackage = client.GetPackage(packageId);
Una vez que haya creado su objeto Signature , recupere su transacción utilizando el cliente OneSpan Sign. Entonces, con OneSpan Sign ApprovalService, agregue su firma al documento. Utilice los objetos DocumentPackage, Signature y documentID como parámetros. Use el siguiente código para hacerlo:
client.ApprovalService.AddApproval(createdPackage, documentId, signature1);
Actualizar una firma en un documento
Puede actualizar una firma que ya se haya asociado a un documento. Use el siguiente código para hacerlo:
Signature updatedSignature = SignatureBuilder.CaptureFor("[email protected]") .OnPage(0) .AtPosition(215, 510) .WithSize(300, 50) .WithId(new SignatureId("signature1")) .Build(); IList<Signature> signatures = new List(); signatures.Add(updatedSignature); DocumentPackage updatedPackage = client.GetPackage(packageId); client.ApprovalService.UpdateApprovals(updatedPackage, documentId, signatures);
Al actualizar una firma, el nuevo objeto Signature debe tener el mismo id que la firma que desea actualizar.
Borrar una firma de un documento
La eliminación de una firma de un documento se realiza con OneSpan Sign ApprovalService. Utilice el PackageID, SignatureID y documentID como parámetros. Use el siguiente código para hacerlo:
client.ApprovalService.DeleteApproval(packageId, documentId, "signature1");
Resultados
Una vez que haya ejecutado su código, sus firmas aparecerán en los documentos de su transacción.
Para descargar la muestra de código completa, consulte nuestro sitio Code Share.
Agregar una firma a un documento
Para agregar una firma a un documento, primero deberá editar el objeto fields. Use el siguiente código para hacerlo:
Solicitud HTTP
POST /api/packages/{packageId}/documents/{documentId}/approvals
Encabezados HTTP
Accept: application/json Content-Type: application/json Authorization: Basic api_key
Carga útil de solicitud
{ "role": "Signer1", "id": "signature1", "fields": [ { "top": 510, "left": 215, "width": 200, "height": 50, "page": 0, "type": "SIGNATURE", "subtype": "FULLNAME" } ] } { "role": "Signer1", "id": "signature1", "fields": [ { "top": 510, "left": 215, "width": 200, "height": 50, "page": 0, "type": "SIGNATURE", "subtype": "CAPTURE" } ] } { "role": "Signer1", "id": "signature1", "fields": [ { "top": 510, "left": 215, "width": 200, "height": 50, "page": 0, "type": "SIGNATURE", "subtype": "INITIALS" } ] }
Para obtener una descripción completa de cada campo, consulte la tabla Carga útil de solicitud siguiente.
Carga útil de respuesta
{ "signed": null, "role": "Signer1", "accepted": null, "id": "signature1", "data": null, "fields": [ { "top": 50, "left": 300, "height": 50, "page": 0, "type": "SIGNATURE", "validation": null, "binding": null, "width": 200, "subtype": "FULLNAME", "extract": false, "extractAnchor": null, "id": "tx1qz7485780", "data": null, "value": "", "name": "" } ], "name": "" } Actualizar una firma en un documento
Puede actualizar una firma que ya se haya asociado a un documento. Para actualizar una firma, deberá realizar una solicitud PUT para:
https://sandbox.esignlive.com/api/packages/{packageId}/documents/{documentId}/approvals/{signatureId}/ Con los parámetros de firma actualizados:
{ "role": "Signer1", "fields": [ { "top": 510, "left": 215, "width": 300, "height": 50, "id": "signature1", "page": 0, "type": "SIGNATURE", "subtype": "CAPTURE" } ] } Al actualizar una firma, el nuevo objeto Signature debe tener el mismo id que la firma que desea actualizar.
Borrar una firma de un documento
Por último, la eliminación de una firma se realiza mediante una solicitud DELETE para:
https://sandbox.esignlive.com/api/packages/{packageId}/documents/{documentId}/approvals/{signatureId}/ Resultados
Una vez que haya ejecutado su código, sus firmas aparecerán en los documentos de su transacción.
Tabla de carga útil de solicitud
| Propiedad | Tipo | Editable | Obligatorio | Predeterminado | Valores de ejemplo |
|---|---|---|---|---|---|
| role | string | Sí | No | n/a | Signer1 |
| id | string | Sí | No | n/a | signature1 |
| fields | |||||
| top | integer | Sí | No | 0 | 510 |
| left | integer | Sí | No | 0 | 215 |
| width | integer | Sí | No | 200 | 200 |
| height | integer | Sí | No | 50 | 50 |
| page | integer | Sí | No | 0 | 0 |
| type | string | Sí | No | n/a | FIRMA / ENTRADA |
| 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 |
Para descargar la muestra de código completa, consulte nuestro sitio Code Share.
Agregar una firma a un documento
Para agregar una firma a un documento, primero deberá crear su objeto Approval. Use el siguiente código para hacerlo:
//#1. Add signature //Fullname signature style ESignLiveAPIObjects.Field field_fullname = new ESignLiveAPIObjects.Field(); field_fullname.id = 'field_fullname'; field_fullname.type = 'SIGNATURE'; field_fullname.subtype = 'FULLNAME'; field_fullname.page = 0; field_fullname.top = 100.0; field_fullname.left = 50.0; field_fullname.width = 150.0; field_fullname.height = 50.0; ESignLiveAPIObjects.Approval approval_fullname = new ESignLiveAPIObjects.Approval(); approval_fullname.fields = new List<ESignLiveAPIObjects.Field>{field_fullname}; approval_fullname.id = 'approval_fullname'; approval_fullname.role = roleId; //Capture signature style ESignLiveAPIObjects.Field field_capture = new ESignLiveAPIObjects.Field(); field_capture.id = 'field_capture'; field_capture.type = 'SIGNATURE'; field_capture.subtype = 'CAPTURE'; field_capture.page = 0; field_capture.top = 200.0; field_capture.left = 50.0; field_capture.width = 150.0; field_capture.height = 50.0; ESignLiveAPIObjects.Approval approval_capture = new ESignLiveAPIObjects.Approval(); approval_capture.fields = new List<ESignLiveAPIObjects.Field>{field_capture}; approval_capture.id = 'approval_capture'; approval_capture.role = roleId; //Initials signature style ESignLiveAPIObjects.Field field_initials = new ESignLiveAPIObjects.Field(); field_initials.id = 'field_initials'; field_initials.type = 'SIGNATURE'; field_initials.subtype = 'INITIALS'; field_initials.page = 0; field_initials.top = 300.0; field_initials.left = 50.0; field_initials.width = 150.0; field_initials.height = 50.0; ESignLiveAPIObjects.Approval approval_initials = new ESignLiveAPIObjects.Approval(); approval_initials.fields = new List<ESignLiveAPIObjects.Field>{field_initials}; approval_initials.id = 'approval_initials'; approval_initials.role = roleId;
Una vez que creado el objeto Signature , utilice el cliente SDK OneSpan Sign para agregar la firma al documento. Utilice el objeto PackageID, Signature y documentID como parámetros. Use el siguiente código para hacerlo:
ESignLiveSDK sdk = new ESignLiveSDK(); //String packageId, String documentId,ESignLiveAPIObjects.Approval approval sdk.addSignature(packageId, documentId, approval_fullname); sdk.addSignature(packageId, documentId, approval_capture); sdk.addSignature(packageId, documentId, approval_initials);
Actualizar una firma en un documento
Puede actualizar una firma que ya se haya asociado a un documento. Use el siguiente código para hacerlo:
//#2. update single signature ESignLiveAPIObjects.Field label_field_fullname = new ESignLiveAPIObjects.Field(); label_field_fullname.id = 'label_field_fullname'; label_field_fullname.type = 'INPUT'; label_field_fullname.subtype = 'LABEL'; label_field_fullname.value = 'label value fullname'; label_field_fullname.page = 0; label_field_fullname.top = 100.0; label_field_fullname.left = 250.0; label_field_fullname.width = 150.0; label_field_fullname.height = 50.0; approval_fullname.fields.add(label_field_fullname); //String packageId, String documentId, String approvalId, ESignLiveAPIObjects.Approval approval sdk.updateApproval(packageId, documentId, 'approval_fullname', approval_fullname);
Al actualizar una firma, el nuevo objeto Signature debe tener el mismo id que la firma que desea actualizar.
Borrar una firma de un documento
La eliminación de una firma de un documento se realiza con el cliente SDK OneSpan Sign. Utilice el PackageID, ApprovalID y documentID como parámetros. Use el siguiente código para hacerlo:
//#4. delete signature sdk.deleteApproval(packageId, documentId, 'approval_fullname');
Resultados
Una vez que haya ejecutado su código, sus firmas aparecerán en los documentos de su transacción.