<link-where>

Ausschnitt aus der DTD:

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

Definition:

<!ENTITY % cm.link-where "
  (id?)
">
<!ELEMENT link-where %cm.link-where;>

Aufgabe: link-where ermöglicht die Suche nach einem Link, bei dem der Wert des angegebenen Parameters dem spezifizierten String entspricht. Wird kein Parameterwert angegeben, so werden alle Links ermittelt.

Verwendung: link-where ist ein Funktionselement, das nicht ohne ein weiteres unmittelbar darauf folgendes Funktionselement verwendet werden kann. Mit link-where erhält man die ID des Links, der dem Suchkriterium entspricht, oder die Liste aller Link-IDs. Erst durch das folgende Funktionselement wird bestimmt, wie die Link-ID oder die Link-IDs zu behandeln sind. Jedes der Elemente, die auf link-where folgen können, entspricht dabei einer Schablone, die nacheinander auf jeden der mit link-where ermittelten Links angewendet wird (siehe Requests als Schablonen und die Darstellung der Ergebnis-Daten).

Erforderliche Rechte: keine Einschränkungen.