| ... |
... |
@@ -8,6
+8,49 @@ |
| 8 |
8 |
The sources or rather data sources are lodged as text in the format CSV, JSON or XML and can be worked up through the {{designer/}}/the form. |
| 9 |
9 |
To have an access to data sources in the script area via javascript too, all data sources are converted into a JSON structure and customized in the object {{code}}XFC_METADATA.urls.datasource_[csv|json|xml]{{/code}}. The structure of this JSON structure for the different data sources is expounded in the respective section. |
| 10 |
10 |
|
|
11 |
+== Creating a data source == |
|
12 |
+ |
|
13 |
+Open the module "Data > Sources" and click the button "New" {{ficon name="plus-circle-outline"/}} in the header of the list (see point 1 in [[figure>>||anchor="fig_data_source"]]). After that you will be prompted to either create an empty data source or import one from a file. Three types of data sources can be created: //XML//, //CSV// und //JSON//. |
|
14 |
+ |
|
15 |
+{{lightbox image="data_source_new_en.png" title="Data sources can be imported or created from scratch."/}} |
|
16 |
+ |
|
17 |
+Every data source needs: |
|
18 |
+ |
|
19 |
+* a unique name (in the settings panel: see point 3 in [[figure>>||anchor="fig_data_source"]]) |
|
20 |
+* the actual data in the editing area (see point 2 in [[figure>>||anchor="fig_data_source"]]) |
|
21 |
+ |
|
22 |
+=== Import of data sources from files === |
|
23 |
+ |
|
24 |
+The following Data types can be used to import data sources: |
|
25 |
+ |
|
26 |
+* **XML**: //.xml// |
|
27 |
+* **CSV**: //.csv//, //.xls//, //.xlsx// (Excel) |
|
28 |
+* **JSON**: //.json// |
|
29 |
+ |
|
30 |
+{{id name="data_source_import_csv"/}} |
|
31 |
+__CSV-Datenquellen__ |
|
32 |
+ |
|
33 |
+CSV-Datenquellen können aus unterschiedlichen Dateitypen importiert werden: |
|
34 |
+ |
|
35 |
+* //.csv// |
|
36 |
+Es öffnet sich ein Dialog zur Konfiguration des Imports: |
|
37 |
+** **Trennzeichen**: Gibt an welches Trennzeichen in der Datei verwendet wird, um Datenfelder/Spalten voneinander zu trennen (typischerweise: Komma). |
|
38 |
+** **Textqualifizierer**: Gibt an welches Feldbegrenzerzeichen in der Datei verwendet wird. Dieses Zeichen wird verwendet, um Sonderzeichen innerhalb der Datenfelder nutzen zu können (z. B. Komma in Dezimalzahlwerten). |
|
39 |
+** **Beginnen ab Zeile**: Gibt an, ab welcher Zeile die CSV-Datei importiert werden soll. |
|
40 |
+** **Leere Zeilen ignorieren**: Wenn aktiviert werden leere Zeilen beim Import ignoriert. |
|
41 |
+ |
|
42 |
+{{lightbox image="data_source_import_csv_de.png" title="Importdialog für CSV-Dateien"/}} |
|
43 |
+ |
|
44 |
+* //.xls//, //.xlsx// |
|
45 |
+Es öffnet sich ein Dialog zur Konfiguration des Imports: |
|
46 |
+** **Zu importierende Tabellen**: Gibt an welche Arbeitsblätter/Tabellen aus der Datei importiert werden sollen. |
|
47 |
+ |
|
48 |
+{{lightbox image="data_source_import_excel_de.png" title="Importdialog für Excel-Dateien"/}} |
|
49 |
+ |
|
50 |
+__Drag&Drop__ |
|
51 |
+ |
|
52 |
+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. |
|
53 |
+ |
| 11 |
11 |
== CSV == |
| 12 |
12 |
|
| 13 |
13 |
Here you can insert data sets in the CSV format. |