From version 1.18
edited by gru
on 31.03.2022, 12:23
Change comment: There is no comment for this version
To version 1.26
edited by gru
on 31.03.2022, 16:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,10 +1,10 @@
1 -Im folgenden wird Anhand eines Beispieles kurz beschrieben, wie Daten von {{formcycle/}} an ein [[ALVA9 DMS System>>HERSTELLERSEITE]] übertragen werden können.
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.
2 2  
3 3  {{content/}}
4 4  
5 5  == Grundlegende Vorgehensweise ==
6 6  
7 -Zum Übertragen von Daten aus einem Formular an ein ALVA9 DMS muss eine XML-Datei mit den Informationen generiert und zusammen mit allen anderen zu speichernden Daten in einem ZIP-Archiv gesteckt und in einem Austauschverzeichnis abgelegt werden, von dem aus das DMS sie automatisch importiert.
7 +Zum Übertragen von Daten aus einem Formular an ein ALVA9 System muss eine XML-Datei mit den Informationen generiert und zusammen mit allen anderen zu speichernden Daten in einem ZIP-Archiv gepackt und in einem Austauschverzeichnis abgelegt werden, von dem aus ALVA9 sie automatisch importiert.
8 8  
9 9  == Workflow im Beispiel ==
10 10  
... ... @@ -161,27 +161,24 @@
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 Ü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.
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.
165 165  
166 166  === Speichern von zusätzlichen Dokumenten ===
167 167  
168 -Im Beispiel werden alle an das Formualar angehangenen Dateien und eine mithilfe einer [[PDF-Print-Aktion>>doc:TODO]] generierte
169 -Hierbei ist die Verwendung gl dateinamen
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.
170 170  
171 -Über eine Aktion vom Typ [[ZIP Komprimieren>>doc:TODO]]
172 -
173 -
174 174  === Benennung der erzeugten Dateien ===
175 175  
176 -Im Beispiel
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.
177 177  
178 178  das ist wichtig weil
179 179  
180 180  Selbe, eindeutige ID -> Es empfiehlt sich, Process_ID zu verwenden
181 181  
178 +---Hierbei ist die Verwendung gl dateinamen
182 182  
183 -TBD
184 184  
181 +
185 185  == Ansprechpartner für Fragen ==
186 186  
187 187  Für weitere Fragen zur Anbindung und der nötigen Konfiguration für den Import in ALVA9 steht folgender Ansprechpartner auf Seiten der Ascherslebener Computer GmbH zur Verfügung: