Configurar firmas opcionales

  Signature fullnameOptionalSignature = SignatureBuilder.signatureFor("[email protected]")   .onPage(0)   .atPosition(100, 100)   .makeOptional()   .build();  

  Signature captureOptionalSignature = SignatureBuilder.captureFor("[email protected]")   .onPage(0)   .atPosition(100, 200)   .makeOptional()   .build();   Signature initialsOptionalSignature = SignatureBuilder.initialsFor("[email protected]")   .onPage(0)   .atPosition(100, 300)   .makeOptional()   .build();   Signature mobileOptionalSignature = SignatureBuilder.mobileCaptureFor("[email protected]")   .onPage(0)   .atPosition(100, 400)   .makeOptional()   .build();  

  [Signer.SigStyle#.Optional]  

  {{Xesl[_fieldName]:roleName:fieldType[:parameter1,parameter2,...]}}  

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

Las firmas opcionales dan a sus firmantes la flexibilidad de completar una transacción sin tener que firmar todos los campos de firma en sus documentos. Esta función es útil para documentos que requieren que el firmante acepte o rechace secciones de un formulario.

Nota: Al menos un firmante debe tener una firma requerida o un documento Aceptar únicamente separado para que se complete una transacción. Esto no incluye el formulario de consentimiento predeterminado.

Creación de firmas opcionales

El siguiente código hará que el objeto Firma sea opcional:

  Signature fullnameOptionalSignature = SignatureBuilder.SignatureFor("[email protected]")   .OnPage(0)   .AtPosition(100, 100)   .MakeOptional()   .Build();  

Del mismo modo, la función MakeOptional() también está disponible para otros tipos de firmas:

  Signature captureOptionalSignature = SignatureBuilder.CaptureFor("[email protected]")   .OnPage(0)   .AtPosition(100, 200)   .MakeOptional()   .Build();   Signature initialsOptionalSignature = SignatureBuilder.InitialsFor("[email protected]")   .OnPage(0)   .AtPosition(100, 300)   .MakeOptional()   .Build();   Signature mobileOptionalSignature = SignatureBuilder.MobileCaptureFor("[email protected]")   .OnPage(0)   .AtPosition(100, 400)   .MakeOptional()   .Build();  

Resultados

Cualquier firma que se haya denotado como opcional se indicará claramente como tal. No son necesarias las firmas opcionales para confirmar una transacción.

Creación de firmas opcionales con extracción de documentos

Para que un campo de firma sea opcional, aplique el siguiente formato a su formulario PDF:

  [Signer.SigStyle#.Optional]  

La última parte .Optional se extiende para configurar la firma como opcional. Aquí se ofrecen algunos ejemplos más:

 

• Las firmas son obligatorias de manera predeterminada, por lo que debe agregar .Optional solo cuando sea necesario.
• La sintaxis del nombre del formulario PDF no distingue entre mayúsculas y minúsculas, incluido el Role Name y Custom ID del firmante. [Agent1.Fullname1.Optional] se trata de la misma manera que [AGENT1.FULLNAME1.OPTIONAL].
• Esta extensión de sintaxis solo está disponible para las firmas y no se reconocerá al crear ningún otro campo. Nombres como [Agent1.Fullname1.Textfield1.Optional] no funcionarán.

Una vez creada la transacción, todas las firmas deben aparecer como se esperaba.

Creación de firmas opcionales con extracción de etiquetas de texto

La siguiente línea muestra la sintaxis de una etiqueta de texto:

  {{Xesl[_fieldName]:roleName:fieldType[:parameter1,parameter2,...]}}  

Para marcar esta firma como opcional, cambie el tercer carácter, X, a un signo de interrogación, ?. De lo contrario, se requerirán todas las firmas de forma predeterminada. Estos son algunos ejemplos:

En este ejemplo, {{?esl:Signer1:Signature}} significa que una firma de nombre completo opcional está vinculada a Signer1.

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

Las firmas opcionales dan a sus firmantes la flexibilidad de completar una transacción sin tener que firmar todos los campos de firma en sus documentos. Esta función es útil para documentos que requieren que el firmante acepte o rechace secciones de un formulario.

Nota: Al menos un firmante debe tener una firma requerida o un documento Aceptar únicamente separado para que se complete una transacción. Esto no incluye el formulario de consentimiento predeterminado.

Creación de firmas opcionales

El siguiente código hará que el objeto Firma sea opcional:

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

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 = "optional signature basic usage.pdf"
Content - Type: application / pdf % PDF - 1.5 % µµµµ 1 0 obj < >>> endobj....-- -- --WebKitFormBoundary1bNO60n7FqP5WO4t Content - Disposition: form - data;
name = "payload" {
   "documents": [{
      "approvals": [{
         "fields": [{
            "height": 50,
            "left": 100,
            "page": 0,
            "subtype": "FULLNAME",
            "top": 100,
            "type": "SIGNATURE",
            "width": 200
         }],
         "id": "signature1",
         "role": "Role1"
      }, {
         "fields": [{
            "height": 50,
            "left": 100,
            "page": 0,
            "subtype": "FULLNAME",
            "top": 300,
            "type": "SIGNATURE",
            "width": 200
         }],
         "id": "signature2",
         "role": "Role1",
         "optional": true
      }],
      "name": "Test Document"
   }],
   "name": "Optional Signature Basic Usage REST",
   "roles": [{
      "id": "Role1",
      "signers": [{
         "email": "[email protected]",
         "firstName": "1.firstname",
         "lastName": "1.lastname",
         "company": "OneSpan Sign"
      }]
   }],
   "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": "7g-LhL0zEzN0jZi7Yccell7y6jA="   } 

Resultados

Cualquier firma que se haya denotado como opcional se indicará claramente como tal. No son necesarias las firmas opcionales para confirmar una transacción.

Creación de firmas opcionales con extracción de documentos

Para que un campo de firma sea opcional, aplique el siguiente formato a su formulario PDF:

  [Signer.SigStyle#.Optional]  

La última parte .Optional se extiende para configurar la firma como opcional. Aquí se ofrecen algunos ejemplos más:

 

• Las firmas son obligatorias de manera predeterminada, por lo que debe agregar .Optional solo cuando sea necesario.
• La sintaxis del nombre del formulario PDF no distingue entre mayúsculas y minúsculas, incluido el Role Name y Custom ID del firmante. [Agent1.Fullname1.Optional] se trata de la misma manera que [AGENT1.FULLNAME1.OPTIONAL].
• Esta extensión de sintaxis solo está disponible para las firmas y no se reconocerá al crear ningún otro campo. Nombres como [Agent1.Fullname1.Textfield1.Optional] no funcionarán.