Tips & Tricks

Live datafeeds insluiten in een PDF-dashboard

Een traditionele PDF is een momentopname. De gegevens die worden weergegeven, zijn bevroren op het moment dat de PDF werd gegenereerd. Een Interactief PDF-dashboard met live gegevens vernieuwt de inhoud telkens wanneer het document wordt geopend, waarbij actuele cijfers uit een webservice, een database of een gekoppelde gegevensbron worden gehaald. De lezer ziet actuele gegevens, niet de export van vorige week. Deze mogelijkheid verandert een PDF van een statisch rapport in een live rapportagetool.

Voor het insluiten van live datafeeds in een PDF zijn drie benaderingen nodig: het opnieuw genereren van de PDF volgens een schema met bijgewerkte gegevens, het insluiten van JavaScript dat een webservice aanroept wanneer de PDF wordt geopend, of het koppelen van PDF-elementen aan externe gegevensbronnen die de PDF-lezer automatisch vernieuwt. Elke aanpak heeft verschillende infrastructuurvereisten en verschillende niveaus van ondersteuning voor PDF-lezers.

De Web naar PDF-tools van WukongPDF zetten live gegevensweergaven op aanvraag om in PDF's. Voor dashboards die altijd actuele gegevens moeten tonen, is de geplande regeneratiebenadering het meest betrouwbaar voor alle PDF-lezers.

How to Embed Live Data Feeds in a PDF Dashboard

Aanpak 1: Geplande PDF-regeneratie met huidige gegevens

De meest betrouwbare manier om ervoor te zorgen dat een PDF-dashboard altijd actuele gegevens weergeeft, is door deze volgens een schema opnieuw te genereren. Een script haalt gegevens uit de brondatabase of API, vult een rapportsjabloon in en exporteert een nieuwe PDF. De gegenereerde PDF bevat de huidige gegevens als statische inhoud. De lezer hoeft geen JavaScript of externe dataverbindingen te ondersteunen. De PDF ziet er in elke reader hetzelfde uit, omdat de gegevens tijdens het genereren in het bestand worden ingebakken.

Tools zoals Python met de matplotlib- en reportlab-bibliotheken kunnen programmatisch datagestuurde PDF-dashboards genereren. Een cronjob op een server voert het script elk uur of elke dag uit, haalt nieuwe gegevens op en overschrijft de vorige PDF. De URL van de pdf blijft hetzelfde, maar de inhoud wordt bijgewerkt telkens wanneer het script wordt uitgevoerd. Deze aanpak werkt met elke PDF-lezer en elke gegevensbron die programmatisch kan worden opgevraagd. De beperking is dat de gegevens slechts zo actueel zijn als de laatste regeneratiecyclus. Voor dashboards waar updates per uur of per dag voldoende zijn, biedt geplande regeneratie de beste compatibiliteit.

WukongPDF

Probeer PDF bewerken

Geen installatie nodig. Werkt rechtstreeks in uw browser.

Nu beginnen →

Aanpak 2: JavaScript-API-aanroepen op geopend document

PDF-bestanden kunnen JavaScript bevatten dat wordt uitgevoerd wanneer het document wordt geopend. Het script kan een externe webservice aanroepen, als antwoord JSON-gegevens ontvangen en formuliervelden invullen of tekstelementen bijwerken met de geretourneerde waarden. Wanneer de lezer de PDF opent en door een beveiligingswaarschuwing klikt om de netwerkverbinding toe te staan, wordt het dashboard gevuld met live gegevens van de webservice.

Deze aanpak vereist een servereindpunt dat de dashboardgegevens in JSON-indeling retourneert. De PDF bevat JavaScript dat dit eindpunt aanroept met behulp van de Net.HTTP.request-methode in de Acrobat JavaScript API. Het script wordt uitgevoerd op de DocOpen-gebeurtenis, haalt gegevens op en werkt veldwaarden bij. De aanpak werkt in Adobe Acrobat Reader met JavaScript ingeschakeld. Het werkt niet in browsergebaseerde PDF-viewers, de meeste mobiele PDF-lezers of Acrobat Reader met JavaScript uitgeschakeld. De beperkte lezersondersteuning maakt deze aanpak geschikt voor interne dashboards die worden gedistribueerd naar gebruikers op bekende, JavaScript-compatibele lezers.

Aanpak 3: gekoppelde Excel-gegevens met automatisch vernieuwen

Microsoft Excel kan grafieken en tabellen exporteren naar PDF met gekoppelde gegevensverbindingen. Wanneer het Excel-bestand is verbonden met een externe gegevensbron, zoals een SQL-database, een web-API of een Power Query-gegevensfeed, worden de grafieken en draaitabellen in de Excel-werkmap bijgewerkt wanneer de gegevensverbinding wordt vernieuwd. Als u de bijgewerkte werkmap naar PDF exporteert, worden de nieuwste gegevens ingesloten.

In de praktijk is de link tussen de PDF en de live data indirect. Het Excel-bestand maakt verbinding met de gegevensbron, wordt volgens schema of bij het openen vernieuwd, en een macro of geplande taak exporteert de bijgewerkte PDF. De PDF zelf bevat statische gegevens van de meest recente Excel-vernieuwing. Deze aanpak maakt gebruik van de gegevensconnectiviteit die in Excel is ingebouwd, zonder dat JavaScript in de PDF nodig is.

GegevensbronVernieuwingsmethodeComplexiteit
Server-side script + PDF-regeneratieGenereer de volledige PDF op tijd opnieuw met bijgewerkte gegevensMedium, vereist scripting en planning
JavaScript + ingebedde webserviceoproepPDF-formulier roept API aan bij openen, vult velden met antwoordMedium, vereist kennis van servereindpunten en JS
Gekoppelde spreadsheet met automatische updatePDF-diagrammen gekoppeld aan externe gegevensbron, update bij openenLaag, ondersteund in Excel-naar-PDF-workflows

