Inline example
< iframe id="HelloWorld" runat="server"
src="home/HelloWorld"
height="500" scrolling="AUTO" width="600"> < /iframe >
Este artículo se divide en dos:
public static void ResponsePDF(Report report, System.Web.UI.Page page)
La entidad Report será utilizada para llamar al método Create que implementa cualquier reporte que creemos heredando de la misma Root.Reports.Report.
La página es solamente utilizada para acceder al objeto Response, que es el que modela la respuesta del servidor a la página. En este tenemos los elementos necesarios para mostrar un output en la página resultante. Aquí podemos ver que se limpia el contenido anterior, se hace el set del contentType a application/pdf, se crea el reporte cargando el OutputStream de la página y llamándose a End del objeto response.
public static void ResponsePDF4MVC(Report report, System.Web.HttpContext currentContext)
public static void ResponsePDF4MVC(Report report, System.Web.HttpContext currentContext)
{
currentContext.Response.Clear();
currentContext.Response.ContentType = "application/pdf";
if (!(report.formatter is PdfFormatter))
{
throw new ReportException("PDF formatter required");
}
if (report.page_Cur == null)
{
report.Create();
}
report.formatter.Create(report, currentContext.Response.OutputStream);
currentContext.Response.End();
}
Ya desde aquí, vemos que la firma cambió. En vez de utilizar un objeto System.Web.UI.Page, usaremos un HttpContext. Debido a que ASP.NET MVC no maneja ninguna Page e interactúa directamente con los HttpHandlers (MvcHandler) . Esto nos da la posibilidad de hacer lo que deseemos con el output resultante. Tal como en el bloque anterior, este método utiliza el parámetro tipo HttpContext para manejar su objeto Response. Por lo demás, el manejo del método es igual a su padre :D.
Compilamos el proyecto y tendremos nuestro assembly modificado.
Bien, ya tenemos lo necesario para crear nuestro primer reporte ASP.NET MVC. Antes de continuar, será necesario que revisemos si tenemos ASP.NET MVC instalado para continuar. Si no lo tenemos, podremos descargarlo desde el sitio de asp.net.
Una vez sepamos que podemos continuar, abriremos Visual Studio y creamos un proyecto ASP.NET MVC (File -> New -> Project)
Nombramos a nuestro proyecto como PDFGenerator y definimos la ruta a grabar. Lo siguiente que veremos será la pantalla preguntándonos si queremos crear pruebas unitarias. Para efectos de este ejemplo, seleccionaremos la opción No, do not create a unit test Project.
A continuación, tendremos un proyecto ASP.NET MVC inicial generado para nosotros.
Haremos referencia a nuestro assembly Reports.dll
Ahora, iremos por partes. Primero el Modelo, luego el Controller y finalmente la vista.
Model
Conceptualmente, el modelo define la estructura de nuestros datos, las reglas y la lógica de negocio. Es aquí donde crearemos nuestro objeto reporte, el mismo tendrá toda la estructura a ser mostrada en pantalla posteriormente.
Sobre la carpeta Models creamos una nueva clase a la que llamaremos SampleReport. Éste debe heredar de Root.Reports.Report.
public class SampleReport : Report
using Root.Reports;
public class SampleReport : Report
{
FontDef _fontDefinition;
FontProp _fontProperty;
protected override void Create()
{
// Este llamado es muy importante para generar la página
NewPage();
// Inicialia las propiedades del reporte
InitializeReportProperties();
// Imprime mensaje
PrintHelloWorldMessage();
}
private void InitializeReportProperties()
{
// Este estilo de fuente debe ser definido sólo una vez
_fontDefinition = new FontDef(this, FontDef.StandardFont.TimesRoman);
_fontProperty = new FontProp(_fontDefinition, 10, Color.Navy);
}
private void PrintHelloWorldMessage()
{
page_Cur.AddCT_MM(100, 50, new RepString(_fontProperty, "Good morning joy!"));
page_Cur.AddCT_MM(100, 70, new RepString(_fontProperty, "Implementing ASP.NET MVC"));
}
internal void NewPage()
{
new Root.Reports.Page(this);
}
}
Explicación:
Hacemos un Override del método Create, esto nos permitirá tener el punto de partida para crear el reporte. El método NewPage nos permite crear una nueva página. Sí o sí tendremos que hacer esta llamada. Inicializamos las propiedades del reporte con InitializeReportProperties y finalmente imprimimos nuestro mensaje: “Buen día alegría!” :D.
Una vez que hemos definido el reporte eso es todo con relación a la vista.
Controller
La parte de controller es mucho más sencilla, ya que casi todo el trabajo ha sido hecho. Lo único que tendremos que hacer será añadir un método público denominado HelloWorld en nuestro HomeController. Ésta será tomada como acción y accedida desde la URL.
Dentro de la acción, instanciaremos nuestro reporte y haremos la llamada al método ResponsePDF4MVC (el que previamente creamos en el proyecto Report). Quedaría así:
public ActionResult HelloWorld()
{
SampleReport report = new SampleReport();
RT.ResponsePDF4MVC(report, this.HttpContext.ApplicationInstance.Context);
return View();
}
View
En esta parte, añadiremos una vista llamada HelloWorld.aspx bajo la carpeta Views/Home:
Esta página me sirve para hacer el llamado a la acción, el sistema de ruteo haga la llamada al controller identificando la acción HelloWorld y éste a su vez devuelva el resultado a una vista con el mismo nombre. Es importante el nombrado de views y acciones, esto por convención, nos permitirá hacer la comunicación entre los elementos del patrón.
Ya casi acabando, modificaremos la página Index.aspx, eliminamos el contenido de MainContent por con un simple link que apunte a nuestro HelloWorld.aspx. Entonces nuestra página index.aspx quedaría así:
<%@ Page Language="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="System.Web.Mvc.ViewPage" %>
<asp:Content ID="Content1" ContentPlaceHolderID="TitleContent" runat="server">
Home Page
</asp:Content>
<asp:Content ID="indexContent" ContentPlaceHolderID="MainContent" runat="server">
<h2>My first ASP.NET MVC PDF</h2>
<p>
Watch our <%= Html.ActionLink("Hello world", "HelloWorld") %> example
</p>
</asp:Content>
Si nos fijamos en el código que tiene el llamado a ActionLink, veremos que vamos a mostrar solamente el texto Hello world acompañado de la acción a ser invocada. Por dentro, el sistema de ruteo se encargará de llamar al método HelloWorld y nuestro controller sabrá que tiene que existir una página también llamada HelloWorld.aspx.
Finalmente, compilamos nuestro código le damos debug (dejamos que se pueda modificar el archivo web.config para hacer debugging) para ver nuestra página de la siguiente manera:
Presionando sobre el link Hello world tendremos finalmente nuestro tan ansiado reporte PDF en ASP.NET MVC
Bueno, eso es todo amigos. Mi primer reporte PDF en ASP.NET MVC implicó que conozca la API de reporte Report.net, también implicó el conocimiento de conceptos del patrón MVC y la práctica con ASP.NET MVC para juntar todo. En sí no es complicado. Como lo dije antes, el construir el reporte “a mano” puede ser un poco largo para quienes están acostumbrados a usar herramientas tipo Crystal, pero si lo vemos del otro lado tendremos una libertad completa para generar contenido en PDF mediante código, sin mencionar que en vez de usar DataTables, podremos actuar directamente con entidades de negocio.
ASP.NET MVC puede ser asimilado rápidamente, la página del framework tiene excelentes artículos para comenzar a aprender y también está la opción de adquirir un libro que hable del tema. Yo recomendaría el libro Professional ASP.NET MVC 1.0, escrito por la gente que diseñó el framework. También está ASP.NET MVC In Action que basa la explicación del modelo en base a Domain Driven Development.
Este ejemplo lo realicé porque se me vino una corazonada una de esas noches de inspiración. Si es que existen algunas inconsistencias conceptuales, les agradezco si pueden comentar al respecto.
Bueno, eso es todo. Espero que esto sirva para complementar a este maravilloso framework MVC y ayudar a quienes lo necesitan.
private void ProbarSaltoCursor()
{
// Se inicializa el cursor al valor predeterminado
IniciarCursor();
// Se va a llamar al salto de cursor dentro de un bucle 100 veces
for (int index = 1; index <= 100; index++) CrearLineaDeTexto(string.Format("Imprimiendo linea Nº : {0:00}", index)); }
private void CrearLineaDeTexto(string pTexto)
{
// Primero revisamos si el cursor ha revasado el limite de la pagina
EvaluarSaltoPagina();
// Se adiciona a la pagina el texto en una posicion predeterminada
page_Cur.AddCT_MM(100, cursorActual, new RepString(_propiedadFuente, pTexto));
cursorActual += 10;
}
protected void Page_Load(object sender, EventArgs e)
{
ReporteCursor reporte = new ReporteCursor();
RT.ResponsePDF(reporte, this);
}
using System;
using System.Collections.Generic;
using System.Text;
using Root.Reports;
using System.Drawing;
namespace Reportes
{
public class ReporteCursor : Report
{
#region Propiedades reporte
FontDef _definicionFuente;
FontProp _propiedadFuente;
FontProp _propiedadFuentePequenia;
FontProp _propiedadFuenteFooter;
// Se definen los bordes de la pagina
internal Double rPosTop = 25;
internal Double rPosBottom = 280;
internal Double rPosLeft = 10;
internal Double rPosRight = 200;
// se define una variable que represente un cursor
double cursorActual;
#endregion
protected override void Create()
{
InicializarReporte();
ProbarSaltoCursor();
CrearPieDePagina();
}
private void ProbarSaltoCursor()
{
// Se inicializa el cursor al valor predeterminado
IniciarCursor();
// Se va a llamar al salto de cursor dentro de un bucle 100 veces
for (int index = 1; index <= 100; index++) CrearLineaDeTexto(string.Format("Imprimiendo linea Nº : {0:00}", index)); } #region Métodos básicos private void CrearPieDePagina() { foreach (Root.Reports.Page page in enum_Page) page.AddRT_MM(rPosRight, rPosBottom + 4, new RepString(_propiedadFuenteFooter, string.Format("Página {0} de {1}", page.iPageNo, iPageCount))); } private void EvaluarSaltoPagina() { if (cursorActual > rPosBottom)
{
IniciarCursor();
NuevaPagina();
page_Cur.AddCT_MM(20, 10, new RepString(_propiedadFuentePequenia, "(Nueva página)"));
}
}
private void InicializarReporte()
{
NuevaPagina();
InicializarPropiedadesReporte();
}
private void InicializarPropiedadesReporte()
{
// Este estilo de fuente debe ser definido sólo una vez
_definicionFuente = new FontDef(this, FontDef.StandardFont.TimesRoman);
_propiedadFuente = new FontProp(_definicionFuente, 10, Color.Navy);
_propiedadFuentePequenia = new FontProp(_definicionFuente, 7, Color.Maroon);
_propiedadFuenteFooter = new FontProp(_definicionFuente, 5, Color.SlateBlue);
}
internal void NuevaPagina()
{
new Root.Reports.Page(this);
}
#endregion
#region Metodos especificos
private void CrearLineaDeTexto(string pTexto)
{
// Primero revisamos si el cursor ha revasado el limite de la pagina
EvaluarSaltoPagina();
// Se adiciona a la pagina el texto en una posicion predeterminada
page_Cur.AddCT_MM(100, cursorActual, new RepString(_propiedadFuente, pTexto));
cursorActual += 10;
}
private void IniciarCursor()
{
cursorActual = rPosTop;
}
#endregion
}
}
public enum CaracterNoCapital
{
a = 1,
al,
con,
de,
del,
el,
ello,
en,
es,
la,
le,
las,
lo,
los,
mi,
no,
por,
para,
que,
te,
se,
si,
su,
un,
una,
y,
}
public class Capital
{
public static string ConvierteACapital(string pTexto)
{
// Se obtiene la coleccion de strings formateada
string[] partesCadena = FormatearCadena(pTexto);
//letraCapital = "";
string primeraLetra = "";
bool esCaracterNoCapital = false;
CaracterNoCapital miEnum = new CaracterNoCapital();
// Se obtienen los elementos de la enumeracion EnumCaracteresNoCapital
string[] enumArray = Enum.GetNames(miEnum.GetType());
for (int i = 0; i < escaracternocapital =" false;" a ="="" escaracternocapital =" true;" i ="="" primeraletra =" (partesCadena[i][0].ToString()).ToUpper();" aux =" 0;" letracapital =" new">= partesCadena.Length-2 )
letraCapital.Append(parte);
else
{
letraCapital.Append(parte);
letraCapital.Append(" ");
}
aux++;
}
return letraCapital.ToString();
}
private static string[] FormatearCadena(string pCadena)
{
// Se eliminan los espacios de los extremos de la cadena
pCadena = pCadena.ToLower().Trim();
// Se separa por el caracter ' '
string[] split = pCadena.Split(' ');
string textoParaSeparar = "";
foreach (string parteCadena in split)
{ // Se omiten espacios extra innecesarios
if (parteCadena != ""){
// Se añade cada parte de la cadena que no sea vacio
textoParaSeparar += parteCadena + "^";
}
}
// finalmente se separa el texto por el caracter "^"
string[] partesCadena = textoParaSeparar.Split('^');
return partesCadena;
}
}
using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using Root.Reports;
using System.Drawing;
public partial class PaginaReporte : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
ReporteEjemplo reporte = new ReporteEjemplo();
RT.ResponsePDF(reporte, this);
}
}
public class ReporteEjemplo:Report
{
FontDef _definicionFuente;
FontProp _propiedadFuente;
protected override void Create()
{
NuevaPagina();
InicializarPropiedadesReporte();
ImprimirHolaMundo();
}
private void InicializarPropiedadesReporte()
{
// Este estilo de fuente debe ser definido sólo una vez
_definicionFuente = new FontDef(this, FontDef.StandardFont.TimesRoman);
_propiedadFuente = new FontProp(_definicionFuente, 10, Color.Navy);
}
private void ImprimirHolaMundo()
{
page_Cur.AddCT_MM(100, 50, new RepString(_propiedadFuente, "Hola mundo... ¿que esperabas?"));
}
internal void NuevaPagina()
{
new Root.Reports.Page(this);
}
}
