Zusammenfassung

• Seiteneigenschaften (2 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Dokument-Autor

...	...	@@ -1,1 +1,1 @@
1		-XWiki.awa
	1	+XWiki.gru

Inhalt

...	...	@@ -17,7 +17,7 @@
17	17	* Vergeben Sie einen eindeutigen Namen und optional eine Beschreibung.
18	18	* Aktivieren Sie ggf. die Benutzung der //LDAP//-Verbindung des [[Mandanten>>doc:Formcycle.SystemSettings.UserInterface.Clients]] oder wählen sie eine separate [[//LDAP//-Verbindung>>doc:Formcycle.UserInterface.Data.LDAPConnections]] aus.
19	19	* Definieren Sie für diese //LDAP//-Abfrage zu verwendende //BaseDN//. Diese dient als Wurzel für die Suche mittels der eigentlichen Filterabfrage.
20		-* Definieren Sie die Abfrage in entsprechender //LDAP//-Filtersyntax ([[Tutorial>>url:http://www.selfadsi.de/ldap-filter.htm#FilterDef||rel="__blank"]]). Parameter werden innerhalb des Filters durch {{code}}?{{/code}} angegeben und durch entsprechende Übergaben ersetzt (Punkt 2 in [[Abbildung>>||anchor="fig_data_ldap_query"]]).
	20	+* Definieren Sie die Abfrage in entsprechender //LDAP//-Filtersyntax ([[Tutorial>>url:http://www.selfadsi.de/ldap-filter.htm#FilterDef||rel="__blank"]]). Parameter werden innerhalb des Filters durch {{code language="none"}}?{{/code}} angegeben und durch entsprechende Übergaben ersetzt (Punkt 2 in [[Abbildung>>||anchor="fig_data_ldap_query"]]).
21	21	* Tragen Sie ggf. die von Ihnen benötigten Attribute in den Attributfilter ein. Die Rückgabe der Abfrage wird anschließend auf diese beschränkt. Wird hier kein Attribut definiert, werden alle Attribute des Such-Ergebnisses zurückgeliefert (Punkt 4 in [[Abbildung>>||anchor="fig_data_ldap_query"]]).
22	22
23	23	== Verwendung der Abfrage ==
...	...	@@ -24,7 +24,7 @@
24	24
25	25	Die //LDAP//-Datenabfrage ist innerhalb und außerhalb eines Formulars über das hierfür vorgesehene //Servlet// unter Verwendung der entsprechenden Parameter abrufbar.
26	26
27		-{{code}}
	27	+{{code language="none"}}
28	28	http://<server>/formcycle/datenabfrageldap
29	29	{{/code}}
30	30
...	...	@@ -36,8 +36,8 @@
36	36	|name|Muss dem Namen der LDAP-Abfrage entsprechen.|Ja
37	37	|mandantName|Muss dem Namen des Mandanten entsprechen, unter welchen diese Datenquelle erstellt wurde.|Ja, wenn //projektId// nicht gegeben
38	38	|projektId|Muss der ID des Formulars entsprechen. Diese Information kann über XFC_METADATA.currentProject.id abgerufen werden.|Ja, wenn //mandantName// nicht gegeben
39		-|queryParameter|Nur erforderlich, wenn innerhalb der LDAP-Abfrage Platzhalter in Form eines Fragezeichens {{code}}?{{/code}} verwendet werden. Ist dies der Fall, werden die einzelnen Parameter übergeben getrennt mit dem Trennzeichen, welches durch den Parameter //delimiter// festgelegt wird.|Nein
40		-|delimiter|Trennzeichen, welches die einzelnen Werte des //queryParameter// trennt. Standardmäßig ein Komma {{code}},{{/code}}.|Nein
	39	+|queryParameter|Nur erforderlich, wenn innerhalb der LDAP-Abfrage Platzhalter in Form eines Fragezeichens {{code language="none"}}?{{/code}} verwendet werden. Ist dies der Fall, werden die einzelnen Parameter übergeben getrennt mit dem Trennzeichen, welches durch den Parameter //delimiter// festgelegt wird.|Nein
	40	+|delimiter|Trennzeichen, welches die einzelnen Werte des //queryParameter// trennt. Standardmäßig ein Komma {{code language="none"}},{{/code}}.|Nein
41	41	{{/table}}
42	42
43	43	Bei Zugriff aus einem Formular verwenden Sie bitte immer das globale Variablen-Objekt {{jsdoc page="metadata" name="urls"}}XFC_METADATA.urls{{/jsdoc}}. In diesem Objekt stehen alle relevanten URLs von {{formcycle case="dat"/}} zur Verfügung, sodass diese Beispielhaft wie folgt ermittelt werden kann: {{code language="javascript"}}XFC_METADATA.urls.datasource_ldap{{/code}}.
...	...	@@ -47,7 +47,7 @@
47	47	== Testen der Abfrage ==
48	48
49	49	{{info}}
50		-Zum schnellen Testen der Abfrage steht die Tastenkombination {{code}}Strg + Enter{{/code}} zur Verfügung.
	50	+Zum schnellen Testen der Abfrage steht die Tastenkombination {{code language="none"}}Strg + Enter{{/code}} zur Verfügung.
51	51	{{/info}}
52	52
53	53	LDAP-Abfragen können direkt in der Konfigurationsoberfläche getestet werden. Hierzu steht eine Testkonsole unterhalb des Editors zur Verfügung (siehe [[Abbildung>>||anchor="fig_data_ldap_query"]]).
...	...	@@ -54,9 +54,9 @@
54	54	Im Header der Testkonsole befindet sich eine Reihe von Buttons zur Steuerung der Abfrage:
55	55
56	56	* {{ficon name="database-search"/}}**Abfrage ausführen**
57		-Führt die LDAP-Abfrage aus. Werden //Abfrageparameter// ({{code}}?{{/code}}) verwendet, wird der Nutzer aufgefordert Werte für diese Parameter einzugeben. Ist dies nicht der Fall wird das Ergebnis der Abfrage direkt in der //Quellcodeansicht// dargestellt.{{lightbox image="data_ldap_query_test_de.png" title="Abfrage ausführen"/}}
	57	+Führt die LDAP-Abfrage aus. Werden //Abfrageparameter// ({{code language="none"}}?{{/code}}) verwendet, wird der Nutzer aufgefordert Werte für diese Parameter einzugeben. Ist dies nicht der Fall wird das Ergebnis der Abfrage direkt in der //Quellcodeansicht// dargestellt.{{lightbox image="data_ldap_query_test_de.png" title="Abfrage ausführen"/}}
58	58	* {{icon name="question"/}}**Abfrageparameter**
59		-Maske zum Eingeben von Werten für Abfrageparameter. Diese Option steht nur zur Verfügung, wenn Abfrageparameter ({{code}}?{{/code}}) in der LDAP-Abfrage verwendet werden. Die einzelnen Abfrageparameter werden nummeriert im Query dargestellt. Ein Klick auf "Parameter für Abfrage verwenden" {{ficon name="arrow-right-bold-circle-outline2"/}} führt die Abfrage mit den eingebenen Parametern aus. Das Ergebnis wird in der //Quellcodeansicht// dargestellt.
	59	+Maske zum Eingeben von Werten für Abfrageparameter. Diese Option steht nur zur Verfügung, wenn Abfrageparameter ({{code language="none"}}?{{/code}}) in der LDAP-Abfrage verwendet werden. Die einzelnen Abfrageparameter werden nummeriert im Query dargestellt. Ein Klick auf "Parameter für Abfrage verwenden" {{ficon name="arrow-right-bold-circle-outline2"/}} führt die Abfrage mit den eingebenen Parametern aus. Das Ergebnis wird in der //Quellcodeansicht// dargestellt.
60	60	{{lightbox image="data_ldap_query_test_param_de.png" title="Die Paramter der Abfrage werden nummeriert."/}}
61	61	Eigentliche Abfrage im Editor:{{lightbox image="data_ldap_query_example.png" title="Beispielabfrage"/}}
62	62	* {{icon name="code"/}}**Quellcodeansicht**
...	...	@@ -71,13 +71,13 @@
71	71
72	72	Beispielsweise ein LDAP-Abfrage mit dem Namen //MeinAbfrage// angelegt und folgende Abfrage hinterlegt.
73	73
74		-{{code}}
	74	+{{code language="none"}}
75	75	((distinguishedName=?,?)
76	76	{{/code}}
77	77
78	78	Es müssen zwei Werte für die beiden Platzhalter (Fragezeichen) übergeben werden. Diese Abfrage kann wie folgt aufgerufen werden.
79	79
80		-{{code}}
	80	+{{code language="none"}}
81	81	http://<server>/formcycle/datenabfrageldap?name=MeineAbfrage&mandantName=MeinMandant&queryParameter=Wert,1;Wert,2&delimiter=;
82	82	{{/code}}
83	83