<groupProxy-where>

Ausschnitt aus der DTD:

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

Definition:

<!ENTITY % cm.group-where "
  (name |
  groupText)
">
<!ELEMENT groupProxy-where %cm.group-where;>

Aufgabe: groupProxy-where ermöglicht die Suche nach Benutzergruppennamen über den Benutzermanager-Proxy. Wird kein Parameterwert angegeben, so werden die Namen aller Benutzergruppen zurückgegeben.

Spezielle Parameter dieses Funktionselements:

• groupText: bewirkt, dass die Namen der Benutzergruppen zurückgegeben werden, bei denen die angegebene Zeichenkette in name oder realName enthalten ist.

Verwendung: groupProxy-where ist ein Funktionselement, das nicht ohne ein weiteres unmittelbar darauf folgendes Funktionselement verwendet werden kann. Mit groupProxy-where erhält man abhängig vom Suchkriterium einen oder mehrere Gruppennamen oder die Liste aller Gruppennamen. Erst durch das folgende Funktionselement groupProxy-get wird jedoch bestimmt, wie die ermittelten Benutzergruppen zu behandeln sind. groupProxy-get entspricht dabei einer Schablone, die nacheinander auf jede der mit groupProxy-where ermittelten Gruppen angewendet wird (siehe Requests als Schablonen und die Darstellung der Ergebnis-Daten).

Erforderliche Rechte: keine Einschränkungen.