Получение информации о проекте

Метод: GetProject

ПараметрОписание
ASPNETSessionIdИдентификатор сессии
projectIdИдентификатор проекта
<?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>
    <GetProject xmlns="http://streamline/">
      <contract>
        <ASPNETSessionId>string</ASPNETSessionId>
        <ProjectId>string</ProjectId>
      </contract>
    </GetProject>
  </soap:Body>
</soap:Envelope>
ПараметрОписание
UIDИдентификатор проекта
ParentProjectIdИдентификатор родительского проекта
NameНазвание проекта
StatusСтатус проекта
PercentCompleteПроцент выполнения
SystemStartDateРасчетная дата начала проекта
SystemEndDateРасчетная дата окончания проекта
PlannedStartDateПланируемая дата начала проекта
PlannedEndDateПланируемая дата окончания проекта
ActualStartDateДата начала проекта
ActualEndDateДата окончания проекта
OwnerIdИдентификатор руководителя проекта
ResponsibleIdИдентификатор исполнителя проекта
ResourceAssignmentsМассив назначенных ресурсов
ResourceAssignmentWrapperМассив параметров ресурса
PersonIdИдентификатор ресурса
ValueЗначение ресурса
PlannedCost(с версии 3.29) Значение плановых трудозатрат
Если объект не имеет плановых трудозатрат, то в параметре PlannedCost возвращается значение null
CalculatedCost(с версии 3.29) Значение расчетных трудозатрат
Если объект не имеет расчетных трудозатрат, то в параметре CalculatedCost возвращается значение null

Возможные статусы объектов (значения параметра «Status»):

  • «1» – Не начат
  • «3» – В работе
  • «6» – Завершен
  • «7» – Отменен
  • «8» – Отложен
  • «9» – На проверке

статусы с номерами 2, 4 и 5 устарели и больше не используются.

Формат дат вида: YYYY-MM-DD

  • YYYY – указатель года
  • MM – указатель месяца
  • DD – указатель дня
<?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>
        <Status>int</Status>
        <PercentComplete>int</PercentComplete>
        <SystemStartDate>dateTime</SystemStartDate>
        <SystemEndDate>dateTime</SystemEndDate>
        <PlannedStartDate>dateTime</PlannedStartDate>
        <PlannedEndDate>dateTime</PlannedEndDate>
        <ActualStartDate>dateTime</ActualStartDate>
        <ActualEndDate>dateTime</ActualEndDate>
        <OwnerId>string</OwnerId>
        <ResponsibleId>string</ResponsibleId>
        <ResourceAssignments>
          <ResourceAssignmentWrapper>
            <PersonId>string</PersonId>
            <Value>double</Value>
          </ResourceAssignmentWrapper>
          <ResourceAssignmentWrapper>
            <PersonId>string</PersonId>
            <Value>double</Value>
          </ResourceAssignmentWrapper>
        </ResourceAssignments>
      </GetProjectResult>
    </GetProjectResponse>
  </soap:Body>
</soap:Envelope>

Пример запроса с передачей плановых трудозатрат (доступно с версии 3.29) - добавлены необязательные передаваемые параметры PlannedCost и CalculatedCost:

<?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>

Вызов метода с помощью SoapUI:

1. В окне запроса в передаваемых параметрах указать идентификатор сессии (можно получить с помощью метода Authenticate) и идентификатор проекта:


2. При корректно выполненном методе появится код 200 и возвращаемые параметры - в данном случае:

  • UID;
  • ParentProjectId;
  • Name;
  • Status;
  • PercentComplete;
  • SystemStartDate и SystemEndDate;
  • PlannedStartDate и PlannedEndDate;
  • ActualStartDate и ActualEndDate;
  • OwnerId;
  • ResponsibleId;
  • ResourceAssignments.


Готовый пример: