Ä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,18 +1,19 @@
1		-Im folgenden wird Anhand eines Beispieles kurz beschrieben, wie Daten von {{formcycle/}} an ein ALVA9 DMS System ü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 in einem Austauschverzeichnis abgelegt werden, von dem aus das DMS sie automatisch importiert. Für den Fall, dass zusätzlich zu den Informationen in der XML-Datei auch Dateien aus dem Formular oder dem Workflow mit in das DMS übertragen werden sollen, ist es nötig, diese Dateien in Form eines ZIP-Archivs an die selbe Stelle zu speichern.
	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
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 über eine XSL-Transformation in ein für ALVA9 importierbares XML-Format umgewandelt. Anschließend speichert der Workflow diese XML-Datei und ein ZIP-Archiv mit allen im Formular übertragenen Daten und einer PDF-Druckquittung in einem Austauschverzeichnis. 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.
	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.
	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.
12	12
13	13	=== Inhalt und Erstellung der XML-Datei ===
14	14
15		-Die XML-Datei mit allen im Formular eingegebenen Daten wird über eine sagenannte 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.
	16	+Die XML-Datei mit allen im Formular eingegebenen Daten wird über eine sagenannte [[XSL-Transformation>>WIKIPEDIA]] 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.
16	16
17	17	Die vollständige XSL-Transformation für das Beispiel sieht wie folgt aus:
18	18
...	...	@@ -66,26 +66,25 @@
66	66	<AUF2KENNZ><xsl:value-of select="form/field[@name='tfAUF2KENNZ']/plainValue"/></AUF2KENNZ>
67	67	<ERS2KENNZ1><xsl:value-of select="form/field[@name='tfERS2KENNZ1']/plainValue"/></ERS2KENNZ1>
68	68	<ERS2KENNZ2><xsl:value-of select="form/field[@name='tfERS2KENNZ2']/plainValue"/></ERS2KENNZ2>
69		-
70	70	<LKW_GEWICH>
71	71	<xsl:call-template name="formatWeight">
72	72	<xsl:with-param name="weight" select="form/field[@name='tfLKW_GEWICH']/plainValue" />
73		- </xsl:call-template>
	73	+ </xsl:call-template>
74	74	</LKW_GEWICH>
75	75	<ANH_GEWICH>
76	76	<xsl:call-template name="formatWeight">
77	77	<xsl:with-param name="weight" select="form/field[@name='tfANH_GEWICH']/plainValue" />
78		- </xsl:call-template>
	78	+ </xsl:call-template>
79	79	</ANH_GEWICH>
80	80	<ZUG_GEWICH>
81	81	<xsl:call-template name="formatWeight">
82	82	<xsl:with-param name="weight" select="form/field[@name='tfZUG_GEWICH']/plainValue" />
83		- </xsl:call-template>
	83	+ </xsl:call-template>
84	84	</ZUG_GEWICH>
85	85	<AUF_GEWICH>
86	86	<xsl:call-template name="formatWeight">
87	87	<xsl:with-param name="weight" select="form/field[@name='tfAUF_GEWICH']/plainValue" />
88		- </xsl:call-template>
	88	+ </xsl:call-template>
89	89	</AUF_GEWICH>
90	90	<!--
91	91	<LKW_LEER><xsl:value-of select="form/field[@name='']/plainValue"/></LKW_LEER>
...	...	@@ -96,18 +96,18 @@
96	96	<ERS_GEWI_1>
97	97	<xsl:call-template name="formatWeight">
98	98	<xsl:with-param name="weight" select="form/field[@name='tfERS_GEWI_1']/plainValue" />
99		- </xsl:call-template>
	99	+ </xsl:call-template>
100	100	</ERS_GEWI_1>
101	101	<ERS_GEWI_2>
102	102	<xsl:call-template name="formatWeight">
103	103	<xsl:with-param name="weight" select="form/field[@name='tfERS_GEWI_2']/plainValue" />
104		- </xsl:call-template>
	104	+ </xsl:call-template>
105	105	</ERS_GEWI_2>
106	106	<ART><xsl:value-of select="form/field[@name='tfART']/plainValue"/></ART>
107	107	<ART_GEWICH>
108	108	<xsl:call-template name="formatWeight">
109	109	<xsl:with-param name="weight" select="form/field[@name='tfART_GEWICH']/plainValue" />
110		- </xsl:call-template>
	110	+ </xsl:call-template>
