Task new



Task_new

Create new task object

Syntax

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

Arguments

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

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	{1,1,1,1,0,0,0,1,40}
TASK_COMPLETION_DEADLINE	array DateTime	{9999,12,31,23,59,59,999,52,40}
TASK_APPROVAL_DEADLINE	array DateTime	{1,1,1,1,0,0,0,1,40}
TASK_ACTUAL_START_DATE	array DateTime (read only)	{1,1,1,1,0,0,0,1,40}
TASK_ACTUAL_END_DATE	array DateTime (read only)	{9999,12,31,23,59,59,999,52,40}
TASK_APPROVED_DATE	array DateTime (read only)	{1,1,1,1,0,0,0,1,40}
TASK_MAN_HOURS	number	0
TASK_DESCRIPTION	string	Entered value (Task name is default if not specified)
TASK_VERSION	number (read only)	0
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, observer's name},...}

Ex: {{123,RESOURCE_ACCESS_OBSERVER, John Smith (JohnSmith)},{246,RESOURCE_ACCESS_MANAGER, Alice Sophia Eve (AliceAve)}}

Or:{{123,2, John Smith (JohnSmith)},{246,4, Alice Sophia Eve (AliceAve)}}

In which, control access constants are:

Index	Constant name
2	RESOURCE_ACCESS_OBSERVER
4	RESOURCE_ACCESS_MANAGER
6	RESOURCE_ACCESS_ADMINISTRATOR

Observer's name can be set by function User_formatName

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

Example

string taskname = "Test Task";
number responsibleRId = 14042920;
number supervisorRId = 12344998;
number observerRId = 10768810;
number parentResourceId = 11088827;
number taskTemplateResourceId = 2072;
array task = Task_new(taskname, parentResourceId, taskTemplateResourceId);
task[TASK_RESPONSIBLE_RESOURCE_ID] = responsibleRId;
task[TASK_SUPERVISOR_RESOURCE_ID ] = supervisorRId;
task[TASK_OBSERVER]={{observerRId, 2, User_formatName(User_getUserByResourceId(observerRId))}};
task[TASK_ACCEPTANCE_DEADLINE]=DateTime_getByYMD(2017,10,18);
task[TASK_COMPLETION_DEADLINE]=DateTime_getByYMD(2017,10,21);
task[TASK_APPROVAL_DEADLINE]=DateTime_getByYMD(2017,10,30);
task[TASK_DESCRIPTION]="This task with high priority";
Task_save(task);

Availability

Version 5.8