Filtering objects
Most practical application cases refer to determining a certain results quantity from the directory service, and conveniently integrating the results into the existing statistics.
The different filter options provide great support in this connection. The filter rules are defined as follows.
Table 15.
| Syntax | Description |
|---|---|
| filter | "("filtercomp")" |
| filtercomp | and / or / not / item |
| and | "&" filter list |
| or | "|" filter list |
| not | "!" filter |
| item | simple / present / substring / extensible |
| simple | attr filter type value |
| filtertype | equal / approx / greater / less |
| equal | "=" |
| approx | "~=" |
| greater | ">=" |
| less | "<=" |
| extensible | attr [":dn"] [":" matching rule] ":=" value / [":dn"] ":" matching rule ":=" value |
| present | attr "=*" |
| substring | attr "=" [initial] any [final] |
| initial | value |
| any | "*" *(value "*") |
| final | value |
| attr | Attribute description from Section 4.1.5 of RFC-2251 |
| matchingrule | Matching rule ID from Section 4.1.9 of RFC-2251 |
| value | Attribute value from Section 4.1.6 of RFC-2251 |
Example:
(|(!(obj=XX))(&(user=YY)(obj=ZZ)))
(&(&(a=b)(b=c))(c=d))
The most common filters are summarised in the dialogue into corresponding categories. Self-defined filters can also be saved in the configuration file ub.xml.
In addition to these pre-defined filter definitions, filters can also be determined dynamically from a file. The actual filter is defined by so-called variables, and enables the compilation of any required results quantity, which is based on an already existing selection in a file.
The actual filter in this configuration is made up of the entry under Pattern and the content of the file ‘filter_sample.csv’.
Content of the file filter_sample.csv:
cn=Max Ehlert
givenName=Stefan
displayName=*
This means in this set-up that three enquiries will be produced with the following filter definitions:
(&(objectClass=user)(CN=Max Ehlert))
(&(objectClass=user)(givenName=Stefan))
(&(objectClass=user)(displayName=*))
The results quantity contains all objects of the class User with the attribute givenname=Stefan, the attribute cn=Max Ehlert and all objects with the attribute displayName.