Zusammenfassung

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

Details

Seiteneigenschaften

Titel

...	...	@@ -1,1 +1,1 @@
1		-Print-Service
	1	+Print-Service Plugin

Dokument-Autor

...	...	@@ -1,1 +1,1 @@
1		-XWiki.nlo
	1	+XWiki.gru

Inhalt

...	...	@@ -1,21 +1,49 @@
	1	+[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-phantomjs&fileid=342||target="_blank"]] (erfordert Anmeldung)
	2	+
	3	+{{info}}
	4	+Bitte verwenden Sie für {{formcycle/}} Version 6 das Plugin ab **Version 2.0.0**.
	5	+{{/info}}
	6	+
1	1	{{content/}}
2	2
3		-Das Plugin //Print-Service//, welches separat angeboten wird, ermöglicht es, in der Statusverarbeitung ein PDF aus dem Formular zu erzeugen, welches besser für den Druck geeignet ist. Um das Plugin zu nutzen, fügen Sie eine Aktion vom Typ [[Plugin ausführen>>doc:WebHome]] in der Statusverarbeitung hinzu. Technisch erfolgt die Umsetzung mittels Selenium und dem Treiber //phantomJS//. Das PDF-Dokument wird im Format A4 erzeugt.
	9	+Das Plugin //Print-Service// ermöglicht es, in der Statusverarbeitung ein PDF aus dem Formular zu erzeugen, welches besser für den Druck geeignet ist.
4	4
	11	+== Technische Besonderheiten ==
	12	+
	13	+Technisch erfolgt die Umsetzung mittels Selenium und dem Treiber //phantomJS//. Das PDF-Dokument wird im Format A4 erzeugt.
	14	+
	15	+{{warning}}
	16	+Beim Drucken mit dem Print-Service wird JavaScript aus dem Formular ausgeführt. Hierbei muss allerdings beachtet werden, dass hierbei keine neuen JavaScript-Funktionen zur Verfügung stehen. Konkret werden keine Funktionalitäten ab {{smallcaps}}Ecma{{/smallcaps}}Script6 und höher unterstützt. Es können also etwa keine neuen Schlüsselwörter wie //let// und //const// oder neue Syntax wie Arrow-Funktionen oder Destrukturierung verwendet werden.
	17	+{{/warning}}
	18	+
	19	+== Installation ==
	20	+
	21	+Das Plugin kann als Mandant-Plugin oder System-Plugin installiert werden. Eine Anleitung zur Installation von Plugins finden Sie [[hier>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]].
	22	+
	23	+{{info}}Es existieren mehrere Versionen des Print-PDF-Plugins für verschiedne Betriebssysteme (//32-Bit Linux//, //64-Bit Linux//, //Windows//, //MacOSX//). Es muss nur die Version des Plugin installiert werden, welche dem Betriebssystem entspricht, auf dem {{formcycle /}} installiert ist.{{/info}}
	24	+
5	5	== Optionen ==
6	6
7		-* Dateiname: Dateiname, unter dem das erzeugte PDF-Dokument gespeichert wird.
8		-* Druckmodus Formular mit textueller Ausgabe von Werten: Eingabefelder werden in Text umgewandelt und das Formular wird in der Breite entsprechend angepasst, siehe nächster Abschnitt.
9		-* Druckmodus Formular mit Eingabefeldern: Das Formular wird so in dem PDF ausgegeben wie es auch im Browser aussieht.
10		-* Zoomfaktor: 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.
11		-* Benutzergruppen: 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.
12		-* URL-Parameter: 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.FormDesigner.URLParameter]]. Auf diese URL-Parameter kann auch von selbstgeschriebenen JavaScript im Scriptbereich zugegriffen werden.
	27	+Um das Plugin zu nutzen, klicken Sie in der Statusverarbeitung auf neue Aktion und wählen das Print-Plugin aus. Die folgenden Optionen werden zum Konfigurieren der Plugin-Aktion verwendet:
13	13
	29	+; **Dateiname**
	30	+: Dateiname, unter dem das erzeugte PDF-Dokument gespeichert wird.
	31	+; **Druckmodus Formular mit textueller Ausgabe von Werten**
	32	+: Eingabefelder werden in Text umgewandelt und das Formular wird in der Breite entsprechend angepasst, siehe nächster Abschnitt.
	33	+; **Druckmodus Formular mit Eingabefeldern**
	34	+: Das Formular wird so in dem PDF ausgegeben wie es auch im Browser aussieht.
	35	+; **Zoomfaktor**
	36	+: 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.
	37	+; **Benutzergruppen**
	38	+: 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.
	39	+; **URL-Parameter**
	40	+: 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.FormDesigner.URLParameter]]. Auf diese URL-Parameter kann auch von selbstgeschriebenem JavaScript im Scriptbereich zugegriffen werden.
	41	+
14	14	== Textfelder und Auswahllisten ==
15	15
16		-Zur Optimierung des PDF-Dokuments für den Druck werden Formularelemente vom Typ [[Eingabefeld>>Formcycle.FormDesigner.FormElements.Input]], [[Textarea>>Formcycle.FormDesigner.FormElements.Textarea]] und [[Auswahl>>Formcycle.FormDesigner.FormElements.Selection]] (Drop-Down) in reine Textfelder umgewandelt. Zudem werden diese mit der CSS-Klasse //print// und //XSpan// versehen, welches für Anpassungen des Aussehens verwendet werden kann. Um etwas die Schriftgröße zu ändern, kann folgendes CSS verwendet werden:
	44	+Zur Optimierung des PDF-Dokuments für den Druck werden Formularelemente vom Typ [[Eingabefeld>>Formcycle.FormDesigner.FormElements.Input]], [[Textarea>>Formcycle.FormDesigner.FormElements.Textarea]] und [[Auswahl>>Formcycle.FormDesigner.FormElements.Selection]] (Drop-Down) in reine Textfelder umgewandelt, falls als Druckmodus Formular mit textueller Ausgabe von Werten eingestellt ist. Zudem werden diese mit der CSS-Klasse //print// und //XSpan// versehen, welches für Anpassungen des Aussehens verwendet werden kann. Um etwas die Schriftgröße zu ändern, kann folgendes CSS verwendet werden:
17	17
18		-{{code langauge="css"}}
	46	+{{code language="css"}}
19	19	.print.XSpan {
20	20	font-size: 18pt;
21	21	font-family: serif;
...	...	@@ -24,7 +24,7 @@
24	24
25	25	Um einige Eigenschaften des Standard-CSS zu überschreiben, welches mit {{formcycle/}} ausgeliefert wird, können spezifischerer Selektoren verwendet werden, wie beispielsweise
26	26
27		-{{code langauge="css"}}
	55	+{{code language="css"}}
28	28	xm-form .xm-content div.print.XSpan {
29	29	font-size: 18pt;
30	30	font-family: serif;