Создание проекта


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):

  • YYYY - указатель года;
  • MM - указатель месяца;
  • DD - указатель дня;
  • T - разделитель даты и времени;
  • hh - указатель часов;
  • mm - указатель минут;
  • ss - указатель секунд.
<?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>

Варианты комбинаций параметров и результат работы метода:

UsePlannedCostPlannedCostРезультат работы метода
trueУказанЗначение плановых трудозатрат установлено и равно значению, переданному в параметре PlannedCost
Или, если фиксированная общая продолжительность объекта равна 0, значение, переданное в параметре PlannedCost, игнорируется
false (или null)УказанЗначение плановых трудозатрат не установлено
Значение, переданное в параметре PlannedCost, игнорируется
truenullЗначение плановых трудозатрат становится расчетным
Результат данной комбинации идентичен результатам второй/четвертой комбинаций
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>