====== Получение информации о проектах ======
Метод **GetProjects**
Возвращает все проекты, согласно переданному фильтру проектов и заданной сортировке. В фильтр можно задавать любое поле проекта.
Также назначать несколько фильтров, соединяя их по "И" или по "ИЛИ". Получение информации о ресурсах проекта вынесено в отдельный метод: [GetProjectResourceAssignments|Получение ресурсов по проекту]
=====Передаваемые параметры=====
^Параметр^Описание^
|ASPNETSessionId|Идентификатор сессии|
|filterWrappers*|Массив фильтра возвращаемых проектов|
|FilterWrapper*|Элемент фильтра|
|Field|Элемент фильтра. Возможные значения:
UID
ParentProjectId
ProjectTypeId
Name
Status
PercentComplete
PlannedStartDate
PlannedEndDate
ActualStartDate
ActualEndDate
OwnerId
ResponsiblePersonId
|
|Value|значение передаваемого параметра в FieldId|
|Operation|Возможные значения: ''='', ''>'', ''>='', ''<'', ''<='', ''LIKE'', ''!=''. \\ По умолчанию значение ''=''|
|GroupOr|Признак добавления фильтра. \\ По умолчанию False - добавление по "И"|
|sortWrappers|Массив с параметрами сортировки проектов|
|SortWrapper|Элемент сортировки|
|Field|Элемент сортировки. Возможные значения:
UID
ParentProjectId
Name
Status
PercentComplete
PlannedStartDate
PlannedEndDate
ActualStartDate
ActualEndDate
OwnerId
ResponsiblePersonId
WBS
|
|Descending|Порядок сортировки. \\ По умолчанию false -- сортировка по возрастанию|
|Hierarchical|Флаг для получения информации обо всех подчиненных объектах (всей иерархии подчиненных объектов). \\ True - вернется информация обо всех объектах, попавших в фильтр и их дочерних на всю глубину вложенности. \\ False - вернется информация только об объектах, попавших в фильтр.|
* -- параметры, обязательные для заполнения.
Возможные статусы проектов:
* "1" -- Предполагаемый
* "3" -- В работе
* "4" -- Требует внимания
* "5" -- Наивысший приоритет
* "6" -- Завершен
* "7" -- Отменен
* "8" -- Отложен
* "9" -- Готов к проверке
string
string
string
string
boolean
string
string
string
boolean
string
boolean
string
boolean
boolean
=====Возвращаемые параметры=====
^Параметр^Описание^
|GetProjectsResult|Массив с проектами|
|ProjectWrapper|Параметры проекта|
|UID|Идентификатор проекта|
|ParentProjectId|Идентификатор родительского проекта|
|Name|Наименование проекта|
|ProjectTypeId|Идентификатор типа объекта (Директория/Проект/Задача)|
|ProjectType|Тип объекта (Директория/Проект/Задача)|
|Status|Статус проекта|
|PercentComplete|Процент выполнения проекта|
|SystemStartDate|Расчетная дата начала проекта|
|SystemEndDate|Расчетная дата окончания проекта|
|PlannedStartDate|Планируемая дата начала проекта|
|PlannedEndDate|Планируемая дата окончания проекта|
|ActualStartDate|Фактическая дата начала проекта|
|ActualEndDate|Фактическая дата окончания проекта|
|OwnerId|Идентификатор руководителя проекта|
|ResponsiblePersonId|Идентификатор исполнителя проекта|
|PlannedDuration|Плановая длительность проекта|
|DurationUnit|Единица измерения плановой длительности проекта. Возвращаемые значения: HOURS, DAYS, WEEKS, MONTHS, YEARS|
|StartDateConstraint|Тип ограничения даты начала проекта. Возвращаемые значения: MUST_START_ON, START_NO_EARLIER_THAN, AS_SOON_AS_POSSIBLE, AS_LATE_AS_POSSIBLE, NOT_SET (ограничение не установлено)|
|EndDateConstraint|Тип ограничения даты окончания проекта. Возвращаемые значения: MUST_FINISH_ON, FINISH_NO_EARLIER_THAN, FINISH_NO_LATER_THAN, NOT_SET (ограничение не установлено)|
|CalendarId|Идентификатор производственного календаря проекта|
|WBS|Порядок записей, в соответствии с иерархической структурой работ|
|PlannedCost|''(с версии 3.29)'' Значение плановых трудозатрат \\ Если объект не имеет плановых трудозатрат, то в параметре ''PlannedCost'' возвращается значение null|
|CalculatedCost|''(с версии 3.29)'' Значение расчетных трудозатрат \\ Если объект не имеет расчетных трудозатрат, то в параметре ''CalculatedCost'' возвращается значение null|
Сортировка по WBS позволяет выводить записи в соответствии с иерархической структурой работ (порядок, в котором они расположены в диаграмме Ганте), но в виде плоского списка.
**Иерархическая структура:**
* Проект 1
* Задача 1
* Подзадача 1
* Подзадача 2
* Задача 2
Сортировка задач по WBS в результате выполнения метода:
Проект 1 \\
Задача 1 \\
Подзадача 1 \\
Подзадача 2 \\
Задача 2 \\
string
string
string
string
string
int
int
dateTime
dateTime
dateTime
dateTime
dateTime
dateTime
int
string
string
double
string
string
string
guid
string
string
string
string
string
int
int
dateTime
dateTime
dateTime
dateTime
dateTime
dateTime
int
string
string
double
string
string
string
guid
Пример запроса с передачей плановых трудозатрат (доступно ''с версии 3.29'') - добавлены необязательные передаваемые параметры ''PlannedCost'' и ''CalculatedCost'':
string
string
string
string
string
int
int
dateTime
dateTime
dateTime
dateTime
dateTime
dateTime
int
string
string
boolean
double
double
double
string
string
string
guid
string
string
string
string
string
int
int
dateTime
dateTime
dateTime
dateTime
dateTime
dateTime
int
string
string
boolean
double
double
double
string
string
string
guid