Inhoud
Table of Contents |
---|
Introductie
Excerpt |
---|
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.
Info |
---|
|
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.
Note 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 maken van een PDF-afdruk in een
SSO-afgeschermde 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; de afgeschermde omgeving wordt AD(FS)
genoemd):
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 (omgeving AD(FS)
), 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 WGP versie 4.8.0 is het mogelijk om in beheer WGP Beheer voor het maken van een PDF-afdruk 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 De volgende afbeelding laat zien hoe je via deze alternatieve WGP-server PDF-afdrukken kunt maken ondanks het feit dat WGP zich in een afgeschermde omgeving bevindt die niet vanuit de printerserver-omgeving is te bereiken ( in de afbeelding wordt de alternatieve WGP-server WGP-B
genoemd en de afgeschermde omgeving AD(FS)
).
Je kunt de server WGP-B
gebruiken voor het maken van een PDF-afdruk als deze aan de volgende eisen voldoet:
- Bereikbaar
De alternatieve serverWGP-B
is toegankelijk voor zowel de client (inAD(FS)
-omgeving ) als de headless browser (in printeserver-omgeving). - Identiek
De alternatieve serverWGP-B
bevat precies dezelfde themakaarten als de WGP-server (op de afbeelding aangegeven metWGP
).
In stap 1 slaat de client de momentopname van de af te printen drukken kaart (snapshot) op in de omgeving van de alternatieve server WGP-B
-omgeving en in stap 3 opent de headless browser de kaart op de alternatieve server WGP-B
omgeving in in plaats van op de WGP omgeving.Doordat (onbereikbare) WGP-server zelf. Doordat server WGP-B
wel toegankelijk is voor de headless browser kan er een screenshot worden gemaakt waardoor stap 3 niet meer blokkeert deze een schermafdruk van de kaart maken en wordt stap 3 in het proces niet meer geblokkeerd.
Het Je kunt het URL-adres van de alternatieve server WGP-
B omgeving kan worden ingesteld B
in de beheeromgeving van de hoofd-WGP. Zie Instellingen/Algemeen, settings hoofdserver WGP als algemene serverinstelling specificeren (WGP Beheer > Beheer > Instellingen > Categorie Algemeen > instelling print_server_url).
Versie 4.8
Page Properties | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
4.7.6 → e-mail configureren voor nieuw wachtwoord 8 alternatieve printserver
|