Generación de PDF desde .NET usando formularios

Un post en .NET Answers me ha recordado que hace tiempo tenía pendiente escribir una entrada para comentar la técnica que he utilizado en más de una ocasión para generar documentos PDF desde mis aplicaciones .NET de forma muy sencilla, y que puede aplicarse en escenarios donde se conozca de antemano el diseño del documento a imprimir y sólo sea necesario introducir información concreta en espacios muy definidos. Un caso muy habitual es el rellenado de formularios o impresos, aunque usando un poco la imaginación seguro que podéis encontrarle muchas más utilidades.

La técnica consiste en crear, utilizando alguna herramienta de diseño como Adobe Acrobat, un documento PDF que contenga todos los contenidos estáticos del documento que deseamos generar. En cada zona donde queremos inyectar contenido deberemos introducir un campo de formulario (por ejemplo, “nombre”, “apellidos”, etc.) adaptando el tipo de letra, límites y las propiedades del campo que sean necesarias.

Ya desde código el procedimiento será bien sencillo: abrimos la plantilla, introducimos los valores en cada uno de los campos, y hacemos con el documento resultante lo que nos convenga según la ocasión: enviarlo por email, salvarlo a disco, ofrecerlo para la descarga, etc.

Para conseguir estos objetivos utilizaremos iTextSharp, una adaptación para .NET de la librería iText, muy conocida en el mundo Java. Por tanto, en primer lugar, es necesario descargarla desde Sourceforge, y referenciarla en el proyecto desde el cual vamos a utilizarla.

El siguiente código implementa un método realiza el procedimiento descrito:

   1: public void FillPDF(string templateFile, Stream stream)

   2: {

   3:     // Abrimos la plantilla y creamos una copia, sobre

   4:     // la cual trabajaremos...

   5:     PdfReader reader = new PdfReader(templateFile);

   6:     PdfStamper stamp = new PdfStamper(reader, stream);

   7:  

   8:     // Introducimos el valor en los campos del formulario...

   9:     stamp.AcroFields.SetField("Nombre", "Juan");

  10:     stamp.AcroFields.SetField("Apellidos", "Rodríguez Méndez");

  11:  

  12:     // Fijamos los valores y enviamos el resultado al stream...

  13:     stamp.FormFlattening = true;

  14:     stamp.Close(); 

  15: }

Así, para almacenar la plantilla con los datos en un nuevo PDF, bastaría con invocar al método anterior de la siguiente manera:

   1: Stream file = new FileStream("FormularioRelleno.pdf", FileMode.Create);

   2: FillPDF("plantilla.pdf", file);

O si queremos que desde una aplicación ASP.NET el usuario pudiera descargarlo directamente, podríamos utilizar un código como el siguiente:

   1: protected void btnGenerarPDF_Click(object sender, EventArgs e)

   2: {

   3:     Response.Clear();

   4:     Response.ContentType = "application/pdf";

   5:     Response.AddHeader("content-disposition", "attachment;filename=Formulario.pdf");

   6:     FillPDF(Server.MapPath("Plantilla.pdf"), Response.OutputStream);

   7: }

Por último, sólo comentar que iTextSharp no sólo es útil para rellenar formularios, ni mucho menos. Se trata de una librería muy potente que permite la creación y edición al vuelo de documentos PDF completos, y dispone de un complejo amplísimo API que nos permite hacer casi de todo con ellos. Además, se distribuye bajo licencias LGPL y MPL, muy permisivas ambas, por lo que pueden ser utilizadas en prácticamente cualquier tipo de sistemas.

Para el que no se le apetezca teclear mucho, ahí va una solución para Visual Studio 2005 con dos proyectos, uno web y otro de consola, demostrando el funcionamiento.

Publicado en: Variable not found.