OneSpan Sign Cómo: Usar etiquetas de texto

Haris Haidary, 2 de Agosto de 2017
Thumbnail

En el próximo lanzamiento de OneSpan Sign (11.5), hemos agregado una nueva función de extracción de etiquetas de texto que extrae automáticamente las firmas y los campos al colocar etiquetas de texto directamente en un documento. En otras palabras, OneSpan Sign analizará el documento cargado y reemplazará cada texto que coincida con el patrón de Etiqueta de texto con la firma o campo apropiado. La versión 11.5 está programada para ser lanzada el 7 de agosto para el entorno de sandbox y el 17 de agosto para el entorno de producción. En este blog, lo guiaré a través de un ejemplo de cómo usar las Etiquetas de texto.

El código

Vamos directo a ello. La función de extracción de etiquetas de texto es muy sencilla de usar. En resumen, todo lo que necesita hacer es agregar las "etiquetas de texto" en su documento donde desea que sus firmas y campos utilicen la nomenclatura de OneSpan Sign. Una vez que cargue su documento en OneSpan Sign, las etiquetas de texto desaparecerán y se reemplazarán con las firmas y campos correspondientes. Por ejemplo, la siguiente es la sintaxis válida más corta para una etiqueta de texto:

{{esl: role: fieldType}}

Dónde papel el es el Identificación del rol de su destinatario y fieldType es la firma o tipo de campo que desea poner. A continuación se muestra una captura de pantalla del documento que utilicé en mi ejemplo. Ilustra algunas etiquetas de texto de ejemplo válidas que puede usar.

etiquetas de texto

La función de extracción de etiquetas de texto está disponible a través de nuestra API REST y SDK. Para obtener una descripción completa de la nueva función de etiqueta de texto, consulte nuestro documentación . Una vez que finalice su documento, debe habilitar esta función durante la creación de la transacción. A continuación se muestran ejemplos que utilizan nuestro SDK de Java, SDK de .NET y API REST respectivamente.

SDK de Java

EslClient eslClient = nuevo EslClient (API_KEY, API_URL);

DocumentPackage pkg = PackageBuilder.newPackageNamed ("Ejemplo de etiquetas de texto")
		.withSigner (SignerBuilder.newSignerWithEmail ("mail32 @mailinator .com ")
				.withFirstName ("John")
				.withLastName ("Smith")
				.withCustomId ("signer1"))
		.withDocument (DocumentBuilder.newDocumentWithName ("Contrato de muestra")
				.fromFile ("C: /Users/hhaidary/Desktop/sample_contract_text_tags.docx")
				.enableExtraction ()
				.withExtractionType (ExtractionType.TEXT_TAGS))
		.construir();

PackageId packageId = eslClient.createAndSendPackage (paquete);

System.out.println (packageId);

.NET SDK

EslClient eslClient = nuevo EslClient (API_KEY, API_URL);

DocumentPackage pkg = PackageBuilder.NewPackageNamed ("Ejemplo de etiquetas de texto")
        .WithSigner (SignerBuilder.NewSignerWithEmail ("mail32 @mailinator .com ")
                .WithFirstName ("John")
                .WithLastName ("Smith")
                .WithCustomId ("signer1"))
        .WithDocument (DocumentBuilder.NewDocumentNamed ("Contrato de muestra")
                .FromFile ("C: /Users/hhaidary/Desktop/sample_contract_text_tags.docx")
                .EnableExtraction ()
                .WithExtractionType (ExtractionType.TEXT_TAGS))
        .WithStatus (DocumentPackageStatus.SENT)
        .Construir();

PackageId packageId = eslClient.CreatePackageOneStep (paquete);

Debug.WriteLine (packageId);

API REST

POST https://sandbox.esignlive.com/api/packages HTTP / 1.1
Tipo de contenido: multipart / form-data; esl-api-version = 11.9; límite = lKkOm3QpMGT9LnKz
Autorización: básica YOUR_API_KEY
Anfitrión: sandbox.esignlive.com
Longitud del contenido: 13736
Esperar: 100-continuar
Conexión: Keep-Alive

--lKkOm3QpMGT9LnKz

Disposición de contenido: datos de formulario; nombre = "carga útil"; filename = "carga útil"

{
  "autocompletar": verdadero,
  "documentos": [
    {
      "extracto": verdadero,
      "extractTypes": [
        "TEXT_TAGS"
      ],
      "índice": 0,
      "nombre": "Contrato de muestra"
    }
  ],
  "name": "Ejemplo de etiquetas de texto",
  "roles": [
    {
      "id": "firmante1",
      "índice": 0,
      "nombre": "firmante1",
      "firmantes": [
        {
          "email": "mail32 @mailinator .com ",
          "firstName": "John",
          "id": "firmante1",
          "apellido": "Smith"
        }
      ]
    }
  ],
  "status": "ENVIADO",
  "type": "PAQUETE",
  "visibilidad": "CUENTA"
}

--lKkOm3QpMGT9LnKz

Disposición de contenido: datos de formulario; nombre = "archivo"; filename = "C: /Users/hhaidary/Desktop/sample_contract_text_tags.docx"

[documentos binarios]

--lKkOm3QpMGT9LnKz--

Ejecutando su código

Una vez que ejecute su código, verá que las etiquetas de texto han desaparecido y han sido reemplazadas por su firma y campos correspondientes.

capturar

Puede descargar el JSON de muestra y el documento anterior de la Comunidad de desarrolladores Código compartido .

Si tiene preguntas sobre este blog o cualquier otra cosa relacionada con la integración de OneSpan Sign en su aplicación, visite los foros de la comunidad de desarrolladores: developer.esignlive.com . Eso es todo de mi parte. ¡Gracias por leer! Si esta publicación le parece útil, compártala en Facebook, Twitter o LinkedIn.

Haris Haidary

Evangelista técnico

LinkedIn El | Gorjeo  

Comunidad de desarrolladores de OneSpan Sign

¡Únase a la comunidad de desarrolladores de OneSpan Sign! Foros, blogs, documentación, descargas de SDK y más.

Únete hoy