Getting Time Sheet Lines

Request: http://<PPM_Server_IP>:<port>/itg/rest/tm/timeSheets/id/timeSheetLines

HTTP Method: GET

Description: Get time sheet lines of a time sheet.

Request path variables:

Attribute Description Required
id The id of the time sheet Yes

Response entity body:

  • on success: Return an XML object of the time sheet lines with the following format:

    <ns2:timeSheetLines xmlns:ns2="http://www.hp.com/ppm/tm/"> 
     <timeSheetLine>
      <id>1468301</id> 
      <workItemId>3282935</workItemId> 
      <workItemType>PROJECT</workItemType> 
      <workItemName>MS Mail Strategy</workItemName> 
      <workItemDescription>MS Mail Strategy</workItemDescription> 
      <status>1</status> 
      <approver>
        <id>33877</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>31448</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>31476</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>31446</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>31702</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>103632</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>31777</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <actuals>
        <actual>
          <activityId>30067</activityId> 
          <activityName>Execute - Benefits Realisation</activityName> 
          <efforts>
            <dayNum>10</dayNum> 
            <effort>4.0</effort> 
          </efforts>
          <efforts>
            <dayNum>15</dayNum> 
            <effort>6.0</effort> 
          </efforts>
          <activityType>added</activityType> 
        </actual>
        <actual>
          <activityId>30076</activityId> 
          <activityName>Execute - Performance Management</activityName> 
          <efforts>
            <dayNum>7</dayNum> 
            <effort>10.0</effort> 
          </efforts>
          <activityType>added</activityType> 
        </actual>
        <actual>
          <activityId>30131</activityId> 
          <activityName>914 upgrade act1</activityName> 
          <activityType>added</activityType> 
        </actual>
          <actualsType>activity</actualsType> 
        </actuals>
      <workUnit>
        <id>171904</id> 
        <actualStart>1368514800000</actualStart> 
        <actualFinish>0</actualFinish> 
        <actualEffort>2508.0</actualEffort> 
        <percentComplete>50.0</percentComplete> 
        <estimatedFinish>0</estimatedFinish> 
        <effortModified>true</effortModified> 
      </workUnit>
      <chargeCodes>
        <updateChargeCodeFlag>true</updateChargeCodeFlag> 
        <requireChargeCodeFlag>false</requireChargeCodeFlag> 
        <tslChargeCodes>
          <chargePercent>0.0</chargePercent> 
          <chargeCode>
            <id>100002</id> 
            <name>Fixed Price</name> 
            <description>Time for activities billed at Fixed Rate</description> 
            <enabled>true</enabled> 
            <chargeCodeCategory>BILLABLE</chargeCodeCategory> 
          </chargeCode>
        </tslChargeCodes>
        <tslChargeCodes>
          <chargePercent>10.0</chargePercent> 
          <chargeCode>
            <id>100003</id> 
            <name>Non Billable</name> 
            <description>Non Billable Activity</description> 
            <enabled>true</enabled> 
            <chargeCodeCategory>NON_BILLABLE</chargeCodeCategory> 
          </chargeCode>
        </tslChargeCodes>
        <tslChargeCodes>
          <chargePercent>90.0</chargePercent> 
          <chargeCode>
            <id>100001</id> 
            <name>Billable T&M</name> 
            <description>Time billed at T&M daily rate</description> 
            <enabled>true</enabled> 
            <chargeCodeCategory>BILLABLE</chargeCodeCategory> 
          </chargeCode>
        </tslChargeCodes>
      </chargeCodes>
      <workItemSetId>60000</workItemSetId> 
      <notes>
        <note>
          <id>159986</id> 
          <description>time sheet restful notes sample. it is used for sample only - update12334
          </description> 
          <type>TSL</type> 
          <createdBy>1</createdBy> 
          <createdDate>2013-04-25T00:09:26.000-07:00</createdDate> 
          <lastUpdatedBy>1</lastUpdatedBy> 
          <lastUpdatedDate>2013-04-25T00:09:26.000-07:00</lastUpdatedDate> 
        </note>
      </notes> 
     </timeSheetLine>
     <timeSheetLine>
      <id>1468302</id> 
      <workItemId>217037</workItemId> 
      <workItemType>TASK</workItemType> 
      <workItemName>IPS - Interest Rate Risk Management Processing System (R20)(D791)
      </workItemName> 
      <workItemDescription>ESO PBS GMGI BB-Flexi Loan R20 > IPS - Interest Rate Risk Management Processing System (R20) (D791)
      </workItemDescription> 
      <status>1</status> 
      <approver>
        <id>30772</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>30968</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>31791</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>31476</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>31446</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <approver>
        <id>30897</id> 
        <type>UsersTimeApprover</type> 
      </approver>
      <actuals>
        <actual>
          <efforts>
            <dayNum>7</dayNum> 
            <effort>9.0</effort> 
          </efforts>
          <efforts>
            <dayNum>10</dayNum> 
            <effort>7.0</effort> 
          </efforts>
          <efforts>
            <dayNum>15</dayNum> 
            <effort>8.0</effort> 
          </efforts>
        </actual>
        <actualsType>common</actualsType> 
      </actuals>
      <workUnit>
        <id>172244</id> 
        <actualStart>1368514800000</actualStart> 
        <actualFinish>0</actualFinish> 
        <actualEffort>2482.8</actualEffort> 
        <percentComplete>80.0</percentComplete> 
        <estimatedFinish>0</estimatedFinish> 
        <effortModified>true</effortModified> 
      </workUnit>
      <chargeCodes>
        <updateChargeCodeFlag>true</updateChargeCodeFlag> 
        <requireChargeCodeFlag>false</requireChargeCodeFlag> 
        <tslChargeCodes>
          <chargePercent>0.0</chargePercent> 
          <chargeCode>
            <id>100002</id> 
            <name>Fixed Price</name> 
            <description>Time for activities billed at Fixed Rate</description> 
            <enabled>true</enabled> 
            <chargeCodeCategory>BILLABLE</chargeCodeCategory> 
          </chargeCode>
        </tslChargeCodes>
        <tslChargeCodes>
          <chargePercent>0.0</chargePercent> 
          <chargeCode>
            <id>100003</id> 
            <name>Non Billable</name> 
            <description>Non Billable Activity</description> 
            <enabled>true</enabled> 
            <chargeCodeCategory>NON_BILLABLE</chargeCodeCategory> 
          </chargeCode>
        </tslChargeCodes>
        <tslChargeCodes>
          <chargePercent>100.0</chargePercent> 
          <chargeCode>
            <id>100001</id> 
            <name>Billable T&M</name> 
            <description>Time billed at T&M daily rate</description> 
            <enabled>true</enabled> 
            <chargeCodeCategory>BILLABLE</chargeCodeCategory> 
          </chargeCode>
        </tslChargeCodes>
      </chargeCodes>
      <workItemSetId>31600</workItemSetId> 
      <notes /> 
     </timeSheetLine>
    </ns2:timeSheetLines>
  • on failure: The following message codes are returned if the operation fails:

    Message Code

    HTTP Return Code

    Message

    Cause

    Possible Corrective Action

    PPMC_WSE005

    404

    Not found

    The time sheet does not exist.

    N/A

    PPMC_WSE000

    500

    Internal error

    There was an internal error when you executed the operation.

    N/A

    PPMC_WSE509

    500

    Error when trying to convert the time sheet attributes.

    There was a data issue when converting the time sheet attributes.

    Fix the data issue