Änderungen von Dokument Print-Service-Plugin

Zusammenfassung

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

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,11 +409,51 @@
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.1
	415	+
	416	+* Fix: Version des Print-Server beim Check wird korrekt angezeigt
	417	+
414	414	=== 4.2.0
415	415
416	416	* Feature: Neue Option //Blankodruck// im Plugin
	421	+* 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.