Von Version < 56.1 >
bearbeitet von nlo
am 10.05.2019, 12:21
Auf Version < 27.1 >
bearbeitet von nlo
am 09.05.2019, 17:52
< >
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -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 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  
data_source_csv_servlet_json_comparison.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.nlo
Größe
... ... @@ -1,1 +1,0 @@
1 -23.8 KB
Inhalt
data_source_csv_settings_de.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.nlo
Größe
... ... @@ -1,1 +1,0 @@
1 -5.2 KB
Inhalt
data_source_csv_settings_en.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.nlo
Größe
... ... @@ -1,1 +1,0 @@
1 -4.9 KB
Inhalt
data_source_csv_source.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.nlo
Größe
... ... @@ -1,1 +1,0 @@
1 -4.0 KB
Inhalt
data_source_csv_table.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.nlo
Größe
... ... @@ -1,1 +1,0 @@
1 -13.8 KB
Inhalt
data_source_csv_table_w_header.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.nlo
Größe
... ... @@ -1,1 +1,0 @@
1 -14.1 KB
Inhalt
Copyright 2000-2024