Update a task

patch

/fscmRestApi/resources/11.13.18.05/workPlanTemplates/{WorkPlanTemplateId}/child/Tasks/{TaskId}

Request

Path Parameters
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Allocation Percentage
    The percentage of resource's hours allocated to the task for the task duration.
  • Title: Billable
    Maximum Length: 1
    Indicates whether the transactions charged to the task can be billed to customers. Only the lowest-level financial tasks can be billable.
  • Title: Chargeable
    Maximum Length: 1
    Indicates whether transactions can be charged to the task. Only the lowest-level financial tasks can be chargeable.
  • Title: Task Description
    Maximum Length: 2000
    Text description of the task.
  • Title: Display Sequence
    For internal use. The order in which the task is displayed.
  • Title: Planned Duration
    The planned duration of the task.
  • Title: Planned Effort in Hours
    The estimated effort, in hours, required to complete a task.
  • Title: Planned Expense Amount
    Default Value: 0
    The planned expense amount for the task.
  • Gate Approvers
    Title: Gate Approvers
    The Gate Approvers resource is used to view gate approver details.
  • Title: Planned Labor Bill Amount
    The planned bill amount for all the labor resources associated with the task.
  • Title: Planned Labor Cost
    The planned cost amount for all the labor resources associated with the task.
  • Title: Leaf Indicator
    Maximum Length: 1
    Default Value: Y
    Indicates whether the task is a lowest-level task.
  • Title: Manual Schedule
    Maximum Length: 1
    Indicates whether the schedule mode of a task is manual. If the schedule mode is manual, the task can't be updated automatically using the scheduling process.
  • Title: Milestone
    Maximum Length: 1
    Default Value: false
    Indicates whether the task is a milestone.
  • Title: Task Name
    Maximum Length: 255
    Name of the task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Title: Parent Task ID
    Identifier of the parent task of the task.
  • Title: Peer Reference Task ID
    Unique identifier of the peer task.
  • Title: Priority
    Priority of the task for the assigned resource.
  • Title: Task Schedule Type Code
    Maximum Length: 30
    Schedule type of the task. Valid values are fixed effort and fixed duration.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • TaskDFF
  • Title: Task Level
    Indicates the level of the task in the hierarchy. The level of the task that holds the rollup values of the project is 0.
  • Title: Task Number
    Maximum Length: 100
    The number assigned to a task. It's used to uniquely identify a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Title: Total Cost
    The total cost of the task. It's the sum of expense and labor costs.
  • Title: Work Type
    Maximum Length: 240
    Name of the classification of the work associated with the project task. Use work types to categorize and group tasks for processing purposes. The work type must be active as of the current system date.
  • Title: Work Type ID
    Unique identifier of the work type. Work type is used to classify the work associated with the project task. The work type must be active as of the current system date.
