OneSpan Sign Cómo: Extracción de documentos (.NET SDK)

Michael Williams, 8 de Agosto de 2015

Recientemente he visto un par de preguntas sobre el uso de la extracción de documentos, así que pensé que sería bueno crear un blog al respecto. Cada vez que haga un blog sobre cómo usar una función, lo pondré en la serie "OneSpan Sign How To".

Configurar los campos del formulario PDF

Lo primero es lo primero, necesitará un PDF con campos de formulario, llamado cómo OneSpan Sign puede reconocerlos. Puede ver más sobre el formato adecuado de los nombres de campo de formulario en el documentación . A continuación se muestra el documento PDF que utilicé. Puse los nombres de campo de formulario en los campos de la imagen para mostrar lo que nombré todo.

formFieldPDF

Como puede ver, los dos firmantes en el documento serán "Firmante1" y "Preparador1". Estas serán las ID personalizadas que se utilizan en la sección de códigos a continuación, lo que permite que OneSpan Sign sepa qué campos asociar con cada firmante.

Comunidad de desarrolladores de OneSpan Sign

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

El código

Entonces, con su documento configurado correctamente, ahora puede escribir su código. Para este blog, usaré C # y OneSpan Sign .NET SDK. A continuación, encontrará el código que usé para mi PDF de ejemplo, arriba.

utilizando el sistema;
usando System.IO;
usando Silanis.ESL.SDK;
usando Silanis.ESL.SDK.Builder;
utilizando System.Diagnostics;

espacio de nombres CreateAndSendPackage
{
    clase CreateAndSendPackage
    {
        Private static String apiUrl = "https://sandbox.esignlive.com/api";
        Cadena estática privada apiKey = "YOUR_API_KEY";

        public static void Main (cadena [] args)
        {
            EslClient eslClient = nuevo EslClient (apiKey, apiUrl);
            FileStream fileStream1 = File.OpenRead ("C: /PATH_TO_FILE/sampleDocumentExtract.pdf");

            DocumentPackage superDuperPackage = PackageBuilder.NewPackageNamed ("Prueba de extracción de documentos")
                .WithSettings (DocumentPackageSettingsBuilder.NewDocumentPackageSettings ())
                    .WithSigner (SignerBuilder.NewSignerWithEmail ("signer.email @example .com ")
                                .WithFirstName ("John")
                                .WithLastName ("Smith")
                                .WithCustomId ("Signer1")
                    )
                    .WithSigner (SignerBuilder.NewSignerWithEmail ("preparer.email @example .com ")
                                .WithFirstName ("Michael")
                                .WithLastName ("Williams")
                                .WithCustomId ("Preparador1")
                    )
                    .WithDocument (DocumentBuilder.NewDocumentNamed ("testDocumentExtraction")
                                  .FromStream (fileStream1, DocumentType.PDF)
                                  .EnableExtraction ()
                                 )
                    .Construir();
            PackageId packageId = eslClient.CreatePackage (superDuperPackage);
            eslClient.SendPackage (packageId);
        }
    }
}

El código para este ejemplo es bastante simple y la parte que está asociada con esta característica es aún más simple. En cada llamada "WithSigner", verá que los ID personalizados coinciden con los de la imagen del formulario PDF que se muestra anteriormente en el blog. El .WithDocument también tiene una llamada a "EnableExtraction". Como se hace esto, es posible que observe que no tiene que definir las ubicaciones de las firmas y quién debe firmar el documento. Esto ya se solucionó con los ID y los nombres de campo de formulario asociados del PDF.

Como se ve

Una vez que ejecute este código, el paquete se crea con los campos apropiados para cada firmante. Esto es lo que verá Signer1:

formFieldPDFPackageSignerView

Como puede ver, los campos obligatorios están resaltados para que el usuario los complete. OneSpan Sign completará automáticamente el campo Nombre cuando se complete la firma. Del mismo modo, el preparador ve esto:

formFieldPDFPackagePreparerView

Ahí tienes. El proceso de firma ocurre tal como lo ha definido en su paquete. ¡Gracias por leer! Si tiene alguna pregunta o hay algún tema que le gustaría ver cubierto en mi blog, no dude en publicar en la sección de comentarios.

- Michael Williams Gorjeo El | Facebook El | LinkedIn