Различия

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

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

Предыдущая версия справа и слева Предыдущая версия
Следующая версия		 Предыдущая версия
product:api:list:getproject [19.08.2021 07:40] – [Возвращаемые параметры] holkinaproduct:api:list:getproject [05.12.2024 08:59] (текущий) – Белугин Александр
Строка 40: Строка 40:
 |PersonId|Идентификатор ресурса| |PersonId|Идентификатор ресурса|
 |Value|Значение ресурса| |Value|Значение ресурса|
 +|PlannedCost|''(с версии 3.29)'' Значение плановых трудозатрат \\ Если объект не имеет плановых трудозатрат, то в параметре ''PlannedCost'' возвращается значение null|
 +|CalculatedCost|''(с версии 3.29)'' Значение расчетных трудозатрат \\ Если объект не имеет расчетных трудозатрат, то в параметре ''CalculatedCost'' возвращается значение null|
  
-Возможные статусы проектов: +Возможные статусы объектов (значения параметра "Status"): 
-  * "1" -- Предполагаемый+  * "1" -- Не начат
   * "3" -- В работе   * "3" -- В работе
-  * "4" -- Требует внимания 
-  * "5" -- Наивысший приоритет 
   * "6" -- Завершен   * "6" -- Завершен
   * "7" -- Отменен   * "7" -- Отменен
   * "8" -- Отложен   * "8" -- Отложен
-  * "9" -- Готов к проверке+  * "9" -- На проверке 
 +статусы с номерами 2, 4 и 5 устарели и больше не используются. 
 Формат дат вида: ''YYYY-MM-DD'' Формат дат вида: ''YYYY-MM-DD''
   * YYYY -- указатель года   * YYYY -- указатель года
Строка 88: Строка 90:
 </soap:Envelope> </soap:Envelope>
 </code> </code>
 +
 +Пример запроса с передачей плановых трудозатрат (''доступно с версии 3.29'') - добавлены необязательные передаваемые параметры ''PlannedCost'' и ''CalculatedCost'':
 +
 +<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>
 +    <GetProjectResponse xmlns="http://streamline/">
 +      <GetProjectResult>
 +        <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>
 +            <PersonId>guid</PersonId>
 +            <Value>double</Value>
 +          </ResourceAssignmentWrapper>
 +          <ResourceAssignmentWrapper>
 +            <PersonId>guid</PersonId>
 +            <Value>double</Value>
 +          </ResourceAssignmentWrapper>
 +        </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>
 +      </GetProjectResult>
 +    </GetProjectResponse>
 +  </soap:Body>
 +</soap:Envelope>
 +</code>
 +
 +===== Пример вызова метода =====
 +Вызов метода с помощью [[https://soapui.ru/|SoapUI]]:
 +
 +1. В окне запроса в передаваемых параметрах указать идентификатор сессии (можно получить с помощью метода [[:product:api:list:authenticate|Authenticate]]) и идентификатор проекта:
 +
 +<image shape="thumbnail">{{ :product:api:list:getproject1.png |}}</image>
 +\\
 +2. При корректно выполненном методе появится код 200 и возвращаемые параметры - в данном случае:
 +  * ''UID'';
 +  * ''ParentProjectId'';
 +  * ''Name'';
 +  * ''Status'';
 +  * ''PercentComplete'';
 +  * ''SystemStartDate'' и ''SystemEndDate'';
 +  * ''PlannedStartDate'' и ''PlannedEndDate'';
 +  * ''ActualStartDate'' и ''ActualEndDate'';
 +  * ''OwnerId'';
 +  * ''ResponsibleId'';
 +  * ''ResourceAssignments''.
 +
 +<image shape="thumbnail">{{ :product:api:list:getproject2.png |}}</image>
 +\\
 +Готовый пример:
 +<image shape="thumbnail">{{ :product:api:list:getproject3.png |}}</image>