LSsearch
Cette section décrit la manière de paramétrer les recherches dans
l'annuaire pour un type d'&LSobject; donné.
La configuration des LSsearch se situe dans la
configuration des &LSobjects;, dans la variable LSsearch
($GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSsearch']).
Structure
array(
'attr1',
'attr2',
...
'attr3' => array(
'searchLSformat' => '[LSformat]',
'approxLSformat' => '[LSformat]',
),
...
),
'params' => array(
// Paramètres de la recherche
'pattern' => '[string]',
'sizelimit' => [integer],
'recursive' => [boolean],
'approx' => [boolean],
'withoutCache' => [boolean],
// Paramètres de tri
'sortBy' => [displayName|subDn],
'sortDirection' => [ASC|DESC],
'sortlimit' => [integer],
// Paramètre d'affichage
'displayFormat' => [LSformat],
'nbObjectsByPage' => [integer],
'nbPageLinkByPage' => [integer]
),
'predefinedFilters' => array(
'filter1' => 'label filter1',
'filter2' => 'label filter2'
),
'extraDisplayedColumns' => array(
'col1' => array(
'label' => 'label column 1',
'LSformat' => '[LSformat]'
),
'col2' => array(
'label' => 'label column 2',
'LSformat' => '[LSformat]',
'alternativeLSformats' => array (
'[LSformat 1]',
'[LSformat 2]'
)
)
)
);]]>
Paramètres de configuration
attrs
Tableau listant les attributs pouvant être utilisés dans les filtres
de recherche LDAP employés par &LdapSaisie;. Lorsqu'un motif de recherche est
passé par l'utilisateur, &LdapSaisie; composera un filtre LDAP à partir de
cette liste.
Lors d'une recherche non-approximative, le filtre de recherche sera
composé (par défaut) de la manière suivante :
(|(attr1=*motif*)(attr2=*motif*)...)
Lors d'une recherche approximative, le filtre de recherche sera
composé (par défaut) de la manière suivante :
(|(attr1=~motif)(attr2~=motif)...)
Il est également possible de paramétrer la manière dont sera composé le filtre
de recherche attribut par attribut à l'aide des paramètres searchLSformat
et approxLSformat.
Ces filtres, une fois composés, sont insérés dans un autre,
filtrant en plus sur les ObjectClass du type
d'&LSobject; de la manière suivante :
Paramètres des attributs
searchLSformat
Ce paramètre est un &LSformat; permettant de définir, attribut par attribut, comment le
filtre de recherche LDAP est composé à partir d'un motif de recherche et en cas de recherche
non-approximative.
Ce &LSformat; est composé à l'aide des éléments name, le nom de
l'attribut et pattern, le motif de recherche.
Exemple
Le filtre déduit doit obligatoirement commencer par ( et
se terminer par ).
approxLSformat
Ce paramètre est un &LSformat; permettant de définir, attribut par attribut, comment le
filtre de recherche LDAP est composé à partir d'un motif de recherche et en cas de recherche
approximative.
Ce &LSformat; est composé à l'aide des éléments name, le nom de
l'attribut et pattern, le motif de recherche.
Exemple
Le filtre déduit doit obligatoirement commencer par ( et
se terminer par ).
params
Tableau des paramètres par défaut d'une recherche. Ce tableau contient
les paramètres qui seront utilisés pour initialisé une recherche. Ces paramètres
pourront être redéfini par l'utilisateur ou par l'application en fonction du
contexte dans lequel cette recherche est effectuée.
Paramètres de configuration
pattern
Mot clé de la recherche.
sizelimit
Entier determinant le nombre maximum d'objet pouvant être retournés dans
une recherche.
recursive
Booléen déterminant si la recherche récursive est activée.
approx
Booléen déterminant si la recherche approximative est activée.
withoutCache
Booléen déterminant si le cache de recherche doit être utilisé.
sortBy
Mot clé déterminant sur quel valeur/colonne le résultat de recherche
sera trié.
Valeurs possibles : displayName, subDn ou NULL.
sortDirection
Mot clé déterminant le sens du trie du résultat de la recherche.
Valeurs possibles : ASC, DESC ou NULL.
sortlimit
Entier determinant le nombre maximum d'objet pouvant être triés dans
le résultat d'une recherche.
displayFormat
&LSformat; d'affichage du nom de l'objet dans le résultat de la recherche.
nbObjectsByPage
Entier déterminant le nombre d'objet maximum affichés dans une page
de résultat de la recherche.
nbPageLinkByPage
Entier déterminant le nombre maximum de liens vers d'autres pages
affichés sous le résultat de la recherche.
Par défaut : 10
predefinedFilters
Tableau associatif contenant des filtres prédéfinis pour la recherche.
Les clés sont les filtres au format LDAP et les valeurs sont les labels associés.
extraDisplayedColumns
Tableau associatif contenant des colonnes supplémentaires à afficher dans les
résultats de recherche. Les clés sont les identifiants des colonnes supplémentaires
et les valeurs sont leur configuration définie à partir des paramètres suivant :
label
Le label de la colonne.
LSformat
Le &LSformat; d'affichage de la colonne. Ce format est composé à partir
des attributs des objets LDAP dans leur format brut.
alternativeLSformats
Tableau des &LSformats; alternatifs à utiliser si le résultat du format
principal est vide. Les formats définis dans cette liste sont essayés les uns
après les autres et le premier &LSformat; retournant une valeur non-vide est
utilisé.