Различия

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

--- product:api:list:updateproject [14.12.2021 13:09] – anna.makhneva
+++ 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 указатель года
@@ Строка 84: / Строка 85: @@
 </soap:Envelope>
 </code>
+Пример запроса с передачей плановых трудозатрат (доступно ''с версии 3.29'') - добавлены необязательные передаваемые параметры ''UsePlannedCost'' и ''PlannedCost'':
+<code xml>
+<?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>
+</code>
+Варианты комбинаций параметров и результат работы метода:
+^UsePlannedCost^PlannedCost^Результат работы метода^
+|true|Указан|Значение плановых трудозатрат установлено и равно значению, переданному в параметре ''PlannedCost'' \\ **Или**, если изменяемый объект иерархии узловой, значение текущих трудозатрат объекта не изменяется и значение, переданное в параметре ''PlannedCost'', игнорируется|
+|false (или null)|Указан|Значение плановых трудозатрат не установлено\\ Значение, переданное в параметре ''PlannedCost'', игнорируется \\ Текущее значение трудозатрат объекта и их тип (плановые трудозатраты или расчетные трудозатраты) не изменяются|
+|true|null|Значение плановых трудозатрат становится расчетным|
+|false (или null)|null|Значение плановых трудозатрат не установлено \\ Текущее значение трудозатрат объекта и их тип (плановые трудозатраты или расчетные трудозатраты) не изменяются|
 =====Возвращаемые параметры=====
 ^Параметр^Описание^
@@ Строка 97: / Строка 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>