Änderungen von Dokument Print-Service-Plugin


Von Version 12.1
bearbeitet von sas
am 11.03.2022, 10:16
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 16.1
bearbeitet von awa
am 14.06.2022, 13:44
Änderungskommentar: Add changelog

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.sas
1 +XWiki.awa
Inhalt
... ... @@ -155,7 +155,7 @@
155 155  
156 156  Damit ist die Einrichtung des Print-Service Plugins abgeschlossen und steht als Aktion im Workflow zur Verfügung.
157 157  
158 -== Troubleshooting ==
158 +== Troubleshooting Installation ==
159 159  
160 160  === Befehl npm wird nicht gefunden ===
161 161  
... ... @@ -207,19 +207,58 @@
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 -; **Dateiname**
211 -: Dateiname, unter dem das erzeugte PDF-Dokument gespeichert wird.
212 -; **Druckmodus Formular mit textueller Ausgabe von Werten**
213 -: Eingabefelder werden in Text umgewandelt und das Formular wird in der Breite entsprechend angepasst, siehe nächster Abschnitt.
214 -; **Druckmodus Formular mit Eingabefeldern**
215 -: Das Formular wird so in dem PDF ausgegeben wie es auch im Browser aussieht.
216 -; **Zoomfaktor**
210 +; **Druck-Modus**
211 +: Formular mit textueller Ausgabe von Werten: Eingabefelder werden in Text umgewandelt und das Formular wird in der Breite entsprechend angepasst, siehe nächster Abschnitt.
212 +Formular mit Eingabefeldern: Das Formular wird so in dem PDF ausgegeben wie es auch im Browser aussieht.
213 +
214 +; Papiergröße
215 +: Angabe des Formats für das gedruckte Dokument.
216 +
217 +; Seitenausrichtung
218 +: Seiteausrichtung, welche für den Druck verwendet werden soll, Quer- und Hochformat sind möglich.
219 +
220 +; Hintergrundbilder und Farben berücksichtigen
221 +: Hintergrundbilder und Farben werden nicht immer mit berücksichtigt, dies kann hiermit erzwungen werden.
222 +
223 +; Blankodruck
224 +: 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.
225 +
226 +; Formulartitel in der Kopfzeile anzeigen
227 +: Titel des Formulars im Kopfbereich des Dokumentes mitdrucken.
228 +
229 +; Seitenzahlen in der Fußzeile anzeigen
230 +: Seitanzahl in des Fußzeile des Dokumentes mitdrucken.
231 +
232 +; Datum in der Kopfzeile anzeigen
233 +: Aktuelle Daum im Kopfbereich des Dokumentes mitdrucken.
234 +
235 +; Zoomfaktor
217 217  : Faktor, um den das Formular vergrößert wird. Ist dieser kleiner 1, wird das Formular verkleinert. Kann genutzt werden, um besonders große oder kleine Formulare auf das A4-Format des PDF-Dokuments anzupassen.
218 -; **Benutzergruppen**
237 +
238 +; Rand
239 +: Einstellungen für den Rand für oben, links, rechts und unten in Millimeter.
240 +
241 +; Status beim Drucken
242 +: In Abhängigkeit von einem bestimmten Status drucken. Durch die Einstellungsmöglichkeit [[Verfügbar wenn>>doc:Formcycle.Designer.Form.ElementProperties.AvailableOnlyIf||target="_blank"]], können Formularelemente abhängig vom Status ausgeblendet werden und somit kann das Druckbild beeinflusst werden.
243 +
244 +; Benutzergruppen
219 219  : Benutzergruppen, denen der virtuelle Benutzer angehört, der das Formular über Selenium öffnet. Formularelemente können abhängig von der Benutzergruppe ausgeblendet bzw. //readonly// geschaltet werden.
220 -; **URL-Parameter**
246 +
247 +; URL-Parameter
221 221  : Zusätzliche URL-Parameter, die an die URL angehängt werden, wenn das Formular über Selenium bei der Generierung des PDF-Dokuments geöffnet wird. Diese können beispielsweise genutzt werden, um [[Formularfelder vorzubefüllen>>Formcycle.Designer.Form.URLParameter]]. Auf diese URL-Parameter kann auch von selbstgeschriebenem JavaScript im Scriptbereich zugegriffen werden.
222 222  
250 +; Timeout (in Sekunden)
251 +: Timout, bis der Druck abgebrochen wird, weil z.b. der Dienst nicht erreichbar ist. Die Standardeinstellung von 30 Sekunden zu ändern, kann dann sinnvoll sein, wenn die Last für den Druckprozessor erhöht ist um alle Anfragen abzuarbeiten.
252 +
253 +; Zeitpunkt für die PDF-Erstellung selbst bestimmen
254 +: Falls in einem selbst geschriebenen Java-Script verzögert Abfragen ausgeführt werden, dann kann mittels dem Parameter //window.print.status = true//, der Druck angestoßen werden. Dazu muss aber die Checkbox aktiviert werden. Sonst erfolgt der Druck sobald aus Sicht des Printers das Formular fertig geladen ist und Skripte ausgeführt wurden. Hierbei handelt es sich um eine fortgeschrittene Einstellung und sollte nur verwendet werden, wenn dies wirklich gebraucht wird.
255 +
256 +; Dateiname
257 +: Dateiname, unter dem das erzeugte PDF-Dokument gespeichert wird.
258 +
259 +; An den Vorgang anhängen
260 +: 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.
261 +
223 223  == CSS-Anpassungen für Druckbild ==
224 224  
225 225  === Textfelder und Auswahllisten ===
... ... @@ -306,6 +306,49 @@
306 306  
307 307  ==== Rechtliche Hinweise ====
308 308  
309 -Schriftarten haben zum Teil sehr eng umgrenzte Lizenzbedingungen und werden je nach Einsatzzweck unterschiedlich bepreist. Es ist zu beachten, dass Schriftarten für das Erstellen von PDFs in diese eingebettet werden müssen, was bei vielen kommerziellen Schriftarten eine andere Lizenz als für das Ausliefern über einen Webserver für den Zweck der Darstellung einer Webseite in einem Webbrowser verlangt.
348 +Schriftarten haben zum Teil sehr eng umgrenzte Lizenzbedingungen und werden je nach Einsatzzweck unterschiedlich bepreist. Es ist zu beachten, dass Schriftarten für das Erstellen von PDFs in diese eingebettet werden müssen, was bei vielen kommerziellen Schriftarten eine andere Lizenz als für das Ausliefern über einen Webserver für den Zweck der Darstellung einer Webseite in einem Webbrowser verlangt.
310 310  
311 311  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.
351 +
352 +== Versionshistorie
353 +
354 +=== 4.2.0
355 +
356 +* Feature: Neue Option //Blankodruck// im Plugin
357 +* 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.
358 +* 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.
359 +* 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.
360 +
361 +=== 4.1.2
362 +
363 +* Hinweis in der Plugin-Oberfläche bezüglich //$.xutil.onPrint// ergänzt.
364 +
365 +=== 4.1.1
366 +
367 +* Erfordert wenigstens {{formcycle/}} in Version 7.0.4.
368 +* Change: Pflichtfeldhinweis wird nicht mehr angezeigt
369 +* Fix: Datumformat wird wieder sofort eingeblendet
370 +
371 +=== 4.1.0
372 +
373 +* Status zum Drucken kann ausgewählt werden. Ist kein Status ausgewählt, wird wie bisher der aktuelle Status des Vorgangs genommen.
374 +* Konfigurierte Nutzergruppen werden korrekt an der Aktion gespeichert.
375 +
376 +=== 4.0.2
377 +
378 +* Es kann nun ein Timeout gesetzt werden. Ist der Print-Service nicht erreichbar, wird die Aktion sonst möglicherweise nie abgebrochen.
379 +
380 +=== 4.0.1
381 +
382 +* Fix: In der Aktion für den neuen Workflow wurde die Datei nicht an den Vorgang angehangen.
383 +
384 +=== 4.0.0
385 +
386 +* Anpassungen für {{formcycle/}} Version 7.
387 +
388 +
389 +
390 +
391 +
392 +
393 +