From Smoke to Soil: Una actualización sobre nuestro proyecto de biochar en el norte de Tailandia
La mayoría de los desarrolladores, la primera vez que tienen que agregar informes PDF a una aplicación interna, pierden un día.
Prueban el cuadro de diálogo de impresión del navegador. La salida se ve mal. Prueban una biblioteca PDF del lado del cliente. El diseño se rompe. Ellos mismos crean algo con texto posicionado y coordenadas absolutas. Funciona para un informe y se desmorona para el siguiente. Para cuando envían la función, han desperdiciado ocho horas en un problema que debería haber tomado veinte minutos.
Jeff Fritz mostró a una sala llena de principiantes cómo hacerlo en veinte minutos.
El taller
Si no conoces a Jeff Fritz: él es un MVP de Microsoft, un Gerente Principal de Programas en Microsoft, y anfitrión del stream de larga duración Fritz and Friends. Organiza talleres gratuitos para desarrolladores que están comenzando su camino en .NET, y hace unas semanas llevó a cabo uno de los más ambiciosos: una construcción en vivo de cinco horas que cubre HTML, CSS, C#, Blazor, ASP.NET y .NET Aspire, con todo el grupo creando una aplicación de seguimiento de colecciones funcional desde cero.
A las cuatro horas, la aplicación necesitaba informes PDF. Un usuario debería poder hacer clic en un botón y obtener un PDF limpio y descargable de su colección. Cosas reales de herramientas internas. El tipo de función que cada gerente de producto eventualmente solicita y cada desarrollador eventualmente tiene que entregar.
El patrón que Jeff enseña es el que la mayoría de los equipos deberían utilizar, y vale la pena analizarlo porque una vez que lo ves, dejas de buscar las herramientas incorrectas.
El patrón de cinco pasos
Aquí está su forma. Es engañosamente corto.
Una página Razor dedicada para el informe. Jeff crea Report.razor dentro del directorio Pages del proyecto. Pequeña elección, gran recompensa, mantener el informe como su propia página significa que puede ser estilizado, regenerado y probado independientemente del resto de la UI. El informe se convierte en una parte de primera clase de la aplicación, no un truco añadido a otra vista.
Inyectar el contexto de datos. La fábrica CollectionContext del Entity Framework Core llega a través de la inyección de dependencia, exactamente como cualquier otro punto de obtención de datos en la aplicación. Sin patrón especial, sin solución alternativa, sin camino de datos separado solo para informes. El informe utiliza los mismos datos que el resto de la aplicación utiliza, de la misma manera.
Renderizar el informe como HTML. Este es el movimiento que separa un buen patrón de uno frágil. Jeff no utiliza un lenguaje de diseño específico para PDF. Escribe el informe como HTML, el mismo marcado que ha estado usando toda la tarde y deja que el estilo existente funcione. Encabezados, tablas, secciones, todo en HTML. El hecho de que la salida final sea un PDF es un detalle que viene después.
Convertir HTML a PDF con una línea. Esto es donde IronPDF se gana su lugar. ChromePdfRenderer toma la cadena HTML y produce un PDF real y correctamente renderizado usando un motor de Chrome bajo el capó. El CSS que se ve bien en el navegador se ve bien en el PDF. No hay una capa de estilo separada para aprender, ni rarezas de renderizado para depurar.
- Devuélvelo como un archivo. El navegador descarga el PDF limpiamente cuando el usuario hace clic en el botón. Hecho. Funcionalidad enviada.
Ese es todo el patrón. Cinco pasos, veinte minutos de tiempo de transmisión, y una característica que se mantiene en producción.
Por qué esto funciona
La razón más profunda por la que este patrón es el correcto es la durabilidad, pero la razón superficial es que cada paso se asigna a algo que el desarrollador ya sabe hacer.
¿Escribir el diseño del informe? Eso es HTML y CSS, igual que cualquier otra página. ¿Consultar los datos? Mismo patrón de EF Core. ¿Integrar la página en la aplicación? Mismas páginas Razor, misma DI. El único paso genuinamente nuevo es la conversión a PDF, y eso es una línea.
Comparalo con las alternativas. Enfoques basados en el cuadro de diálogo de impresión se rompen en el momento en que un usuario tiene un navegador diferente, un nivel de zoom diferente, o una configuración de impresora inesperada. Las bibliotecas de PDF del lado del cliente obligan al desarrollador a aprender un idioma de diseño completamente nuevo. El diseño basado en coordenadas creado a mano funciona para un informe y colapsa en el segundo. Ninguno de esos enfoques sobrevive al contacto con un producto real.
El patrón HTML-a-PDF del lado del servidor sobrevive. La salida es consistente, determinista y centralizada, la misma entrada produce el mismo PDF cada vez, en cada cliente, porque el renderizado ocurre en un solo lugar bajo un conjunto de reglas. Para herramientas internas, informes de cara al cliente, documentos de seguimientos de auditoría, en cualquier lugar donde la consistencia de la salida realmente importa, este es el patrón que se mantiene.
Este taller lo enseña claramente porque no tiene tiempo para enseñarlo de otra manera.
Inténtalo en tu propio proyecto
La biblioteca que Jeff utiliza para el paso de conversión, IronPDF, es gratuita para probar con una clave de prueba de 30 días. Regístrate con un correo electrónico de empresa, la clave llega a tu bandeja de entrada, y puedes construir el patrón exacto que Jeff Fritz enseña en tu propio proyecto antes de que termine la tarde. Sin marcas de agua durante la prueba, acceso completo a funciones, todas las API disponibles.
Si has estado posponiendo añadir informes en PDF porque la última vez que lo intentaste tomó un día, esta es la versión del proyecto que toma veinte minutos.
Mira el taller completo
La sesión completa de Jeff está en su canal de YouTube. El segmento de informes PDF empieza en 4:56:48, pero los módulos anteriores también valen la pena, son una rampa limpia a través de la pila moderna de .NET, y la enseñanza de Jeff es realmente buena.
Comience gratis
Comience gratis
Reserve demostración en vivo gratis
