<channel-where>

Ausschnitt aus der DTD:

<!ENTITY % cm.cm-request "
  ...
  (channel-where+, channel-delete) |
  (channel-where+, channel-get) |
  (channel-where+, channel-description) |
  (channel-where+, channel-set) |
  ...
">

Definition:

<!ENTITY % cm.channel-where "
  (name |
  namePrefix)*
">
<!ELEMENT channel-where %cm.channel-where;>

Aufgabe: channel-where ermöglicht es, nach Channels zu suchen. Sämtliche Channelnamen werden zurückgegeben, wenn kein Parameterwert angegeben wird.

Spezielle Parameter dieses Funktionselements:

  • name: bewirkt, dass der Channel mit dem angegebenen Namen zurückgegeben wird.
  • namePrefix: bewirkt, dass die Channels zurückgegeben werden, deren Name mit der angegebenen Zeichenkette beginnt.

Verwendung: channel-where ist ein Funktionselement, das nicht ohne ein weiteres unmittelbar darauf folgendes Funktionselement verwendet werden kann. Mit channel-where erhält man den Channelnamen, der dem Suchkriterium entspricht oder die Liste aller Channelnamen. Erst durch das folgende Funktionselement wird jedoch bestimmt, wie diese Channelnamen zu behandeln sind. channel-get entspricht dabei einer Schablone, die nacheinander auf jeden der mit channel-where ermittelten Channelnamen angewendet wird (siehe Requests als Schablonen und die Darstellung der Ergebnis-Daten).

Erforderliche Rechte: keine Einschränkungen.