Projects
Create, Update and Query the Projects in TSheets.
Table Specific Information
Select
Query the Projects table. The add-in will use the QuickBooks Time API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client side within the add-in.
- Id supports the '=,IN'
- JobCodeId supports the '=,IN'
- ParentJobCodeId supports the '='
- Name supports the '='
- Active supports the '='
- ByJobCodeAssignment supports the '='
For example, the following queries are processed server side:
SELECT * FROM Projects SELECT * FROM Projects WHERE Id = 2056676
Insert
Insert can be executed by specifying Name column. The columns that are not required can be inserted optionally. Following is an example of how to insert into this table
INSERT INTO Projects (Name, Description) VALUES ('ProjectTest', 'This is a test project')
Update
Update can be executed by specifying the Id in the WHERE Clause. The columns that are not read-only can be Updated.
For example:
UPDATE Projects SET Status = 'complete' WHERE Id = '2062894'
Columns
Name | Type | ReadOnly | Description |
Id [KEY] | Integer | True |
ID of this project. |
JobCodeId | Integer | False |
The jobcode that represents the project for time tracking. |
ParentJobCodeId | Integer | False |
Id of the project jobcode's parent. 0 if it's top-level. |
Name | String | False |
Name of project. Limited to 64 characters. |
Description | String | False |
Description text associated with project. Limited to 300 characters. |
Status | String | False |
Status of project. The allowed values are not_started, in_progress, complete. |
StartDate | Datetime | False |
YYYY-MM-DD formatted date string. Must be before due date if one is defined. |
DueDate | Datetime | False |
YYYY-MM-DD formatted date string. Must be after the start date if one is defined. |
CompletedDate | Datetime | False |
YYYY-MM-DD formatted date string. Must be after the start date if one is defined. |
Active | Boolean | True |
True or false. If false, the project is considered deleted. |
LastModified | Datetime | True |
Date/time when this project was last modified, in ISO 8601 format. |
Created | Datetime | True |
Date/time when this project was created, in ISO 8601 format. |
LinkedObjects | String | True |
A key/value map of all the objects linked to this project and the corresponding object ids. |
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 |
ByJobCodeAssignment | Boolean |
If specified, only projects with a jobcode_id the user is assigned to will be returned. |