| ... |
... |
@@ -7,11
+7,6 @@ |
| 7 |
7 |
|
| 8 |
8 |
Um auch im Skriptbereich per Javaskript auf die Datenquellen Zugriff zu haben, werden alle Datenquellen in eine JSON-Struktur umgewandelt und im Objekt {{code}}XFC_METADATA.urls.datasource_[csv|json|xml]{{/code}} zugänglich gemacht. Die Struktur dieser JSON-Struktur für die verschiedenen Datenquellen ist im jeweiligen Abschnitt erläutert. |
| 9 |
9 |
|
| 10 |
|
-{{info}} |
| 11 |
|
-**Servlet-URL** |
| 12 |
|
-Die Servlet-URL einer Datenquelle wird nach dem Anlegen in der Konfigurationsoberfläche dargestellt (siehe Punkt 4 in der [[Abbildung>>||anchor="fig_data_source"]]) und ist im JS-Objekt {{code}}XFC_METADATA.urls.datasource_[csv|json|xml]{{/code}} verfügbar. |
| 13 |
|
-{{/info}} |
| 14 |
|
- |
| 15 |
15 |
== Anlegen einer Datenquelle == |
| 16 |
16 |
|
| 17 |
17 |
Öffnen Sie das Modul "Daten > Quellen" und klicken Sie auf die Schaltfläche "Neu" {{ficon name="plus-circle-outline"/}} in der Kopfzeile der Liste (siehe Punkt 1 in der [[Abbildung>>||anchor="fig_data_source"]]). Daraufhin werden Sie aufgefordert eine leere Datenquelle anzulegen oder diese aus einer Datei zu importieren. Es können drei Typen von Datenquellen angelegt werden: //XML//, //CSV// und //JSON//. |
| ... |
... |
@@ -19,7
+19,6 @@ |
| 19 |
19 |
{{lightbox image="data_source_new_de.png" title="Datenquellen können aus Dateien importiert oder neu angelegt werden"/}} |
| 20 |
20 |
|
| 21 |
21 |
Jede Datenquelle benötigt: |
| 22 |
|
- |
| 23 |
23 |
* einen eindeutigen Namen (im Einstellungspanel: siehe Punkt 3 in der [[Abbildung>>||anchor="fig_data_source"]]) |
| 24 |
24 |
* die eigentlichen Daten im Editierbereich (siehe Punkt 2 in der [[Abbildung>>||anchor="fig_data_source"]]) |
| 25 |
25 |
|
| ... |
... |
@@ -31,7
+31,6 @@ |
| 31 |
31 |
* **CSV**: //.csv//, //.xls//, //.xlsx// (Excel) |
| 32 |
32 |
* **JSON**: //.json// |
| 33 |
33 |
|
| 34 |
|
-{{id name="data_source_import_csv"/}} |
| 35 |
35 |
__CSV-Datenquellen__ |
| 36 |
36 |
|
| 37 |
37 |
CSV-Datenquellen können aus unterschiedlichen Dateitypen importiert werden: |
| ... |
... |
@@ -57,39
+57,24 @@ |
| 57 |
57 |
|
| 58 |
58 |
== CSV == |
| 59 |
59 |
|
| 60 |
|
-{{figure image="data_source_csv_servlet_json_comparison.png"}} |
| 61 |
|
-Die JSON-Struktur einer CSV-Datenquelle. Auf diese JSON-Struktur kann per Javaskcipt über {{code}}XFC_METADATA.urls.datasource_csv{{/code}} zugegriffen werden. (1) Links ist die JSON-Struktur der Datenquelle dargestellt, bei welcher die erste Zeile nicht als Header verwendet wird. Stattdessen werden Header in Form von {{code}}colX{{/code}} verwendet. (2) Rechts ist die Datenquelle zu sehen, wenn die erste Zeile als Header verwendet wird. |
|
53 |
+CSV-Datenquellen können in einer Quellcode-Ansicht oder in einer Tabellenansicht dargestellt werden. Die Ansicht kann mit einem Klick auf die entsprechende Schaltfläche in der Fußzeile unterhalb des Editierbereichs geändert werden. |
|
54 |
+ |
|
55 |
+{{figure image="datenquelle_csv_8.png"}} |
|
56 |
+Die JSON-Struktur der CSV-Datenquelle. Auf diese JSON-Struktur kann dann per Javaskript über {{code}}XFC_METADATA.urls.datasource_[csv|json|xml]{{/code}} zugegriffen werden. |
| 62 |
62 |
{{/figure}} |
| 63 |
63 |
|
| 64 |
|
-CSV-Datenquellen können in einer Quellcode-Ansicht oder in einer Tabellenansicht dargestellt werden. Die Ansicht kann mit einem Klick auf die entsprechende Schaltfläche {{ficon name="table-large"/}}/{{icon name="code"/}} in der Fußzeile unterhalb des Editierbereichs geändert werden. |
|
59 |
+=== Beispiel für eine CSV-Datenquelle === |
| 65 |
65 |
|
| 66 |
|
-//Quellcode-Ansicht einer CSV-Datenquelle//: |
| 67 |
|
-{{lightbox image="data_source_csv_source.png" title="Quellcode-Ansicht einer CSV-Datenquelle"/}} |
| 68 |
|
-//Tabellenansicht einer CSV-Datenquelle//: |
| 69 |
|
-{{lightbox image="data_source_csv_table.png" title="Tabellenansicht einer CSV-Datenquelle"/}} |
|
61 |
+{{info}} |
|
62 |
+Die CSV-Daten werden intern in ein JSON-Objekt umgewandelt, sodass die erste Zeile der //CSV-Datei// immer die Objektnamen für den späteren Zugriff definiert. |
|
63 |
+{{/info}} |
| 70 |
70 |
|
| 71 |
|
-=== Bearbeitung von CSV-Tabellen === |
|
65 |
+{{code}} |
|
66 |
+Wert 1.1, Wert 1.2, Wert 1.3, Wert 1.4, ... |
|
67 |
+{{/code}} |
| 72 |
72 |
|
| 73 |
|
-Zum Bearbeitung einer CSV-Tabelle befinden sich unterhalb des Editierbereichs eine Reihe von Schaltflächen: |
|
69 |
+Das Auslesen der Werte im {{designer case="dat"/}} erfolgt über das //Servlet// mit Namen //datenquellecsv//. |
| 74 |
74 |
|
| 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 Zeile oder Spalte oder leert die selektierte Zelle. |
| 77 |
|
-* {{icon name="upload"/}} **Importieren**: Öffnet den [[Dialog zum Importieren von CSV-Datenquellen>>||anchor="data_source_import_csv"]]. |
| 78 |
|
-* {{icon name="code"/}} **Quellcode-Ansicht**: Wechselt in die Quellcode-Ansicht. |
| 79 |
|
- |
| 80 |
|
-=== Header von CSV-Datenquellen === |
| 81 |
|
- |
| 82 |
|
-Für CSV-Datenquellen gibt es eine zusätzliche Option in den Datenquelleinstellungen. Die Option **Erste Zeile ist Header** regelt den Zugriff auf die Werte der Datenquelle über das entsprechende Servlet ({{code}}XFC_METADATA.urls.datasource_csv{{/code}}): |
| 83 |
|
- |
| 84 |
|
-* **Aktiviert**: |
| 85 |
|
-Die Zellen der erste Zeile werden als Schlüssel bzw. {{code}}keys{{/code}} für den Zugriff auf die Werte der jeweiligen Spalte verwendet (siehe [[Anwendungsbeispiel>>||anchor="data_source_csv_example"]]). |
| 86 |
|
-* **Deaktiviert**: |
| 87 |
|
-Die Schlüssel bzw. {{code}}keys{{/code}} für den Zugriff auf die Werte der einzelnen Datensätze/Zeilen sind durchnummeriert, beginnend mit {{code}}0{{/code}}. Diese Schlüssel haben folgende Form: {{code}}colX{{/code}}, wobei {{code}}X{{/code}} für den Index der Spalte steht. |
| 88 |
|
- |
| 89 |
|
-{{lightbox image="data_source_csv_settings_de.png" title="Die Option **Erste Zeile ist Header** regelt den Zugriff auf die Werte der Datenquelle über das entsprechende Servlet"/}} |
| 90 |
|
- |
| 91 |
|
-CSV-Datenquellen können im {{designer case="dat"/}} über das //Servlet// mit Namen {{code}}XFC_METADATA.urls.datasource_csv{{/code}} ausgelsen werden. |
| 92 |
|
- |
| 93 |
93 |
=== Servlet-Parameter === |
| 94 |
94 |
|
| 95 |
95 |
{{info}} |
| ... |
... |
@@ -110,8
+110,6 @@ |
| 110 |
110 |
|csvTrennzeichen|Gibt das Trennzeichen zwischen den einzelnen Datenzellen an. Wird dieses nicht gesetzt, wird hier standardmäßig ein Komma {{code}},{{/code}} benutzt.|Nein |
| 111 |
111 |
|csvQuote|Das Trennzeichen, mit dem die Werte der Zeilen getrennt sind. Wird dieses nicht gesetzt, wird hier standardmäßig ein Anführungszeichen verwendet {{code}}"{{/code}}.| Nein |
| 112 |
112 |
|
| 113 |
|
-{{id name="data_source_csv_example"/}} |
| 114 |
|
- |
| 115 |
115 |
=== Anwendungsbeispiel === |
| 116 |
116 |
|
| 117 |
117 |
{{figure image="datenquelle_csv_7.png" width="300"}} |
| ... |
... |
@@ -133,17
+133,17 @@ |
| 133 |
133 |
|
| 134 |
134 |
{{code language="javascript"}} |
| 135 |
135 |
$.getJSON( XFC_METADATA.urls.datasource_csv + "?name=Demo&mandantName=xima.de", function(json) { |
| 136 |
|
- var obj = json.returnValue[0]; |
|
112 |
+ var obj = json.returnValue[0] |
| 137 |
137 |
|
| 138 |
|
- $('[name=tfAnrede]').val(obj.anrede); |
| 139 |
|
- $('[name=tfVorname]').val(obj.vorname); |
| 140 |
|
- $('[name=tfName]').val(obj.nachname); |
| 141 |
|
- $('[name=tfPLZ]').val(obj.plz); |
| 142 |
|
- $('[name=tfOrt]').val(obj.ort); |
| 143 |
|
- }); |
|
114 |
+ $('[name=tfAnrede]').val(obj.anrede) |
|
115 |
+ $('[name=tfVorname]').val(obj.vorname) |
|
116 |
+ $('[name=tfName]').val(obj.nachname) |
|
117 |
+ $('[name=tfPLZ]').val(obj.plz) |
|
118 |
+ $('[name=tfOrt]').val(obj.ort) |
|
119 |
+ }) |
| 144 |
144 |
{{/code}} |
| 145 |
145 |
|
| 146 |
|
-{{lightbox image="data_source_csv_designer_script_de.png" width="300"/}} |
|
122 |
+{{lightbox image="datenquelle_csv_4.png" width="300"/}} |
| 147 |
147 |
|
| 148 |
148 |
Dieses Beispiel als Datenquelle für den {{designer case="acc"/}} [[zum Herunterladen>>attach:beispiel_datenquelle_csv.json||rel="__blank"]]. |
| 149 |
149 |
|