Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия		 Предыдущая версия
product:api:list:createproject [30.08.2024 09:50] – [Передаваемые параметры] ekaterina.menkhuzinaproduct:api:list:createproject [28.10.2024 08:24] (текущий) – [Пример вызова метода] ekaterina.menkhuzina
Строка 1: Строка 1:
 ====== Создание проекта ====== ====== Создание проекта ======
- +Метод: **CreateProject** \\
-Метод: **CreateProject**+
 Возвращает идентификатор созданного проекта. Возвращает идентификатор созданного проекта.
 +
 =====Передаваемые параметры===== =====Передаваемые параметры=====
 ^Параметр^Описание^ ^Параметр^Описание^
Строка 8: Строка 8:
 |ParentProjectId*|Идентификатор родительского проекта| |ParentProjectId*|Идентификатор родительского проекта|
 |ProjectTypeId*|Идентификатор типа создаваемого проекта| |ProjectTypeId*|Идентификатор типа создаваемого проекта|
-|TemplateID((доступно с [[releases/3_20|версии 3.20]]))|Шаблон проекта|+|TemplateID|Шаблон проекта ''(доступно с [[releases/3_20|версии 3.20]])''|
 |ProjectName*|Название проекта| |ProjectName*|Название проекта|
 |Order|Порядковый номер| |Order|Порядковый номер|
Строка 34: Строка 34:
 |DocumentBody|Документ в формате Base64| |DocumentBody|Документ в формате Base64|
 |DocumentContentType|[[https://ru.wikipedia.org/wiki/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA_MIME-%D1%82%D0%B8%D0%BF%D0%BE%D0%B2|Тип загружаемого документа]]| |DocumentContentType|[[https://ru.wikipedia.org/wiki/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA_MIME-%D1%82%D0%B8%D0%BF%D0%BE%D0%B2|Тип загружаемого документа]]|
 +|UsePlannedCost|''(с версии 3.29)'' Использовать значение плановых трудозатрат, переданное в параметре ''PlannedCost''\\ Доступные значения:\\ • true;\\ • false (или null) - значение по умолчанию|
 +|PlannedCost|''(с версии 3.29)'' Значение плановых трудозатрат\\ Доступные значения:\\ • неотрицательные дробные значения (округляются до сотых);\\ • null|
 |PlannedDuration|Плановая длительность проекта| |PlannedDuration|Плановая длительность проекта|
-|DurationUnit|Единица измерения плановой длительности проекта. Возвращаемые значения: HOURS, DAYS, WEEKS, MONTHS, YEARS|+|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|Тип ограничения даты начала проекта. Передаваемые значения: 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 (ограничение не установлено)| |EndDateConstraint|Тип ограничения даты окончания проекта. Передаваемые значения: MUST_FINISH_ON, FINISH_NO_EARLIER_THAN, FINISH_NO_LATER_THAN, NOT_SET (ограничение не установлено)|
 |CalendarId|Идентификатор производственного календаря проекта| |CalendarId|Идентификатор производственного календаря проекта|
 +
 +
 * -- параметры, обязательные для заполнения. \\  * -- параметры, обязательные для заполнения. \\ 
 %%**%% -- при изменении реквизита-классификатора, [[product/requisites/requisite-class#основанные_на_базовых_объектах|основанного на объекте]], можно использовать как идентификатор записи классификатора, так и идентификатор объекта (проект, пользователь, документ, дискуссия). //Например, в случае, если названия объектов дублируются, а нужно выбрать конкретный объект.// \\  %%**%% -- при изменении реквизита-классификатора, [[product/requisites/requisite-class#основанные_на_базовых_объектах|основанного на объекте]], можно использовать как идентификатор записи классификатора, так и идентификатор объекта (проект, пользователь, документ, дискуссия). //Например, в случае, если названия объектов дублируются, а нужно выбрать конкретный объект.// \\ 
Строка 54: Строка 58:
   * **ss** -- указатель секунд.   * **ss** -- указатель секунд.
  
 +
 +Пример запроса:
 <code xml> <code xml>
 <?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
Строка 113: Строка 119:
 </code> </code>
  
-''Начиная с версии системы 3.29'' следующие необязательные передаваемые параметры: +Пример запроса с передачей плановых трудозатрат (доступно ''с версии 3.29'') - добавлены необязательные передаваемые параметры ''UsePlannedCost'' и ''PlannedCost'': 
-^Параметр^Описание^ +
-|UsePlannedCost|Использовать значение плановых трудозатрат, переданное в параметре PlannedCost\\ Доступные значения:\\ • true;\\ • false (или null) - значение по умолчанию| +
-|PlannedCost|Значение плановых трудозатрат\\ Доступные значения:\\ • неотрицательные дробные значения;\\ • null|+
  
 <code xml> <code xml>
Строка 198: Строка 202:
 </soap:Envelope> </soap:Envelope>
 </code> </code>
 +
 +===== Пример вызова метода =====
 +Вызов метода с помощью [[https://soapui.ru/|SoapUI]]:
 +
 +1. В окне запроса в передаваемых параметрах указать:
 +  * идентификатор сессии (можно получить с помощью метода [[:product:api:list:authenticate|Authenticate]]);
 +  * идентификатор родительского проекта;
 +  * идентификатор типа создаваемого проекта;
 +  * название проекта;
 +  * идентификатор руководителя проекта.
 +
 +<image shape="thumbnail">{{ :product:api:list:createproject1.png |}}</image>
 +\\
 +2. При корректно выполненном методе появится код 200 и возвращаемый параметр - в данном случае ''CreateProjectResult'':
 +
 +<image shape="thumbnail">{{ :product:api:list:createproject2.png |}}</image>
 +\\
 +Готовый пример:
 +<image shape="thumbnail">{{ :product:api:list:createproject3.png |}}</image>