Метод: 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 |
Возможные статусы проектов:
Формат передаваемых дат должен быть типа 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
:
Готовый пример: