... |
... |
@@ -1,7
+1,9 @@ |
1 |
1 |
{{content/}} |
2 |
2 |
|
3 |
3 |
{{id name="fig_data_source"/}} |
4 |
|
-{{figure image="data_source_en.png"}}Configuration screen for creating data sources: (1) list of existing data sources, (2) area for editing the selected data source, (3) settings panel of the data source, (4) servlet URL for accessing the data source.{{/figure}} |
|
4 |
+{{figure image="data_source_en.png" }} |
|
5 |
+Configuration screen for creating data sources: (1) list of existing data sources, (2) area for editing the selected data source, (3) settings panel of the data source, (4) servlet URL for accessing the data source. |
|
6 |
+{{/figure}} |
5 |
5 |
|
6 |
6 |
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. |
7 |
7 |
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. |
... |
... |
@@ -56,39
+56,28 @@ |
56 |
56 |
|
57 |
57 |
== CSV == |
58 |
58 |
|
59 |
|
-{{figure image="data_source_csv_servlet_json_comparison.png"}} |
60 |
|
-The JSON structure of a CSV data source. This JSON structure can be accessed through JavaScript via {{code}}XFC_METADATA.urls.datasource_csv{{/code}}. (1) On the left there is the JSON structure of the data source with out using the first row as a header. Instead the headers are of the form: {{code}}colX{{/code}}. (2) On the right there is the data source where the first row is being used as the header. |
61 |
|
-{{/figure}} |
|
61 |
+Here you can insert data sets in the CSV format. |
62 |
62 |
|
63 |
|
-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. |
|
63 |
+* Choose the option //CSV// under //type//. |
|
64 |
+* Assign an explicit name. |
|
65 |
+* Insert the data sperated with a comma in the arrey //value//. |
64 |
64 |
|
65 |
|
-//Quellcode-Ansicht einer CSV-Datenquelle//: ([[CSV Dateiformat>>https://de.wikipedia.org/wiki/CSV_(Dateiformat)||target="_blank"]]) |
66 |
|
-{{lightbox image="data_source_csv_source.png" title="Quellcode-Ansicht einer CSV-Datenquelle"/}} |
67 |
|
-//Tabellenansicht einer CSV-Datenquelle//: |
68 |
|
-{{lightbox image="data_source_csv_table.png" title="Tabellenansicht einer CSV-Datenquelle"/}} |
|
67 |
+{{figure image="datenquelle_csv_8.png" width="300"}} |
|
68 |
+The JSON structure of the CSV data source. To this JSON structure can only be accessed via {{code}}XFC_METADATA.urls.datasource_[csv|json|xml]{{/code}}. |
|
69 |
+{{/figure}} |
69 |
69 |
|
70 |
|
-=== Bearbeitung von CSV-Tabellen === |
|
71 |
+=== Example for a CSV data source === |
71 |
71 |
|
72 |
|
-Zum Bearbeitung einer CSV-Tabelle befinden sich unterhalb des Editierbereichs eine Reihe von Schaltflächen: |
|
73 |
+{{info}} |
|
74 |
+The CSV data are converted to a JSON object internally, so that the first line of the //CSV data// always defines the object names for the later access. |
|
75 |
+{{/info}} |
73 |
73 |
|
74 |
|
-* {{ficon name="plus-circle"/}} **Einfügen**: Fügt neue Zeilen oder Spalten relativ zur derzeit selektierten Zelle ein. |
75 |
|
-* {{ficon name="trash-alt2"/}} **Entfernen**: Entfernt die selektierte Zeile oder Spalte oder leert die selektierte Zelle. |
76 |
|
-* {{icon name="upload"/}} **Importieren**: Öffnet den [[Dialog zum Importieren von CSV-Datenquellen>>||anchor="data_source_import_csv"]]. |
77 |
|
-* {{icon name="code"/}} **Quellcode-Ansicht**: Wechselt in die Quellcode-Ansicht. |
|
77 |
+{{code}} |
|
78 |
+Value 1.1, value 1.2, value 1.3, value 1.4, ... |
|
79 |
+{{/code}} |
78 |
78 |
|
79 |
|
-=== Header von CSV-Datenquellen === |
|
81 |
+The readout of the values in the {{designer/}} ensues through the //servlet// with the namen //datenquellecsv//. |
80 |
80 |
|
81 |
|
-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}}): |
82 |
|
- |
83 |
|
-* **Aktiviert**: |
84 |
|
-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"]]). |
85 |
|
-* **Deaktiviert**: |
86 |
|
-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. |
87 |
|
- |
88 |
|
-{{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"/}} |
89 |
|
- |
90 |
|
-CSV-Datenquellen können im {{designer case="dat"/}} über das //Servlet// mit Namen {{code}}XFC_METADATA.urls.datasource_csv{{/code}} ausgelsen werden. |
91 |
|
- |
92 |
92 |
=== Servlet parameters === |
93 |
93 |
|
94 |
94 |
{{info}} |