Wiki-Quellcode von PDF-Utils-Plugin
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
1 | [[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/fc-plugin-pdf-utils&fileid=3371||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 | |||
7 | {{content/}} | ||
8 | |||
9 | Das Plugin-Bundle //fc-plugin-pdf-utils// stellt Aktionen jeweils eine [[Aktion>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WebHome]] bereit, mit der | ||
10 | * ein PDF-Dokumente signiert werden kann | ||
11 | * ein vorhandenes PDF-Dokument in das PDF/A-Format (oder ein anderes PDF-Format) umgewandelt werden kann | ||
12 | * mehrere PDF-Dokumente in ein Dokument zusammengefügt werden können | ||
13 | |||
14 | == Installation == | ||
15 | |||
16 | 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]]. | ||
17 | |||
18 | == Pluginparameter == | ||
19 | |||
20 | Nach der Installation des Plugins können die folgenden Parameter konfiguriert werden. Es müssen nicht zwingend alle Parameter konfiguirert sein, sondern nur diejenigen, welche für die geplante Verwendung benötigt werden. | ||
21 | |||
22 | ; **enable.producer.set.applicationname** | ||
23 | : Legt fest, ob die Metadaten "producer" und "creator" in erzeugten PDFs mit dem Namen der Anwendung gefüllt werden sollen. Standardwert: **true** | ||
24 | ; **enable.producer.action.properties** | ||
25 | : Legt fest, ob die Metadaten "producer" und "creator" innerhalb der jeweiligen Aktionen einzeln konfiguriert werden können. Standardwert: **false** | ||
26 | ; **pdf.sign.cert.pwd** | ||
27 | : Mit diesem Parameter kann ein globales Passworet gesetzt werden, welches als Standardpasswort für alle Aktionen zum Signieren von PDFs verwendet wird. | ||
28 | ; **pdf.sign.timestampserver.use** | ||
29 | : Legt fest, ob ein globaler Zeitserver für alle Aktionen zum Signieren von PDFs verwendet werden soll. Standardwert: **false** | ||
30 | ; **pdf.sign.timestampserver.url** | ||
31 | : Legt die URL fest, unter der ein für alle Aktionen zum Signieren von PDFs verwendeter globaler Zeitserver erreicht werden kann. Die Antwort des Zeitservers muss der RFC3161 entsprechen. Standardwert: **{{html}}http://timestamp.apple.com/ts01{{/html}}** | ||
32 | ; **pdf.sign.timestampserver.usr** | ||
33 | : Optionaler Parameter, mit dem ein Benutzername angegeben werden kann, welcher für den Zugriff auf den oben konfigurierten globalen Zeitserver benötigt wird. | ||
34 | ; **pdf.sign.timestampserver.pwd** | ||
35 | : Optionaler Parameter, mit dem ein Passwort angegeben werden kann, welches für den Zugriff auf den oben konfigurierten globalen Zeitserver benötigt wird. | ||
36 | |||
37 | = Verfügbare Pluginaktionen = | ||
38 | |||
39 | == PDF-Utils:Merge PDF == | ||
40 | |||
41 | Mit dieser Aktion können mehrere PDF-Dokumente in ein PDF-Dokument zusammengeführt werden. Die folgenden Optionen werden zum Konfigurieren der Plugin-Aktion verwendet: | ||
42 | |||
43 | === Allgemeine Einstellungen === | ||
44 | |||
45 | ; **PDFs** | ||
46 | : Hier können die PDFs ausgewählt werden, welche im Ausgabedokument zusammengeführt werden. Zudem kann die die Reihenfolge bestimmt werden. | ||
47 | : | ||
48 | : Es können dazu einzelne oder mehrere PDFs in der rechten oder linken Liste ausgewählt und mittels den zwischen den Listen befindlichen Schaltflächen mit dem nach rechts bzw. links zeigenden Pfeil zum zu erstellenden Dokument hinzugefügt oder entfernt werden. Alternativ können mit den doppelten Pfeilen alle vorhandenen Elemente aus einer der Liste in die andere verschoben werden. In der Liste "Ausgewählt" können selektierte Elemente innerhalb der Listemit den rechts davon befindlichen Schaltflächen nach oben oder nach unten verschoben werden. Auch per Drag&Drop können die PDFs zwischen und innerhalb von Listen verschoben werden. | ||
49 | : | ||
50 | : Es können nur Dokumente aus der Status- und Aktionsverarbeitung ausgewählt werden. Um Dateien aus Uploadelementen im Formular zu verwenden, ist es daher nötig, diese mit einer Aktion vom Typ [[//Upload bereitstellen//>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.DeprecatedProvideUpload]] für die Verwendung bereitzustellen. | ||
51 | |||
52 | ; **Name der Ausgabedatei** | ||
53 | : Dateiname, unter dem das erzeugte PDF-Dokument gespeichert wird. | ||
54 | |||
55 | === Metadaten === | ||
56 | |||
57 | Unter diesem Punkt können Metadaten des zuerszeugenden PDF-Dokuments festgelegt werden. Dabei können durch die Nutzung von Platzhaltern auch erfasste Inhalte aus dem Formular verwendet werden. | ||
58 | |||
59 | ; **Titel** | ||
60 | : Inhalt des Metadatenfeldes //title// im erzeugten PDF. | ||
61 | ; **Betreff** | ||
62 | : Inhalt des Metadatenfeldes //subject// im erzeugten PDF. | ||
63 | ; **Schlagwörter** | ||
64 | : Inhalt des Metadatenfeldes //keywords// im erzeugten PDF. | ||
65 | ; **Autor** | ||
66 | : Inhalt des Metadatenfeldes //author// im erzeugten PDF. | ||
67 | |||
68 | Die beiden folgenden Optionen sind nur dann verfügbar, wenn der Pluginparameter **enable.producer.action.properties** auf **true** gesetzt wurde. | ||
69 | |||
70 | ; **Inhalt erstellt mit** | ||
71 | : Inhalt des Metadatenfeldes //producer// im erzeugten PDF. Falls das Feld leer gelassen wird, wird der Standardwert verwendet, der durch die getroffene Einstellung beim Pluginparameter **enable.producer.set.applicationname** vorgegeben wird. | ||
72 | ; **Codierungs-Software** | ||
73 | : Inhalt des Metadatenfeldes //creator// im erzeugten PDF. Falls das Feld leer gelassen wird, wird der Standardwert verwendet, der durch die getroffene Einstellung beim Pluginparameter **enable.producer.set.applicationname** vorgegeben wird. | ||
74 | |||
75 | === Ablage der erzeugten Dateien === | ||
76 | ; **An den Vorgang anhängen** | ||
77 | : Die in dieser Aktion erzeugte Datei ist standardmäßig nur während der Status- und Aktionsverarbeitung verfügbar. Wenn diese Option aktiviert wird, kann die durch die Aktion erzeugte Datei an den Vorgang angehangen werden. | ||
78 | |||
79 | == PDF-Utils:PDF to PDF/A == | ||
80 | |||
81 | Mit dieser Aktion können mehrere PDF-Dokumente in ein PDF-Dokument zusammengeführt werden. Die folgenden Optionen werden zum Konfigurieren der Plugin-Aktion verwendet: | ||
82 | |||
83 | === PDF/A Einstellungen === | ||
84 | |||
85 | ; **PDF** | ||
86 | : Auswahl des Quelldokuments für die Umwandlung. Es können nur Dokumente aus der Status- und Aktionsverarbeitung ausgewählt werden. Um Dateien aus Uploadelementen im Formular zu verwenden, ist es daher nötig, diese mit einer Aktion vom Typ [[//Upload bereitstellen//>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.DeprecatedProvideUpload]] für die Verwendung bereitzustellen. | ||
87 | ; **Format** | ||
88 | : Format des zu erzeugenden PDF-Dokuments. Standardmäßig wird //PDF/A-3b// verwendet. Neben den PDF/A-Formaten können als Augabeformat auch normale PDF-Versionen ausgewählt werden. | ||
89 | ; **Name der Ausgabedatei** | ||
90 | : Dateiname, unter dem das erzeugte PDF-Dokument gespeichert wird. | ||
91 | |||
92 | === Metadaten === | ||
93 | |||
94 | Unter diesem Punkt können Metadaten des zuerszeugenden PDF-Dokuments festgelegt werden. Dabei können durch die Nutzung von Platzhaltern auch erfasste Inhalte aus dem Formular verwendet werden. | ||
95 | |||
96 | ; **Titel** | ||
97 | : Inhalt des Metadatenfeldes //title// im erzeugten PDF. | ||
98 | ; **Betreff** | ||
99 | : Inhalt des Metadatenfeldes //subject// im erzeugten PDF. | ||
100 | ; **Schlagwörter** | ||
101 | : Inhalt des Metadatenfeldes //keywords// im erzeugten PDF. | ||
102 | ; **Autor** | ||
103 | : Inhalt des Metadatenfeldes //author// im erzeugten PDF. | ||
104 | |||
105 | Die beiden folgenden Optionen sind nur dann verfügbar, wenn der Pluginparameter **enable.producer.action.properties** auf **true** gesetzt wurde. | ||
106 | |||
107 | ; **Inhalt erstellt mit** | ||
108 | : Inhalt des Metadatenfeldes //producer// im erzeugten PDF. Falls das Feld leer gelassen wird, wird der Standardwert verwendet, der durch die getroffene Einstellung beim Pluginparameter **enable.producer.set.applicationname** vorgegeben wird. | ||
109 | ; **Codierungs-Software** | ||
110 | : Inhalt des Metadatenfeldes //creator// im erzeugten PDF. Falls das Feld leer gelassen wird, wird der Standardwert verwendet, der durch die getroffene Einstellung beim Pluginparameter **enable.producer.set.applicationname** vorgegeben wird. | ||
111 | |||
112 | === Ablage der erzeugten Dateien === | ||
113 | ; **An den Vorgang anhängen** | ||
114 | : Die in dieser Aktion erzeugte Datei ist standardmäßig nur während der Status- und Aktionsverarbeitung verfügbar. Wenn diese Option aktiviert wird, kann die durch die Aktion erzeugte Datei an den Vorgang angehangen werden. | ||
115 | |||
116 | == PDF-Utils:Sign PDF == | ||
117 | |||
118 | |||
119 | |||
120 |