| ... |
... |
@@ -53,7
+53,7 @@ |
| 53 |
53 |
|
| 54 |
54 |
__Drag&Drop__ |
| 55 |
55 |
|
| 56 |
|
-Datenquellen können auch per Drag&Drop importiert werden. Wird eine Datei über die Liste (grüner Bereich gezogen), so wird eine neue Datenquelle vom entsprechenden Typ angelegt (bei Excel-Dateien wird eine Datenquelle pro Arbeitsblatt angelegt). Wird die Datenquelle allerdings über den Editierbereich einer bereits existierenden Datenquelle gezogen, so wird diese aktualisiert. Die Änderungen werden allerdings erst mit einem Klick auf "Speichern" {{icon name="save"/}} übernommen. |
|
56 |
+Datenquellen können auch per Drag&Drop importiert werden. Wird eine Datei über die Liste (grüner Bereich) gezogen, so wird eine neue Datenquelle vom entsprechenden Typ angelegt (bei Excel-Dateien wird eine Datenquelle pro Arbeitsblatt angelegt). Wird die Datenquelle allerdings über den Editierbereich einer bereits existierenden Datenquelle gezogen, so wird diese aktualisiert. Die Änderungen werden allerdings erst mit einem Klick auf "Speichern" {{icon name="save"/}} übernommen. |
| 57 |
57 |
|
| 58 |
58 |
== CSV == |
| 59 |
59 |
|
| ... |
... |
@@ -114,6
+114,8 @@ |
| 114 |
114 |
|
| 115 |
115 |
=== Anwendungsbeispiel === |
| 116 |
116 |
|
|
117 |
+Es wurde eine CSV-Datenquelle mit folgendem Inhalt angelegt, bei welcher die **erste Zeile als Header** verwendet wird. |
|
118 |
+ |
| 117 |
117 |
{{code language="csv"}} |
| 118 |
118 |
anrede,vorname,nachname,plz,ort |
| 119 |
119 |
Herr,Max,Mustermann,1000,Musterhausen |
| ... |
... |
@@ -122,7
+122,7 @@ |
| 122 |
122 |
|
| 123 |
123 |
{{/code}} |
| 124 |
124 |
|
| 125 |
|
-Im {{designer case="dat"/}} wird dann folgendes Skript im [[Skriptbereich>>doc:Formcycle.FormDesigner.CodingPanel.WebHome]] verwendet. |
|
127 |
+Im {{designer case="dat"/}} wird dann folgendes Skript im [[Skriptbereich>>doc:Formcycle.FormDesigner.CodingPanel.WebHome]] verwendet, um die Felder im Formular vorzubefüllen. |
| 126 |
126 |
|
| 127 |
127 |
{{code language="javascript"}} |
| 128 |
128 |
$.getJSON( XFC_METADATA.urls.datasource_csv + "?name=Demo&mandantName=xima.de", function(json) { |
| ... |
... |
@@ -138,7
+138,7 @@ |
| 138 |
138 |
|
| 139 |
139 |
{{lightbox image="data_source_csv_designer_script_de.png"/}} |
| 140 |
140 |
|
| 141 |
|
-Dieses Beispiel als Datenquelle für den {{designer case="acc"/}} [[zum Herunterladen>>attach:beispiel_datenquelle_csv.json||rel="__blank"]]. |
|
143 |
+Dieses Beispielformular für den {{designer case="acc"/}} [[zum Herunterladen>>attach:CSV-Demo_de.json||rel="__blank"]]. |
| 142 |
142 |
|
| 143 |
143 |
=== Sonderfall Auswahlelement === |
| 144 |
144 |
|
| ... |
... |
@@ -146,28
+146,32 @@ |
| 146 |
146 |
Die Anbindung einer Datenquelle an eine Auswahlelement erfolgt direkt im {{designer case="dat"/}} |
| 147 |
147 |
{{/figure}} |
| 148 |
148 |
|
| 149 |
|
-Soll die //CSV//-Datenquelle direkt in ein [[Auswahlelement>>doc:Main.Auswahl]] geladen werden, erfolgt dies über die Eigenschaften des Auswahlelements im {{designer case="dat"/}}. |
|
151 |
+Soll die //CSV//-Datenquelle direkt in ein [[Auswahlelement>>doc:Formcycle.FormDesigner.FormElements.Selection.WebHome]] geladen werden, erfolgt dies über die Eigenschaften des Auswahlelements im {{designer case="dat"/}}. |
| 150 |
150 |
|
| 151 |
|
-Der Inhalt der CSV-Datenquelle wird folgendermaßen in einem [[Auswahlelement>>doc:Main.Auswahl]] verarbeitet. |
|
153 |
+Der Inhalt der CSV-Datenquelle wird folgendermaßen in einem [[Auswahlelement>>doc:Formcycle.FormDesigner.FormElements.Selection.WebHome]] verarbeitet: |
| 152 |
152 |
|
| 153 |
153 |
{{code}} |
| 154 |
|
-sichtbarer wert, übertragener, wert, optionaler wert, optionaler wert, ... |
|
156 |
+sichtbarer wert, übertragener wert, optionaler wert, optionaler wert, ... |
| 155 |
155 |
{{/code}} |
| 156 |
156 |
|
| 157 |
|
-Werden mehr als der sichtbare und übertragene Wert angegeben, also optionale Werte, so können diese im Javaskript über den folgenden jQuery-Selektor abgerufen werden. |
|
159 |
+Die Spalten werden der Datenquelle werden für [[Auswahlelemente>>doc:Formcycle.FormDesigner.FormElements.Selection.WebHome]] wie folgt bezeichnet: |
|
160 |
+{{code}}col + Index der Spalte{{/code}}. |
| 158 |
158 |
|
|
162 |
+Beitzt die Datenquelle mehr als 2 Spalten, besitzt sie optionale Werte. Auf die optionalen Werte kann im Javascript über den folgenden jQuery-Selektor zugegriffen werden: |
|
163 |
+ |
| 159 |
159 |
{{code language="javascript"}} |
| 160 |
|
-$('[name=sel2]').find('option:selected').attr('col0'); |
|
165 |
+$('[name=sel2]').find('option:selected').attr('col2'); |
| 161 |
161 |
{{/code}} |
| 162 |
162 |
|
| 163 |
|
-Jeder optionale Wert wird am Auswahlelement als Attribut {{code}}col + Index des optionalen Wert{{/code}} gespeichert. Bei z.B. drei optionalen Werten würde es also //col0//, //col1// und //col2// geben. |
|
168 |
+Die optionalen Werte beginnen also mit Spaltenindex 2. |
|
169 |
+Ist die erste Zeile als Header markiert, so wird diese für das Auswahlelement ignoriert. |
| 164 |
164 |
|
| 165 |
165 |
== XML == |
| 166 |
166 |
|
| 167 |
|
-Die XML Datenquelle verhält sich analog zur //CSV//-Datenquelle, kann jedoch nicht direkt an ein [[Auswahlelement>>doc:Main.Auswahl]] gebunden werden. |
|
173 |
+Die XML Datenquelle verhält sich analog zur //CSV//-Datenquelle, kann jedoch nicht direkt an ein [[Auswahlelement>>doc:Formcycle.FormDesigner.FormElements.Selection.WebHome]] gebunden werden. |
| 168 |
168 |
|
| 169 |
|
-{{figure image="datenquelle_xml.png" width="300"}} |
| 170 |
|
-Die JSON-Struktur der XML-Datenquelle. Auf diese JSON-Struktur kann dann per Javaskript über {{code}}XFC_METADATA.urls.datasource_[csv|json|xml]{{/code}} zugegriffen werden. |
|
175 |
+{{figure image="data_source_xml_servlet_json.png" width="300"}} |
|
176 |
+Die JSON-Struktur der XML-Datenquelle. Auf diese JSON-Struktur kann dann per Javascript über {{code}}XFC_METADATA.urls.datasource_xml{{/code}} zugegriffen werden. |
| 171 |
171 |
{{/figure}} |
| 172 |
172 |
|
| 173 |
173 |
=== Beispiel für eine XML-Datenquelle === |
| ... |
... |
@@ -207,7
+207,7 @@ |
| 207 |
207 |
http(s):~/~/<server>/formcycle/datenquellexml?mandantName=<Mandant-Name>&name=<Datenquellen-Name> |
| 208 |
208 |
{{/info}} |
| 209 |
209 |
|
| 210 |
|
-Bei Zugriff aus dem {{designer case="dat"/}} verwenden Sie immer das globale Variablen-Objekt //XFC_METADATA//, siehe hierzu auch [[Globale Designer Variablen>>doc:Main.Formular-Metadaten]]. Beispielsweise kann wie folgt darauf zugegriffen werden: {{code language="javascript"}}XFC_METADATA.urls.datasource_xml{{/code}}. |
|
216 |
+Bei Zugriff aus dem {{designer case="dat"/}} verwenden Sie immer das globale Variablen-Objekt //XFC_METADATA//, siehe hierzu auch [[Globale Designer Variablen>>https://jsdocs.formcycle.eu/jsdocs/de/interfaces/_formcycle_v6_de_d_.formcyclede.xfcmetadata.html]]. Beispielsweise kann wie folgt darauf zugegriffen werden: {{code language="javascript"}}XFC_METADATA.urls.datasource_xml{{/code}}. |
| 211 |
211 |
|
| 212 |
212 |
Folgende Parameter sind möglich: |
| 213 |
213 |
|
| ... |
... |
@@ -217,10
+217,10 @@ |
| 217 |
217 |
|
| 218 |
218 |
== JSON == |
| 219 |
219 |
|
| 220 |
|
-Die //JSON//-Datenquelle verhält sich analog zur //CSV//-Datenquelle, kann jedoch nicht direkt an ein [[Auswahlelement>>doc:Main.Auswahl]] gebunden werden. |
|
226 |
+Die //JSON//-Datenquelle verhält sich analog zur //CSV//-Datenquelle, kann jedoch nicht direkt an ein [[Auswahlelement>>doc:Formcycle.FormDesigner.FormElements.Selection.WebHome]] gebunden werden. |
| 221 |
221 |
|
| 222 |
|
-{{figure image="datenquelle_json.png" width="300"}} |
| 223 |
|
-Die JSON-Struktur der JSON-Datenquelle. Sie ist identisch mit der JSON-Datenquelle. Auf diese JSON-Struktur kann dann per Javaskript über {{code}}XFC_METADATA.urls.datasource_[csv|json|xml]{{/code}} zugegriffen werden. |
|
228 |
+{{figure image="data_source_json_servlet_json.png"}} |
|
229 |
+Die JSON-Struktur der JSON-Datenquelle. Sie ist identisch mit der JSON-Datenquelle. Auf diese JSON-Struktur kann dann per Javascript über {{code}}XFC_METADATA.urls.datasource_json{{/code}} zugegriffen werden. |
| 224 |
224 |
{{/figure}} |
| 225 |
225 |
|
| 226 |
226 |
=== Beispiel für eine JSON-Datenquelle === |
| ... |
... |
@@ -227,16
+227,16 @@ |
| 227 |
227 |
|
| 228 |
228 |
{{code language="json"}} |
| 229 |
229 |
{"person":[ |
| 230 |
|
- { |
| 231 |
|
- 'anrede':'Herr', |
| 232 |
|
- 'vorname':'Max', |
| 233 |
|
- 'nachname':'Mustermann' |
| 234 |
|
- }, |
| 235 |
|
- { |
| 236 |
|
- 'anrede':'Frau', |
| 237 |
|
- 'vorname':'Monika', |
| 238 |
|
- 'nachname':'Musterfrau' |
| 239 |
|
- } |
|
236 |
+ { |
|
237 |
+ 'anrede':'Herr', |
|
238 |
+ 'vorname':'Max', |
|
239 |
+ 'nachname':'Mustermann' |
|
240 |
+ }, |
|
241 |
+ { |
|
242 |
+ 'anrede':'Frau', |
|
243 |
+ 'vorname':'Monika', |
|
244 |
+ 'nachname':'Musterfrau' |
|
245 |
+ } |
| 240 |
240 |
]} |
| 241 |
241 |
{{/code}} |
| 242 |
242 |
|