getTaskBy

sucht eine Aufgabe basierend auf den angegebenen Kriterien

Array <Task> getTaskBy(string | function propertyName, [string | number | boolean | array propertyValue,object types] );
propertyNamestring | functiondie Eigenschaft, nach der gesucht wird, oder eine Filterfunktion
propertyValuestring | number | boolean | arrayder Wert, der für die Eigenschaft übereinstimmen soll
typesobjectein Objekt, das angibt, welche Arten von Aufgaben in den Ergebnissen enthalten sein sollen
Array <Task>ein Array von Task-Objekten, die den Kriterien entsprechen

Example

// einfache Suche
const userTasks = gantt.getTaskBy("user_id", [5]);
 
// mit einer Filterfunktion
let userTasks = gantt.getTaskBy(function(task){
   return task.user_id == 5 || !task.user_id;
});
 
userTasks = gantt.getTaskBy(task => task.user_id == 5);

Related samples

Details
  • Diese Methode ermöglicht es, Aufgaben basierend auf einem Eigenschaftswert auszuwählen, z.B. um Aufgaben zu finden, die einem bestimmten Benutzer zugewiesen sind oder Aufgaben, die abgeschlossen sind.
  • Beim Aufruf von gantt.getTaskBy(propertyName, propertyValue) wird ein lockerer Gleichheitsvergleich ("double equals", ==) verwendet.
  • Die Ergebnisse von gantt.getTaskBy(propertyName, propertyValue) können vom gantt gecached werden, wodurch diese Form potenziell schneller ist als die Verwendung der Filterfunktion gantt.getTaskBy((task: object) => boolean).

Standardmäßig gibt gantt.getTaskBy() nur Aufgaben und Meilensteine zurück, die den Kriterien entsprechen, und schließt Projekt-Items aus.

Um alle Arten von Einträgen einzuschließen, verwenden Sie diesen dritten Parameter:

gantt.getTaskBy("progress", 1, { task: true, project: true, milestone: true });

Um nur einen bestimmten Typ von Eintrag zu erhalten, geben Sie ihn im dritten Parameter an:

gantt.getTaskBy("progress", 1, { project: true})
See also
Change log

der types Parameter wurde in Version 8.0 eingeführt

Zurück nach oben