Getting Work Items

Request: http://<PPM_Server_IP>:<port>/itg/rest/tm/workItems

HTTP Method: GET

Description: Get work items by work item type and work item owner user ID . This API reads work items from the table TM_RESOURCE_QUICKLIST_ITEMS which stores the "My Items" list of each resource. If the specified resource has no records in this table, the API returns nothing.

Query Parameters:

Attribute Description
type The type of the work items. The types of the work items are as follows: REQUEST, PACKAGE, TASK, PROJECT, MISC.
ownerUserId The user ID of the work item owner

Response entity body:

  • on success: Return an XML object of the work items with the following format:

    <ns2:workItems xmlns:ns2="http://www.hp.com/tm/">
  <workItem>
    <id>217037</id>
    <type>TASK</type>
    <setId>31600</setId>
    <name>IPS - Interest Rate Risk Management Processing System (R20)(D791)
    </name>
    <description>ESO PBS GMGI BB-Flexi Loan R20 &gt; IPS -Interest Rate Risk 
     Management Processing System (R20) (D791)</description>
   </workItem>
   <workItem>
     <id>3282935</id>
     <type>PROJECT</type>
     <setId>60000</setId>
     <name>MS Mail Strategy</name>
     <description>MS Mail Strategy</description>
   </workItem>
</ns2:workItems>

  • on failure: The following message codes are returned if the operation fails:

    Message Code

    HTTP Return Code

    Message

    Cause

    Possible Corrective Action

    PPMC_WSE502

    400

    The owner user id is invalid. Please input correct owner user id.

    The owner user ID should be more than 0.

    Input correct owner user ID.

    PPMC_WSE006

    403

    The user does not have the access grant to perform this action.

    The user does not have the required access grant.

    Get the required access grant.

    PPMC_WSE007

    403

    The user does not have access to this resource.

    The user does not have access to this resource.

    N/A

    PPMC_WSE508

    400

    Cannot find the resource with the owner user id.

    The owner user ID is not correct.

    Correct the owner user ID.

    PPMC_WSE000

    500

    Internal error

    There was an internal error when you executed this operation.

    N/A