Änderungen von Dokument Print-Service-Plugin

Zusammenfassung

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

Details

Seiteneigenschaften

Dokument-Autor

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

Inhalt

...	...	@@ -1,12 +1,8 @@
1	1	[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/fc-plugin-print-service&fileid=8194||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung)
2	2
3		-{{info}}
4		-Für {{formcycle/}} Version 7 wird das //Print-Service// Plugin in der Version **4.0.0** oder höher benötigt.
5		-{{/info}}
6		-
7	7	{{content/}}
8	8
9		-Das kostenpflichtige Plugin //Print-Service// ermöglicht es, im Workflow ein PDF aus dem Formular zu erzeugen, welches besser für den Druck geeignet ist.
	5	+Das kostenpflichtige Plugin //Print-Service// ermöglicht es, in der Statusverarbeitung ein PDF aus dem Formular zu erzeugen, welches besser für den Druck geeignet ist.
10	10
11	11	== Technische Besonderheiten ==
12	12
...	...	@@ -16,7 +16,7 @@
16	16
17	17	Die Installation des benötigten //Print Servers// erfordert je nach Betriebssystem unterschiedlicher Vorgehensweisen.
18	18
19		-=== Installation Print Server unter Windows ===
	15	+=== Installation Print Server unter Windows ===
20	20
21	21	==== Installation von Node.js ====
22	22
...	...	@@ -111,10 +111,9 @@
111	111
112	112	==== Installation Plugin Print-Service ====
113	113
114		-Damit das Plugin in {{formcycle/}} als Aktion im Workflow zur Verfügung steht, muss dieses im Bereich Systemplugin der Verwaltungsoberfläche bereitgestellt werden. Eine Anleitung zur Installation von Plugins finden Sie [[hier>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]].
	110	+Damit das Plugin in {{formcycle/}} als Aktion in der Verarbeitung zur Verfügung steht, muss dieses im Bereich Systemplugin der Verwaltungsoberfläche bereitgestellt werden. Eine Anleitung zur Installation von Plugins finden Sie [[hier>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]].
115	115
116	116	Falls bereits die alte Version des Print-Service Plugins (Phantom-Plugin) installiert war, wird folgende Vorgehensweise für die Installation empfohlen:
117		-
118	118	* Phantom-Plugin deaktivieren
119	119	* Phantom-Plugin löschen
120	120	* Neues Print-Service Plugin hochladen
...	...	@@ -127,7 +127,7 @@
127	127	Ist die Installation auf dem gleichen Server wie {{formcycle/}} erfolgt, dann ist als Domain {{code language="none"}}localhost{{/code}} anzugeben. Wurden keine Änderungen an dem Port vorgenommen, so bleibt die Einstellung {{code language="none"}}8090{{/code}} beibehalten.
128	128	Zum Beispiel: {{code language="none"}}http://localhost:8089/pdf{{/code}}
129	129
130		-Damit ist die Einrichtung des Print-Service Plugins abgeschlossen und steht als Aktion im Workflow zur Verfügung.
	125	+Damit ist die Einrichtung des Print-Service Plugins abgeschlossen und steht als Aktion in der Verarbeitung zur Verfügung.
131	131
132	132	=== Troubleshooting ===
133	133
...	...	@@ -160,7 +160,9 @@
160	160	==== Download Chromium schlägt fehl ====
161	161
162	162	Folgende Fehlermeldung erscheint auf der Konsole nach der Ausführung von „npm install“:
163		-{{code language="none"}}Error: unable to verify the first certificate{{/code}}
	158	+{{code language="none"}}
	159	+Error: unable to verify the first certificate
	160	+{{/code}}
164	164
165	165	Bei den beschriebenen Schritten handelt es sich nur um einen Workaround und die Umgebungsvariablen sollten nach der erfolgreichen Installation wieder auf die Standardwerte gesetzt werden!
166	166
...	...	@@ -171,7 +171,7 @@
171	171
172	172	== Optionen der Plugin-Aktion ==
173	173
174		-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:
	171	+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:
175	175
176	176	; **Dateiname**
177	177	: Dateiname, unter dem das erzeugte PDF-Dokument gespeichert wird.
...	...	@@ -184,18 +184,17 @@
184	184	; **Benutzergruppen**
185	185	: 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.
186	186	; **URL-Parameter**
187		-: 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.
	184	+: 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.
188	188
189	189	== CSS-Anpassungen für Druckbild ==
190		-
191	191	=== Textfelder und Auswahllisten ===
192	192
193		-Zur Optimierung des PDF-Dokuments für den Druck werden Formularelemente vom Typ [[Eingabefeld>>Formcycle.Designer.Form.FormElements.Input]], [[Textarea>>Formcycle.Designer.Form.FormElements.Textarea]] und [[Auswahl>>Formcycle.Designer.Form.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:
	189	+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:
194	194
195	195	{{code language="css"}}
196	196	.print.XSpan {
197		- font-size: 18pt;
198		- font-family: serif;
	193	+ font-size: 18pt;
	194	+ font-family: serif;
199	199	}
200	200	{{/code}}
201	201
...	...	@@ -215,35 +215,12 @@
215	215	Um einen definierten Seitenumbruch zu erzeugen, sind die page-break Attribute per CSS zu setzen. Dabei ist der entsprechende Container bzw. Element per xn-Attribut zu selektieren. Hierbei müssen Sie beachten, dass die {{smallcaps}}Css{{/smallcaps}}-Eigenschaft //display// auf //block// gesetzt werden, sonst wird kein Zeilenumbruch erzeugt. In diesem Beispiel soll vor dem Container //div1 //ein Umbruch erzeugt werden.
216	216
217	217	{{code language="css"}}
218		-[data-xn=div2] {
	214	+[xn=div2] {
219	219	display: block !important;
220	220	page-break-before: always;
221	221	}
222	222	{{/code}}
223	223
224		-=== Seitenumbruch verhindern ===
225		-
226		-Die Standardeinstellung beim Druck sieht vor, dass nach jeder Formularseite ein Umbruch eingefügt wird:
227		-
228		-{{code language="css"}}
229		-@media print {
230		- .CXPage:not(:first-child ), .page-break {
231		- display: block !important;
232		- page-break-before: always;
233		- }
234		-}
235		-{{/code}}
236		-
237		-Um die Umbrüche zu vermeiden ist im Formularen folgende Regel im Reiter CSS zu hinterlegen:
238		-
239		-{{code language="css"}}
240		-@media print {
241		- .CXPage:not(:first-child ) {
242		- page-break-before: avoid;
243		- }
244		-}
245		-{{/code}}
246		-
247	247	=== Verwendung von anderen Schriftarten ===
248	248
249	249	==== Technische Voraussetzungen ====