Von Version < 49.1 >
bearbeitet von nlo
am 10.05.2019, 10:49
Auf Version < 61.1 >
bearbeitet von nlo
am 10.05.2019, 12:29
< >
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -7,6 +7,11 @@
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 +
10 10  == Anlegen einer Datenquelle ==
11 11  
12 12  Ö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//.
... ... @@ -58,7 +58,7 @@
58 58  
59 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.
60 60  
61 -//Quellcode-Ansicht einer CSV-Datenquelle//:
66 +//Quellcode-Ansicht einer CSV-Datenquelle//: ([[CSV Dateiformat>>https://de.wikipedia.org/wiki/CSV_(Dateiformat)||target="_blank"]])
62 62  {{lightbox image="data_source_csv_source.png" title="Quellcode-Ansicht einer CSV-Datenquelle"/}}
63 63  //Tabellenansicht einer CSV-Datenquelle//:
64 64  {{lightbox image="data_source_csv_table.png" title="Tabellenansicht einer CSV-Datenquelle"/}}
... ... @@ -79,16 +79,10 @@
79 79  * **Aktiviert**:
80 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 81  * **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.
82 82  
83 -{{lightbox image="data_source_csv_table.png" title="Tabellenansicht einer CSV-Datenquelle"/}}
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"/}}
84 84  
85 -**Erste Zeile ist Header**
86 -
87 -
88 -{{info}}
89 -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.
90 -{{/info}}
91 -
92 92  CSV-Datenquellen können im {{designer case="dat"/}} über das //Servlet// mit Namen {{code}}XFC_METADATA.urls.datasource_csv{{/code}} ausgelsen werden.
93 93  
94 94  === Servlet-Parameter ===
... ... @@ -115,10 +115,6 @@
115 115  
116 116  === Anwendungsbeispiel ===
117 117  
118 -{{figure image="datenquelle_csv_7.png" width="300"}}
119 -Ein Beispiel dafür, wie eine CSV-Datenquelle aussehen kann. Die Spalten werden durch Kommas getrennt.
120 -{{/figure}}
121 -
122 122  {{code language="csv"}}
123 123  anrede,vorname,nachname,plz,ort
124 124  Herr,Max,Mustermann,1000,Musterhausen
... ... @@ -134,17 +134,17 @@
134 134  
135 135  {{code language="javascript"}}
136 136  $.getJSON( XFC_METADATA.urls.datasource_csv + "?name=Demo&mandantName=xima.de", function(json) {
137 - var obj = json.returnValue[0]
132 + var obj = json.returnValue[0];
138 138  
139 - $('[name=tfAnrede]').val(obj.anrede)
140 - $('[name=tfVorname]').val(obj.vorname)
141 - $('[name=tfName]').val(obj.nachname)
142 - $('[name=tfPLZ]').val(obj.plz)
143 - $('[name=tfOrt]').val(obj.ort)
144 - })
134 + $('[name=tfAnrede]').val(obj.anrede);
135 + $('[name=tfVorname]').val(obj.vorname);
136 + $('[name=tfName]').val(obj.nachname);
137 + $('[name=tfPLZ]').val(obj.plz);
138 + $('[name=tfOrt]').val(obj.ort);
139 + });
145 145  {{/code}}
146 146  
147 -{{lightbox image="datenquelle_csv_4.png" width="300"/}}
142 +{{lightbox image="data_source_csv_designer_script_de.png"/}}
148 148  
149 149  Dieses Beispiel als Datenquelle für den {{designer case="acc"/}} [[zum Herunterladen>>attach:beispiel_datenquelle_csv.json||rel="__blank"]].
150 150  
data_source_csv_designer_script_de.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.nlo
Größe
... ... @@ -1,0 +1,1 @@
1 +26.0 KB
Inhalt
data_source_csv_designer_script_en.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.nlo
Größe
... ... @@ -1,0 +1,1 @@
1 +26.8 KB
Inhalt
Copyright 2000-2024