Wiki-Quellcode von Word-Datei befüllen
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
1 | {{figure image="word_fill_de.png"}} | ||
2 | Konfigurationsoberfläche der Aktion //Word-Datei befüllen//. Die Quellressource ist ein //Word-Dokument//. Die Ausgabedatei ist ein //PDF-Dokument// oder //Word-Dokument//. | ||
3 | {{/figure}} | ||
4 | |||
5 | Die Aktion //Word-Datei befüllen// befüllt ein bestehendes //Word-Dokument// mit Werten aus den übertragenen Formulardaten und erzeugt daraus wieder ein //Word-Dokument// oder ein //PDF-Dokument//. | ||
6 | |||
7 | Das Word-Dokument muss entsprechend hierfür vorbereitet sein, siehe hierzu den Abschnitt [[Vorrausetzung des zu befüllenden Word-Dokuments>>doc:Formcycle.Designer.Workflow.Actions.FillWordDocument.PreparationWord]]. | ||
8 | |||
9 | == Parameter == | ||
10 | === Details für die Word-Generierung mittels Word-Datei === | ||
11 | ; Datei | ||
12 | : Auswahl des zu verwendenden Word-Dokuments. Es können [[Formulardateien>>Formcycle.UserInterface.MyForms.Files]], [[Mandantdateien>>Formcycle.UserInterface.FilesAndTemplates.Files]], über eine URL geladene Dateien oder Vorgangsanhänge Word-Datei befüllen. Siehe [[Aktionen>>doc:Formcycle.Designer.Workflow.Actions.WebHome]] für eine Liste der unterstützten URL-Protokolle. | ||
13 | ; Ressourcen-URL | ||
14 | : Eingabe der abzurufenden URL, falls als Datei //Externe Ressourcen-URL// ausgewählt wurde. | ||
15 | ; Dateiname für Suche | ||
16 | : Falls als Datei //Vorgangsanhänge mittels Dateinamen suchen// ausgewählt ist, kann hier der Dateiname zur Suche ausgewählt werden. | ||
17 | ; Typ-Filter | ||
18 | : Über diesen Filter kann die Suche der Vorgangsanhänge eingegrenzt werden. | ||
19 | |||
20 | === Ablage der erzeugten Dateien === | ||
21 | |||
22 | ; Name der Ausgabedatei | ||
23 | : Der Dateiname des zu generierenden Word-Dokuments. Dabei ist zu beachten, dass die Dateinamenerweiterung //pdf// (Ausgabe als PDF-Dokument) oder //docx// (Ausgabe als Word-Dokument) den Typ der Datei festlegt, also auf //.pdf// oder //.doc// bzw. //.docx// enden muss. Es ist auch möglich andere Formate wie z.B. HTML, XML, etc. zu erstellen. Im Grunde kann alles verwendet werden wie ein Word-Dokument gespeichert werden kann. | ||
24 | ; An den Vorgang anhängen | ||
25 | : Wenn diese Option angewählt wird, werden in dieser Aktion erzeugte Dateien an den Vorgang angehangen. Ansonsten stehen Sie nur innerhalb des Workflows für Aktionen innerhalb der selben Verarbeitungskette zur Verfügung. | ||
26 | |||
27 | == Aktionsplatzhalter == | ||
28 | |||
29 | Aktionen vom Typ //PDF-Datei befüllen// stellen [[Aktionsplatzhalter>>Formcycle.UserInterface.Variables||anchor="Aktionsplatzhalter"]] bereit, welche in darauf folgenden Aktionen verwendet werden können. | ||
30 | |||
31 | === Standardplatzhalter === | ||
32 | |||
33 | ; [%$<Aktionsname>.SUCCESS%] | ||
34 | : Rückgabe ob Aktion erfolgreich ausgeführt wurde. Liefert Boolean (true/false) zurück. | ||
35 | ; [%$<Aktionsname>.RESULT%] | ||
36 | : Rückgabe aller von der Aktion bereitgestellten Ergebnisse in strukturierter Form. | ||
37 | |||
38 | ; [%$<Aktionsname>.ERROR_CODE%] | ||
39 | : Der geworfene Fehler-Code im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist. | ||
40 | ; [%$<Aktionsname>.ERROR_MESSAGE%] | ||
41 | : Die geworfene Fehler-Nachricht im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist. | ||
42 | |||
43 | === Aktionsspezifische Platzhalter === | ||
44 | |||
45 | ; [%$<Aktionsname>.RESULT.fileSize%] | ||
46 | : Größe der erstellten Word-Datei oder PDF-Datei, in Bytes. | ||
47 | ; [%$<Aktionsname>.ERROR.message%] | ||
48 | : Fehlernachricht, die zurückgeliefert wird, wenn die Word- oder PDF-Datei nicht in das Dateisystem geschrieben werden konnte, die angegebene URL keinem gültigen Format entspricht, keine Quelldatei ermittelt werden konnte, das Datei-Format der Quelldatei nicht unterstützt wird oder beim Erzeugen des Word-Dokuments ein Fehler auftritt. | ||
49 | |||
50 | == Videos == | ||
51 | |||
52 | [[Workshop-Video>>https://help6.formcycle.eu/xwiki/bin/view/Workshops/2020/052020%20Teil%202%20-%20Word%20Fill/]] (Der Workshop bezieht sich auf FORMCYCLE Version 6. Die grundsätzlichen Inhalte sind aber auf Version 7 übertragbar) |