Zum Inhalt springen

Wiki-Quellcode von Word-Datei befüllen

Zeige letzte Bearbeiter
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)