Zeige letzte Bearbeiter
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
3 {{content/}}
4
5 == Grundlegende Vorgehensweise ==
6
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
9 == Workflow im Beispiel ==
10
11 {{figure image="workflow_full_de.png"}}
12 Workflow im Beispielformular, mit dem die entsprechen
13 {{/figure}}
14
15 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:Formcycle.UserInterface.FilesAndTemplates.XSLTransformation]] 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.
16 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.
17
18 === Inhalt und Erstellung der XML-Datei ===
19
20 {{figure image="workflow_xml_de.png"}}
21 Konfiguration der Workflow-Aktion vom
22 {{/figure}}
23
24 Die XML-Datei mit allen im Formular eingegebenen Daten wird durch eine Aktion vom Typ [[XXX>>doc:TODO]] mithilfe eine sogenannten [[XSL-Transformation>>https://de.wikipedia.org/wiki/XSL_Transformation]] erzeugt. Die Struktur der erzeugten XML-Datei wird dabei von ALVA9 vorgegeben und besteht im Beispiel aus den Konten //daten// und //datensatz//, wobei in letzteren die einzelnen Informationen als eigene Unterknoten eingefügt werden.
25
26 Die vollständige XSL-Transformation für das Beispiel sieht wie folgt aus:
27
28 {{panel title="XSL-Transformation des Beispielformulars" triggerable="true" initial="hidden"}}
29 {{code language="xslt"}}
30 <?xml version="1.0" encoding="UTF-8"?>
31 <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
32 <xsl:template match="process">
33 <daten>
34 <datensatz>
35 <NAME1><xsl:value-of select="form/field[@name='tfOrgName']/plainValue"/>&#xA0;<xsl:value-of select="form/field[@name='Rechtsform']/plainValue"/></NAME1>
36 <NAME2><xsl:value-of select="form/field[@name='tfAntragstellerAnrede']/plainValue"/>&#xA0;<xsl:value-of select="form/field[@name='tfAntragstellerTitel']/plainValue"/>&#xA0;<xsl:value-of select="form/field[@name='tfAntragstellerVorname']/plainValue"/>&#xA0;<xsl:value-of select="form/field[@name='tfAntragstellerName']/plainValue"/></NAME2>
37 <NAME3><xsl:value-of select="form/field[@name='']/plainValue"/></NAME3>
38 <NAME4><xsl:value-of select="form/field[@name='']/plainValue"/></NAME4>
39 <STRASSE><xsl:value-of select="form/field[@name='tfAntragstellerAdresse']/plainValue"/></STRASSE>
40 <HAUS_NR><xsl:value-of select="form/field[@name='']/plainValue"/></HAUS_NR>
41 <ORT><xsl:value-of select="form/field[@name='tfAntragstellerOrt']/plainValue"/></ORT>
42 <PLZ><xsl:value-of select="form/field[@name='tfAntragstellerPLZ']/plainValue"/></PLZ>
43 <TELEFON><xsl:value-of select="form/field[@name='tfAntragstellerTelefon']/plainValue"/></TELEFON>
44 <EMAIL><xsl:value-of select="form/field[@name='tfAntragstellerEmail']/plainValue"/></EMAIL>
45 <FAX><xsl:value-of select="form/field[@name='tfAntragstellerFax']/plainValue"/></FAX>
46 <SONNTAGE><xsl:value-of select="form/field[@name='cbSONNTAGE']/plainValue"/></SONNTAGE>
47 <FERIEN><xsl:value-of select="form/field[@name='cbFERIEN']/plainValue"/></FERIEN>
48 <GRUND2><xsl:value-of select="form/field[@name='cbGRUND2']/plainValue"/></GRUND2>
49 <GRUND1><xsl:value-of select="form/field[@name='cbGRUND1']/plainValue"/></GRUND1>
50 <ANTR_DATUM><xsl:value-of select="substring-before(./@creation-date, ' ')" /></ANTR_DATUM>
51 <NAME_HALT><xsl:value-of select="form/field[@name='tfNAME_HALT']/plainValue"/></NAME_HALT>
52 <FIRMA_HALT><xsl:value-of select="form/field[@name='tfFIRMA_HALT']/plainValue"/></FIRMA_HALT>
53 <POS_HALTER><xsl:value-of select="form/field[@name='tfPOS_HALTER']/plainValue"/></POS_HALTER>
54 <xsl:if test="form/field[@name='cbLKW']/plainValue!=1"><LKW>0</LKW></xsl:if>
55 <xsl:if test="form/field[@name='cbLKW']/plainValue=1"><LKW><xsl:value-of select="form/field[@name='cbLKW']/plainValue"/></LKW></xsl:if>
56 <xsl:if test="form/field[@name='cbANHAENGER']/plainValue!=1"><ANHAENGER>0</ANHAENGER></xsl:if>
57 <xsl:if test="form/field[@name='cbANHAENGER']/plainValue=1"><ANHAENGER><xsl:value-of select="form/field[@name='cbANHAENGER']/plainValue"/></ANHAENGER></xsl:if>
58 <xsl:if test="form/field[@name='cbZUGMASCHIN']/plainValue!=1"><ZUGMASCHIN>0</ZUGMASCHIN></xsl:if>
59 <xsl:if test="form/field[@name='cbZUGMASCHIN']/plainValue=1"><ZUGMASCHIN><xsl:value-of select="form/field[@name='cbZUGMASCHIN']/plainValue"/></ZUGMASCHIN></xsl:if>
60 <xsl:if test="form/field[@name='cbAUFLIEGER']/plainValue!=1"><AUFLIEGER>0</AUFLIEGER></xsl:if>
61 <xsl:if test="form/field[@name='cbAUFLIEGER']/plainValue=1"><AUFLIEGER><xsl:value-of select="form/field[@name='cbAUFLIEGER']/plainValue"/></AUFLIEGER></xsl:if>
62 <xsl:if test="form/field[@name='cbERSATZ1']/plainValue!=1"><ERSATZ1>0</ERSATZ1></xsl:if>
63 <xsl:if test="form/field[@name='cbERSATZ1']/plainValue=1"><ERSATZ1><xsl:value-of select="form/field[@name='cbERSATZ1']/plainValue"/></ERSATZ1></xsl:if>
64 <xsl:if test="form/field[@name='cbERSATZ2']/plainValue!=1"><ERSATZ2>0</ERSATZ2></xsl:if>
65 <xsl:if test="form/field[@name='cbERSATZ2']/plainValue=1"><ERSATZ2><xsl:value-of select="form/field[@name='cbERSATZ2']/plainValue"/></ERSATZ2></xsl:if>
66 <LKW_KENNZ><xsl:value-of select="form/field[@name='tfLKW_KENNZ']/plainValue"/></LKW_KENNZ>
67 <ANH_KENNZ><xsl:value-of select="form/field[@name='tfANH_KENNZ']/plainValue"/></ANH_KENNZ>
68 <ZUG_KENNZ><xsl:value-of select="form/field[@name='tfZUG_KENNZ']/plainValue"/></ZUG_KENNZ>
69 <AUF_KENNZ><xsl:value-of select="form/field[@name='tfAUF_KENNZ']/plainValue"/></AUF_KENNZ>
70 <ERS_KENNZ1><xsl:value-of select="form/field[@name='tfERS_KENNZ1']/plainValue"/></ERS_KENNZ1>
71 <ERS_KENNZ2><xsl:value-of select="form/field[@name='tfERS_KENNZ2']/plainValue"/></ERS_KENNZ2>
72 <LKW2KENNZ><xsl:value-of select="form/field[@name='tfLKW2KENNZ']/plainValue"/></LKW2KENNZ>
73 <ANH2KENNZ><xsl:value-of select="form/field[@name='tfANH2KENNZ']/plainValue"/></ANH2KENNZ>
74 <ZUG2KENNZ><xsl:value-of select="form/field[@name='tfZUG2KENNZ']/plainValue"/></ZUG2KENNZ>
75 <AUF2KENNZ><xsl:value-of select="form/field[@name='tfAUF2KENNZ']/plainValue"/></AUF2KENNZ>
76 <ERS2KENNZ1><xsl:value-of select="form/field[@name='tfERS2KENNZ1']/plainValue"/></ERS2KENNZ1>
77 <ERS2KENNZ2><xsl:value-of select="form/field[@name='tfERS2KENNZ2']/plainValue"/></ERS2KENNZ2>
78 <LKW_GEWICH>
79 <xsl:call-template name="formatWeight">
80 <xsl:with-param name="weight" select="form/field[@name='tfLKW_GEWICH']/plainValue" />
81 </xsl:call-template>
82 </LKW_GEWICH>
83 <ANH_GEWICH>
84 <xsl:call-template name="formatWeight">
85 <xsl:with-param name="weight" select="form/field[@name='tfANH_GEWICH']/plainValue" />
86 </xsl:call-template>
87 </ANH_GEWICH>
88 <ZUG_GEWICH>
89 <xsl:call-template name="formatWeight">
90 <xsl:with-param name="weight" select="form/field[@name='tfZUG_GEWICH']/plainValue" />
91 </xsl:call-template>
92 </ZUG_GEWICH>
93 <AUF_GEWICH>
94 <xsl:call-template name="formatWeight">
95 <xsl:with-param name="weight" select="form/field[@name='tfAUF_GEWICH']/plainValue" />
96 </xsl:call-template>
97 </AUF_GEWICH>
98 <!--
99 <LKW_LEER><xsl:value-of select="form/field[@name='']/plainValue"/></LKW_LEER>
100 <ANH_LEER><xsl:value-of select="form/field[@name='']/plainValue"/></ANH_LEER>
101 <ZUG_LEER><xsl:value-of select="form/field[@name='']/plainValue"/></ZUG_LEER>
102 <AUF_LEER><xsl:value-of select="form/field[@name='']/plainValue"/></AUF_LEER>
103 -->
104 <ERS_GEWI_1>
105 <xsl:call-template name="formatWeight">
106 <xsl:with-param name="weight" select="form/field[@name='tfERS_GEWI_1']/plainValue" />
107 </xsl:call-template>
108 </ERS_GEWI_1>
109 <ERS_GEWI_2>
110 <xsl:call-template name="formatWeight">
111 <xsl:with-param name="weight" select="form/field[@name='tfERS_GEWI_2']/plainValue" />
112 </xsl:call-template>
113 </ERS_GEWI_2>
114 <ART><xsl:value-of select="form/field[@name='tfART']/plainValue"/></ART>
115 <ART_GEWICH>
116 <xsl:call-template name="formatWeight">
117 <xsl:with-param name="weight" select="form/field[@name='tfART_GEWICH']/plainValue" />
118 </xsl:call-template>
119 </ART_GEWICH>
120 <STARTORT><xsl:value-of select="form/field[@name='tfSTARTORT']/plainValue"/></STARTORT>
121 <ZIELORT><xsl:value-of select="form/field[@name='tfZIELORT']/plainValue"/></ZIELORT>
122 <UEBER><xsl:value-of select="form/field[@name='tfUEBER']/plainValue"/></UEBER>
123 <ZEIT_VON>
124 <xsl:call-template name="formatDate">
125 <xsl:with-param name="dateTime" select="form/field[@name='tfZEIT_VON']/plainValue" />
126 </xsl:call-template>
127 </ZEIT_VON>
128 <VON_UHR><xsl:value-of select="form/field[@name='tfVON_UHR']/plainValue"/></VON_UHR>
129 <ZEIT_BIS>
130 <xsl:call-template name="formatDate">
131 <xsl:with-param name="dateTime" select="form/field[@name='tfZEIT_BIS']/plainValue" />
132 </xsl:call-template>
133 </ZEIT_BIS>
134 <BIS_UHR><xsl:value-of select="form/field[@name='tfBIS_UHR']/plainValue"/></BIS_UHR>
135 <ORT_LEERFA><xsl:value-of select="form/field[@name='tfORT_LEERFA']/plainValue"/></ORT_LEERFA>
136 <BEGRUENDG><xsl:value-of select="form/field[@name='tfBEGRUENDG']/plainValue"/></BEGRUENDG>
137 <!--
138 <ORTSLAGE><xsl:value-of select="form/field[@name='tfORTSLAGE']/plainValue"/></ORTSLAGE>
139 <NOTIZ><xsl:value-of select="form/field[@name='tfNOTIZ']/plainValue"/></NOTIZ>
140 -->
141 <ORTSLAGE><xsl:value-of select="form/field[@name='edAnmerkungen']/plainValue"/></ORTSLAGE>
142 <NOTIZ><xsl:value-of select="form/field[@name='edAnmerkungen']/plainValue"/></NOTIZ>
143 <SACHGEBIET>Z</SACHGEBIET>
144 <FORMID><xsl:value-of select="form/field[@name='tfFORMID']/plainValue"/></FORMID>
145 <SERVICE_ID><xsl:value-of select="./@process-uid" /></SERVICE_ID>
146 </datensatz>
147 </daten>
148 </xsl:template>
149 <xsl:template name="formatDate">
150 <xsl:param name="dateTime"/>
151 <xsl:variable name="day" select="substring-before($dateTime, '.')" />
152 <xsl:variable name="month" select="substring-before(substring-after($dateTime, '.'), '.')" />
153 <xsl:variable name="year" select="substring-after(substring-after($dateTime, '.'), '.')" />
154
155 <xsl:choose>
156 <xsl:when test="$dateTime !=''">
157 <xsl:value-of select="concat($year, '-', $month, '-', $day)" />
158 </xsl:when>
159 <xsl:otherwise>
160
161 </xsl:otherwise>
162 </xsl:choose>
163 </xsl:template>
164 <xsl:template name="formatWeight">
165 <xsl:param name="weight"/>
166 <xsl:value-of select="translate($weight, ',', '.')" />
167 </xsl:template>
168 </xsl:stylesheet>
169 {{/code}}
170 {{/panel}}
171
172 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.
173
174 === Speichern von zusätzlichen Dokumenten ===
175
176 Im Beispiel wird zunächst über eine Aktion vom Typ [[ZIP Komprimieren>>doc:Formcycle.Designer.Workflow.Actions.CompressFiles]] ein ZIP-Archiv erzeugt, welches alle an das Formualar angehangenen Dateien, eine mithilfe einer [[PDF-Print-Aktion>>doc:Formcycle.PluginDocumentation.PrintServicePlugin]] generierte PDF-Quittung des Formulars und die erstellte XML-Datei beinhaltet. 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.
177
178 === Benennung der erzeugten Dateien ===
179
180 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. Auch bei der XML-Datei empfiehlt es sich, auch einen eindeutigen Namen zu verwenden.
181
182 == Ansprechpartner für Fragen ==
183
184 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:
185
186 TODO Name
187 TODO Kontaktdaten