... |
... |
@@ -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 |
|
... |
... |
@@ -73,7
+73,7 @@ |
73 |
73 |
Zum Bearbeitung einer CSV-Tabelle befinden sich unterhalb des Editierbereichs eine Reihe von Schaltflächen: |
74 |
74 |
|
75 |
75 |
* {{ficon name="plus-circle"/}} **Einfügen**: Fügt neue Zeilen oder Spalten relativ zur derzeit selektierten Zelle ein. |
76 |
|
-* {{ficon name="trash-alt2"/}} **Entfernen**: Entfernt die selektierte(n) Zeile(n) oder Spalte(n) oder leert die selektierte Zelle. |
|
76 |
+* {{ficon name="trash-alt2"/}} **Entfernen**: Entfernt die selektierte Zeile oder Spalte oder leert die selektierte Zelle. |
77 |
77 |
* {{icon name="upload"/}} **Importieren**: Öffnet den [[Dialog zum Importieren von CSV-Datenquellen>>||anchor="data_source_import_csv"]]. |
78 |
78 |
* {{icon name="code"/}} **Quellcode-Ansicht**: Wechselt in die Quellcode-Ansicht. |
79 |
79 |
|
... |
... |
@@ -124,7
+124,7 @@ |
124 |
124 |
|
125 |
125 |
{{/code}} |
126 |
126 |
|
127 |
|
-Im {{designer case="dat"/}} wird dann folgendes Skript im [[Skriptbereich>>doc:Formcycle.FormDesigner.CodingPanel.WebHome]] verwendet, um die Felder im Formular vorzubefüllen. |
|
127 |
+Im {{designer case="dat"/}} wird dann folgendes Skript im [[Skriptbereich>>doc:Formcycle.FormDesigner.CodingPanel.WebHome]] verwendet. |
128 |
128 |
|
129 |
129 |
{{code language="javascript"}} |
130 |
130 |
$.getJSON( XFC_METADATA.urls.datasource_csv + "?name=Demo&mandantName=xima.de", function(json) { |
... |
... |
@@ -140,7
+140,7 @@ |
140 |
140 |
|
141 |
141 |
{{lightbox image="data_source_csv_designer_script_de.png"/}} |
142 |
142 |
|
143 |
|
-Dieses Beispielformular für den {{designer case="acc"/}} [[zum Herunterladen>>attach:CSV-Demo_de.json||rel="__blank"]]. |
|
143 |
+Dieses Beispiel als Datenquelle für den {{designer case="acc"/}} [[zum Herunterladen>>attach:CSV-Demo_de.json||rel="__blank"]]. |
144 |
144 |
|
145 |
145 |
=== Sonderfall Auswahlelement === |
146 |
146 |
|
... |
... |
@@ -148,32
+148,28 @@ |
148 |
148 |
Die Anbindung einer Datenquelle an eine Auswahlelement erfolgt direkt im {{designer case="dat"/}} |
149 |
149 |
{{/figure}} |
150 |
150 |
|
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"/}}. |
|
151 |
+Soll die //CSV//-Datenquelle direkt in ein [[Auswahlelement>>doc:Main.Auswahl]] geladen werden, erfolgt dies über die Eigenschaften des Auswahlelements im {{designer case="dat"/}}. |
152 |
152 |
|
153 |
|
-Der Inhalt der CSV-Datenquelle wird folgendermaßen in einem [[Auswahlelement>>doc:Formcycle.FormDesigner.FormElements.Selection.WebHome]] verarbeitet: |
|
153 |
+Der Inhalt der CSV-Datenquelle wird folgendermaßen in einem [[Auswahlelement>>doc:Main.Auswahl]] verarbeitet. |
154 |
154 |
|
155 |
155 |
{{code}} |
156 |
|
-sichtbarer wert, übertragener wert, optionaler wert, optionaler wert, ... |
|
156 |
+sichtbarer wert, übertragener, wert, optionaler wert, optionaler wert, ... |
157 |
157 |
{{/code}} |
158 |
158 |
|
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}}. |
|
159 |
+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. |
161 |
161 |
|
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 |
|
- |
164 |
164 |
{{code language="javascript"}} |
165 |
|
-$('[name=sel2]').find('option:selected').attr('col2'); |
|
162 |
+$('[name=sel2]').find('option:selected').attr('col0'); |
166 |
166 |
{{/code}} |
167 |
167 |
|
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. |
|
165 |
+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. |
170 |
170 |
|
171 |
171 |
== XML == |
172 |
172 |
|
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. |
|
169 |
+Die XML Datenquelle verhält sich analog zur //CSV//-Datenquelle, kann jedoch nicht direkt an ein [[Auswahlelement>>doc:Main.Auswahl]] gebunden werden. |
174 |
174 |
|
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 |
+{{figure image="datenquelle_xml.png" width="300"}} |
|
172 |
+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. |
177 |
177 |
{{/figure}} |
178 |
178 |
|
179 |
179 |
=== Beispiel für eine XML-Datenquelle === |
... |
... |
@@ -213,7
+213,7 @@ |
213 |
213 |
http(s):~/~/<server>/formcycle/datenquellexml?mandantName=<Mandant-Name>&name=<Datenquellen-Name> |
214 |
214 |
{{/info}} |
215 |
215 |
|
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}}. |
|
212 |
+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}}. |
217 |
217 |
|
218 |
218 |
Folgende Parameter sind möglich: |
219 |
219 |
|
... |
... |
@@ -223,10
+223,10 @@ |
223 |
223 |
|
224 |
224 |
== JSON == |
225 |
225 |
|
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. |
|
222 |
+Die //JSON//-Datenquelle verhält sich analog zur //CSV//-Datenquelle, kann jedoch nicht direkt an ein [[Auswahlelement>>doc:Main.Auswahl]] gebunden werden. |
227 |
227 |
|
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 |
+{{figure image="datenquelle_json.png" width="300"}} |
|
225 |
+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. |
230 |
230 |
{{/figure}} |
231 |
231 |
|
232 |
232 |
=== Beispiel für eine JSON-Datenquelle === |
... |
... |
@@ -233,16
+233,16 @@ |
233 |
233 |
|
234 |
234 |
{{code language="json"}} |
235 |
235 |
{"person":[ |
236 |
|
- { |
237 |
|
- 'anrede':'Herr', |
238 |
|
- 'vorname':'Max', |
239 |
|
- 'nachname':'Mustermann' |
240 |
|
- }, |
241 |
|
- { |
242 |
|
- 'anrede':'Frau', |
243 |
|
- 'vorname':'Monika', |
244 |
|
- 'nachname':'Musterfrau' |
245 |
|
- } |
|
232 |
+ { |
|
233 |
+ 'anrede':'Herr', |
|
234 |
+ 'vorname':'Max', |
|
235 |
+ 'nachname':'Mustermann' |
|
236 |
+ }, |
|
237 |
+ { |
|
238 |
+ 'anrede':'Frau', |
|
239 |
+ 'vorname':'Monika', |
|
240 |
+ 'nachname':'Musterfrau' |
|
241 |
+ } |
246 |
246 |
]} |
247 |
247 |
{{/code}} |
248 |
248 |
|