ПланФикс API task.add
Материал из ПланФикс
Версия от 12:37, 20 августа 2010; Seva (обсуждение | вклад) (Новая страница: «== task.add Добавление задачи== Добавление: <source lang="xml"> <?xml version="1.0" encoding="UTF-8"?> <request method="task.add"> <accou...»)
task.add Добавление задачи
Добавление:
<?xml version="1.0" encoding="UTF-8"?>
<request method="task.add">
<account><!-- имя аккаунта --></account>
<sid><!-- ключ сессии, полученный после аутентификации --></sid>
<task>
<title><!-- Название задачи --></title>
<description><!-- О чем эта задача --></description>
<importance><!-- Срочность --></importance>
<status><!-- Статус --></status>
<checkResult>{true|false}</checkResult><!-- Является ли задача задачей с обязательной проверкой результата -->
<!-- Создатель задачи -->
<owner>
<id></id>
</owner>
<!-- Над задача -->
<parent>
<id></id>
</parent>
<!-- В рамках какого проекта поставлена задача -->
<project>
<id></id>
</project>
<!-- Контрагент -->
<client>
<id></id>
</client>
<startTime><!-- Время начала (приступить к работе) --></startTime>
<endTime><!-- Время окончания (закончить работу До) --></endTime>
<!-- список исполнителей -->
<Workers>
<!-- список пользователей -->
<Users>
<id><!-- идентификатор логина --></id>
<id></id>
<!-- ... -->
</Users>
<Groups>
<id></id>
<id></id>
<!-- ... -->
</Groups>
</Workers>
<!-- периодичность задачи, необязательный параметр -->
<periodicity>
<!-- ежедневно -->
<daily>
<type>{EVERY|EVERY_WORKING|AFTER_COMPLETE}</type>
<shift></shift>
</daily>
<!-- еженедельно -->
<weekly>
<type>{EVERY|AFTER_COMPLETE}</type>
<shift></shift>
<days><!-- список дней через запятую --></days>
</weekly>
<!-- ежемесячно -->
<monthly>
<type>{AFTER_COMPLETE|DAY_OF_MONTH|BY_CONDITION}</type>
<month></month>
<day></day>
<dayType></dayType>
</monthly>
</periodicity>
</task>
</request>
Добавляемые даты могут задаваться в двух форматах. Первый формат короткий, указывается только число, год и месяц. Второй формат - полный, дополнительно указывается время начала/завершения, если того требует задача. Периодичность - не обязательный параметр. Внутри тега periodicity может быть только один из перечисленных элементов: daily, weekly, monthly.
Ответ при удачном выполнении операции:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<task>
<id></id>
</task>
</response>