Zusammenfassung

• Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
• Anhänge (0 geändert, 3 hinzugefügt, 0 gelöscht)
  • data_source_csv_designer_script_de.png
  • data_source_csv_designer_script_en.png
  • data_source_csv_settings_en.png

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//.
...	...	@@ -53,12 +53,12 @@
53	53	== CSV ==
54	54
55	55	{{figure image="data_source_csv_servlet_json_comparison.png"}}
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.
	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.
57	57	{{/figure}}
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)]])
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"/}}
...	...	@@ -74,14 +74,16 @@
74	74
75	75	=== Header von CSV-Datenquellen ===
76	76
77		-**Erste Zeile ist Header**
	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}}):
78	78
	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.
79	79
80		-{{info}}
81		-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.
82		-{{/info}}
	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"/}}
83	83
84		-CSV-Datenquellen können im {{designer case="dat"/}} über das //Servlet// mit Namen //datenquellecsv// ausgelsen werden.
	91	+CSV-Datenquellen können im {{designer case="dat"/}} über das //Servlet// mit Namen {{code}}XFC_METADATA.urls.datasource_csv{{/code}} ausgelsen werden.
85	85
86	86	=== Servlet-Parameter ===
87	87
...	...	@@ -103,12 +103,10 @@
103	103	|csvTrennzeichen|Gibt das Trennzeichen zwischen den einzelnen Datenzellen an. Wird dieses nicht gesetzt, wird hier standardmäßig ein Komma {{code}},{{/code}} benutzt.|Nein
104	104	|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
105	105
	113	+{{id name="data_source_csv_example"/}}
	114	+
106	106	=== Anwendungsbeispiel ===
107	107
108		-{{figure image="datenquelle_csv_7.png" width="300"}}
109		-Ein Beispiel dafür, wie eine CSV-Datenquelle aussehen kann. Die Spalten werden durch Kommas getrennt.
110		-{{/figure}}
111		-
112	112	{{code language="csv"}}
113	113	anrede,vorname,nachname,plz,ort
114	114	Herr,Max,Mustermann,1000,Musterhausen
...	...	@@ -124,17 +124,17 @@
124	124
125	125	{{code language="javascript"}}
126	126	$.getJSON( XFC_METADATA.urls.datasource_csv + "?name=Demo&mandantName=xima.de", function(json) {
127		- var obj = json.returnValue[0]
	132	+ var obj = json.returnValue[0];
128	128
129		- $('[name=tfAnrede]').val(obj.anrede)
130		- $('[name=tfVorname]').val(obj.vorname)
131		- $('[name=tfName]').val(obj.nachname)
132		- $('[name=tfPLZ]').val(obj.plz)
133		- $('[name=tfOrt]').val(obj.ort)
134		- })
	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	+ });
135	135	{{/code}}
136	136
137		-{{lightbox image="datenquelle_csv_4.png" width="300"/}}
	142	+{{lightbox image="data_source_csv_designer_script_de.png"/}}
138	138
139	139	Dieses Beispiel als Datenquelle für den {{designer case="acc"/}} [[zum Herunterladen>>attach:beispiel_datenquelle_csv.json||rel="__blank"]].
140	140

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

data_source_csv_settings_en.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.nlo

Größe

...	...	@@ -1,0 +1,1 @@
	1	+4.9 KB

Inhalt