Метод: UpdateProject
| Параметр | Описание | Комментарии |
|---|---|---|
| ASPNETSessionId | Идентификатор сессии | Обязательно для заполнения |
| Project | Массив значений проекта | |
| UID | Идентификатор проекта | Обязательно для заполнения |
| ParentProjectId | Идентификатор родительского проекта | |
| Name | Название проекта | |
| Status | Статус проекта | |
| PercentComplete | Процент выполнения | |
| PlannedStartDate | Планируемая дата начала проекта | Плановая дата начала игнорируется, если в параметре StartDateConstraint передано одно из значений: AS_SOON_AS_POSSIBLE, AS_LATE_AS_POSSIBLE, NOT_SET |
| PlannedEndDate | Планируемая дата окончания проекта | Плановая дата окончания игнорируется, если в параметре EndDateConstraint передано значение NOT_SET |
| ActualStartDate | Фактическая дата начала проекта | |
| ActualEndDate | Фактическая дата завершения проекта | |
| OwnerId | Идентификатор руководителя проекта | Изменять ответственных в существующем объекте возможно только методом delegate project |
| ResponsibleId | Идентификатор исполнителя проекта | Изменять ответственных в существующем объекте возможно только методом delegate project |
| ResourceAssignments | Массив назначенных ресурсов | |
| ResourceAssignmentWrapper | Массив параметров ресурса | |
| PersonId | Идентификатор ресурса | |
| Value | Значение ресурса | |
| 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 (ограничение не установлено) | Если в параметре StartDateConstraint передано одно из значений: AS_SOON_AS_POSSIBLE, AS_LATE_AS_POSSIBLE, NOT_SET, то ограничение в плановой дате начала объекта будет удалено |
| EndDateConstraint | Тип ограничения даты окончания проекта. Передаваемые значения: MUST_FINISH_ON, FINISH_NO_EARLIER_THAN, FINISH_NO_LATER_THAN, NOT_SET (ограничение не установлено) | Если в параметре EndDateConstraint передано значение NOT_SET, то ограничение в плановой дате окончания объекта будет удалено |
| CalendarId | Идентификатор производственного календаря проекта | |
| UsePlannedCost | (с версии 3.29) Использовать значение плановых трудозатрат, переданное в параметре PlannedCostДоступные значения: • true; • false (или null) - значение по умолчанию | |
| PlannedCost | (с версии 3.29) Значение плановых трудозатратДоступные значения: • неотрицательные дробные значения (округляются до сотых); • null | |
Возможные статусы проектов:
статусы с номерами 2, 4 и 5 устарели и больше не используются.
Формат передаваемых дат должен быть типа YYYY-MM-DDThh:mm:ss, например: 2002-05-30T09:00:00
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <UpdateProject xmlns="http://streamline/"> <contract> <ASPNETSessionId>string</ASPNETSessionId> <Project> <UID>string</UID> <ParentProjectId>string</ParentProjectId> <Name>string</Name> <ProjectTypeId>string</ProjectTypeId> <ProjectType>string</ProjectType> <Status>int</Status> <PercentComplete>int</PercentComplete> <SystemStartDate>dateTime</SystemStartDate> <SystemEndDate>dateTime</SystemEndDate> <PlannedStartDate>dateTime</PlannedStartDate> <PlannedEndDate>dateTime</PlannedEndDate> <ActualStartDate>dateTime</ActualStartDate> <ActualEndDate>dateTime</ActualEndDate> <Order>int</Order> <OwnerId>string</OwnerId> <ResponsibleId>string</ResponsibleId> <ResourceAssignments> <ResourceAssignmentWrapper xsi:nil="true" /> <ResourceAssignmentWrapper xsi:nil="true" /> </ResourceAssignments> <PlannedDuration>double</PlannedDuration> <DurationUnit>string</DurationUnit> <StartDateConstraint>string</StartDateConstraint> <EndDateConstraint>string</EndDateConstraint> <CalendarId>guid</CalendarId> </Project> </contract> </UpdateProject> </soap:Body> </soap:Envelope>
Пример запроса с передачей плановых трудозатрат (доступно с версии 3.29) - добавлены необязательные передаваемые параметры UsePlannedCost и PlannedCost:
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <UpdateProject xmlns="http://streamline/"> <contract> <ASPNETSessionId>string</ASPNETSessionId> <Project> <UID>string</UID> <ParentProjectId>string</ParentProjectId> <Name>string</Name> <ProjectTypeId>string</ProjectTypeId> <ProjectType>string</ProjectType> <Status>int</Status> <PercentComplete>int</PercentComplete> <SystemStartDate>dateTime</SystemStartDate> <SystemEndDate>dateTime</SystemEndDate> <PlannedStartDate>dateTime</PlannedStartDate> <PlannedEndDate>dateTime</PlannedEndDate> <ActualStartDate>dateTime</ActualStartDate> <ActualEndDate>dateTime</ActualEndDate> <Order>int</Order> <OwnerId>string</OwnerId> <ResponsibleId>string</ResponsibleId> <ResourceAssignments> <ResourceAssignmentWrapper xsi:nil="true" /> <ResourceAssignmentWrapper xsi:nil="true" /> </ResourceAssignments> <UsePlannedCost>boolean</UsePlannedCost> <PlannedCost>double</PlannedCost> <CalculatedCost>double</CalculatedCost> <PlannedDuration>double</PlannedDuration> <DurationUnit>string</DurationUnit> <StartDateConstraint>string</StartDateConstraint> <EndDateConstraint>string</EndDateConstraint> <CalendarId>guid</CalendarId> </Project> </contract> </UpdateProject> </soap:Body> </soap:Envelope>
Варианты комбинаций параметров и результат работы метода:
| UsePlannedCost | PlannedCost | Результат работы метода |
|---|---|---|
| true | Указан | Значение плановых трудозатрат установлено и равно значению, переданному в параметре PlannedCost Или, если изменяемый объект иерархии узловой, значение текущих трудозатрат объекта не изменяется и значение, переданное в параметре PlannedCost, игнорируется |
| false (или null) | Указан | Значение плановых трудозатрат не установлено Значение, переданное в параметре PlannedCost, игнорируется Текущее значение трудозатрат объекта и их тип (плановые трудозатраты или расчетные трудозатраты) не изменяются |
| true | null | Значение плановых трудозатрат становится расчетным |
| false (или null) | null | Значение плановых трудозатрат не установлено Текущее значение трудозатрат объекта и их тип (плановые трудозатраты или расчетные трудозатраты) не изменяются |
| Параметр | Описание |
|---|---|
| UpdateProjectResult | Результат выполнения запроса |
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <UpdateProjectResponse xmlns="http://streamline/"> <UpdateProjectResult>string</UpdateProjectResult> </UpdateProjectResponse> </soap:Body> </soap:Envelope>
Вызов метода с помощью SoapUI:
1. В окне запроса в передаваемых параметрах указать:
2. При корректно выполненном методе появится код 200 и возвращаемый параметр - в данном случае UpdateProjectResult:
Готовый пример: