Objekte filtern
Die meisten praktischen Anwendungsfälle beziehen sich darauf, eine bestimmte Ergebnismenge aus dem Verzeichnisidienst zu ermitteln und in die Ergebnisse komfortabel in die existierenden Statistiken einzuarbeiten.
Die verschiedenen Filteroptionen bieten in diesem Zusammenhang eine große Unterstützung. Die Filterregeln werden wie folgt definiert.
Tabelle 13.
| Syntax | Beschreibung |
|---|---|
| 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 |
Beispiel:
(|(!(obj=XX))(&(user=YY)(obj=ZZ)))
(&(&(a=b)(b=c))(c=d))
Die häufigsten FIlter werden in dem Dialog in entsprechenden Kategorien zusammengefasst. Zusätzlich besteht die Möglichkeit selbstdefinierte Filter in der Konfigurationsdatei ub.xml zu hinterlegen.
Neben diesen vordefinierten Filterdefinitionen, besteht die Möglichkeit, Filter dynamisch aus einer Datei zu bestimmen. Der eigentliche Filter wird über so genannte Platzhalter definiert und ermöglicht die Zusammenstellung einer beliebigen Ergebnismenge, welche bereits auf einer existierenden Auswahl in einer Datei basiert.
Der eigentliche Filter in dieser Konfiguration wird aus dem Eintrag unter Pattern und dem Inhalt der Datei 'filter_sample.csv' zusammengesetzt.
Inhalt der Datei filter_sample.csv:
cn=Max Ehlert
givenName=Stefan
displayName=*
Das bedeutet in dieser Konstellation werden drei Abfragen mit folgenden Filterdefinitionen produziert:
(&(objectClass=user)(CN=Max Ehlert))
(&(objectClass=user)(givenName=Stefan))
(&(objectClass=user)(displayName=*))
Die Ergebnismenge enthält alle Objekte der Klasse user mit dem Attribut givenname=Stefan, dem Attribut cn=Max Ehlert und alle Objekte die das Attribut displaName besitzen.