====== Получение информации о проектах ====== Метод **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