Änderungen von Dokument Print-Service-Plugin


Von Version 16.8
bearbeitet von awa
am 25.07.2022, 12:18
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 26.1
bearbeitet von sas
am 14.11.2022, 14:23
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.awa
1 +XWiki.sas
Inhalt
... ... @@ -12,19 +12,17 @@
12 12  
13 13  Um das //Print-Service// Plugin verwenden zu können, ist es erforderlich, //Node.js// sowie den //Print Server// zu installieren. Dieser kann auf dem gleichen Server wie der {{formcycle/}} Master-Server installiert werden.
14 14  
15 -== Installation ==
15 +== Installation Print Server unter Windows ==
16 16  
17 17  Die Installation des benötigten //Print Servers// erfordert je nach Betriebssystem unterschiedlicher Vorgehensweisen.
18 18  
19 -=== Installation Print Server unter Windows ===
19 +=== Installation von Node.js ===
20 20  
21 -==== Installation von Node.js ====
22 -
23 23  : 1. Download der LTS-Version unter https://nodejs.org/
24 24  : 2. MSI-Datei ausführen
25 25  : 3. Wizard-Schritte durchlaufen, wobei die Standardeinstellungen so belassen werden können
26 26  
27 -==== Installationsschritte für den Print Server ====
25 +=== Installationsschritte für den Print Server ===
28 28  
29 29  : 4. Die Print Server Installationsdateien können Sie hier über die Customer-Cloud herunterladen.
30 30  : 5. Entpacken Sie die ZIP Datei „print_server_fc.zip“ und verschieben Sie den Inhalt in den Ordner print_server_fc unter C:\Programme\.
... ... @@ -64,15 +64,16 @@
64 64  * Den Print-Service-Windows-Dienst stoppen.
65 65  * Aus dieser ZIP-Datei die Dateien {{code language="none"}}server.js{{/code}}, {{code language="none"}}package.json{{/code}} und {{code language="none"}}package-lock.json{{/code}} in den Ordner kopieren, wo der Print-Service aktuell installiert ist (bei Nachfrage "Dateien überscheiben" auswählen).
66 66  * Wichtig: Der Ordner {{code language="none"}}daemon{{/code}} und die darin enthaltenen Dateien sollten dabei nicht geändert werden!
67 -* Eine Window-Kommandozeile (cmd) mit administrativen Berechtigungen öffnen und in den Ordner wechseln, wohin die Dateien kopiert wurden.
65 +* Eine Window-Kommandozeile (cmd) mit administrativen Berechtigungen öffnen
66 +* In den //print_server_fc// Ordner wechseln, wohin die Dateien kopiert wurden.
68 68  * Via {{code language="none"}}npm install{{/code}} nun die Abhängigkeiten aktualisieren. Dieser Befehl kann einige Momente dauern. Hierfür ist es notwendig, dass der Server eine Internetverbindung hat. Falls eine Verbindung nicht möglich ist, schaue Sie bitte [[hier>>doc:||anchor="HBefehlnpminstallfFChrtzuTimeout"]].
69 69  * Nun kann der Print-Service-Windows-Dienst wieder gestartet werden.
70 70  
71 71  Sollt das Update dazu führen, dass der Dienst nicht mehr gestartet werden kann, sollten Sie eine Neuinstallation durchfürhen. Heißt erst eine Deinstallation und dann den Schritten unter Installation folgen.
72 72  
73 -=== Installation Print Server unter Linux ===
72 +== Installation Print Server unter Linux ==
74 74  
75 -==== Installationsschritte für die Installation von Node.js und dem Print Server ====
74 +=== Installationsschritte für die Installation von Node.js und dem Print Server ===
76 76  
77 77  Zur Installation öffnen Sie die Konsole und führen die folgenden Befehle aus:
78 78  
... ... @@ -122,21 +122,24 @@
122 122  In den meisten Fällen reicht es allerdings aus, die Server-Script-Dateien zu ersetzen und die Abhängigkeiten per npm zu aktualsieren:
123 123  
124 124  * Die aktuelle Version "print_server_fc.zip" herunterladen.
125 -* Den Print-Service-Systemdienst stoppen.
126 -* Aus dieser ZIP-Datei die Dateien {{code language="none"}}server.js{{/code}}, {{code language="none"}}package.json{{/code}} und {{code language="none"}}package-lock.json{{/code}} in den Ordner kopieren, wo der Print-Service aktuell installiert ist (bei Nachfrage "Dateien überscheiben" auswählen).
127 -* Eine Window-Kommandozeile (cmd) mit administrativen Berechtigungen öffnen und in den Ordner wechseln, wohin die Dateien kopiert wurden.
124 +* Den Print-Service-Systemdienst FORMCYCLE Print Sever stoppen: {{code language="none"}}systemctl stop printserver{{/code}}
125 +* Aus dieser ZIP-Datei die Dateien {{code language="none"}}server.js{{/code}}, {{code language="none"}}package.json{{/code}} und {{code language="none"}}package-lock.json{{/code}} in den Ordner kopieren, wo der Print-Service aktuell installiert ist (bei Nachfrage "Dateien überschreiben" auswählen).
126 +* Eine Kommandozeile (cmd) mit administrativen Berechtigungen öffnen und in den Ordner wechseln, wohin die Dateien kopiert wurden. Di Dateien sollten standardmäßig unter (% id="cke_bm_219S" style="display:none" %) (%%) {{code language="none"}}/home/formcycle/print_server{{/code}} zu finden sein.
128 128  * Via {{code language="none"}}npm install{{/code}} nun die Abhängigkeiten aktualisieren. Dieser Befehl kann einige Momente dauern. Hierfür ist es notwendig, dass der Server eine Internetverbindung hat. Falls ein Proxy notwendig ist für die Internetverbindung, kann dieser per {{code language="none"}}npm config set proxy http:/...{{/code}} gesetzt und per {{code language="none"}}npm config delete proxy{{/code}} wieder gelöscht werden.
129 -* Nun kann der Print-Service-Systemdienst wieder gestartet werden.
128 +* Nun kann der Print-Service-Systemdienst wieder gestartet werden: {{code language="none"}}systemctl start printserver{{/code}}
130 130  
131 -=== Test ===
130 +== Test ==
132 132  
133 -Um zu prüfen, ob die Installation erfolgreich durchgeführt wurde, kann der Service testweise auf dem Server aufgerufen werden:
134 -{{code language="none"}}http://localhost:8090/pdf?orientation=landscape&format=A4&wait=false&marginTop=0mm&formURL=http://www.formcycle.de{{/code}}
132 +Um zu prüfen, ob die Installation erfolgreich durchgeführt wurde, kann der Service testweise auf dem localen Server aufgerufen werden (in diesem Beispiel wird versucht die Webseite formcycle.de zu drucken):
135 135  
136 -=== Einrichtung des Plugins ===
134 +{{code language="none"}}
135 +http://localhost:8090/pdf?orientation=landscape&format=A4&wait=false&marginTop=0mm&formURL=http://www.formcycle.de
136 +{{/code}}
137 137  
138 -==== Installation Plugin Print-Service ====
138 +== Einrichtung des Plugins ==
139 139  
140 +=== Installation Plugin Print-Service ===
141 +
140 140  Damit das Plugin in {{formcycle/}} als Aktion im Workflow zur Verfügung steht, muss dieses im Bereich Systemplugin der Verwaltungsoberfläche bereitgestellt werden. Eine Anleitung zur Installation von Plugins finden Sie [[hier>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]].
141 141  
142 142  Falls bereits die alte Version des Print-Service Plugins (Phantom-Plugin) installiert war, wird folgende Vorgehensweise für die Installation empfohlen:
... ... @@ -146,7 +146,7 @@
146 146  * Neues Print-Service Plugin hochladen
147 147  * Mit der Konfiguration fortfahren
148 148  
149 -==== Konfiguration des Plugins ====
151 +=== Konfiguration des Plugins ===
150 150  
151 151  Nachdem das Plugin installiert weurde, muss noch die Service-URL angepasst werden. Diese wird am Plugin über den Pflichtparameter {{code language="none"}}pdf.print.services.url{{/code}} festgelegt.
152 152  
... ... @@ -207,7 +207,7 @@
207 207  
208 208  Um das Plugin zu nutzen, klicken Sie im Workflow auf neue Aktion und wählen das Print-Plugin aus. Die folgenden Optionen werden zum Konfigurieren der Plugin-Aktion verwendet:
209 209  
210 -; Druck-Modus
212 +: Druck-Modus
211 211  :; Formularfelder in Text umwandeln
212 212  :: Eingabefelder werden in Text umgewandelt und das Formular wird in der Breite entsprechend angepasst, siehe nächster Abschnitt.
213 213  :; Formularfelder bewahren
... ... @@ -374,7 +374,7 @@
374 374  
375 375  In Schriftarten vom Typ //TrueType// und //OpenType// können Informationen über die Einbettbarkeit der Schriftart direkt mitgespeichert werden. Je nachdem, was dort konfiguriert ist, kann eine Schriftart gegebenenfalls nicht eingebettet werden und wird vom //Print-Service-Plugin// stattdessen nur als Vektorgrafik in die erstellten PDF-Dokumente gerendert.
376 376  
377 -== JavaScript-Anpassungen für Druckbild
379 +== JavaScript-Anpassungen für Druckbild ==
378 378  
379 379  Manchmal kann es erforderlich sein, vor dem Druck noch JavaScript auszuführen. Hierzu kann die Funktion //$.xutil.onPrint// verwendet werden, welche folgende Signatur hat
380 380  
... ... @@ -409,13 +409,23 @@
409 409   });
410 410  {{/jsIE}}
411 411  
412 -== Versionshistorie
414 +== Versionshistorie ==
413 413  
414 -=== 4.2.1
416 +=== Plugin ===
415 415  
418 +==== 4.2.3 ====
419 +
420 +* Fix: Sonderzeichen im Wert von Auswahloptionen bei Combobox-Felder werden nun immer korrekt im Druck dargestellt.
421 +
422 +==== 4.2.2 ====
423 +
424 +* Fix: Bei Textareas, wo die automatische Höhenanpassung aktiviert ist, wird vor dem Druck die Höhe noch einmal neu berechnet.
425 +
426 +==== 4.2.1 ====
427 +
416 416  * Fix: Version des Print-Server beim Check wird korrekt angezeigt
417 417  
418 -=== 4.2.0
430 +==== 4.2.0 ====
419 419  
420 420  * Feature: Neue Option //Blankodruck// im Plugin
421 421  * Feature: Es werden einige CSS-Klassen //xm-print// an das //form.xm-form// angefügt.
... ... @@ -423,36 +423,50 @@
423 423  * Change: Betrifft den Druckmodus //dynamisch//: Hatte ein Eingabefeld keinen Wert, wurde stattdessen der Platzhalter (placeholder-Attribute) des Elements als Wert angezeigt. Dies ist verwirrend und wurde geändert. Hat ein Eingabefeld keinen Wert, wird auch kein Wert dargestellt.
424 424  * Change: Betrifft den Druckmodus //dynamisch//: Hatte ein Auswahlfeld mit Darstellung Dropdown keinen Wert, wurde //Bitte auswählen// als Wert angezeigt. Dies wurde so geändert, dass nun kein Wert angezeigt wird.
425 425  
426 -=== 4.1.2
438 +==== 4.1.2 ====
427 427  
428 428  * Hinweis in der Plugin-Oberfläche bezüglich //$.xutil.onPrint// ergänzt.
429 429  
430 -=== 4.1.1
442 +==== 4.1.1 ====
431 431  
432 432  * Erfordert wenigstens {{formcycle/}} in Version 7.0.4.
433 433  * Change: Pflichtfeldhinweis wird nicht mehr angezeigt
434 434  * Fix: Datumformat wird wieder sofort eingeblendet
435 435  
436 -=== 4.1.0
448 +==== 4.1.0 ====
437 437  
438 438  * Status zum Drucken kann ausgewählt werden. Ist kein Status ausgewählt, wird wie bisher der aktuelle Status des Vorgangs genommen.
439 439  * Konfigurierte Nutzergruppen werden korrekt an der Aktion gespeichert.
440 440  
441 -=== 4.0.2
453 +==== 4.0.2 ====
442 442  
443 443  * Es kann nun ein Timeout gesetzt werden. Ist der Print-Service nicht erreichbar, wird die Aktion sonst möglicherweise nie abgebrochen.
444 444  
445 -=== 4.0.1
457 +==== 4.0.1 ====
446 446  
447 447  * Fix: In der Aktion für den neuen Workflow wurde die Datei nicht an den Vorgang angehangen.
448 448  
449 -=== 4.0.0
461 +==== 4.0.0 ====
450 450  
451 451  * Anpassungen für {{formcycle/}} Version 7.
452 452  
465 +=== Server ===
453 453  
467 +==== 1.5.1 ====
454 454  
469 +* Abhängigkeit node-windows aktualisiert
455 455  
471 +==== 1.5.0 ====
456 456  
473 +* Update auf Chromium 105.0.5173.0
474 +* Erfordert mindestens Node.JS 14 oder höher
457 457  
476 +==== 1.4.1 ====
458 458  
478 +* Script zum Installieren / Deinstallieren des Windows-Services ist wieder lauffähig (//install-windows-service.js// und //uninstall-windows-service.js//)
479 +
480 +==== 1.4.0 ====
481 +
482 +* Bei Fehlern während des Druckens wird dieser Fehler mit der HTTP-Antwort zurückgeliefert
483 +* Print-Server kann nun zum Drucken beliebiger Webseiten genutzt werden. JavaScript und CSS, welche im Kontext der zu druckenden Seite ausgeführt werden soll, kann nun mit der HTTP-Anfrage übergeben werden.
484 +* Bei Aufruf des Pfads ///pdf// liefer der Print-Server nun eine Status-Report des Servers zurück.