LSattr_html :: select_list : Add sort feature (with sort and sortDirection parameters)
[ldapsaisie.git] / doc / conf / subDn.docbook
1 <?xml version="1.0" encoding="UTF-8" ?>
2 <!-- Début subDn -->
3 <sect4 id='config-subDn'>
4   <title>Sous-niveaux de connexion</title>
5   
6   <para>Cette section décrit la manière de définir des sous-niveaux de connexion
7   à l'annuaire (<emphasis>subDn</emphasis>). Le concept de sous-niveau de 
8   connexion sert à déclarer les niveaux logiques de l'annuaire. Par exemple, dans un 
9   annuaire dans lequel sont stockés des objets concernant plusieurs organisations
10   et que celles-ci se distinguent grâce à la présence d'une séparation dans 
11   l'arbre, il sera alors possible de définir des sous-niveaux de connexion pour
12   chacune des organisations.</para>
13   
14 <programlisting linenumbering="unnumbered">
15   <citetitle>Exemple d'arborescence d'annuaire utilisant le concept de 
16   sous-niveaux correspondant à des sociétés</citetitle>
17 |- o=ls
18 | |- ou=companies
19 | | |- ou=company1
20 | | | |- ou=people
21 | | | |- ou=groups
22 | | |- ou=company2
23 | | | |- ou=people
24 | | | |- ou=groups
25 | |- ou=people
26 | |- ou=groups
27
28 </programlisting>
29
30 <para>Explications : Il est possible dans cet exemple de définir des
31 sous-niveaux de connexion correspondants aux sociétés. Dans chacune de ces 
32 sociétés, on retrouve les <emphasis>OU</emphasis> correspondant au type 
33 d'<emphasis>LSobjets</emphasis>. Lors de la connexion à l'interface, l'utilisateur
34 devra choisir dans quel sous-niveau de l'annuaire il souhaite se connecter. Une
35 fois connecté, l'utilisateur manipulera uniquement les objets du sous-niveau de
36 l'annuaire dans lequel il se trouve. Il lui sera également possible de changer
37 de sous-niveau de connexion à travers l'interface&nbsp;: une liste déroulante est
38 disponible pour cela dans le menu.</para>
39
40 <para>
41 Il existe deux manières de déclarer des sous-niveaux de connexion à l'annuaire&nbsp;:
42 <itemizedlist>
43
44 <!-- D - Déclaration manuelle -->
45 <listitem>
46 <simpara>En déclarant manuellement un <emphasis>subDn</emphasis> de l'annuaire
47 et en lui donnant un nom.</simpara>
48 </listitem>
49 <!-- F - Déclaration manuelle -->
50
51 <!-- D - via les LSobjects -->
52 <listitem>
53 <simpara>En listant les <emphasis>LSobjets</emphasis> d'un type précis et en 
54 utilisant leurs données pour constituer le nom des sous-niveaux. Cette liste est
55 constituée en effectuant une recherche dans l'annuaire. Il est possible de définir
56 un <emphasis>basedn</emphasis> particulier pour cette recherche.</simpara>
57 </listitem>
58 <!-- F - via les LSobjets -->
59
60 </itemizedlist>
61
62 Pour chacune de ces méthodes on définira également les types 
63 d'<emphasis>LSobjets</emphasis> qui sont présents dans cette branche de
64 l'annuaire.
65 </para>
66
67 <programlisting linenumbering="unnumbered">
68   <citetitle>Structure</citetitle>...
69 <![CDATA['subDn' => array(
70   // Déclaration manuelle
71   '[Nom du sous-niveau]' => array(
72     'dn' => '[basedn du sous-niveau]',
73     'nologin' => true, // Désactive la connection dans ce subDn
74     'LSobjects' => array( // Liste des types d'LSobjets présents dans le sous-niveau
75       [LSobject1],
76       [LSobject2],
77       ...
78     )
79   ),
80   // Liste de LSobjets
81   'LSobject' => array(
82     '[type d'LSobject]' => array( // le type d'LSobjet à lister
83       'basedn' => '[basedn]', // Le basedn de la recherche
84       'displayValue' => '[format]', // Format du nom des sous-niveaux
85       'nologin' => true, // Désactive la connection dans ces subDn
86       'LSobjects' => array( // Liste des types d'LSobjets présents dans les sous-niveaux
87         [LSobject1],
88         [LSobject2],
89         ...
90       )
91     )
92   )
93 ),]]>
94 ...
95 </programlisting> 
96   
97   
98 </sect4>
99 <!-- Fin subDn -->