Änderungen von Dokument Print-Service-Plugin


Von Version 16.3
bearbeitet von awa
am 14.06.2022, 14:17
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 16.10
bearbeitet von awa
am 25.08.2022, 14:45
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -223,7 +223,7 @@
223 223  : Hintergrundbilder und Farben werden nicht immer mit berücksichtigt, dies kann hiermit erzwungen werden.
224 224  
225 225  ; Blankodruck
226 -: Wenn aktiviert, werden beim Druck alle Formularfelder geleert, alle versteckten Felder angezeigt. Zudem werden einige weitere Anpassungen für Blankodrücke vorgenommen, etwa wird die maximale Anzahl an Elementwiederholungen erzeugt.
226 +: (erfordert wenigstens Print-Plugin ab Version 4.2.0 und Print-Service ab Version 1.4.0) Wenn aktiviert, werden beim Druck alle Formularfelder geleert, alle versteckten Felder angezeigt. Zudem werden einige weitere Anpassungen für Blankodrücke vorgenommen, etwa wird die maximale Anzahl an Elementwiederholungen erzeugt.
227 227  
228 228  ; Formulartitel in der Kopfzeile anzeigen
229 229  : Titel des Formulars im Kopfbereich des Dokumentes mitdrucken.
... ... @@ -261,41 +261,6 @@
261 261  ; An den Vorgang anhängen
262 262  : Die Datei dauerhaft speichern. Diese Einstellung ist auch notwendig, wenn die Datei z.B. auf einer Abschlussseite als Download (mittels [[Attachment-Platzhalter>>doc:Formcycle.UserInterface.Variables||anchor="HSystemplatzhalterfFCrHTML-Templates" target="_blank"]]) angeboten werden soll.
263 263  
264 -== JavaScript-Anpassungen für Druckbild
265 -
266 -Manchmal kann es erforderlich sein, vor dem Druck noch JavaScript auszuführen. Hierzu kann die Funktion //$.xutil.onPrint// verwendet werden, welche folgende Signatur hat
267 -
268 -{{code language="text"}}
269 -function onPrint(callback: () => Promise<void> | void): void
270 -{{/code}}
271 -
272 -Mit dieser Funktion können ein oder mehrere Callbacks registriert werden, welche vor dem Druck ausgeführt werden. Wenn ein Callback ein //Promise// zurückliefert, wird mit dem Druck gewartet, bis das Promise erfüllt ist. Falls das Promise abgewiesen wird, wird der Fehler gelogged, der Print aber nicht abgebrochen. Zu beachten ist weiterhin, dass die Registrierung der Callbacks vor dem Druck erfolgen muss, also beispielsweise innerhalb eines JQuery-Document-Ready-Handlers (//$(callback)//).
273 -
274 -Falls beispielsweise ein AJAX-Request fertig ausgeführt werden soll, bevor mit dem Druck begonnen wird:
275 -
276 -{{js}}
277 - $.xutil.onPrint(async () => {
278 - const response = await fetch("http://some-url.de");
279 - // do something with response
280 - });
281 -{{/js}}
282 -
283 -{{jsIE}}
284 - $.xutil.onPrint(function() {
285 - return new Promise(function(resolve, reject) {
286 - $.ajax("http://some-url.de", {
287 - success: function(data, textStatus, jqXHR) {
288 - // Do something with the response data
289 - resolve(undefined);
290 - },
291 - error: function(jqXHR, textStatus, errorThrown) {
292 - reject("HTTP request error: " + textStatus + " - " + errorThrown);
293 - },
294 - });
295 - });
296 - });
297 -{{/jsIE}}
298 -
299 299  == CSS-Anpassungen für Druckbild ==
300 300  
301 301  Allgemeine CSS-Anpassungen für den Druck können über eine entsprechende Media-Query umgesetzt werden:
... ... @@ -312,13 +312,13 @@
312 312  
313 313  ; xm-print
314 314  : Wird immer angefügt.
315 -; xm-print--mode-plain
280 +; xm-print~-~-mode-plain
316 316  : Wird angefügt, wenn als Druckmodus //Formularfelder bewahren// ausgewählt ist.
317 -; xm-print--mode-dynamic
282 +; xm-print~-~-mode-dynamic
318 318  : Wird angefügt, wenn als Druckmodus //Formularfelder in Text umwandeln// ausgewählt ist.
319 -; xm-print--style-filled
284 +; xm-print~-~-style-filled
320 320  : Wird angefügt, wenn die Option //Blankodruck// deaktiviert ist.
321 -; xm-print--style-blank
286 +; xm-print~-~-style-blank
322 322  : Wird angefügt, wenn die Option //Blankodruck// aktiviert ist.
323 323  
324 324  === Textfelder und Auswahllisten ===
... ... @@ -409,45 +409,101 @@
409 409  
410 410  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.
411 411  
377 +== JavaScript-Anpassungen für Druckbild
378 +
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 +
381 +{{code language="text"}}
382 +function onPrint(callback: () => Promise<void> | void): void
383 +{{/code}}
384 +
385 +Mit dieser Funktion können ein oder mehrere Callbacks registriert werden, welche vor dem Druck ausgeführt werden. Wenn ein Callback ein //Promise// zurückliefert, wird mit dem Druck gewartet, bis das Promise erfüllt ist. Falls das Promise abgewiesen wird, wird der Fehler gelogged, der Print aber nicht abgebrochen. Zu beachten ist weiterhin, dass die Registrierung der Callbacks vor dem Druck erfolgen muss, also beispielsweise innerhalb eines JQuery-Document-Ready-Handlers (//$(callback)//).
386 +
387 +Falls beispielsweise ein AJAX-Request fertig ausgeführt werden soll, bevor mit dem Druck begonnen wird:
388 +
389 +{{js}}
390 + $.xutil.onPrint(async () => {
391 + const response = await fetch("http://some-url.de");
392 + // do something with response
393 + });
394 +{{/js}}
395 +
396 +{{jsIE}}
397 + $.xutil.onPrint(function() {
398 + return new Promise(function(resolve, reject) {
399 + $.ajax("http://some-url.de", {
400 + success: function(data, textStatus, jqXHR) {
401 + // Do something with the response data
402 + resolve(undefined);
403 + },
404 + error: function(jqXHR, textStatus, errorThrown) {
405 + reject("HTTP request error: " + textStatus + " - " + errorThrown);
406 + },
407 + });
408 + });
409 + });
410 +{{/jsIE}}
411 +
412 412  == Versionshistorie
413 413  
414 -=== 4.2.0
414 +=== Plugin
415 415  
416 +==== 4.2.2
417 +
418 +* Fix: Bei Textareas, wo die automatische Höhenanpassung aktiviert ist, wird vor dem Druck die Höhe noch einmal neu berechnet.
419 +
420 +==== 4.2.1
421 +
422 +* Fix: Version des Print-Server beim Check wird korrekt angezeigt
423 +
424 +==== 4.2.0
425 +
416 416  * Feature: Neue Option //Blankodruck// im Plugin
427 +* Feature: Es werden einige CSS-Klassen //xm-print// an das //form.xm-form// angefügt.
417 417  * Change: Ist im Designer unter Print-Einstellungen (Word- und PDF-Export-Optionen) eingestellt, dass ein Element versteckt sein soll, wird dieses auch im Druck nicht mitgedruckt. FÜr dieses Features ist {{formcycle/}} Version 7.0.14 oder höher erforderlich.
418 418  * 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.
419 419  * 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.
420 420  
421 -=== 4.1.2
432 +==== 4.1.2
422 422  
423 423  * Hinweis in der Plugin-Oberfläche bezüglich //$.xutil.onPrint// ergänzt.
424 424  
425 -=== 4.1.1
436 +==== 4.1.1
426 426  
427 427  * Erfordert wenigstens {{formcycle/}} in Version 7.0.4.
428 428  * Change: Pflichtfeldhinweis wird nicht mehr angezeigt
429 429  * Fix: Datumformat wird wieder sofort eingeblendet
430 430  
431 -=== 4.1.0
442 +==== 4.1.0
432 432  
433 433  * Status zum Drucken kann ausgewählt werden. Ist kein Status ausgewählt, wird wie bisher der aktuelle Status des Vorgangs genommen.
434 434  * Konfigurierte Nutzergruppen werden korrekt an der Aktion gespeichert.
435 435  
436 -=== 4.0.2
447 +==== 4.0.2
437 437  
438 438  * Es kann nun ein Timeout gesetzt werden. Ist der Print-Service nicht erreichbar, wird die Aktion sonst möglicherweise nie abgebrochen.
439 439  
440 -=== 4.0.1
451 +==== 4.0.1
441 441  
442 442  * Fix: In der Aktion für den neuen Workflow wurde die Datei nicht an den Vorgang angehangen.
443 443  
444 -=== 4.0.0
455 +==== 4.0.0
445 445  
446 446  * Anpassungen für {{formcycle/}} Version 7.
447 447  
459 +=== Server
448 448  
461 +==== 1.5.0
449 449  
463 +* Update auf Chromium 105.0.5173.0
464 +* Erfordert mindestens Node.JS 14 oder höher
450 450  
466 +=== 1.4.1
451 451  
468 +* Script zum Installieren / Deinstallieren des Windows-Services ist wieder lauffähig (//install-windows-service.js// und //uninstall-windows-service.js//)
452 452  
470 +=== 1.4.0
453 453  
472 +* Bei Fehlern während des Druckens wird dieser Fehler mit der HTTP-Antwort zurückgeliefert
473 +* 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.
474 +* Bei Aufruf des Pfads //~/pdf// liefer der Print-Server nun eine Status-Report des Servers zurück.