Wiki-Quellcode von Word-Datei befüllen


Verstecke letzte Bearbeiter
XIMA Admin 1.1 1 {{figure image="word_fill_de.png"}}
jdr 7.3 2 Konfigurationsoberfläche der Aktion //Word-Datei befüllen//. Die Quellressource ist ein //Word-Dokument//. Die Ausgabedatei ist ein //PDF-Dokument// oder //Word-Dokument//.
XIMA Admin 1.1 3 {{/figure}}
4
jdr 7.3 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//.
XIMA Admin 1.1 6
gru 6.1 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]].
XIMA Admin 1.1 8
9 == Parameter ==
jdr 7.3 10 === Details für die Word-Generierung mittels Word-Datei ===
XIMA Admin 1.1 11 ; Datei
awa 15.2 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.
XIMA Admin 1.1 13 ; Ressourcen-URL
jdr 7.3 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
XIMA Admin 1.1 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.
jdr 7.3 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.
XIMA Admin 1.1 26
jdr 7.3 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
XIMA Admin 1.1 50 == Videos ==
51
gru 15.1 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)