111	111	</ART_GEWICH>
112	112	<STARTORT><xsl:value-of select="form/field[@name='tfSTARTORT']/plainValue"/></STARTORT>
113	113	<ZIELORT><xsl:value-of select="form/field[@name='tfZIELORT']/plainValue"/></ZIELORT>
...	...	@@ -115,13 +115,13 @@
115	115	<ZEIT_VON>
116	116	<xsl:call-template name="formatDate">
117	117	<xsl:with-param name="dateTime" select="form/field[@name='tfZEIT_VON']/plainValue" />
118		- </xsl:call-template>
	118	+ </xsl:call-template>
119	119	</ZEIT_VON>
120	120	<VON_UHR><xsl:value-of select="form/field[@name='tfVON_UHR']/plainValue"/></VON_UHR>
121	121	<ZEIT_BIS>
122	122	<xsl:call-template name="formatDate">
123	123	<xsl:with-param name="dateTime" select="form/field[@name='tfZEIT_BIS']/plainValue" />
124		- </xsl:call-template>
	124	+ </xsl:call-template>
125	125	</ZEIT_BIS>
126	126	<BIS_UHR><xsl:value-of select="form/field[@name='tfBIS_UHR']/plainValue"/></BIS_UHR>
127	127	<ORT_LEERFA><xsl:value-of select="form/field[@name='tfORT_LEERFA']/plainValue"/></ORT_LEERFA>
...	...	@@ -128,10 +128,10 @@
128	128	<BEGRUENDG><xsl:value-of select="form/field[@name='tfBEGRUENDG']/plainValue"/></BEGRUENDG>
129	129	<!--
130	130	<ORTSLAGE><xsl:value-of select="form/field[@name='tfORTSLAGE']/plainValue"/></ORTSLAGE>
131		- <NOTIZ><xsl:value-of select="form/field[@name='tfNOTIZ']/plainValue"/></NOTIZ>
	131	+ <NOTIZ><xsl:value-of select="form/field[@name='tfNOTIZ']/plainValue"/></NOTIZ>
132	132	-->
133	133	<ORTSLAGE><xsl:value-of select="form/field[@name='edAnmerkungen']/plainValue"/></ORTSLAGE>
134		- <NOTIZ><xsl:value-of select="form/field[@name='edAnmerkungen']/plainValue"/></NOTIZ>
	134	+ <NOTIZ><xsl:value-of select="form/field[@name='edAnmerkungen']/plainValue"/></NOTIZ>
135	135	<SACHGEBIET>Z</SACHGEBIET>
136	136	<FORMID><xsl:value-of select="form/field[@name='tfFORMID']/plainValue"/></FORMID>
137	137	<SERVICE_ID><xsl:value-of select="./@process-uid" /></SERVICE_ID>
...	...	@@ -146,35 +146,39 @@
146	146
147	147	<xsl:choose>
148	148	<xsl:when test="$dateTime !=''">
149		- <xsl:value-of select="concat($year, '-', $month, '-', $day)" />
150		- </xsl:when>
151		- <xsl:otherwise>
	149	+ <xsl:value-of select="concat($year, '-', $month, '-', $day)" />
	150	+ </xsl:when>
	151	+ <xsl:otherwise>
152	152
153	153	</xsl:otherwise>
154		- </xsl:choose>
	154	+ </xsl:choose>
155	155	</xsl:template>
156	156	<xsl:template name="formatWeight">
157	157	<xsl:param name="weight"/>
158		- <xsl:value-of select="translate($weight, ',', '.')" />
	158	+ <xsl:value-of select="translate($weight, ',', '.')" />
159	159	</xsl:template>
160	160	</xsl:stylesheet>
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		-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.
169	169
170		-Über eine Aktion vom Typ [[ZIP Komprimieren>>doc:TODO]]
171		-Selbe, eindeutige ID -> Es empfiehlt sich, Process_ID zu verwenden
	170	+=== Benennung der erzeugten Dateien ===
172	172
	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.
173	173
	174	+das ist wichtig weil
174	174
	176	+Selbe, eindeutige ID -> Es empfiehlt sich, Process_ID zu verwenden
175	175
176		-TBD
	178	+---Hierbei ist die Verwendung gl dateinamen
177	177
	180	+
	181	+
178	178	== Ansprechpartner für Fragen ==
179	179
180	180	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: