Änderungen von Dokument Beispiel für die Anbindung an ein ALVA9 Fachverfahren

Zusammenfassung

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

Details

Seiteneigenschaften

Inhalt

...	...	@@ -1,4 +1,4 @@
1		-Im folgenden wird Anhand eines Beispielformulars kurz beschrieben, wie Daten von {{formcycle/}} an ein [[ALVA9 System (Link zum Hersteller)>>https://www.ascherslebener-computer.de/alva-9_software-strassenverkehrsbehoerden/]] übertragen werden können.
	1	+Im folgenden wird Anhand eines Beispieles kurz beschrieben, wie Daten von {{formcycle/}} an ein [[ALVA9 System>>HERSTELLERSEITE]] übertragen werden können.
2	2
3	3	{{content/}}
4	4
...	...	@@ -8,7 +8,7 @@
8	8
9	9	== Workflow im Beispiel ==
10	10
11		-Im Formularstore kann das Beispielformular mit dem Namen "ALVA Sonn- und Feiertagsverbot" importiert oder heruntergeladen werden. In diesem werden Informationen gesammelt und diese nach dem Absenden des Formulars im [[Workflow>>doc:Formcycle.Designer.Workflow.WebHome]] über eine [[XSL-Transformation>>doc:https://de.wikipedia.org/wiki/XSL_Transformation]] in ein für ALVA9 importierbares XML-Format umgewandelt. Anschließend erstellt der Workflow aus diese XML-Datei, allen im Formular übertragenen Daten und einer PDF-Druckquittung ein ZIP-Archiv.
	11	+Im Formularstore kann das Beispielformular mit dem Namen "ALVA Sonn- und Feiertagsverbot" importiert oder heruntergeladen werden. In diesem werden Informationen gesammelt und diese nach dem Absenden des Formulars im [[Workflow>>doc:TODO]] über eine [[XSL-Transformation>>doc:TODO]] in ein für ALVA9 importierbares XML-Format umgewandelt. Anschließend erstellt der Workflow aus diese XML-Datei, allen im Formular übertragenen Daten und einer PDF-Druckquittung ein ZIP-Archiv.
12	12	Dieses wird anschließend in das Austauschverzeichnis gespeichert. Das Austauschverzeichnis ist im Beispielformular noch nicht konfiguriert und muss in den jeweiligen Aktionen zunächst noch festgelegt werden. Der Grund dafür ist, dass der Pfade nicht allgemengültig sind und vom jeweiligen System abhängen, in welches das Beispielformular importiert wurde.
13	13
14	14	=== Inhalt und Erstellung der XML-Datei ===
...	...	@@ -161,15 +161,15 @@
161	161	{{/code}}
162	162	{{/panel}}
163	163
164		-Im Beispiel werden über die am Ende stehenden Templates //formatDate// und //formatWeight// Datumswerte und Gewichte in das Format überführt, welches ALVA9 erwartet. Eine Konvertierung von im Formular eingegebenen Werten in ein von ALVA9 erwartetes Format kann gegebenenfalls auch bei anderen Daten nötig sein. In den solchen Fällen ist die Verwendung von speziellen Templates häufig die einfachste Lösung.
	164	+Im Beispiel werden über die am Ende stehenden Templates //formatDate// und //formatWeight// Datumswerte und Gewichte in das Format überführt, welches ALVA9 erwartet. Eine Überführung von im Formular eingegebenen Werten in eine für ALVA9 erwartetes Format kann gegebenenfalls auch bei anderen Daten nötig sein. In den meisten Fällen ist die Verwendung von speziellen Templates häufig die einfachste Lösung, um die Werte in das gewünschte Format zu konvertieren.
165	165
166	166	=== Speichern von zusätzlichen Dokumenten ===
167	167
168		-Im Beispiel wird zunächst über eine Aktion vom Typ [[ZIP Komprimieren>>doc:Formcycle.Designer.Workflow.Actions.CompressFiles]] ein ZIP-Archiv mit allen an das Formualar angehangenen Dateien und einer mithilfe einer [[PDF-Print-Aktion>>doc:Formcycle.PluginDocumentation.PrintServicePlugin]] generierte PDF-Quittung des Formulars sowie der erstellten XML-Datei erzeugt. Dieses Archiv wird dann über eine Aktion vom Typ [[Speichern im Dateisystem>>doc:Formcycle.Designer.Workflow.Actions.SaveToFileSystem]] an eine Stelle im Dateisystem des Servers gespeichert, die als Austauschverzeichnis für ALVA9 gedacht ist und von der aus sich das System dann die Datei selbstständig abholt. Es ist wichtig, dass alle Dokumente, die zu den in der XML-Datei enthaltenen Daten gehören und zu ALVA9 übertragen werden sollen, mit im gleichen ZIP-Archiv enthalten sind.
	168	+Im Beispiel wird zunächst über eine Aktion vom Typ [[ZIP Komprimieren>>doc:TODO]] ein ZIP-Archiv mit allen an das Formualar angehangenen Dateien und einer mithilfe einer [[PDF-Print-Aktion>>doc:TODO]] generierte PDF-Quittung des Formulars sowie der erstellten XML-Datei erzeugt. Dieses Archiv wird dann über eine Aktion vom Typ [[TODO>>doc:TODO]] an eine Stelle im Dateisystem des Servers gespeichert, die als Austauschverzeichnis für ALVA9 gedacht ist und von der aus sich das System dann die Datei selbstständig abholt. Es ist wichtig, dass alle Dokumente, die
169	169
170	170	=== Benennung der erzeugten Dateien ===
171	171
172		-Im Beispiel wird die XML-Datei //ALVA_SONNTAG_[%$PROCESS_ID%].xml// und das ZIP-Archiv //ALVA_SONN_[%$PROCESS_ID%].zip// genannt. Es ist wichtig, dass der Dateiname der ZIP-Datei eindeutig ist und nicht bei verschiedenen Vorgängen gleich ist. Im Beispiel wird dafür der Platzhalter für die Prozess-ID verwendet, welche bei jedem Vorgang unterschiedlich ist. Grundsätzlich können hierfür aber auch andere Werte wie zum Beispiel Werte von [[Zählern>>doc:Formcycle.UserInterface.Data.Counter]] verwendet werden.
	172	+Im Beispiel
173	173
174	174	das ist wichtig weil
175	175