Änderungen von Dokument Print-Service-Plugin

Von 16.3 nach 16.2 Von 17.1 nach 16.12

Von Version 16.12

bearbeitet von awa
am 05.09.2022, 12:28

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 16.3

bearbeitet von awa
am 14.06.2022, 14:17

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

@@ -223,7 +223,7 @@
  : Hintergrundbilder und Farben werden nicht immer mit berücksichtigt, dies kann hiermit erzwungen werden.
  ; Blankodruck
--: (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.
++: 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.
  ; Formulartitel in der Kopfzeile anzeigen
  : Titel des Formulars im Kopfbereich des Dokumentes mitdrucken.
@@ -261,6 +261,41 @@
  ; An den Vorgang anhängen
  : 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.
++== JavaScript-Anpassungen für Druckbild
++
++Manchmal kann es erforderlich sein, vor dem Druck noch JavaScript auszuführen. Hierzu kann die Funktion //$.xutil.onPrint// verwendet werden, welche folgende Signatur hat
++
++{{code language="text"}}
++function onPrint(callback: () => Promise<void> | void): void
++{{/code}}
++
++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)//).
++
++Falls beispielsweise ein AJAX-Request fertig ausgeführt werden soll, bevor mit dem Druck begonnen wird:
++
++{{js}}
++  $.xutil.onPrint(async () => {
++    const response = await fetch("http://some-url.de");
++    // do something with response
++  });
++{{/js}}
++
++{{jsIE}}
++  $.xutil.onPrint(function() {
++    return new Promise(function(resolve, reject) {
++      $.ajax("http://some-url.de", {
++        success: function(data, textStatus, jqXHR) {
++          // Do something with the response data
++          resolve(undefined);
++        },
++        error: function(jqXHR, textStatus, errorThrown) {
++          reject("HTTP request error: " + textStatus + " - " + errorThrown);
++        },
++      });
++    });
++  });
++{{/jsIE}}
++
  == CSS-Anpassungen für Druckbild ==
  Allgemeine CSS-Anpassungen für den Druck können über eine entsprechende Media-Query umgesetzt werden:
@@ -277,13 +277,13 @@
  ; xm-print
  : Wird immer angefügt.
--; xm-print~-~-mode-plain
++; xm-print--mode-plain
  : Wird angefügt, wenn als Druckmodus //Formularfelder bewahren// ausgewählt ist.
--; xm-print~-~-mode-dynamic
++; xm-print--mode-dynamic
  : Wird angefügt, wenn als Druckmodus //Formularfelder in Text umwandeln// ausgewählt ist.
--; xm-print~-~-style-filled
++; xm-print--style-filled
  : Wird angefügt, wenn die Option //Blankodruck// deaktiviert ist.
--; xm-print~-~-style-blank
++; xm-print--style-blank
  : Wird angefügt, wenn die Option //Blankodruck// aktiviert ist.
  === Textfelder und Auswahllisten ===
@@ -374,109 +374,45 @@
  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.
--== JavaScript-Anpassungen für Druckbild
--
--Manchmal kann es erforderlich sein, vor dem Druck noch JavaScript auszuführen. Hierzu kann die Funktion //$.xutil.onPrint// verwendet werden, welche folgende Signatur hat
--
--{{code language="text"}}
--function onPrint(callback: () => Promise<void> | void): void
--{{/code}}
--
--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)//).
--
--Falls beispielsweise ein AJAX-Request fertig ausgeführt werden soll, bevor mit dem Druck begonnen wird:
--
--{{js}}
--  $.xutil.onPrint(async () => {
--    const response = await fetch("http://some-url.de");
--    // do something with response
--  });
--{{/js}}
--
--{{jsIE}}
--  $.xutil.onPrint(function() {
--    return new Promise(function(resolve, reject) {
--      $.ajax("http://some-url.de", {
--        success: function(data, textStatus, jqXHR) {
--          // Do something with the response data
--          resolve(undefined);
--        },
--        error: function(jqXHR, textStatus, errorThrown) {
--          reject("HTTP request error: " + textStatus + " - " + errorThrown);
--        },
--      });
--    });
--  });
--{{/jsIE}}
--
  == Versionshistorie
--=== Plugin
++=== 4.2.0
--==== 4.2.3
--
--* Fix: Sonderzeichen im Wert von Auswahloptionen bei Combobox-Felder werden nun immer korrekt im Druck dargestellt.
--
--==== 4.2.2
--
--* Fix: Bei Textareas, wo die automatische Höhenanpassung aktiviert ist, wird vor dem Druck die Höhe noch einmal neu berechnet.
--
--==== 4.2.1
--
--* Fix: Version des Print-Server beim Check wird korrekt angezeigt
--
--==== 4.2.0
--
  * Feature: Neue Option //Blankodruck// im Plugin
--* Feature: Es werden einige CSS-Klassen //xm-print// an das  //form.xm-form// angefügt.
  * 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.
  * 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.
  * 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.
--==== 4.1.2
++=== 4.1.2
  * Hinweis in der Plugin-Oberfläche bezüglich //$.xutil.onPrint// ergänzt.
--==== 4.1.1
++=== 4.1.1
  * Erfordert wenigstens {{formcycle/}} in Version 7.0.4.
  * Change: Pflichtfeldhinweis wird nicht mehr angezeigt
  * Fix: Datumformat wird wieder sofort eingeblendet
--==== 4.1.0
++=== 4.1.0
  * Status zum Drucken kann ausgewählt werden. Ist kein Status ausgewählt, wird wie bisher der aktuelle Status des Vorgangs genommen.
  * Konfigurierte Nutzergruppen werden korrekt an der Aktion gespeichert.
--==== 4.0.2
++=== 4.0.2
  * Es kann nun ein Timeout gesetzt werden. Ist der Print-Service nicht erreichbar, wird die Aktion sonst möglicherweise nie abgebrochen.
--==== 4.0.1
++=== 4.0.1
  * Fix: In der Aktion für den neuen Workflow wurde die Datei nicht an den Vorgang angehangen.
--==== 4.0.0
++=== 4.0.0
  * Anpassungen für {{formcycle/}} Version 7.
--=== Server
--==== 1.5.1
--* Abhängigkeit node-windows aktualisiert
--==== 1.5.0
--* Update auf Chromium 105.0.5173.0
--* Erfordert mindestens Node.JS 14 oder höher
--==== 1.4.1
--* Script zum Installieren / Deinstallieren des Windows-Services ist wieder lauffähig (//install-windows-service.js// und //uninstall-windows-service.js//)
--
--==== 1.4.0
--
--* Bei Fehlern während des Druckens wird dieser Fehler mit der HTTP-Antwort zurückgeliefert
--* 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.
--* Bei Aufruf des Pfads //~/pdf// liefer der Print-Server nun eine Status-Report des Servers zurück.