Task new



Task_new

Create new task object

Syntax

Task_new(taskname, parentResourceId[, taskTemplateResourceId][, taskDescription])

Arguments

• taskname: is string. It is the name of new task
• parentResourceId: is number. It is parent resource id of the new task
• taskTemplateResourceId: is number. It is the template resource Id
• taskDescription: is string. It is journal's description of task

Return value

Array which is Task object:

Index	Data type	Initial Value
TASK_RESOURCE_ID	number	0
TASK_CASE_NUMBER	number	0
TASK_NAME	string	Entered value
TASK_PARENT_RESOURCE_ID	number	Entered value
TASK_TEMPLATE_RESOURCE_ID	number	Entered value (default if it is not specified)
TASK_TIME_REGISTRATION	bool	TRUE
TASK_COMPLETED	bool (read only)	FALSE
TASK_TESTCASE_RESOURCE_ID	number	0 (Always = 0 if test case is not required)
TASK_RESPONSIBLE_RESOURCE_ID	number	0
TASK_SUPERVISOR_RESOURCE_ID	number	0
TASK_OBSERVER	array	(Explanation *)
TASK_OBSERVER_INHERIT_ACCESS	bool	FALSE
TASK_STATUS	number (read only)	(Explanation **)
TASK_ACCEPTANCE_DEADLINE	array DateTime
TASK_COMPLETION_DEADLINE	array DateTime
TASK_APPROVAL_DEADLINE	array DateTime
TASK_ACTUAL_START_DATE	array DateTime (read only)
TASK_ACTUAL_END_DATE	array DateTime (read only)
TASK_APPROVED_DATE	array DateTime (read only)
TASK_MAN_HOURS	number
TASK_DESCRIPTION	string
TASK_VERSION	number (read only)
TASK_CREATED_DATE	array DateTime (read only)
TASK_MODIFIED_DATE	array DateTime (read only)
TASK_RESPONSIBLE_NAME	string (read only)
TASK_SUPERVISOR_NAME	string (read only)
TASK_CURRENT_USER_IS_RESPONSIBLE	bool (read only)
TASK_CURRENT_USER_IS_SUPERVISOR	bool (read only)

Explanation *

TASK_OBSERVER:

List of user or group which is observer of this task { {observer's resource id, control access},...}

Ex: {{1,"RESOURCE_ACCESS_OBSERVER"},{2,"RESOURCE_ACCESS_MANAGER"}}

In which, control access constants are:

• RESOURCE_ACCESS_OBSERVER
• RESOURCE_ACCESS_MANAGER
• RESOURCE_ACCESS_ADMINISTRATOR

Explanation **

TASK_STATUS:

Default value is 0

Constants:

Index	Constant name
0	TASK_STATUS_NEEDACCEPTANCE
1	TASK_STATUS_INPROGRESS
2	TASK_STATUS_APPROVED
3	TASK_STATUS_AWAITINGAPPROVAL

Availability

Version 5.8