ПланФикс API project.update — различия между версиями

Материал из ПланФикс
Перейти к: навигация, поиск
(Перейти)
Строка 75: Строка 75:
 
</response>
 
</response>
 
</source>
 
</source>
{| class="wikitable" style="margin-top: 1em; width:100% "
+
 
!width="50"|Значение ''code'' !! Расшифровка
 
|-
 
|align="center"| 0000|| неизвестная ошибка
 
|-
 
|align="center"| 0009 || Отсутствует один из обязательных параметров функции
 
|-
 
|align="center"| 0015 || недопустимое значение параметра
 
|-
 
|align="center"| 2001 || запрошенный проект не существует
 
|-
 
|align="center"| 2002 || на выполнение данного запроса отсутствуют права (привилегии)
 
|-
 
|}
 
  
 
== Перейти ==
 
== Перейти ==
 
*[[ПланФикс API:Проекты]]
 
*[[ПланФикс API:Проекты]]
 
*[[Список функций]]
 
*[[Список функций]]

Версия 12:18, 27 октября 2010

Функция обновления данных о проекте. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="project.update">
  <account></account>
  <sid></sid>
  <project>
    <id></id>
    <title></title>
    <description></description>
    <owner>
      <id></id>
    </owner>
    <client>
      <id></id>
    </client>
    <status></status>
    <hidden></hidden>
    <hasEndDate></hasEndDate>
    <endDate></endDate>
  </project>
  <signature></signature>
</request>
Название Тип Значение Примечание
sid string(32) ключ сесии выдается в результате прохождения аутентификации
id int Идентификатор проекта который редактируется можно получить из функций получения списка или в результате выполнения функции добавления
title string Название проекта не обязательный параметр
description string Описание проекта которое задает пользователь не обязательный параметр
owner не обязательный параметр
owner.id int идентификатор пользователя, который будет считаться создателем проекта. допускается значение 0 (ноль). не обязательный параметр
client необязательное параметр
client.id int идентификатор контрагента допускается значение 0 (ноль).
status enum новый статус проекта перечень допустимых значений для данного поля смотри в разделе константы статусы проектов. не обязательный параметр
hidden bool скрытый не обязательный параметр
hasEndDate bool имеет ли дату окончания не обязательный параметр
endDate DateTime учитывается только в том случае, если параметр hasEndDate установлен в true. не обязательный параметр

Необязательные параметры можно не передавать в запросе. В этом случае сохраняется старое значение.

Результатом удачного выполнения запроса является следующий ответ:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <project>
    <id></id>
  </project>
</response>
Название Тип Значение Примечание
id int идентификатор равен идентификатору переданному в запросе

В противном случае будет возвращен ответ с ошибкой:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Перейти