... |
... |
@@ -13,11
+13,6 @@ |
13 |
13 |
|
14 |
14 |
{{lightbox image="data_source_new_de.png" title="Datenquellen können aus Dateien importiert oder neu angelegt werden"/}} |
15 |
15 |
|
16 |
|
-Jede Datenquelle benötigt: |
17 |
|
- |
18 |
|
-* einen eindeutigen Namen (im Einstellungspanel: siehe Punkt 3 in der [[Abbildung>>||anchor="fig_data_source"]]) |
19 |
|
-* die eigentlichen Daten im Editierbereich (siehe Punkt 2 in der [[Abbildung>>||anchor="fig_data_source"]]) |
20 |
|
- |
21 |
21 |
=== Importieren von Datenquellen aus Dateien === |
22 |
22 |
|
23 |
23 |
Folgende Dateitypen können verwendet werden, um Datenquellen zu importieren: |
... |
... |
@@ -26,7
+26,6 @@ |
26 |
26 |
* **CSV**: //.csv//, //.xls//, //.xlsx// (Excel) |
27 |
27 |
* **JSON**: //.json// |
28 |
28 |
|
29 |
|
-{{id name="data_source_import_csv"/}} |
30 |
30 |
__CSV-Datenquellen__ |
31 |
31 |
|
32 |
32 |
CSV-Datenquellen können aus unterschiedlichen Dateitypen importiert werden: |
... |
... |
@@ -52,39
+52,28 @@ |
52 |
52 |
|
53 |
53 |
== CSV == |
54 |
54 |
|
55 |
|
-{{figure image="data_source_csv_servlet_json_comparison.png"}} |
56 |
|
-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. |
57 |
|
-{{/figure}} |
|
49 |
+Hier können Sie Datensätze im CSV-Format eingeben. |
58 |
58 |
|
59 |
|
-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. |
|
51 |
+* Wählen Sie unter //Typ// die Option //CSV//. |
|
52 |
+* Vergeben Sie einen eindeutigen Namen. |
|
53 |
+* Im Feld //Wert// geben Sie die Daten separiert mit einem Komma ein. |
60 |
60 |
|
61 |
|
-//Quellcode-Ansicht einer CSV-Datenquelle//: |
62 |
|
-{{lightbox image="data_source_csv_source.png" title="Quellcode-Ansicht einer CSV-Datenquelle"/}} |
63 |
|
-//Tabellenansicht einer CSV-Datenquelle//: |
64 |
|
-{{lightbox image="data_source_csv_table.png" title="Tabellenansicht einer CSV-Datenquelle"/}} |
|
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. |
|
57 |
+{{/figure}} |
65 |
65 |
|
66 |
|
-=== Bearbeitung von CSV-Tabellen === |
|
59 |
+=== Beispiel für eine CSV-Datenquelle === |
67 |
67 |
|
68 |
|
-Zum Bearbeitung einer CSV-Tabelle befinden sich unterhalb des Editierbereichs eine Reihe von Schaltflächen: |
|
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}} |
69 |
69 |
|
70 |
|
-* {{ficon name="plus-circle"/}} **Einfügen**: Fügt neue Zeilen oder Spalten relativ zur derzeit selektierten Zelle ein. |
71 |
|
-* {{ficon name="trash-alt2"/}} **Entfernen**: Entfernt die selektierte Zeile oder Spalte oder leert die selektierte Zelle. |
72 |
|
-* {{icon name="upload"/}} **Importieren**: Öffnet den [[Dialog zum Importieren von CSV-Datenquellen>>||anchor="data_source_import_csv"]]. |
73 |
|
-* {{icon name="code"/}} **Quellcode-Ansicht**: Wechselt in die Quellcode-Ansicht. |
|
65 |
+{{code}} |
|
66 |
+Wert 1.1, Wert 1.2, Wert 1.3, Wert 1.4, ... |
|
67 |
+{{/code}} |
74 |
74 |
|
75 |
|
-=== Header von CSV-Datenquellen === |
|
69 |
+Das Auslesen der Werte im {{designer case="dat"/}} erfolgt über das //Servlet// mit Namen //datenquellecsv//. |
76 |
76 |
|
77 |
|
-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}}): |
78 |
|
- |
79 |
|
-* **Aktiviert**: |
80 |
|
-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"]]). |
81 |
|
-* **Deaktiviert**: |
82 |
|
-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. |
83 |
|
- |
84 |
|
-{{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"/}} |
85 |
|
- |
86 |
|
-CSV-Datenquellen können im {{designer case="dat"/}} über das //Servlet// mit Namen {{code}}XFC_METADATA.urls.datasource_csv{{/code}} ausgelsen werden. |
87 |
|
- |
88 |
88 |
=== Servlet-Parameter === |
89 |
89 |
|
90 |
90 |
{{info}} |
... |
... |
@@ -105,8
+105,6 @@ |
105 |
105 |
|csvTrennzeichen|Gibt das Trennzeichen zwischen den einzelnen Datenzellen an. Wird dieses nicht gesetzt, wird hier standardmäßig ein Komma {{code}},{{/code}} benutzt.|Nein |
106 |
106 |
|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 |
107 |
107 |
|
108 |
|
-{{id name="data_source_csv_example"/}} |
109 |
|
- |
110 |
110 |
=== Anwendungsbeispiel === |
111 |
111 |
|
112 |
112 |
{{figure image="datenquelle_csv_7.png" width="300"}} |