Nested Schema : Gate Approvers
Type: array
Title: Gate Approvers
The Gate Approvers resource is used to view gate approver details.
Show Source
Nested Schema : TaskDFF
Type: array
Show Source
Nested Schema : workPlanTemplates-Tasks-GateApprovers-item-patch-request
Type: object
Show Source
Nested Schema : workPlanTemplates-Tasks-TaskDFF-item-patch-request
Type: object
Show Source
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : workPlanTemplates-Tasks-item-response
Type: object
Show Source
  • Title: Allocation Percentage
    The percentage of resource's hours allocated to the task for the task duration.
  • Title: Billable
    Maximum Length: 1
    Indicates whether the transactions charged to the task can be billed to customers. Only the lowest-level financial tasks can be billable.
  • Title: Chargeable
    Maximum Length: 1
    Indicates whether transactions can be charged to the task. Only the lowest-level financial tasks can be chargeable.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the task.
  • Title: Creation Date
    Read Only: true
    The date when the task was created.
  • Title: Task Description
    Maximum Length: 2000
    Text description of the task.
  • Title: Display Sequence
    For internal use. The order in which the task is displayed.
  • Title: Planned Duration
    The planned duration of the task.
  • Title: Planned Effort in Hours
    The estimated effort, in hours, required to complete a task.
  • Title: Task Element Type
    Maximum Length: 30
    Default Value: EXECUTION
    Indicates if the task is financially tracked or tracked for execution only. Valid values are EXECUTION and FINANCIAL.
  • Title: Planned Expense Amount
    Default Value: 0
    The planned expense amount for the task.
  • Gate Approvers
    Title: Gate Approvers
    The Gate Approvers resource is used to view gate approver details.
  • Title: Gate
    Maximum Length: 1
    Default Value: false
    Indicates whether the task is a gate.
  • Title: Planned Labor Bill Amount
    The planned bill amount for all the labor resources associated with the task.
  • Title: Planned Labor Cost
    The planned cost amount for all the labor resources associated with the task.
  • Title: Leaf Indicator
    Maximum Length: 1
    Default Value: Y
    Indicates whether the task is a lowest-level task.
  • Links
  • Title: Manual Schedule
    Maximum Length: 1
    Indicates whether the schedule mode of a task is manual. If the schedule mode is manual, the task can't be updated automatically using the scheduling process.
  • Title: Milestone
    Maximum Length: 1
    Default Value: false
    Indicates whether the task is a milestone.
  • Title: Task Name
    Maximum Length: 255
    Name of the task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Task code defined during implementation that provides the ability to capture a numeric value as additional information for a task.
  • Title: Parent Task ID
    Identifier of the parent task of the task.
  • Title: Peer Reference Task ID
    Unique identifier of the peer task.
  • Title: Primary Resource Email
    Read Only: true
    Maximum Length: 240
    Email of the person who leads the task.
  • Title: Primary Resource Name
    Read Only: true
    Maximum Length: 240
    Name of the resource who leads the work on a task.
  • Title: Priority
    Priority of the task for the assigned resource.
  • Title: Task Schedule Type Code
    Maximum Length: 30
    Schedule type of the task. Valid values are fixed effort and fixed duration.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • Task code defined during implementation that provides a list of values to capture additional information for a task.
  • TaskDFF
  • Title: Task ID
    Unique identifier of the task.
  • Title: Task Level
    Indicates the level of the task in the hierarchy. The level of the task that holds the rollup values of the project is 0.
  • Title: Task Number
    Maximum Length: 100
    The number assigned to a task. It's used to uniquely identify a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Maximum Length: 200
    Task code defined during implementation that provides free-form text entry to capture additional information for a task.
  • Title: Total Cost
    The total cost of the task. It's the sum of expense and labor costs.
  • Title: Work Type
    Maximum Length: 240
    Name of the classification of the work associated with the project task. Use work types to categorize and group tasks for processing purposes. The work type must be active as of the current system date.
  • Title: Work Type ID
    Unique identifier of the work type. Work type is used to classify the work associated with the project task. The work type must be active as of the current system date.
Nested Schema : Gate Approvers
Type: array
Title: Gate Approvers
The Gate Approvers resource is used to view gate approver details.
Show Source
Nested Schema : TaskDFF
Type: array
Show Source
Nested Schema : workPlanTemplates-Tasks-GateApprovers-item-response
Type: object
Show Source
Nested Schema : workPlanTemplates-Tasks-TaskDFF-item-response
Type: object
Show Source
Back to Top

Examples

The following example shows how to update a task in a work plan template by submitting a PATCH request on the REST resource using cURL.

curl --user ppm_cloud_user -X PATCH -d @example_request_payload.json --header "Content-Type: application/json" https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/workPlanTemplates/100100148369454/child/Tasks/100100148369456

Request Body Example

The following shows an example of the request body in JSON format.

{
"Name" : "Task 2"
}

Response Body Example

The following shows an example of the response body in JSON format.

