Zusammenfassung

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

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//.
...	...	@@ -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,8 +57,8 @@
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.
	54	+{{figure image="data_source_csv_servlet_json.png"}}
	55	+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	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.
...	...	@@ -68,27 +68,29 @@
68	68	//Tabellenansicht einer CSV-Datenquelle//:
69	69	{{lightbox image="data_source_csv_table.png" title="Tabellenansicht einer CSV-Datenquelle"/}}
70	70
71		-=== Bearbeitung von CSV-Tabellen ===
72		-
73	73	Zum Bearbeitung einer CSV-Tabelle befinden sich unterhalb des Editierbereichs eine Reihe von Schaltflächen:
74	74
75	75	* {{ficon name="plus-circle"/}} **Einfügen**: Fügt neue Zeilen oder Spalten relativ zur derzeit selektierten Zelle ein.
76	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.
	69	+* {{icon name="upload"/}} **Importieren**: Öffnet den Dialog zum Importieren von CSV-Datenquellen.
	70	+*
79	79
80		-=== Header von CSV-Datenquellen ===
	72	+**Erste Zeile ist Header**
81	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}}):
	74	+=== Beispiel für eine CSV-Datenquelle ===
83	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.
	76	+{{info}}
	77	+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.
	78	+{{/info}}
88	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"/}}
	80	+{{code}}
	81	+anrede,vorname,nachname,plz,ort
	82	+Herr,Max,Mustermann,1000,Musterhausen
	83	+Frau,Monika,Mustermann,2000,Musterdorf
	84	+Frau, Luise,Musterfrau,3000,Musterstadt
	85	+{{/code}}
90	90
91		-CSV-Datenquellen können im {{designer case="dat"/}} über das //Servlet// mit Namen {{code}}XFC_METADATA.urls.datasource_csv{{/code}} ausgelsen werden.
	87	+Das Auslesen der Werte im {{designer case="dat"/}} erfolgt über das //Servlet// mit Namen //datenquellecsv//.
92	92
93	93	=== Servlet-Parameter ===
94	94
...	...	@@ -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];
	130	+ 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		- });
	132	+ $('[name=tfAnrede]').val(obj.anrede)
	133	+ $('[name=tfVorname]').val(obj.vorname)
	134	+ $('[name=tfName]').val(obj.nachname)
	135	+ $('[name=tfPLZ]').val(obj.plz)
	136	+ $('[name=tfOrt]').val(obj.ort)
	137	+ })
144	144	{{/code}}
145	145
146		-{{lightbox image="data_source_csv_designer_script_de.png" width="300"/}}
	140	+{{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_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_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