ReportDocument: "No se ha podido cargar el informe"

Una nueva entrega de errores en Visual Studio y cómo evitarlos, aunque esta vez se trata de una mala utilización del componente ReportDocument -empleado para mostrar informes en Crystal Report-. O mejor dicho, trataré de cómo evitar las malas prácticas de programación. Por decirlo fino.

Tenemos una aplicación web desarrollada en ASP.NET en la que mostramos información sobre albaranes de envío a través de un Crystal Report. Esta aplicación está publicada en una intranet donde, en determinados momentos, puede llegar a haber hasta 40 usuarios mas o menos simultáneos.

Después de hacer los desarrollos y probadas todas las opciones sin ningún error, decidimos pasar el sistema a producción. Pero, oh campos de soledad, oh mustios collados, resulta que después de llevar unos días empieza a dar un error de lo más raro:

No se ha podido cargar el informe.

Primer problema: Estábamos capturando la excepción y mostrando únicamente la información de la propiedad "Message". Esto a veces está muy bien, pero en otras la información contenida aquí no dice nada, y nos hace falta saber mas, es decir, "InnerException".

Este error tenía unos efectos colaterales nada desdeñables, puesto que a partir de este momento ya no se podía mostrar ningún otro informe, ni en esta sesión ni en ninguna del mismo usuario o de otros, teniendo que reiniciar el IIS -el día que deje de funcionar lo de salir y volver a entrar no se qué vamos a hacer-.

Reproducir el error en desarrollo era bastante complicado porque no sabíamos bajo qué condiciones se daba, así que lo siguiente fue sacar toda la información del error. Como ya he dicho, fue en "InnerException" donde empezamos a encontrar la luz al final del túnel con este mensaje:

Se ha alcanzado el límite máximo de tareas de procesamiento de informes configuradas por el administrador del sistema.

Genial. Desde el inicio ya había un cierto tufillo a recursos no liberados, y este mensaje parece que va por ahí. Próximo paso, ver si estamos liberando todo lo que utilizamos. Después de una búsqueda rápida no encontramos en todo el código ningún Dispose() ni ningún Close() del objeto que utilizamos para mostrar el informe. Mecachis.

Lo que faltaba era cerrar el ReportDocument pero claro, la programación web no tiene mucho que ver con la basada en formularios, y no siempre tenemos claro cuándo se producen los eventos. Además tenemos los famosos postback, que hace necesario entender cómo funcionan para no andar repitiendo procesos que ralentizan la carga de la página sin necesidad.

Así pues, ¿dónde cerramos el ReportDocument? No puede ser en el mismo procedimiento que lo crea, porque todavía no lo ha mostrado. El sitio natural es en el evento Page_Unload, ya que es el momento en el que termina de procesarse la página... cuyo concepto es algo parecido al evento Leave de un Windows.Form -insisto, parecido-. Es decir, algo como:

protected void Page_Unload(object sender, EventArgs e)
{

if ((informe != null) && informe.IsLoaded)

informe.Close();

}

[Actualización 06/11/2008: Además de informe.Close(), no estaría demás hacer también informe.Dispose(), tal y como me han dicho en varios comentarios de esta entrada. :-)]

"informe" es una variable del tipo ReportDocument privada de la página. En este fragmento de código se puede ver cómo primero comprobamos si está instanciada -no lo estará si no hemos encontrado el albarán de carga buscado- y después comprobamos si tiene datos cargados -esta propiedad cambia a true al utilizar el método SetDataSource(), entre otros-.

Con esto terminaron nuestros quebraderos de cabeza, al menos en lo relativo a este error.


PD: Al que hizo esa página le tenemos escribiendo 1024 veces "Liberaré los recursos cuando termine de utilizarlos". :-)