<group-where>

Ausschnitt aus der DTD:

<!ENTITY % cm.cm-request "
  ...
  (group-where+, group-addUsers) |
  (group-where+, group-delete) | 
  (group-where+, group-description) |
  (group-where+, group-get) | 
  (group-where+, group-grantGlobalPermissions) |
  (group-where+, group-removeUsers) |
  (group-where+, group-revokeGlobalPermissions) |
  (group-where+, group-set) |
  ...
">

Definition:

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

Aufgabe: group-where ermöglicht die Suche nach den Namen der Benutzergruppen, bei denen der Wert der angegebenen Parameter den jeweils spezifizierten String enthält. Werden keine Parameterwerte angegeben, so werden die Namen aller vorhandenen 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: group-where ist ein Funktionselement, das nicht ohne ein weiteres unmittelbar darauf folgendes Funktionselement verwendet werden kann. Mit group-where erhält man die Liste der Gruppennamen, die dem Suchkriterium entsprechen. Erst durch das folgende Funktionselement wird jedoch bestimmt, wie die ermittelten Benutzergruppen zu behandeln sind. Jedes der Elemente, die auf group-where folgen können, entspricht dabei einer Schablone, die nacheinander auf jede der mit group-where ermittelten Gruppen angewendet wird (siehe Requests als Schablonen und die Darstellung der Ergebnis-Daten).

Erforderliche Rechte: keine Einschränkungen.