Von Version < 64.1 >
bearbeitet von nlo
am 10.05.2019, 14:14
Auf Version < 50.1 >
bearbeitet von nlo
am 10.05.2019, 10:55
< >
Ä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//.
... ... @@ -58,12 +58,12 @@
58 58  == CSV ==
59 59  
60 60  {{figure image="data_source_csv_servlet_json_comparison.png"}}
61 -Die JSON-Struktur einer CSV-Datenquelle. Auf diese JSON-Struktur kann per Javascript ü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.
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.
62 62  {{/figure}}
63 63  
64 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.
65 65  
66 -//Quellcode-Ansicht einer CSV-Datenquelle//: ([[CSV Dateiformat>>https://de.wikipedia.org/wiki/CSV_(Dateiformat)||target="_blank"]])
61 +//Quellcode-Ansicht einer CSV-Datenquelle//:
67 67  {{lightbox image="data_source_csv_source.png" title="Quellcode-Ansicht einer CSV-Datenquelle"/}}
68 68  //Tabellenansicht einer CSV-Datenquelle//:
69 69  {{lightbox image="data_source_csv_table.png" title="Tabellenansicht einer CSV-Datenquelle"/}}
... ... @@ -88,6 +88,11 @@
88 88  
89 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 90  
86 +
87 +{{info}}
88 +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.
89 +{{/info}}
90 +
91 91  CSV-Datenquellen können im {{designer case="dat"/}} über das //Servlet// mit Namen {{code}}XFC_METADATA.urls.datasource_csv{{/code}} ausgelsen werden.
92 92  
93 93  === Servlet-Parameter ===
... ... @@ -97,7 +97,7 @@
97 97  http(s):~/~/<server>/formcycle/datenquellecsv?mandantName=<Mandant-Name>&name=<Datenquellen-Name>
98 98  {{/info}}
99 99  
100 -Bei Zugriff aus dem {{designer case="dat"/}} verwenden Sie immer das globale Variablen-Objekt //XFC_METADATA//, siehe hierzu auch [[Globale Designer Variablen>>https://jsdocs.formcycle.eu/jsdocs/de/modules/_formcycle_v6_de_d_.html#xfc_metadata||target="_blank"]]. Beispielsweise kann wie folgt darauf zugegriffen werden: {{code}}XFC_METADATA.urls.datasource_csv{{/code}}.
100 +Bei Zugriff aus dem {{designer case="dat"/}} verwenden Sie immer das globale Variablen-Objekt //XFC_METADATA//, siehe hierzu auch [[Globale Designer Variablen>>doc:Main.Formular-Metadaten]]. Beispielsweise kann wie folgt darauf zugegriffen werden: {{code}}XFC_METADATA.urls.datasource_csv{{/code}}.
101 101  
102 102  Folgende Parameter sind möglich:
103 103  
... ... @@ -114,6 +114,10 @@
114 114  
115 115  === Anwendungsbeispiel ===
116 116  
117 +{{figure image="datenquelle_csv_7.png" width="300"}}
118 +Ein Beispiel dafür, wie eine CSV-Datenquelle aussehen kann. Die Spalten werden durch Kommas getrennt.
119 +{{/figure}}
120 +
117 117  {{code language="csv"}}
118 118  anrede,vorname,nachname,plz,ort
119 119  Herr,Max,Mustermann,1000,Musterhausen
... ... @@ -122,21 +122,24 @@
122 122  
123 123  {{/code}}
124 124  
125 -Im {{designer case="dat"/}} wird dann folgendes Skript im [[Skriptbereich>>doc:Formcycle.FormDesigner.CodingPanel.WebHome]] verwendet.
126 126  
130 +
131 +
132 +Im {{designer case="dat"/}} wird dann folgendes Skript im [[Skriptbereich>>doc:Main.TAB - Script]] verwendet.
133 +
127 127  {{code language="javascript"}}
128 128  $.getJSON( XFC_METADATA.urls.datasource_csv + "?name=Demo&mandantName=xima.de", function(json) {
129 - var obj = json.returnValue[0];
136 + var obj = json.returnValue[0]
130 130  
131 - $('[name=tfAnrede]').val(obj.anrede);
132 - $('[name=tfVorname]').val(obj.vorname);
133 - $('[name=tfName]').val(obj.nachname);
134 - $('[name=tfPLZ]').val(obj.plz);
135 - $('[name=tfOrt]').val(obj.ort);
136 - });
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 + })
137 137  {{/code}}
138 138  
139 -{{lightbox image="data_source_csv_designer_script_de.png"/}}
146 +{{lightbox image="datenquelle_csv_4.png" width="300"/}}
140 140  
141 141  Dieses Beispiel als Datenquelle für den {{designer case="acc"/}} [[zum Herunterladen>>attach:beispiel_datenquelle_csv.json||rel="__blank"]].
142 142  
data_source_csv_designer_script_de.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.nlo
Größe
... ... @@ -1,1 +1,0 @@
1 -26.0 KB
Inhalt
data_source_csv_designer_script_en.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.nlo
Größe
... ... @@ -1,1 +1,0 @@
1 -26.8 KB
Inhalt
Copyright 2000-2024