Änderungen von Dokument Print-Service-Plugin


Von Version 16.9
bearbeitet von awa
am 25.07.2022, 12:31
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 26.3
bearbeitet von awa
am 29.11.2022, 13:40
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
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,15 +409,27 @@
409 409   });
410 410  {{/jsIE}}
411 411  
412 -== Versionshistorie
414 +== Versionshistorie ==
413 413  
414 -=== Plugin
416 +=== Plugin ===
415 415  
416 -==== 4.2.1
418 +==== 4.3.0 ====
417 417  
420 +* Feature: Neue Option zum erneuten Versuchen des Drucks bei Fehlern.
421 +
422 +==== 4.2.3 ====
423 +
424 +* Fix: Sonderzeichen im Wert von Auswahloptionen bei Combobox-Felder werden nun immer korrekt im Druck dargestellt.
425 +
426 +==== 4.2.2 ====
427 +
428 +* Fix: Bei Textareas, wo die automatische Höhenanpassung aktiviert ist, wird vor dem Druck die Höhe noch einmal neu berechnet.
429 +
430 +==== 4.2.1 ====
431 +
418 418  * Fix: Version des Print-Server beim Check wird korrekt angezeigt
419 419  
420 -==== 4.2.0
434 +==== 4.2.0 ====
421 421  
422 422  * Feature: Neue Option //Blankodruck// im Plugin
423 423  * Feature: Es werden einige CSS-Klassen //xm-print// an das //form.xm-form// angefügt.
... ... @@ -425,46 +425,61 @@
425 425  * 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.
426 426  * 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.
427 427  
428 -==== 4.1.2
442 +==== 4.1.2 ====
429 429  
430 430  * Hinweis in der Plugin-Oberfläche bezüglich //$.xutil.onPrint// ergänzt.
431 431  
432 -==== 4.1.1
446 +==== 4.1.1 ====
433 433  
434 434  * Erfordert wenigstens {{formcycle/}} in Version 7.0.4.
435 435  * Change: Pflichtfeldhinweis wird nicht mehr angezeigt
436 436  * Fix: Datumformat wird wieder sofort eingeblendet
437 437  
438 -==== 4.1.0
452 +==== 4.1.0 ====
439 439  
440 440  * Status zum Drucken kann ausgewählt werden. Ist kein Status ausgewählt, wird wie bisher der aktuelle Status des Vorgangs genommen.
441 441  * Konfigurierte Nutzergruppen werden korrekt an der Aktion gespeichert.
442 442  
443 -==== 4.0.2
457 +==== 4.0.2 ====
444 444  
445 445  * Es kann nun ein Timeout gesetzt werden. Ist der Print-Service nicht erreichbar, wird die Aktion sonst möglicherweise nie abgebrochen.
446 446  
447 -==== 4.0.1
461 +==== 4.0.1 ====
448 448  
449 449  * Fix: In der Aktion für den neuen Workflow wurde die Datei nicht an den Vorgang angehangen.
450 450  
451 -==== 4.0.0
465 +==== 4.0.0 ====
452 452  
453 453  * Anpassungen für {{formcycle/}} Version 7.
454 454  
455 -=== Server
469 +=== Server ===
456 456  
457 -==== 1.5.0
471 +==== 1.6.1 ====
458 458  
473 +* Fix compatibility with Windows service installation script
474 +
475 +==== 1.6.0 ====
476 +
477 +* Es wird nun Chromium 108.0.5351.0 zum Drucken genutzt.
478 +* Neues CLI-Flag --disableCache=true zum Deaktivieren des Browser-Cache.
479 +* Neues CLI-Flag --isolatedBrowser=true um einen separaten Browser für jeden Print-Request zu verwenden.
480 +* Fix Debian Install-Script, installiere auch libgbm1.
481 +
482 +==== 1.5.1 ====
483 +
484 +* Abhängigkeit node-windows aktualisiert
485 +
486 +==== 1.5.0 ====
487 +
459 459  * Update auf Chromium 105.0.5173.0
460 460  * Erfordert mindestens Node.JS 14 oder höher
461 461  
462 -=== 1.4.1
491 +==== 1.4.1 ====
463 463  
464 464  * Script zum Installieren / Deinstallieren des Windows-Services ist wieder lauffähig (//install-windows-service.js// und //uninstall-windows-service.js//)
465 465  
466 -=== 1.4.0
495 +==== 1.4.0 ====
467 467  
468 468  * Bei Fehlern während des Druckens wird dieser Fehler mit der HTTP-Antwort zurückgeliefert
469 469  * 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.
470 -* Bei Aufruf des Pfads //~/pdf// liefer der Print-Server nun eine Status-Report des Servers zurück.
499 +* Bei Aufruf des Pfads ///pdf// liefer der Print-Server nun eine Status-Report des Servers zurück.