De juiste aanpak voor uw publiek kiezen

De geplande regeneratiebenadering werkt voor elk publiek omdat er een standaard, statische PDF wordt geproduceerd die elke lezer kan openen. De JavaScript-aanpak biedt echte live gegevens op het moment van opening, maar alleen voor lezers die Acrobat Reader gebruiken en JavaScript hebben ingeschakeld. De aan Excel gekoppelde aanpak biedt semi-live gegevens, waarbij Excel de brug vormt tussen de gegevensbron en de PDF-uitvoer.

Voor externe distributie naar een publiek met onbekende PDF-lezerconfiguraties is geplande regeneratie de veilige keuze. Voor interne dashboards die door collega's op beheerde apparaten worden bekeken, kunnen JavaScript- of Excel-gekoppelde benaderingen zorgen voor frequentere gegevensupdates. Bij deze beslissing wordt de versheid van gegevens afgewogen tegen de compatibiliteit van lezers. Een dashboard dat de gegevens van het afgelopen uur aan elke ontvanger toont, is vaak nuttiger dan een dashboard dat live gegevens toont aan een subset van ontvangers die over de juiste PDF-lezer beschikken.

Livegegevens in een PDF-dashboard vervagen de grens tussen een statisch document en een dynamische rapportage-interface. Het PDF-formaat, oorspronkelijk ontworpen voor de uitwisseling van statische inhoud, kan in combinatie met het juiste mechanisme voor gegevenslevering dienen als een lichtgewicht dashboardcontainer. De geplande regeneratieaanpak is het meest praktische pad naar live PDF-dashboards voor het breedste publiek.

Livegegevensverbindingen beveiligen in PDF-dashboards

In de meeste gevallen introduceert een PDF die netwerkverzoeken doet om live gegevens op te halen, een beveiligingsoverweging die statische PDF's niet hebben. Het netwerkverzoek kan mogelijk het IP-adres van de lezer aan de dataserver blootstellen, en de reactie van de server kan schadelijke inhoud bevatten als de server wordt gecompromitteerd. Zorg er bij interne dashboards voor dat het gegevenseindpunt HTTPS gebruikt en authenticatie vereist. Het JavaScript van de PDF moet het SSL-certificaat van de server valideren voordat gegevens worden verzonden of ontvangen.

Voor dashboards die extern worden gedistribueerd, is geplande PDF-regeneratie de veiligere aanpak, omdat de gegevens op het moment van genereren in het bestand worden ingebed op een gecontroleerde server en de PDF-lezer van de ontvanger geen netwerkverzoeken doet. Het beveiligingsmodel van een statische PDF is eenvoudiger en gemakkelijker te controleren dan een PDF met JavaScript die live API-aanroepen doet. Reserveer de live API-aanpak voor interne dashboards waarbij het servereindpunt, de configuratie van de PDF-lezer en het netwerkpad daartussen allemaal onder controle van de organisatie staan.

Grafieken van live dataservices insluiten als afbeeldingen

In plaats van een volledig dashboard te bouwen, kunt u overwegen individuele grafieken in te sluiten die zijn gegenereerd door een live dataservice. Services zoals Google Charts en QuickChart geven diagrammen weer als afbeeldingen van URL's met queryparameters die gegevenswaarden specificeren. De PDF geeft een afbeelding weer die is geladen vanaf een URL die op het moment van verzoek een diagram met actuele gegevens retourneert.

Deze aanpak heeft een bredere lezercompatibiliteit dan het ophalen van JavaScript-gegevens, omdat PDF-lezers die gekoppelde afbeeldingen ondersteunen het diagram kunnen weergeven zonder JavaScript uit te voeren. De kaartservice zorgt voor het ophalen en visualiseren van gegevens. De PDF geeft eenvoudigweg de resulterende afbeelding weer. Voor dashboards die worden gedistribueerd naar lezers met onbekende PDF-viewerconfiguraties, bieden gekoppelde kaartafbeeldingen live visualisatie met brede compatibiliteit.

Livegegevens in PDF-dashboards breiden de bruikbaarheid van het PDF-formaat verder uit dan statische documentuitwisseling. De geplande regeneratiebenadering biedt de beste balans tussen gegevensversheid en lezercompatibiliteit. De benaderingen met JavaScript en gekoppelde afbeeldingen bieden een grotere actualiteit voor gecontroleerde omgevingen waarin leessoftware bekend is. Door de juiste strategie voor gegevensverversing voor het publiek te kiezen, zorgt u ervoor dat het dashboard zijn waarde levert zonder compatibiliteitsverrassingen.

Een PDF-dashboard met live data houdt het midden tussen een statisch rapport en een volledige webapplicatie. Het levert actuele gegevens in een formaat dat elke stakeholder kan openen zonder een nieuwe tool te leren. De geplande regeneratiebenadering biedt de breedste compatibiliteit met de minste technische afhankelijkheden.

Live gegevens in een PDF-dashboard breiden het formaat uit van statische documentuitwisseling naar lichtgewicht rapportage. De geplande regeneratiebenadering biedt de beste compatibiliteit tussen PDF-lezers. De benaderingen met JavaScript en gekoppelde afbeeldingen bieden een grotere actualiteit voor gecontroleerde omgevingen. Door de vernieuwingsstrategie af te stemmen op het publiek, zorgt u ervoor dat het dashboard waarde levert zonder hiaten in de compatibiliteit.

WukongPDF

Probeer PDF bewerken

Geen installatie nodig. Werkt rechtstreeks in uw browser.

Nu beginnen →