Inhoud
Introductie
Met de juiste licentie is het mogelijk om in WGP een themakaart direct naar een PDF-bestand af te drukken (WGP add-on Genereren PDF-bestanden). Dit proces maakt gebruik van een externe printservice die een "headless browser" bevat. De headless browser opent de themakaart die afgedrukt moet worden en converteert deze naar een afbeelding in een PDF-bestand. Als WGP echter in een omgeving draait die is geconfigureerd voor Single Sign On (SSO), bijvoorbeeld via AD of ADFS, kun je geen PDF-bestand genereren omdat de externe headless browser buiten de SSO-omgeving staat en geen themakaarten kan openen vanwege de SSO-barrière. Vanaf WGP 4.8.0 is hiervoor een oplossing (workaround) beschikbaar: vanaf deze versie is het mogelijk om een alternatieve WGP-server aan te wijzen waar de headless browser wel bij kan om een screenshot te maken van de themakaart die afgedrukt moet worden.Dit onderdeel beschrijft hoe je WGP voor een dergelijke alternatieve server configureert.
- Een headless browser is een webbrowser zonder grafische gebruikersinterface. Met een headless browser kun je net als in een gewone webbrowser door verschillende webpagina's navigeren en daarop verschillende operaties uitvoeren, alleen doe je dit niet in een grafische gebruikersinterface, maar via een commandline-interface (bijvoorbeeld een opdrachtpromptvenster). Headless browsers zijn voor webpagina's vooral geschikt om te testen, schermafdrukken te maken, gegevens te verzamelen en interacties te automatiseren.
- Een Single Sign On-omgeving is een omgeving waarbij je voor het aanmelden bij verschillende applicaties je slechts één keer hoeft aan te melden. Nadat je je in het begin hebt aangemeld, zal de SSO-service je inloggegevens automatisch aan de andere applicaties doorgeven.
Standaardproces voor het maken van een PDF-afdruk
De volgende afbeelding toont hoe het proces voor het genereren van een PDF-bestand van een kaartafdruk verloopt zonder gebruik te maken van een alternatieve server (tk staat voor themakaart, WGP voor de WGP-server):
Het proces bestaat uit de volgende stappen:
- De client (de WGP-viewer) start een printopdracht voor de kaart (met de knop Genereer PDF). Hij maakt een momentopname (snapshot) van het huidige kaartbeeld en stuurt deze in JSON-formaat naar de WGP-server. Deze momentopname bevat alle instellingen van de kaart, zoals kaartlagen en filters. De server slaat de momentopname van de kaart op in het bestandssysteem en geeft een SnapshotGUID terug aan de client.
- De client start een print job bij de printservice. Als parameters worden de naam van de themakaart en de SnapshotGUID verzonden (naast de informatie die nodig is om te bepalen welk gebied van de kaart moet worden afgedrukt).
De headless browser opent de gewenste themakaart op de WGP-server in combinatie met de SnapshotGUID. WGP gebruikt de opgeslagen momentopname (snapshot) met alle instellingen van de kaart vervolgens om de themakaart aan de browser aan te bieden met precies het juiste beeld dat afgedrukt moet worden.
Hoewel de headless browser een anonieme gebruiker is, kan deze de themakaart wel openen vanwege een speciaal token in de het JSON-bestand van de momentopname die dit toestaat. Het JSON-bestand met de momentopname wordt nadat het is uitgelezen direct gewist op de server.
- De headless browser maakt een schermafdruk van de geopende themakaart en de printservice maakt hier een PDF-bestand van. Bij een papierformaat van A2 of groter, wordt de headless browser meerdere keren met verschillende aansluitende extents geopend en wordt de resulterende schermafdrukken in het PDF-bestand aan elkaar geplakt. Het gegenereerde PDF-bestand wordt opgeslagen op de printserver.
- De printservice stuurt het URL-adres van het PDF-bestand terug naar de client.
Het probleem bij een PDF-afdruk in een SSO-omgeving
De volgende afbeelding laat zien waarom het proces voor het maken van een PDF-afdruk niet werkt als WGP zich in een SSO-omgeving bevindt (alle stappen die niet uitgevoerd kunnen worden zijn met een rood kruis aangegeven):
In stap 3 probeert de headless browser vanuit de omgeving van de printserver een themakaart te openen, maar omdat de externe omgeving van de printserver geen toegang heeft tot de SSO-omgeving van de client, wordt een request voor het openen van een themakaart tegengehouden. Hierdoor kan er geen schermafdruk van de kaart worden gemaakt en houdt het proces bij stap 3 op.
Een alternatieve WGP-omgeving voor het maken van een PDF-afdruk
Vanaf versie 4.8.0 is het mogelijk om in beheer een alternatieve WGP-server op te geven. Noem deze de B-omgeving (WGP-B in [afbeelding-3.png]).
Deze WGP-B server is voor zowel de client als de headless browser in de printservice bereikbaar en bevat dezelfde themakaarten als de WGP server. In stap 1 slaat de client de te printen snapshot op in de WGP-B-omgeving en in stap 3 opent de headless browser de kaart op de WGP-B omgeving in plaats van de WGP omgeving.
Doordat WGP-B wel toegankelijk is voor de headless browser kan er een screenshot worden gemaakt waardoor stap 3 niet meer blokkeert in het proces.
Het adres van de WGP-B omgeving kan worden ingesteld in de beheeromgeving van de hoofd-WGP. Zie Instellingen/Algemeen, settings print_server_url.
Versie 4.8