ITaskListService.CreateTask — метод (TaskList, Task, Boolean, StaffEmployee)

Добавляет существующее задание в предоставленный список заданий, без внесения изменений в историю карточки.

Синтаксис

TaskListTask CreateTask(TaskList taskList, Task task, bool onControl, StaffEmployee controller)
Параметры
taskList

Тип: TaskList

Список заданий, в который осуществляется добавление задания

task

Тип: Task

Добавляемое задание

onControl

Тип: System.Boolean

Признак постановки задания на контроль. Если true — контроль установлен, иначе — false

controller

Тип: StaffEmployee

Контролёр задания, если onControl = true

Возвращаемое значение

Тип: TaskListTask

Добавленное задание

Исключения

Исключение Условие

System.ArgumentNullException

Ошибка возвращается в случае, если не задан параметр taskList или task.

Заметки

В отличие от метода AddTask, метод CreateTask не осуществляет записи события в историю карточки. Кроме этого, данный метод позволяет указать признак наличия контроля для задания дополнительно к тому, что указано в самом задании.

Примеры

Далее приведён пример использования метода CreateTask при добавлении нового задания с признаком "На контроле" в существующий документ

(1)

IStaffService staffService = objectContext.GetService<IStaffService>();
ITaskService taskService = objectContext.GetService<ITaskService>();
ITaskListService taskListService = objectContext.GetService<ITaskListService>(); (2)

Document document = objectContext.GetObject<Document>(new Guid("00000000-0000-0000-0000-000000000000")); (3)

TaskList taskList = document.MainInfo.Tasks; (4)

KindsCardKind kind = objectContext.GetObject<KindsCardKind>(new Guid("AB801854-70AF-4B6C-AB48-1B59B5D11AA9")); (5)

Task task = taskService.CreateTask(kind);
task.MainInfo.Name = "Задание документа";
task.MainInfo.Author = staffService.GetCurrentEmployee();
task.MainInfo.OnControl = true;
task.MainInfo.Controller = task.MainInfo.Author;

taskListService.CreateTask(taskList, task,task.MainInfo.OnControl, task.MainInfo.Controller); (6)
1 Инициализация контекста объектов.
2 Получение сервисов.
3 Получение документа.
4 Получение существующего списка заданий из документа.
5 Получение вида задания.
6 Добавление задания в список заданий.