Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: printeserver -> printserver



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
  • 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):

Standaardproces voor het maken van een PDF-afdruk

Het proces bestaat uit de volgende stappen:

  1. 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
  2. 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).
  3. 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.


  4. 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.
  5. De printservice stuurt het URL-adres van het PDF-bestand terug naar de client.  


Het probleem bij 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)).

Processtappen voor maken van PDF-afdruk via alternatieve WGP-serverImage Added

 Je kunt de server WGP-B gebruiken voor het maken van een PDF-afdruk als deze aan de volgende eisen voldoet:

  • Bereikbaar
    De alternatieve server WGP-B is toegankelijk voor zowel de client (in AD(FS)-omgeving ) als de headless browser (in printserver-omgeving).
  • Identiek
    De alternatieve server WGP-B bevat precies dezelfde themakaarten als de WGP-server (op de afbeelding aangegeven met WGP).

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 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).

Instelling print-server-urlImage Added







Versie 4.8


Page Properties
hiddentrue

4.7.6 → e-mail configureren voor nieuw wachtwoord 8 alternatieve printserver 

Jira Legacy
serverSystem JIRA
serverId62efed92-443f-34ca-9285-b558f8223ac7
keyWGP4-1165
 
Jira Legacy
serverSystem JIRA
serverId62efed92-443f-34ca-9285-b558f8223ac7
keyHLWGP-509538