Von Version 1.14
bearbeitet von gru
am 31.03.2022, 12:15
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 1.19
bearbeitet von gru
am 31.03.2022, 12:23
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

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 Beispieles kurz beschrieben, wie Daten von {{formcycle/}} an ein [[ALVA9 DMS System>>HERSTELLERSEITE]] ü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 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.
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: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 +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,16 +146,16 @@
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}}
... ... @@ -165,16 +165,23 @@
165 165  
166 166  === Speichern von zusätzlichen Dokumenten ===
167 167  
168 -Hierbei ist die Verwendung gl dateinamen
168 +Im Beispiel werden alle an das Formualar angehangenen Dateien und eine mithilfe einer [[PDF-Print-Aktion>>doc:TODO]] generierte
169 169  
170 170  Über eine Aktion vom Typ [[ZIP Komprimieren>>doc:TODO]]
171 -Selbe, eindeutige ID -> Es empfiehlt sich, Process_ID zu verwenden
172 172  
173 173  
173 +=== Benennung der erzeugten Dateien ===
174 174  
175 +Im Beispiel
175 175  
176 -TBD
177 +das ist wichtig weil
177 177  
179 +Selbe, eindeutige ID -> Es empfiehlt sich, Process_ID zu verwenden
180 +
181 +---Hierbei ist die Verwendung gl dateinamen
182 +
183 +
184 +
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: