Process task object

Change the task due date.

Here is how to set a different due date for a task:

try {
   //  Get the comment from the process context 
  const comment = Context.data. comment; 
  // Get the task ID from the process context 
  const taskUUID =  Context.data.taskid; 
  let task = await System.processes._searchTasks(). where(x => x.__id.eq(taskUUID)).first(); 
  // If the task does not exist,  an error is displayed 
  if (!task) { 
    throw new Error('Задача не  найдена'); 
  } 
  // Get the current date 
  let newDueDate = new  Datetime(); 
  // Add one day 
  newDueDate = newDueDate.addDate(0, 0, 1);  
  await task.changeDueDate(newDueDate, comment); 
} catch (error) { 
  //  If the process has already finished, the exception can be processed 
} 

Create a reminder.

Example of searching for a task and creating a reminder for it:

// Get the tast object 
let task = await System.processes. _searchTasks().where(x => x.__id.eq(taskUUID)).first(); 
// If the task  object is not found, stop the script execution 
if (!task) { 
 return; 
} 
//  Get the current user 
const user = await System.users.getCurrentUser(); 
//  Get the current date and add one day 
// The time zone is taken from the  field `System.timezones.current` 
let dateReminder = new Datetime();  
dateReminder = dateReminder.add(new Duration(1, 'days')) 
// Create a  reminder for the task on the next day 
await task.createReminder( dateReminder, user); 

Get possible task transitions.

Here is how to search for a task and finish it:

try {
  //  Get the task object 
  let task = await System.processes._searchTasks(). where(x => x.__id.eq(taskUUID)).first(); 
  // If the task object is not  found, the execution of the script finishes 
  if (!task) { 
  return; 
  }  
  // Get task transitions 
  const exits = await task.getExits(); 
  //  Finish the task 
  // Pass the transition’s ID and the form’s data 
  await  task.submitTask(exits[0].id, {comment: 'Task completed'}); 
} catch (e) { 
   // If the process is already finished, the exception is processed 
} 

The method returns the list of task executors.

const instance = await task.getPerformers();

The method returns a process object.

const instance = await task.getProcessInstance();

Reassign a task to one or more new executors.

The reason for reassigning the task is written to the task’s activity stream. Review and approval tasks as well as system tasks are assigned to the first user in the list of new executors. If the corresponding process instance or the task is already finished, the method throws an exception.
In the example, we reassign a task using its ID from the context to one new executor.

async function reassign(): Promise<void> {
    //  Getting the task ID for reassigning from the process context 
    const  taskID = Context.data.TaskForReassignUUID; 
    // Searching for the task  
    const task = await Application.processes._searchTasks().where(x => x. __id.eq(taskID)).first(); 
    // Getting the user from the context 
     const user = Context.data.NewPerformer; 
    const comment = 'Replacing the  executor'; 
    await task.reassign(user, comment); 
} 

In the second example, we reassign a task using its ID from the context to users from a group.

async function reassignMany(): Promise<void> {
    //  Getting the task ID for reassigning from the process context 
    const  taskID = Context.data.TaskForReassignUUID; 
    // Searching for the task  
    const task = await Application.processes._searchTasks().where(x => x. __id.eq(taskID)).first(); 
    // Getting the user group ID from the context  
    const userGroupID = Context.data.groupUUID; 
    // Searching for the  user group 
    const userGroup = await System.userGroups.search().where(x  => x.__id.eq(userGroupID)).first(); 
    const newPerformers = <UserItemRef[] >await userGroup.users(); 
    const comment = 'Reassigning to several  executors'; 
    await task.reassign(newPerformers, comment); 
} 

The method finishes a task.

Here is how to search for a task and finish it:

try {
  //  Get the task object 
  let task = await System.processes._searchTasks(). where(x => x.__id.eq(taskUUID)).first(); 
  // Get task transitions 
  const  exits = await task.getExits(); 
  // Pass the transition’s ID and the form’s  data 
  await task.submitTask(exits[0].id, {comment: 'Task completed'}); 
}  catch (e) { 
  // If the process is already finished, the exception is  processed 
}