<userProxy-where>

Ausschnitt aus der DTD:

<!ENTITY % cm.cm-request "
  ...
  (userProxy-where+, userProxy-get) | 
  ...
">

Definition:

<!ENTITY % cm.user-where "
  (login |
  userText)
">
<!ELEMENT userProxy-where %cm.user-where;>

Aufgabe: userProxy-where ermöglicht die Suche nach Benutzern über den Benutzermanager-Proxy. Wird kein Parameter angegeben, so werden die Logins aller Benutzer zurückgegeben.

Spezielle Parameter dieses Funktionselements:

• userText: bewirkt, dass die Logins der Benutzer zurückgegeben werden, bei denen die angegebene Zeichenkette im Login oder im vollständigen Namen der Benutzer enthalten ist.

Verwendung: userProxy-where ist ein Funktionselement, das nicht ohne ein weiteres unmittelbar darauf folgendes Funktionselement verwendet werden kann. Mit userProxy-where erhält man entsprechend dem Suchkriterium das Login eines Benutzers, die Liste der Logins der Benutzer, deren Login oder voller Name die angegebene Zeichenkette enthält, oder die Liste der Logins aller Benutzer. Erst durch das folgende Funktionselement userProxy-get wird jedoch bestimmt, wie der oder die Benutzer zu behandeln sind. userProxy-get entspricht dabei einer Schablone, die nacheinander auf jeden mit userProxy-where ermittelten Benutzer angewendet wird (siehe Requests als Schablonen und die Darstellung der Ergebnis-Daten).

Rückgabewert bei Erfolg: die Liste der Logins der Benutzer oder die Liste aller Anmeldenamen.

Erforderliche Rechte: keine Einschränkungen.