URL: components/services/APIProjects.asmx
Метод: CreateProject
Возвращает идентификатор созданного проекта.
| Параметр | Описание |
|---|---|
ASPNETSessionId | Идентификатор сессии |
ParentProjectId* | Идентификатор родительского проекта |
ProjectTypeId* | Идентификатор типа создаваемого проекта |
TemplateID | Шаблон проекта (доступно с версии 3.20) |
ProjectName* | Название проекта |
Order | Порядковый номер |
ProjectOwnerId | Идентификатор руководителя проекта |
ProjectResponsibleId | Идентификатор исполнителя проекта |
Status | Статус проекта |
PercentComplete | Процент выполнения |
PlannedStartDate*** | Плановая дата начала |
PlannedEndDate**** | Плановая дата окончания |
ActualStartDate | Фактическая дата начала проекта |
ActualEndDate | Фактическая дата завершения проекта |
ResourceAssignments | Массив назначенных ресурсов |
ResourceAssignmentWrapper | Массив параметров ресурса |
PersonId | Идентификатор ресурса |
Value | Значение ресурса |
Order | Порядковый номер проекта в родительском объекте |
Fields | Массив всех реквизитов проекта |
FieldWrapper | Массив значений реквизитов |
FieldName | Название реквизита |
FieldId | Идентификатор реквизита |
FieldVal** | Значение реквизита |
DocumentFieldWrapper | Массив значений реквизитов с типом «документ» |
FieldId | Идентификатор реквизита |
DocumentName | Название документа |
DocumentBody | Документ в формате Base64 |
DocumentContentType | Тип загружаемого документа |
UsePlannedCost | (с версии 3.29) Использовать значение плановых трудозатрат, переданное в параметре PlannedCost Доступные значения: • true; • false (или null) - значение по умолчанию |
PlannedCost | (с версии 3.29) Значение плановых трудозатрат Доступные значения: • неотрицательные дробные значения (округляются до сотых); • null |
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 | Идентификатор производственного календаря проекта |
WaitForClassifierValues | (с версии 3.30.5922.15220-9595b9f0c1a) указывает надо ли ожидать синхронизацию классификаторов, если создаваемый объект должен войти в какой то объектный классификатор.Доступные значения: • true; • false (или null) - значение по умолчанию |
* - параметры, обязательные для заполнения.
** - при изменении реквизита-классификатора, основанного на объекте, можно использовать как идентификатор записи классификатора, так и идентификатор объекта (проект, пользователь, документ, дискуссия). Например, в случае, если названия объектов дублируются, а нужно выбрать конкретный объект.
*** - плановая дата начала игнорируется, если в параметре StartDateConstraint передано одно из значений: AS_SOON_AS_POSSIBLE, AS_LATE_AS_POSSIBLE, NOT_SET.
**** - плановая дата окончания игнорируется, если в параметре EndDateConstraint передано значение NOT_SET.
Формат передаваемых дат для все типов стандартных объектных дат (план, факт): YYYY-MM-ddTHH:mm:ss (например: 2019-02-27T13:36:00).
Формат передаваемых дат для реквизита-даты должен быть типа YYYY-MM-DD hh:mm:ssZ (например: 2011-06-06 01:00:00Z):
<?xml version="1.0" encoding="utf-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:str="http://streamline/"> <soapenv:Header/> <soapenv:Body> <str:CreateProject> <str:newProject> <str:UsePlannedCost>boolean</str:UsePlannedCost> <str:PlannedCost>double</str:PlannedCost> <str:ASPNETSessionId>string</str:ASPNETSessionId> <str:ParentProjectId>string</str:ParentProjectId> <str:ProjectTypeId>string</str:ProjectTypeId> <str:TemplateId>string</str:TemplateId> <str:ProjectName>string</str:ProjectName> <str:Order>int</str:Order> <str:ProjectOwnerId>string</str:ProjectOwnerId> <str:ProjectResponsibleId>string</str:ProjectResponsibleId> <str:PlannedStartDateSerialized>string</str:PlannedStartDateSerialized> <str:PlannedStartDate>dateTime</str:PlannedStartDate> <str:PlannedEndDateSerialized>string</str:PlannedEndDateSerialized> <str:PlannedEndDate>dateTime</str:PlannedEndDate> <str:Fields> <str:FieldWrapper> <str:FieldName>?</str:FieldName> <str:FieldId>?</str:FieldId> <str:FieldVal>string</str:FieldVal> <str:FieldType>string</str:FieldType> </str:FieldWrapper> </str:Fields> <str:PlannedDuration>double</str:PlannedDuration> <str:DurationUnit>string</str:DurationUnit> <str:StartDateConstraint>string</str:StartDateConstraint> <str:EndDateConstraint>string</str:EndDateConstraint> <str:CalendarId>guid</str:CalendarId> <str:Status>int</str:Status> <str:PercentComplete>int</str:PercentComplete> <str:ActualStartDateSerialized>string</str:ActualStartDateSerialized> <str:ActualStartDate>dateTime</str:ActualStartDate> <str:ActualEndDateSerialized>string</str:ActualEndDateSerialized> <str:ActualEndDate>dateTime</str:ActualEndDate> <str:ResourceAssignments> <str:ResourceAssignmentWrapper> <str:PersonId>guid</str:PersonId> <str:Value>double</str:Value> </str:ResourceAssignmentWrapper> </str:ResourceAssignments> </str:newProject> </str:CreateProject> </soapenv:Body> </soapenv:Envelope>
Варианты комбинаций параметров и результат работы метода:
| UsePlannedCost | PlannedCost | Результат работы метода |
|---|---|---|
| true | Указан | Значение плановых трудозатрат установлено и равно значению, переданному в параметре PlannedCost Или, если фиксированная общая продолжительность объекта равна 0, значение, переданное в параметре PlannedCost, игнорируется |
| false (или null) | Указан | Значение плановых трудозатрат не установлено Значение, переданное в параметре PlannedCost, игнорируется |
| true | null | Значение плановых трудозатрат становится расчетным Результат данной комбинации идентичен результатам второй/четвертой комбинаций |
| false (или null) | null | Значение плановых трудозатрат не установлено |
| Параметр | Описание |
|---|---|
CreateProjectResult | Результат выполнения запроса |
<?xml version="1.0" encoding="utf-8"?> <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <CreateProjectResponse xmlns="http://streamline/"> <CreateProjectResult>string</CreateProjectResult> </CreateProjectResponse> </soap:Body> </soap:Envelope>