Метод NewTask
Метод NewTask создает задачу в указанной категории в "Первой Форме". В зависимости от категории, задача может являться, например, записью справочника или инициированным бизнес-процессом.
Параметры функции:
•Идентификатор пользователя (ID), от имени которого ставится задача.
•Текст задачи.
•Срок исполнения задачи, необязательный параметр.
•Идентификатор категории задачи (можно узнать в интерфейсе администрирования "Первой Формы", в разделе "Категории".).
•Комментарий к задаче, необязательный параметр.
•Идентификатор пользователя (ID), назначенного ответственным исполнителем задачи, необязательный параметр.
•Приоритет задачи (высокий/низкий/обычный).
•Дополнительные параметры.
После выполнения функция NewTask возвращает номер задачи. Номер является уникальным идентификатором задачи и используется для осуществления дальнейших действий с данной задачей. Обычно, во внешних системах реализуется функция "словаря", с помощью которого внутренние идентификаторы объектов системы соотносятся с соответствующими номерами задач из "Первой Формы".
Функция GetFullTaskInfo
Функция GetFullTaskInfo позволяет получить все данные о задаче, включая текущее состояние и реквизиты. При вызове функция возвращает основные параметры задачи, значения заполненных ДП, и текущий статус задачи (положение на маршруте).
Параметры функции:
•Номер задачи, о которой требуется получить информацию.
•Идентификатор пользователя с требуемым уровнем доступа, от имени которого осуществляется сбор данных.
Метод PostTask
Метод PostTask аналогичен NewTask, однако имеет более удобную сигнатуру — в частности, намного удобнее заполнять дополнительные параметры в задаче.
Параметры функции:
•Идентификатор пользователя (ID), от имени которого надо производить действия.
•Текст задачи.
•Идентификатор категории, куда надо поставить задачу.
•Опциональные параметры задачи.
Параметр "Опциональные параметры задачи" содержит следующие дочерние элементы:
•Срок задачи.
•Дата начала работы с задачей.
•Проставление автоматического комментария в задачу.
•Идентификатор исполнителя задачи.
•Приоритет. Может иметь значения 3 — высокий, 1 — обычный, 0 – низкий.
•Массив значений дополнительных параметров задачи, каждый из которых содержит следующие свойства:
oидентификатор доп. параметра.
oзначение доп. параметра.
•Напоминание о сроке задачи.
•Настройка постановки подзадачи, если задача создается как подзадача, со следующими свойствами:
oидентификатор родительской задачи.
oтребуется ли копировать подписчиков из родительской задачи.
oтребуется ли копировать вложения из родительской задачи.
Метод возвращает идентификатор созданной задачи (аналогично методу NewTask).