Änderungen von Dokument Print-Service-Plugin


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