<user-where>

Ausschnitt aus der DTD:

<!ENTITY % cm.cm-request "
  ...
  (user-where+, user-addToGroups) |
  (user-where+, user-delete) | 
  (user-where+, user-description) | 
  (user-where+, user-get) | 
  (user-where+, user-grantGlobalPermissions) |
  (user-where+, user-removeFromGroups) |
  (user-where+, user-revokeGlobalPermissions) |
  (user-where+, user-set) | 
  ...
">

Definition:

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

Aufgabe: user-where ermöglicht die Suche nach Benutzern, bei denen der Wert der angegebenen Parameter den jeweils spezifizierten String enthält. Werden keine 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 des Benutzers enthalten ist.

Verwendung: user-where ist ein Funktionselement, das nicht ohne ein weiteres unmittelbar darauf folgendes Funktionselement verwendet werden kann. Mit user-where erhält man die Liste der Logins der Benutzer, die dem Suchkriterium entsprechen. Erst durch das folgende Funktionselement wird jedoch bestimmt, wie diese Benutzer zu behandeln sind. Jedes der Elemente, die auf user-where folgen können, entspricht dabei einer Schablone, die nacheinander auf jeden der mit user-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.

Erforderliche Rechte: keine Einschränkungen.