TaskTimeEntry
A stretch of work on a task by the person who logged it. Entries are never edited or deleted once finished: a correction voids the entry and logs a new one.
Fields
Unique identifier
The task the time was spent on
The person who logged the time; the entry is theirs
Display name of the person who logged the time, falling back to their email; null when the user no longer exists
How the entry was recorded
Possible values (3)
TIMERStarted and stopped as a timer; the only kind that can be running
MANUALLogged by hand with a duration
COMPLETIONLogged with a duration when the task was marked done
When the work started (ISO8601)
When the work ended (ISO8601); null while a timer runs and for a discarded timer
Seconds between start and end, computed by the server from the two instants; null while a timer runs and for a discarded timer
True while this is a running timer: no end and not voided
What the time was spent on, as the logger wrote it
True once the entry was voided or, as a running timer, discarded. A voided entry stays on record but counts toward no total.
When the entry was voided (ISO8601); null unless voided
Who voided the entry; null unless voided
Why the entry was voided; null for a discarded timer and unless voided
The recorded cost this entry booked on the task's job, when it was costed; null otherwise
The recorded cost that reversed this entry's cost when it was voided; null otherwise
When the entry was recorded (ISO8601)
The task the time was spent on, when the caller may read it; null otherwise. Meant for a single entry such as myRunningTimer, not long lists: it reads the task per entry.
Referenced by (4)
Exact type SDL
"""
A stretch of work on a task by the person who logged it. Entries are never edited or deleted once finished: a correction voids the entry and logs a new one.
"""
type TaskTimeEntry {
"""Unique identifier"""
id: TaskTimeEntryID!
"""The task the time was spent on"""
taskId: TaskID!
"""The person who logged the time; the entry is theirs"""
userId: UserID!
"""
Display name of the person who logged the time, falling back to their email; null when the user no longer exists
"""
userName: String
"""How the entry was recorded"""
source: TaskTimeEntrySource!
"""When the work started (ISO8601)"""
startedAt: ISO8601!
"""
When the work ended (ISO8601); null while a timer runs and for a discarded timer
"""
endedAt: ISO8601
"""
Seconds between start and end, computed by the server from the two instants; null while a timer runs and for a discarded timer
"""
durationSeconds: Int
"""True while this is a running timer: no end and not voided"""
running: Boolean!
"""What the time was spent on, as the logger wrote it"""
note: String
"""
True once the entry was voided or, as a running timer, discarded. A voided entry stays on record but counts toward no total.
"""
voided: Boolean!
"""When the entry was voided (ISO8601); null unless voided"""
voidedAt: ISO8601
"""Who voided the entry; null unless voided"""
voidedBy: UserID
"""Why the entry was voided; null for a discarded timer and unless voided"""
voidReason: String
"""
The recorded cost this entry booked on the task's job, when it was costed; null otherwise
"""
recordedCostId: RecordedCostID
"""
The recorded cost that reversed this entry's cost when it was voided; null otherwise
"""
reversalCostId: RecordedCostID
"""When the entry was recorded (ISO8601)"""
createdAt: ISO8601!
"""
The task the time was spent on, when the caller may read it; null otherwise. Meant for a single entry such as myRunningTimer, not long lists: it reads the task per entry.
"""
task: TaskState
}