<task-where>

Ausschnitt aus der DTD:

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

Definition:

<!ENTITY % cm.task-where "
  (id |
  (objectId,
  userLogin?,
  groupNames?,
  taskType?) |
  taskText)?
">
<!ELEMENT task-where %cm.task-where;>

Aufgabe: task-where ermöglicht die Suche nach Tasks, bei denen der Wert der angegebenen Parameter den jeweils spezifizierten String enthält. Eine Liste der IDs aller Tasks wird zurückgegeben, wenn keine Parameterwerte angegeben werden.

Spezielle Parameter dieses Funktionselements:

  • id: die ID des gesuchten Tasks.
  • groupNames: Es werden nur die Tasks zurückgegeben, die den unter groupNames angegebenen Gruppen zugeordnet sind.
  • taskText: Text, der im Kommentar (comment) oder Titel (title) eines Tasks vorkommen muss.

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

Rückgabewert bei Erfolg: die Liste der IDs der Tasks.

Erforderliche Rechte: keine Einschränkungen.