Tasks
Gets all the tasks in the given project. It fetches only the main tasks and not the subtasks.
Select
Columns that support the = operator:- Id
- CreatedBy
- MilestoneId
- Priority
- TasklistId
- Owner
- Status
- Time
- LastModifiedTime
- ViewId
- CreatedDate and LastModifiedTime support: ORDER
SELECT * FROM Tasks WHERE MilestoneId = '12345600000123' AND Priority = 'High' ORDER BY CreatedDate
Insert
To create a new Task you can specify the following fields:
- Name
- Description
- Owners
- Duration
- DurationType
- EndDate
- Priority
- StartDate
- TasklistId
- Work
- GroupNameAssociatedTeamsAnyTeam
- RatePerHour
- ReminderString
- Recurrence
- BudgetValue
- BudgetThreshold
INSERT INTO Tasks (Name, Description, Duration, DurationType, Priority, BudgetValue)
VALUES ('New Task #2', 'This is a test description', '5', 'hrs', 'High', '1000')
Update
To update a Task specify the Id field.
UPDATE Tasks SET Priority = 'Low' WHERE Id = '123456000000034003'
Delete
Tasks can be deleted by providing the Id and issuing a DELETE statement.
DELETE FROM Tasks WHERE Id = '123456000000034003'
Columns
| Name | Type | ReadOnly | Description |
| Id [KEY] | String | False |
Task Id. |
| Name | String | False |
Task Name. |
| Key | String | False |
Task Key. |
| BillingType | String | False |
Task Billing Type. |
| Completed | Boolean | False |
Task Completed. |
| CreatedBy | String | False |
Task Created By. |
| CreatedByEmail | String | False |
Task Created By Email. |
| CreatedByZpuid | String | False |
Task Created By Zpuid. |
| CreatedPerson | String | False |
Task Created Person. |
| CreatedDate | Date | False |
Task Created Date. |
| CreatedDateTime | Datetime | False |
Task Created Date Time. |
| Description | String | False |
Task Description. |
| Owners | String | False |
Task Owners. |
| Duration | String | False |
Task Duration. |
| DurationType | String | False |
Task Duration Type. The allowed values are days, hrs. |
| EndDate | Date | False |
Task End Date. |
| EndDateTime | Datetime | False |
Task End Date Time. |
| CommentAdded | Boolean | False |
Task Comment Added. |
| DocsAssociated | Boolean | False |
Task Docs Associated. |
| ForumAssociated | Boolean | False |
Task Forum Associated. |
| RecurrenceSet | Boolean | False |
Task Recurrence Set. |
| ReminderSet | Boolean | False |
Task Reminder Set. |
| Parent | Boolean | False |
Task Parent. |
| LastUpdatedDate | Date | False |
Task Last Updated Date. |
| LastUpdatedDateTime | Datetime | False |
Task Last Updated Date Time. |
| LinkSelfUrl | String | False |
Task Link Self Url. |
| LinkTimesheetUrl | String | False |
Task Link Timesheet Url. |
| LinkWebUrl | String | False |
Task Link Web Url. |
| LogHoursBillableHours | String | False |
Task Log Hours Billable Hours. |
| LogHoursNonBillableHours | String | False |
Task Log Hours Non Billable Hours. |
| MilestoneId | String | False |
Task Milestone Id. |
| OrderSequence | Integer | False |
Task Order Sequence. |
| PercentComplete | String | False |
Task Percent Complete. |
| Priority | String | False |
Task Priority. The allowed values are none, low, medium, high. |
| StartDate | Date | False |
Task Start Date. |
| StartDateTime | Datetime | False |
Task Start Date Time. |
| StatusColorCode | String | False |
Task Status Color Code. |
| StatusName | String | False |
Task Status Name. |
| StatusId | String | False |
Task Status Id. |
| StatusType | String | False |
Task Status Type. |
| Subtasks | Boolean | False |
Task Subtasks. |
| TaskFollowers | String | False |
Task Task Followers. |
| TaskFollowerSize | Integer | False |
Task Task Follower Size. |
| TasklistId | String | False |
Tasklist Id. |
| TasklistName | String | False |
Tasklist Name. |
| Work | String | False |
Task Work. |
| WorkForm | String | False |
Task Work Form. |
| WorkType | String | False |
Task Work Type. The allowed values are work_hrs_per_day. |
| GroupNameAssociatedTeamsAnyTeam | String | False |
Task Group Name Associated Teams Any Team. |
| GroupNameAssociatedTeamsCount | Integer | False |
Task Group Name Associated Teams Count. |
| GroupNameIsTeamUnassigned | Boolean | False |
Task Group Name Is Team Unassigned. |
| RatePerHour | String | False |
Task Rate Per Hour. |
| ReminderString | String | False |
Task Reminder String. |
| Recurrence | String | False |
Task Recurrence. |
| BudgetValue | String | False |
Task Budget Value. |
| BudgetThreshold | String | False |
Task Budget Threshold. |
Pseudo-Columns
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
| Name | Type | Description |
| Owner | String |
Task Owner. |
| Status | String |
Task Status. The allowed values are completed, notcompleted. |
| Time | String |
Task Time. The allowed values are overdue, today, tomorrow. |
| LastModifiedTime | Datetime |
Task Last Modified Time. |
| ViewId | String |
Task View Id. |