Tijdens een gesprek met een collega over de beperkingen van PDFSharp, een .NET-bibliotheek waarbij je alles handmatig in code moet 'tekenen', kwam een alternatief ter sprake: PDF's genereren vanuit HTML-templates via een headless browser met Puppeteer. De ontwerpvrijheid spreekt aan. Maar een browserengine en server-side JavaScript integreren in een bestaande .NET-webapplicatie heeft consequenties. Het verzwaart deployments, voegt afhankelijkheden toe en vraagt om regelmatige updates voor veiligheid en compatibiliteit. De vraag was of het ook anders kon.
De verkenning richtte zich op een lichtgewicht, serverloze service die de PDF-logica afzonderlijk afhandelt. Een Azure Function leek een logische keuze.
Online waren de signalen wisselend. Oudere artikelen stelden dat Puppeteer binnen een Azure Function niet werkt. Recentere bronnen suggereerden dat het mogelijk is, met de nodige voorbehouden. Genoeg reden om het van de grond af te testen, met ondersteuning van Claude Code AI.
De opzet bestaat uit een paar losse onderdelen die samen de PDF-generatie mogelijk maken.
Het nieuwste Linux Azure Functions-plan is Flex, een pay-per-use-model. Binnen de beschikbare tijd bleek de oplossing daar niet werkend te krijgen: bepaalde modules of afhankelijkheden lijken beperkt te zijn. Het standaard Linux Consumption-plan werkte wel, maar dat is een verouderd plan dat op 30 september 2028 wordt uitgefaseerd.
Wat nu? Ofwel een manier vinden om de beperkingen van het Flex-plan te omzeilen, ofwel overstappen naar een containergebaseerde function. Beide opties vragen meer onderzoek. Voor dit experiment volstaat het Consumption-plan.
De Azure Function retourneert een PDF-bestand als download. Als invoer accepteert de function HTML/CSS met Base64-ondersteuning of een absolute URL. Daarnaast is er ondersteuning voor aangepaste lettertypen en optionele paginanummering.
Hoe de HTML voor de invoer tot stand komt, valt buiten dit artikel. De aanpak hangt af van de situatie: statische templates met placeholders voor dynamische data, een CMS met een renderingengine, of HTML gegenereerd op basis van formulierinvoer. Alle drie zijn gangbare routes en relatief eenvoudig te itereren dankzij snelle visuele feedback.
PDF-output met verschillende stijlen en secties
Het "digital transformation" blok onder "Strategic Priorities for 2025" zou iets hoger moeten zijn. Dat kunnen we veranderen
Informatiebalken? Geen probleem!
De aanpak houdt PDF-generatie volledig zelfstandig. Updates en deployments blijven daardoor overzichtelijk, zonder dat de hoofdapplicatie extra complexiteit krijgt.
Er zijn wel aandachtspunten. De keuze voor het juiste Azure Function-plan vraagt nader onderzoek. De afhankelijkheid van headless Chromium is een risico op de langere termijn: als die ooit wordt uitgefaseerd, is een vervanger nodig. In een productieomgeving moet de function goed beveiligd zijn en nooit publiek toegankelijk.
Er bestaan betaalde diensten met vergelijkbare functionaliteit. Die vereisen doorgaans dat gevoelige data extern wordt verwerkt en zijn vaak aanzienlijk duurder. Deze aanpak houdt alles onder eigen beheer en is volledig te hosten binnen Europese Azure-infrastructuur.