{
"BillableFlag": null,
"ChargeableFlag": null,
"Description": null,
"DisplaySequence": 10000000,
"ElementType": "EXECUTION",
"GateFlag": false,
"ManualScheduleFlag": false,
"MilestoneFlag": true,
"Name": "Task 2",
"ParentTaskId": 100100148369455,
"Allocation": 100,
"Duration": 0,
"Effort": 0,
"PrimaryResourceEmail": "prj_connor_horton_grp@oracle.com",
"PrimaryResourceName": "Connor Horton",
"TaskId": 100100148369456,
"TaskLevel": 1,
"TaskNumber": "2006",
"NumberAttr01": null,
"NumberAttr02": null,
"NumberAttr03": null,
"NumberAttr04": null,
"NumberAttr05": null,
"NumberAttr06": null,
"NumberAttr07": null,
"NumberAttr08": null,
"NumberAttr09": null,
"NumberAttr10": null,
"TaskCode01Id": null,
"TaskCode02Id": null,
"TaskCode03Id": null,
"TaskCode04Id": null,
"TaskCode05Id": null,
"TaskCode06Id": null,
"TaskCode07Id": null,
"TaskCode08Id": null,
"TaskCode09Id": null,
"TaskCode10Id": null,
"TaskCode11Id": null,
"TaskCode12Id": null,
"TaskCode13Id": null,
"TaskCode14Id": null,
"TaskCode15Id": null,
"TaskCode16Id": null,
"TaskCode17Id": null,
"TaskCode18Id": null,
"TaskCode19Id": null,
"TaskCode20Id": null,
"TaskCode21Id": null,
"TaskCode22Id": null,
"TaskCode23Id": null,
"TaskCode24Id": null,
"TaskCode25Id": null,
"TaskCode26Id": null,
"TaskCode27Id": null,
"TaskCode28Id": null,
"TaskCode29Id": null,
"TaskCode30Id": null,
"TaskCode31Id": null,
"TaskCode32Id": null,
"TaskCode33Id": null,
"TaskCode34Id": null,
"TaskCode35Id": null,
"TaskCode36Id": null,
"TaskCode37Id": null,
"TaskCode38Id": null,
"TaskCode39Id": null,
"TaskCode40Id": null,
"TextAttr01": null,
"TextAttr02": null,
"TextAttr03": null,
"TextAttr04": null,
"TextAttr05": null,
"TextAttr06": null,
"TextAttr07": null,
"TextAttr08": null,
"TextAttr09": null,
"TextAttr10": null,
"TextAttr11": null,
"TextAttr12": null,
"TextAttr13": null,
"TextAttr14": null,
"TextAttr15": null,
"TextAttr16": null,
"TextAttr17": null,
"TextAttr18": null,
"TextAttr19": null,
"TextAttr20": null,
"LaborCost": 0,
"LaborBillAmount": 0,
"ExpenseAmount": 0,
"TotalCost": 0,
"Priority": null,
"links": [
{
"rel": "self",
"href": "https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/workPlanTemplates/100100148369454/child/Tasks/100100148369456",
"name": "Tasks",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000004770400000004737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B0200007870000000037371007E0002000000017371007E0002000000057372001B6F7261636C652E6A626F2E646F6D61696E2E4E756C6C56616C75655899C1C58DAABEEB02000149000A6D53514C54797065496478700000000C78"
}
},
{
"rel": "canonical",
"href": "https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/workPlanTemplates/100100148369454/child/Tasks/100100148369456",
"name": "Tasks",
"kind": "item"
},
{
"rel": "parent",
"href": "https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/workPlanTemplates/100100148369454",
"name": "workPlanTemplates",
"kind": "item"
},
{
"rel": "child",
"href": "https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/workPlanTemplates/100100148369454/child/Tasks/100100148369456/child/GateApprovers",
"name": "GateApprovers",
"kind": "collection"
},
{
"rel": "child",
"href": "https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/workPlanTemplates/100100148369454/child/Tasks/100100148369456/child/TaskDFF",
"name": "TaskDFF",
"kind": "collection"
}
]
}
Back to Top