Changes for page Print-Service-Plugin


From version 10.13
edited by awa
on 05.09.2022, 12:30
Change comment: There is no comment for this version
To version 11.12
edited by awa
on 23.06.2023, 17:04
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -12,19 +12,17 @@
12 12  
13 13  To use the //Print-Service// plugin, it is necessary to install //Node.js// and the //Print Server//. This can be installed on the same server as the {{formcycle/}} master server.
14 14  
15 -== Installation ==
15 +== Installation Print Server on Windows ==
16 16  
17 17  The installation of the required //Print Server// requires different procedures depending on the operating system.
18 18  
19 -=== Installation Print Server on Windows ===
19 +=== Installation of Node.js ===
20 20  
21 -==== Installation of Node.js ====
22 -
23 23  : 1. Download the LTS version from https://nodejs.org/
24 24  : 2. Run the MSI file
25 25  : 3. Run the wizard steps, leaving default settings as they are
26 26  
27 -==== Installation steps for the Print Server ====
25 +=== Installation steps for the Print Server ===
28 28  
29 29  : 4. Download the Print Server installation files from the Customer Cloud [[here>>https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/fc-plugin-print-service/Print%20Server&fileid=18856]].
30 30  : 5. unzip the ZIP file "print_server_fc.zip" and move the content to the folder print_server_fc under {{code language="none"}}C:\Programs\{{/code}}.
... ... @@ -46,7 +46,7 @@
46 46  
47 47  After the installation, a folder named {{code language="none"}}deamon{{/code}} is created for the log files.
48 48  
49 -==== Uninstall ====
47 +=== Uninstall ===
50 50  
51 51  Für die Deinstallation des Print Servers, öffnen Sie eine Kommandozeile (cmd) mit administrativen Berechtigungen und führen Sie folgende Befehle aus.
52 52  
... ... @@ -55,10 +55,13 @@
55 55  node uninstall-windows-service.js
56 56  {{/code}}
57 57  
56 +== Installing Print Server under Linux ==
58 58  
59 -=== Installing Print Server under Linux ===
58 +{{info}}
59 + Contrary to earlier versions, you need to copy ALL files from the ZIP file with the print server.
60 +{{/info}}
60 60  
61 -==== Installation steps for installing Node.js and the Print Server ====
62 +=== Installation steps for installing Node.js and the Print Server ===
62 62  
63 63  To install, open the console and run the following commands:
64 64  
... ... @@ -105,15 +105,24 @@
105 105  During the installation, depending on the existing system, some Linux packages such as nodejs were also installed. However, it is not possible to uninstall the packages automatically. Delete the automatically installed packages only if you are 100% sure that they are no longer needed!
106 106  {{/info}}
107 107  
108 -=== Test ===
109 +== Using IPv6 ==
109 109  
110 -To check if the installation was successful, the service can be called on the server for a test:
111 -{{code language="none"}}http://localhost:8090/pdf?orientation=landscape&format=A4&wait=false&marginTop=0mm&formURL=http://www.formcycle.de{{/code}}
111 +Starting with version 2.0.1, the server binds to both IPv4 and IPv6 addresses by default, using the dual stack feature supported by most operating systems. Should that fail, the print server binds only to IPv4 addresses (0.0.0.0).
112 112  
113 -=== Plugin setup ===
113 +If required, you can also set a different bind address via the command line parameter "--bindAddress".
114 114  
115 -==== Print-Service Plugin Installation ====
115 +== Test ==
116 116  
117 +To check if the installation was successful, the service can be called on the local server for a test (in that case it should be printed the formcycle.de website):
118 +
119 +{{code language="none"}}
120 +http://localhost:8090/pdf?orientation=landscape&format=A4&wait=false&marginTop=0mm&formURL=http://www.formcycle.de
121 +{{/code}}
122 +
123 +== Plugin setup ==
124 +
125 +=== Print-Service Plugin Installation ===
126 +
117 117  In order for the plugin to be available in {{formcycle/}} as an action in the workflow, it must be deployed in the System Plugin section of the management interface. Instructions for installing plugins can be found [[here>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]].
118 118  
119 119  If the old version of the print service plugin (phantom plugin) was already installed, the following procedure is recommended for installation:
... ... @@ -123,7 +123,7 @@
123 123  * Upload new print service plugin
124 124  * Proceed with the configuration
125 125  
126 -==== Plugin Configuration ====
136 +=== Plugin configuration ===
127 127  
128 128  After the plugin has been installed, the service URL must be adjusted. This is defined in the plugin via the mandatory parameter {{code language="none"}}pdf.print.services.url{{/code}}.
129 129  
... ... @@ -348,23 +348,31 @@
348 348   });
349 349  {{/jsIE}}
350 350  
351 -== Changelog
361 +== Changelog ==
352 352  
353 -=== Plugin
363 +=== Plugin ===
354 354  
355 -==== 4.2.3
365 +==== 4.3.1 ====
356 356  
367 +* fix: Always show the selected appointment date, if any, regardless of the print mode
368 +
369 +==== 4.3.0 ====
370 +
371 +* feature: New option to retry printing in case of a failure
372 +
373 +==== 4.2.3 ====
374 +
357 357  * Fix: Special characters in combobox select options are now displayed correctly in the printed PDF document
358 358  
359 -==== 4.2.2
377 +==== 4.2.2 ====
360 360  
361 361  * Fix: When a textarea is set to adjust its height automatically to its content, the height is now recalculated once before the form is printed.
362 362  
363 -==== 4.2.1
381 +==== 4.2.1 ====
364 364  
365 365  * Fix: Show correct version of the print server when performing a check
366 366  
367 -==== 4.2.0
385 +==== 4.2.0 ====
368 368  
369 369  * feature: New option //blank form//
370 370  * feature: Add special CSS classes to the //form.xm-form// such as //xm-print//
... ... @@ -372,50 +372,73 @@
372 372  * change: Applicable only when //print mode// is set to //dynamic//: When an input field did not have a value, its placeholders was shown instead. This was changed so that no value is shown when the input field does not have a value.
373 373  * change: Applicable only when //print mode// is set to //dynamic//: When a select field displayed as a dropdown menu did not have a value, the text //Please select// was shown instead. This was changed so that no text is shown anymore when the select field does not have a value.
374 374  
375 -==== 4.1.2
393 +==== 4.1.2 ====
376 376  
377 377  * Added note regarding //$.xutil.onPrint// to the plugin UI.
378 378  
379 -==== 4.1.1
397 +==== 4.1.1 ====
380 380  
381 381  * Requires at least {{formcycle/}} 7.0.4.
382 382  * change: Note regarding required field is not shown anymore.
383 383  * fix: Show the date format immediately
384 384  
385 -==== 4.1.0
403 +==== 4.1.0 ====
386 386  
387 387  * Added a new option for selecting the workflow state used during printing. When no state is selected, the current state of the form record is used as in previous version.
388 388  * Configured user groups are saved correctly.
389 389  
390 -==== 4.0.2
408 +==== 4.0.2 ====
391 391  
392 392  * feature: Added a new timeout option that defaults to 30 seconds. When the print service cannot be reached, the workflow may never complete otherwise.
393 393  
394 -==== 4.0.1
412 +==== 4.0.1 ====
395 395  
396 396  * fix: The PDF document that was created was not attached to the form record (only for the new workflow action).
397 397  
398 -==== 4.0.0
416 +==== 4.0.0 ====
399 399  
400 400  * Adjustments for {{formcycle/}} version 7.
401 401  
402 -=== Server
420 +=== Server ===
403 403  
404 -==== 1.5.1
422 +==== 1.7.2 ====
405 405  
424 +* Close alert messages when any are opened by JavaScript. Otherwise the print can never finish successfully.
425 +
426 +==== 1.7.1 ====
427 +
428 +* Update install scripts for Linux
429 +
430 +==== 1.7.0 ====
431 +
432 +* Switch to media type print before printing and wait until no network traffic is ongoing anymore before printing. This helps to show e.g. background graphics from @media print rules.
433 +
434 +==== 1.6.1 ====
435 +
436 +* Fix compatibility with Windows service installation script
437 +
438 +==== 1.6.0 ====
439 +
440 +* Update puppeteer to latest version, which uses Chromium 108.0.5351.0
441 +* Add CLI flag //~-~-disableCache=true// to disable the browser cache--
442 +* Add CLI flag //~-~-isolatedBrowser=true// to use a new browser instance for each request.--
443 +* Fix Debian install script, install libgbm1.
444 +
445 +==== 1.5.1 ====
446 +
406 406  * Update node-windows dependency
407 407  
408 -==== 1.5.0
449 +==== 1.5.0 ====
409 409  
410 410  * Update to Chromium 105.0.5173.0
411 411  * Requires at least Node.JS version 14 or higher
412 412  
413 -==== 1.4.1
454 +==== 1.4.1 ====
414 414  
415 415  * Fix windows service install / uninstall script (//install-windows-service.js// and //uninstall-windows-service.js//)
416 416  
417 -==== 1.4.0
458 +==== 1.4.0 ====
418 418  
419 419  * When an error occurs while printing, that error is returned as part of the HTTP response
420 420  * The print server can now be used for printing arbitrary pages / URLs. JavaScript and CSS that must be run in the context of the page to print can be passed as part of the HTTP request.
421 -* The //~/pdf// endpoint without parameters returns a quick summary of the server status
462 +* The ///pdf// endpoint without parameters returns a quick summary of the server status