Различия

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

--- product:api:list:updateproject [30.08.2024 10:31] – [Передаваемые параметры] ekaterina.menkhuzina
+++ product:api:list:updateproject [10.06.2025 07:13] (текущий) – ekaterina.menkhuzina
@@ Строка 26: / Строка 26: @@
 |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|
 Возможные статусы проектов:
-  * "1" -- Предполагаемый
+  * "1" - Не начат
-  * "3" -- В работе
+  * "3" - В работе
-  * "4" -- Требует внимания
+  * "6" - Завершен
-  * "5" -- Наивысший приоритет
+  * "7" - Отменен
-  * "6" -- Завершен
+  * "8" - Отложен
-  * "7" -- Отменен
+  * "9" - На проверке
-  * "8" -- Отложен
+статусы с номерами 2, 4 и 5 устарели и больше не используются.
-  * "9" -- Готов к проверке
 Формат передаваемых дат должен быть типа ''YYYY-MM-DDThh:mm:ss'', например: ''2002-05-30T09:00:00''
   * YYYY указатель года
@@ Строка 85: / Строка 86: @@
 </code>
-''Начиная с версии системы 3.29'' добавлены следующие необязательные передаваемые параметры:
+Пример запроса с передачей плановых трудозатрат (доступно ''с версии 3.29'') - добавлены необязательные передаваемые параметры ''UsePlannedCost'' и ''PlannedCost'':
-^Параметр^Описание^
-|UsePlannedCost|Использовать значение плановых трудозатрат, переданное в параметре ''PlannedCost''\\ Доступные значения:\\ • true;\\ • false (или null) - значение по умолчанию|
-|PlannedCost|Значение плановых трудозатрат\\ Доступные значения:\\ • неотрицательные дробные значения (округляются до сотых);\\ • null|
 <code xml>
@@ Строка 133: / Строка 131: @@
 </code>
+Варианты комбинаций параметров и результат работы метода:
+^UsePlannedCost^PlannedCost^Результат работы метода^
+|true|Указан|Значение плановых трудозатрат установлено и равно значению, переданному в параметре ''PlannedCost'' \\ **Или**, если изменяемый объект иерархии узловой, значение текущих трудозатрат объекта не изменяется и значение, переданное в параметре ''PlannedCost'', игнорируется|
+|false (или null)|Указан|Значение плановых трудозатрат не установлено\\ Значение, переданное в параметре ''PlannedCost'', игнорируется \\ Текущее значение трудозатрат объекта и их тип (плановые трудозатраты или расчетные трудозатраты) не изменяются|
+|true|null|Значение плановых трудозатрат становится расчетным|
+|false (или null)|null|Значение плановых трудозатрат не установлено \\ Текущее значение трудозатрат объекта и их тип (плановые трудозатраты или расчетные трудозатраты) не изменяются|
 =====Возвращаемые параметры=====
 ^Параметр^Описание^
@@ Строка 147: / Строка 150: @@
 </soap:Envelope>
 </code>
+===== Пример вызова метода =====
+Вызов метода с помощью [[https://soapui.ru/|SoapUI]]:
+. В окне запроса в передаваемых параметрах указать:
+  * идентификатор сессии (можно получить с помощью метода [[:product:api:list:authenticate|Authenticate]]) и идентификатор проекта - обязательные параметры;
+  * статус проекта - параметр, который в данном случае будет редактироваться - со статуса "В работе" (3) переведем проект в статус "Отложен" (8):
+<image shape="thumbnail">{{ :product:api:list:updateproject1.png |}}</image>
+\\
+. При корректно выполненном методе появится код 200 и возвращаемый параметр - в данном случае ''UpdateProjectResult'':
+<image shape="thumbnail">{{ :product:api:list:updateproject2.png |}}</image>
+\\
+Готовый пример:
+<image shape="thumbnail">{{ :product:api:list:updateproject3.png |}}</image>