Item Class

class item.Item(itemJson, api)

This is the Item class.

allDay

Boolean to determine is the item is active all day.

Type:boolean
api = None
boxFolderID

The BoxFolderID value (read only).

Type:int
childID

The childID value. (read only).

Type:int
completed_by

The name of the user who has completed the item. (read only)

Type:string

Note

The variable will be modified when an user set an item as completed

Note

None in case the item is not completed

completionDate

The date when the item was completed (read only).

Type:datetime

Note

None in case the item is not completed

completionPercentage

The completion percentage value.

Type:int

Warning

completionPercentage param must be greater than or equal to 0 and less than or equal to 100.

Note

If the completionPercentage is 100, the item will be set as completed.

creationDate

The date when the item was created (read only).

Type:datetime
delegate(username)

Delegate the item to the user with the specified username.

Parameters:owner_username (string) – The new name of the item’s owner
delegated_by

The user name who delegated the item (read only).

Type:string
descriptionText

The item description text.

Type:string
dueDate

The due date in case it exists.

Type:datetime
effort

The effort value of the item.

Type:int

Warning

effort param must be greater than or equal to 0 and less than or equal to 10.

frequency

The item’s frequency.

Type:string.

Warning

frequency value must be one the next list: “Never”, “Daily”, “Weekly”, “Biweekly”, “4-weekly”, “Monthly”, “Quaterly”, “Semesterly”, “Yearly” or “None”

getCreator

The user name of the item creator.

Type:string
getEdited_by_username

The last user’s name who edited the item (read only).

Type:string
getParentID

The Parent ID of the item (read only).

Type:int
id

The ID of the item (read only).

Type:int
idd

The idd of the item. (read only)

Type:int
index

The index of the item.

Return type:int
isCompleted()

Returns if the item is completed or not.

Returns:True if the item is completed
Returns:False if the item is not completed
Return type:boolean
isDeleted()

Returns if the item is deleted or not.

Returns:True if the item has been deleted
Returns:False if the item has not been deleted
Return type:boolean
isDue()

Returns if the item is due or not.

Returns:True if the due date has passed
Returns:False if the due date has not passed
Return type:boolean
name

The name of the item.

Type:string
ownerUsername

The owner username of the item.

Type:string
projectID

The Project ID where the item is, in case it isn’t in the item box

Type:int

Note

None in case the item is in item box

Note

The ID must belong to a created project

quadrant

The Quadrant where the item is.

Type:int

Note

None in case the item doesn’t belong to a project yet

save()

Update the item with the changes made.

Note

If we have changed some value of the item, until we dont call to this function, it will not be saved on the API.

setAllDay

Boolean to determine is the item is active all day.

Type:boolean
setDescriptionText

The item description text.

Type:string
setEffort

The effort value of the item.

Type:int

Warning

effort param must be greater than or equal to 0 and less than or equal to 10.

toJson()

Returns all the json code of the item

Returns:The item json code
Return type:string
toString()

Returns a string with relevant information about the item.