Allocations

To Create, Update, Delete and Query the Allocations table.

Table Specific Information

Select

The add-in uses the Asana 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 '=' comparison.
Assignee supports the '=' comparison. Note : Always include WorkspaceId when specifying Assignee, either in the query or the connection string.
Parent supports the '=' comparison.

For example, the following queries are processed server-side:

SELECT * FROM Allocations WHERE Id = '1127092449876457'

SELECT * FROM Allocations WHERE Assignee = '1126938691750986' AND WorkspaceId = '1126938837961830'

SELECT * FROM Allocations WHERE Parent = '1208149945266501'

Insert

StartDate, EndDate, Assignee and Parent are mandatory columns for inserting into the Allocations table. For example:

INSERT INTO Allocations (StartDate, EndDate, AssigneeId, ParentId, EffortType, EffortValue) VALUES ('2024-01-11', '2024-02-11', '1208125247305564', '1207717475644852', 'hours', 20)

Update

The following is an example of how to update the Allocations table:

UPDATE Allocations SET StartDate = '2024-01-11', EndDate = '2024-02-11', Assignee = '1208125247305564', Parent = '1207717475644852', EffortType = 'hours', EffortValue = 20 WHERE Id = '12345'

Delete

The following is an example of how to delete from the Allocations table:

DELETE FROM Allocations WHERE Id = '1234'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	True		Globally unique ID of the user.
ResourceType	String	True		The base type of this resource.
StartDate	Date	False		The localized day on which the allocation starts.
EndDate	Date	False		The localized day on which the allocation ends.
EffortType	String	False		The units used for tracking effort on an allocation, either The allowed values are hours, percent.
EffortValue	Integer	False		The numeric effort value on the allocation.
Assignee	String	False	Users.Id	Globally unique identifier of the resource, as a string.
AssigneeName	String	True		The name of allocation resource.
CreatedById	String	True		Globally unique identifier of the resource, as a string.
CreatedByName	String	True		Read-only except when same user as requester. The user's name.
Parent	String	False	Projects.Id	Globally unique identifier of the resource, as a string.
ParentName	String	True		Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
ResourceSubType	String	True		The subtype of the allocation.
WorkspaceId	String	True	Workspaces.Id	Globally unique ID of the workspace.