Jump to

• Request
• Response
• Examples

Update a project task

patch

/fscmRestApi/resources/11.13.18.05/projectsUsers/{ResourceId}/child/ProjectTasks/{ProjectTasksUniqID}

Request

Path Parameters

• ProjectTasksUniqID(required): string
  This is the hash key of the attributes which make up the composite key for the Project Tasks resource and used to uniquely identify an instance of Project Tasks. The client should not generate the hash key value. Instead, the client should query on the Project Tasks collection resource in order to navigate to a specific instance of Project Tasks to get the hash key.
• ResourceId(required): integer(int64)
  The unique identifier of the resource assigned to the task.

Header Parameters

• Metadata-Context:
  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".
• REST-Framework-Version:
  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

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• FinancialParentTaskId: integer
  Unique identifier of the lowest financial parent task.
• FinancialParentTaskName: string
  The name of the lowest financial parent task.
• FinancialParentTaskNumber: string
  The number of the lowest financial parent task.
• LaborResourceAssignments: array Labor Resource Assignments
  Title: Labor Resource Assignments

  The labor resource assignment includes attributes used to store values while creating or updating labor resource assignments for a project task. For example, a DBA may be assigned as a labor resource for a project task.
• MilestoneFlag: boolean
  Title: Milestone

  Maximum Length: 1

  Indicates whether a task is a milestone in the Team Member Dashboard and Task Management page. If the value is true, then the task is a milestone. The default value is false.
• PlanLineId: integer (int64)
  The unique identifier of the plan line of the task.
• PlanVersionId(required): integer (int64)
  The unique identifier of the plan version of the proejct task.
• TaskActualFinishDate: string (date)
  Title: Actual Finish Date

  The date when work was completed on a task as opposed to the planned end date of the task.
• TaskActualQuantity: number
  Title: ITD Hours

  Default Value: 0

  The number of hours that the project team member reports working on the task.
• TaskActualStartDate: string (date)
  Title: Actual Start Date

  The date when work started on a task as opposed to the planned start date of the task.
• TaskDescription: string
  Title: Description

  Maximum Length: 2000

  The description of the task.
• TaskExceptions: string
  The exceptions generated by the progress entry for the task.
• TaskFollowers: array Project Task Followers
  Title: Project Task Followers

  The task follower resource is used to store values while adding or removing followers on project tasks. A project user can be assigned as a follower on a project task for viewing task details and tracking its completion.
• TaskName(required): string
  Title: Task Name

  Maximum Length: 255

  The name of the task.
• TaskPercentComplete: number
  Title: Percent Complete

  Default Value: 0

  The percent of work completed for a particular task.
• TaskPlannedFinishDate: string (date)
  Title: Finish Date

  The date when the task is scheduled to end.
• TaskPlannedStartDate: string (date)
  Title: Start Date

  The date when task is scheduled to start.
• TaskPriority: number
  Title: Priority

  The priority of the task.
• TaskProgressEnteredDate: string (date)
  The date when progress on a task was last entered.
• TaskProgressStatusCode: string
  Maximum Length: 20

  The code of the progress status of the task.
• TaskProposedFinishDate: string (date)
  Title: Proposed Finish Date

  The date when the task is expected to be completed.
• TaskProposedQuantity: number
  Title: Proposed Hours

  The total number of hours estimated for the resource to complete a task.
• TaskProposedStartDate: string (date)
  Title: Proposed Start Date

  The date when the task is expected to be started.
• TaskQuantity: number
  Title: Planned Effort in Hours

  The scheduled number of hours that the resource is assigned to work on a task.
• TaskRemainingQuantity: number
  Title: Remaining Hours

  The number of hours the project team member has left to complete a task.
• TopTaskName: string
  Name of the top task to which the task rolls up. The top task identifier and task identifier are same for a top task.
• TopTaskNumber: string
  The number of the top task to which the task rolls up. The top task identifier and task identifier are same for a top task.

{
    "required":[
        "PlanVersionId",
        "TaskName"
    ],
    "type":"object",
    "properties":{
        "FinancialParentTaskNumber":{
            "type":"string",
            "description":"The number of the lowest financial parent task.",
            "nullable":true
        },
        "TaskExceptions":{
            "type":"string",
            "description":"The exceptions generated by the progress entry for the task.",
            "nullable":true
        },
        "TaskPriority":{
            "title":"Priority",
            "type":"number",
            "description":"The priority of the task.",
            "nullable":true
        },
        "TaskPercentComplete":{
            "title":"Percent Complete",
            "type":"number",
            "description":"The percent of work completed for a particular task.",
            "nullable":true,
            "default":"0"
        },
        "TaskProgressStatusCode":{
            "maxLength":"20",
            "type":"string",
            "description":"The code of the progress status of the task.",
            "nullable":true,
            "x-hints":{
                "controlType":"choice"
            }
        },
        "TaskProposedStartDate":{
            "title":"Proposed Start Date",
            "type":"string",
            "description":"The date when the task is expected to be started.",
            "format":"date",
            "nullable":true
        },
        "TaskActualQuantity":{
            "title":"ITD Hours",
            "type":"number",
            "description":"The number of hours that the project team member reports working on the task.",
            "nullable":true,
            "default":"0"
        },
        "TaskDescription":{
            "title":"Description",
            "maxLength":"2000",
            "type":"string",
            "description":"The description of the task.",
            "nullable":true
        },
        "TaskRemainingQuantity":{
            "title":"Remaining Hours",
            "type":"number",
            "description":"The number of hours the project team member has left to complete a task.",
            "nullable":true
        },
        "FinancialParentTaskName":{
            "type":"string",
            "description":"The name of the lowest financial parent task.",
            "nullable":true
        },
        "TaskPlannedFinishDate":{
            "title":"Finish Date",
            "type":"string",
            "description":"The date when the task is scheduled to end.",
            "format":"date",
            "nullable":true
        },
        "TaskQuantity":{
            "title":"Planned Effort in Hours",
            "type":"number",
            "description":"The scheduled number of hours that the resource is assigned to work on a task.",
            "nullable":true
        },
        "TaskProposedQuantity":{
            "title":"Proposed Hours",
            "type":"number",
            "description":"The total number of hours estimated for the resource to complete a task.",
            "nullable":true
        },
        "PlanLineId":{
            "type":"integer",
            "description":"The unique identifier of the plan line of the task.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18",
                "fnd:GLOBALLY_UNIQUE":"true"
            }
        },
        "TaskFollowers":{
            "title":"Project Task Followers",
            "type":"array",
            "description":"The task follower resource is used to store values while adding or removing followers on project tasks. A project user can be assigned as a follower on a project task for viewing task details and tracking its completion.",
            "items":{
                "$ref":"#/components/schemas/projectsUsers-ProjectTasks-TaskFollowers-item-patch-request"
            }
        },
        "MilestoneFlag":{
            "title":"Milestone",
            "maxLength":"1",
            "type":"boolean",
            "description":"Indicates whether a task is a milestone in the Team Member Dashboard and Task Management page. If the value is true, then the task is a milestone. The default value is false.",
            "nullable":true
        },
        "PlanVersionId":{
            "type":"integer",
            "description":"The unique identifier of the plan version of the proejct task.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18"
            }
        },
        "LaborResourceAssignments":{
            "title":"Labor Resource Assignments",
            "type":"array",
            "description":"The labor resource assignment includes attributes used to store values while creating or updating labor resource assignments for a project task. For example, a DBA may be assigned as a labor resource for a project task.",
            "items":{
                "$ref":"#/components/schemas/projectsUsers-ProjectTasks-LaborResourceAssignments-item-patch-request"
            }
        },
        "FinancialParentTaskId":{
            "type":"integer",
            "description":"Unique identifier of the lowest financial parent task.",
            "nullable":true
        },
        "TaskName":{
            "title":"Task Name",
            "maxLength":"255",
            "type":"string",
            "description":"The name of the task.",
            "nullable":false
        },
        "TaskProposedFinishDate":{
            "title":"Proposed Finish Date",
            "type":"string",
            "description":"The date when the task is expected to be completed.",
            "format":"date",
            "nullable":true
        },
        "TaskProgressEnteredDate":{
            "type":"string",
            "description":"The date when progress on a task was last entered.",
            "format":"date",
            "nullable":true
        },
        "TaskActualFinishDate":{
            "title":"Actual Finish Date",
            "type":"string",
            "description":"The date when work was completed on a task as opposed to the planned end date of the task.",
            "format":"date",
            "nullable":true
        },
        "TopTaskNumber":{
            "type":"string",
            "description":"The number of the top task to which the task rolls up. The top task identifier and task identifier are same for a top task.",
            "nullable":true
        },
        "TopTaskName":{
            "type":"string",
            "description":"Name of the top task to which the task rolls up. The top task identifier and task identifier are same for a top task.",
            "nullable":true
        },
        "TaskActualStartDate":{
            "title":"Actual Start Date",
            "type":"string",
            "description":"The date when work started on a task as opposed to the planned start date of the task.",
            "format":"date",
            "nullable":true
        },
        "TaskPlannedStartDate":{
            "title":"Start Date",
            "type":"string",
            "description":"The date when task is scheduled to start.",
            "format":"date",
            "nullable":true
        }
    }
}

Nested Schema : Labor Resource Assignments

Type: array

Title: Labor Resource Assignments

The labor resource assignment includes attributes used to store values while creating or updating labor resource assignments for a project task. For example, a DBA may be assigned as a labor resource for a project task.

Show Source

• Array of: object projectsUsers-ProjectTasks-LaborResourceAssignments-item-patch-request

{
    "title":"Labor Resource Assignments",
    "type":"array",
    "description":"The labor resource assignment includes attributes used to store values while creating or updating labor resource assignments for a project task. For example, a DBA may be assigned as a labor resource for a project task.",
    "items":{
        "$ref":"#/components/schemas/projectsUsers-ProjectTasks-LaborResourceAssignments-item-patch-request"
    }
}

Nested Schema : Project Task Followers

Type: array

Title: Project Task Followers

The task follower resource is used to store values while adding or removing followers on project tasks. A project user can be assigned as a follower on a project task for viewing task details and tracking its completion.

Show Source

• Array of: object projectsUsers-ProjectTasks-TaskFollowers-item-patch-request

{
    "title":"Project Task Followers",
    "type":"array",
    "description":"The task follower resource is used to store values while adding or removing followers on project tasks. A project user can be assigned as a follower on a project task for viewing task details and tracking its completion.",
    "items":{
        "$ref":"#/components/schemas/projectsUsers-ProjectTasks-TaskFollowers-item-patch-request"
    }
}

Nested Schema : projectsUsers-ProjectTasks-LaborResourceAssignments-item-patch-request

Type: object

Show Source

{
    "type":"object",
    "properties":{
    }
}

Nested Schema : projectsUsers-ProjectTasks-TaskFollowers-item-patch-request

Type: object

Show Source

{
    "type":"object",
    "properties":{
    }
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

The following table describes the default response for this task.

Headers

• Metadata-Context:
  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".
• REST-Framework-Version:
  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 : projectsUsers-ProjectTasks-item-response

Type: object

Show Source

• CreatedBy: string
  Read Only: true

  Maximum Length: 64

  The unique identifier of the user who created the task.
• CreationDate: string (date-time)
  Read Only: true

  The date when the task is created.
• ElementType: string
  Title: Element Type

  Read Only: true

  Maximum Length: 30

  The element type of the task.
• ElementVersionId: integer (int64)
  Read Only: true

  The unique identifier of the element version of the task.
• ExecutionDisplaySequence: integer (int64)
  Read Only: true

  The order in which the task is displayed in the project.
• FinancialParentTaskId: integer
  Unique identifier of the lowest financial parent task.
• FinancialParentTaskName: string
  The name of the lowest financial parent task.
• FinancialParentTaskNumber: string
  The number of the lowest financial parent task.
• LaborResourceAssignments: array Labor Resource Assignments
  Title: Labor Resource Assignments

  The labor resource assignment includes attributes used to store values while creating or updating labor resource assignments for a project task. For example, a DBA may be assigned as a labor resource for a project task.
• LastUpdateDate: string (date-time)
  Title: Last Updated Date

  Read Only: true

  The date when the task is last updated.
• LastUpdatedBy: string
  Read Only: true

  Maximum Length: 64

  The unique identifier of the user who last updated the task.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• MilestoneFlag: boolean
  Title: Milestone

  Maximum Length: 1

  Indicates whether a task is a milestone in the Team Member Dashboard and Task Management page. If the value is true, then the task is a milestone. The default value is false.
• ObjectType: string
  Read Only: true

  Maximum Length: 30

  Default Value: PJF_TASKS

  The object type of the task.
• OsnSharedTaskFlag: boolean
  Read Only: true

  Indicates whether a task is shared on OSN. If the value is true, then the task is shared. The default value is false.
• ParentTaskName: string
  Title: Task Name

  Read Only: true

  Maximum Length: 255

  The name of the parent task to a new task.
• ParentTaskNumber: string
  Title: Task Number

  Read Only: true

  Maximum Length: 100

  The number of the parent task. If the task is the top task, then parent task is null.
• PlanLineId: integer (int64)
  The unique identifier of the plan line of the task.
• PlanVersionId: integer (int64)
  The unique identifier of the plan version of the proejct task.
• ProjectId: integer (int64)
  Read Only: true

  The unique identifier of the project to which the task is associated.
• ProjectName: string
  Title: Project Name

  Read Only: true

  Maximum Length: 240

  The name of the project to which a task is associated.
• ProjectStatusCode: string
  Read Only: true

  Maximum Length: 30

  The code corresponding to the label that displays the status of the project.
• ProjectStatusName: string
  Read Only: true

  Maximum Length: 80

  The label to display the status of the project.
• ProjectSystemStatusCode: string
  Read Only: true

  Maximum Length: 30

  The code of the system status corresponding to the status of the project.
• ProjElementId: integer (int64)
  Read Only: true

  The unique identifier of the project Element of the task.
• TaskActualFinishDate: string (date)
  Title: Actual Finish Date

  The date when work was completed on a task as opposed to the planned end date of the task.
• TaskActualQuantity: number
  Title: ITD Hours

  Default Value: 0

  The number of hours that the project team member reports working on the task.
• TaskActualStartDate: string (date)
  Title: Actual Start Date

  The date when work started on a task as opposed to the planned start date of the task.
• TaskCurrentActualQuantity: number
  Title: Actual Hours

  Read Only: true

  Current estimated effort to complete the task.
• TaskCurrentFinishDate: string (date)
  Read Only: true

  The date when the task is estimated to end.
• TaskCurrentStartDate: string (date)
  Read Only: true

  The date when the task is estimated to start.
• TaskDescription: string
  Title: Description

  Maximum Length: 2000

  The description of the task.
• TaskExceptions: string
  The exceptions generated by the progress entry for the task.
• TaskFollowers: array Project Task Followers
  Title: Project Task Followers

  The task follower resource is used to store values while adding or removing followers on project tasks. A project user can be assigned as a follower on a project task for viewing task details and tracking its completion.
• TaskId: integer (int64)
  Read Only: true

  The unique identifier of the task.
• TaskLevel: integer (int32)
  Read Only: true

  The level of the task in the project work plan.
• TaskName: string
  Title: Task Name

  Maximum Length: 255

  The name of the task.
• TaskPercentComplete: number
  Title: Percent Complete

  Default Value: 0

  The percent of work completed for a particular task.
• TaskPlannedFinishDate: string (date)
  Title: Finish Date

  The date when the task is scheduled to end.
• TaskPlannedStartDate: string (date)
  Title: Start Date

  The date when task is scheduled to start.
• TaskPrimaryResourceId: integer (int64)
  Read Only: true

  The unique identifier of the primary resource assigned to the task.
• TaskPriority: number
  Title: Priority

  The priority of the task.
• TaskProgressEnteredDate: string (date)
  The date when progress on a task was last entered.
• TaskProgressStatus: string
  Read Only: true

  Maximum Length: 80

  The status of work completed on the task.
• TaskProgressStatusCode: string
  Maximum Length: 20

  The code of the progress status of the task.
• TaskProposedFinishDate: string (date)
  Title: Proposed Finish Date

  The date when the task is expected to be completed.
• TaskProposedQuantity: number
  Title: Proposed Hours

  The total number of hours estimated for the resource to complete a task.
• TaskProposedStartDate: string (date)
  Title: Proposed Start Date

  The date when the task is expected to be started.
• TaskQuantity: number
  Title: Planned Effort in Hours

  The scheduled number of hours that the resource is assigned to work on a task.
• TaskRemainingQuantity: number
  Title: Remaining Hours

  The number of hours the project team member has left to complete a task.
• TaskResourceAllocationPercent: number
  Title: Resource Allocation Percentage

  Read Only: true

  The percentage of total time that resources are planned to work on the task they are assigned to.
• TopTaskId: integer (int64)
  Title: Top Task ID

  Read Only: true

  Identifier of the top task to which the task rolls up. The top task identifier and task identifier are the same for a top task.
• TopTaskName: string
  Name of the top task to which the task rolls up. The top task identifier and task identifier are same for a top task.
• TopTaskNumber: string
  The number of the top task to which the task rolls up. The top task identifier and task identifier are same for a top task.

{
    "type":"object",
    "properties":{
        "CreationDate":{
            "type":"string",
            "description":"The date when the task is created.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskPriority":{
            "title":"Priority",
            "type":"number",
            "description":"The priority of the task.",
            "nullable":true,
            "x-queryable":true
        },
        "TaskProgressStatusCode":{
            "maxLength":"20",
            "type":"string",
            "description":"The code of the progress status of the task.",
            "nullable":true,
            "x-hints":{
                "controlType":"choice"
            },
            "x-queryable":true
        },
        "TaskProposedStartDate":{
            "title":"Proposed Start Date",
            "type":"string",
            "description":"The date when the task is expected to be started.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "ProjElementId":{
            "type":"integer",
            "description":"The unique identifier of the project Element of the task.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18",
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "TaskCurrentStartDate":{
            "type":"string",
            "description":"The date when the task is estimated to start.",
            "format":"date",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "FinancialParentTaskName":{
            "type":"string",
            "description":"The name of the lowest financial parent task.",
            "nullable":true,
            "x-queryable":true
        },
        "TaskPlannedFinishDate":{
            "title":"Finish Date",
            "type":"string",
            "description":"The date when the task is scheduled to end.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "TaskQuantity":{
            "title":"Planned Effort in Hours",
            "type":"number",
            "description":"The scheduled number of hours that the resource is assigned to work on a task.",
            "nullable":true,
            "x-queryable":true
        },
        "ProjectSystemStatusCode":{
            "maxLength":"30",
            "type":"string",
            "description":"The code of the system status corresponding to the status of the project.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskProgressStatus":{
            "maxLength":"80",
            "type":"string",
            "description":"The status of work completed on the task.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "dependencies":[
                    "TaskProgressStatusCode"
                ]
            },
            "x-queryable":true
        },
        "LastUpdatedBy":{
            "maxLength":"64",
            "type":"string",
            "description":"The unique identifier of the user who last updated the task.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "TopTaskId":{
            "title":"Top Task ID",
            "type":"integer",
            "description":"Identifier of the top task to which the task rolls up. The top task identifier and task identifier are the same for a top task.",
            "format":"int64",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "ElementType":{
            "title":"Element Type",
            "maxLength":"30",
            "type":"string",
            "description":"The element type of the task.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "CreatedBy":{
            "maxLength":"64",
            "type":"string",
            "description":"The unique identifier of the user who created the task.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskFollowers":{
            "title":"Project Task Followers",
            "type":"array",
            "description":"The task follower resource is used to store values while adding or removing followers on project tasks. A project user can be assigned as a follower on a project task for viewing task details and tracking its completion.",
            "items":{
                "$ref":"#/components/schemas/projectsUsers-ProjectTasks-TaskFollowers-item-response"
            }
        },
        "TaskCurrentFinishDate":{
            "type":"string",
            "description":"The date when the task is estimated to end.",
            "format":"date",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "LaborResourceAssignments":{
            "title":"Labor Resource Assignments",
            "type":"array",
            "description":"The labor resource assignment includes attributes used to store values while creating or updating labor resource assignments for a project task. For example, a DBA may be assigned as a labor resource for a project task.",
            "items":{
                "$ref":"#/components/schemas/projectsUsers-ProjectTasks-LaborResourceAssignments-item-response"
            }
        },
        "TaskPrimaryResourceId":{
            "type":"integer",
            "description":"The unique identifier of the primary resource assigned to the task.",
            "format":"int64",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "TaskName":{
            "title":"Task Name",
            "maxLength":"255",
            "type":"string",
            "description":"The name of the task.",
            "nullable":false,
            "x-queryable":true
        },
        "TaskProgressEnteredDate":{
            "type":"string",
            "description":"The date when progress on a task was last entered.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "ExecutionDisplaySequence":{
            "type":"integer",
            "description":"The order in which the task is displayed in the project.",
            "format":"int64",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "OsnSharedTaskFlag":{
            "type":"boolean",
            "description":"Indicates whether a task is shared on OSN. If the value is true, then the task is shared. The default value is false.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "TopTaskName":{
            "type":"string",
            "description":"Name of the top task to which the task rolls up. The top task identifier and task identifier are same for a top task.",
            "nullable":true,
            "x-queryable":true
        },
        "FinancialParentTaskNumber":{
            "type":"string",
            "description":"The number of the lowest financial parent task.",
            "nullable":true,
            "x-queryable":true
        },
        "ProjectStatusCode":{
            "maxLength":"30",
            "type":"string",
            "description":"The code corresponding to the label that displays the status of the project.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskExceptions":{
            "type":"string",
            "description":"The exceptions generated by the progress entry for the task.",
            "nullable":true,
            "x-queryable":true
        },
        "TaskId":{
            "type":"integer",
            "description":"The unique identifier of the task.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18",
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "TaskPercentComplete":{
            "title":"Percent Complete",
            "type":"number",
            "description":"The percent of work completed for a particular task.",
            "nullable":true,
            "default":"0",
            "x-queryable":true
        },
        "ProjectName":{
            "title":"Project Name",
            "maxLength":"240",
            "type":"string",
            "description":"The name of the project to which a task is associated.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "ObjectType":{
            "maxLength":"30",
            "type":"string",
            "description":"The object type of the task.",
            "nullable":false,
            "readOnly":true,
            "default":"PJF_TASKS",
            "x-queryable":true
        },
        "ParentTaskNumber":{
            "title":"Task Number",
            "maxLength":"100",
            "type":"string",
            "description":"The  number of the parent task. If the task is the top task, then parent task is null.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskActualQuantity":{
            "title":"ITD Hours",
            "type":"number",
            "description":"The number of hours that the project team member reports working on the task.",
            "nullable":true,
            "default":"0",
            "x-queryable":true
        },
        "TaskDescription":{
            "title":"Description",
            "maxLength":"2000",
            "type":"string",
            "description":"The description of the task.",
            "nullable":true,
            "x-queryable":true
        },
        "TaskRemainingQuantity":{
            "title":"Remaining Hours",
            "type":"number",
            "description":"The number of hours the project team member has left to complete a task.",
            "nullable":true,
            "x-queryable":true
        },
        "ParentTaskName":{
            "title":"Task Name",
            "maxLength":"255",
            "type":"string",
            "description":"The name of the parent task to a new task.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskProposedQuantity":{
            "title":"Proposed Hours",
            "type":"number",
            "description":"The total number of hours estimated for the resource to complete a task.",
            "nullable":true,
            "x-queryable":true
        },
        "PlanLineId":{
            "type":"integer",
            "description":"The unique identifier of the plan line of the task.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18",
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "MilestoneFlag":{
            "title":"Milestone",
            "maxLength":"1",
            "type":"boolean",
            "description":"Indicates whether a task is a milestone in the Team Member Dashboard and Task Management page. If the value is true, then the task is a milestone. The default value is false.",
            "nullable":true,
            "x-queryable":true
        },
        "PlanVersionId":{
            "type":"integer",
            "description":"The unique identifier of the plan version of the proejct task.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "ProjectId":{
            "type":"integer",
            "description":"The unique identifier of the project to which the task is associated.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "ProjectStatusName":{
            "maxLength":"80",
            "type":"string",
            "description":"The label to display the status of the project.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskCurrentActualQuantity":{
            "title":"Actual Hours",
            "type":"number",
            "description":"Current estimated effort to complete the task.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "FinancialParentTaskId":{
            "type":"integer",
            "description":"Unique identifier of the lowest financial parent task.",
            "nullable":true,
            "x-queryable":true
        },
        "TaskResourceAllocationPercent":{
            "title":"Resource Allocation Percentage",
            "type":"number",
            "description":"The percentage of total time that resources are planned to work on the task they are assigned to.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskProposedFinishDate":{
            "title":"Proposed Finish Date",
            "type":"string",
            "description":"The date when the task is expected to be completed.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "ElementVersionId":{
            "type":"integer",
            "description":"The unique identifier of the element version of the task.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18",
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "TaskLevel":{
            "type":"integer",
            "description":"The level of the task in the project work plan.",
            "format":"int32",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":"3"
            },
            "x-queryable":true
        },
        "TaskActualFinishDate":{
            "title":"Actual Finish Date",
            "type":"string",
            "description":"The date when work was completed on a task as opposed to the planned end date of the task.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "TopTaskNumber":{
            "type":"string",
            "description":"The number of the top task to which the task rolls up. The top task identifier and task identifier are same for a top task.",
            "nullable":true,
            "x-queryable":true
        },
        "TaskActualStartDate":{
            "title":"Actual Start Date",
            "type":"string",
            "description":"The date when work started on a task as opposed to the planned start date of the task.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "LastUpdateDate":{
            "title":"Last Updated Date",
            "type":"string",
            "description":"The date when the task is last updated.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskPlannedStartDate":{
            "title":"Start Date",
            "type":"string",
            "description":"The date when task is scheduled to start.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Labor Resource Assignments

Type: array

Title: Labor Resource Assignments

The labor resource assignment includes attributes used to store values while creating or updating labor resource assignments for a project task. For example, a DBA may be assigned as a labor resource for a project task.

Show Source

• Array of: object projectsUsers-ProjectTasks-LaborResourceAssignments-item-response

{
    "title":"Labor Resource Assignments",
    "type":"array",
    "description":"The labor resource assignment includes attributes used to store values while creating or updating labor resource assignments for a project task. For example, a DBA may be assigned as a labor resource for a project task.",
    "items":{
        "$ref":"#/components/schemas/projectsUsers-ProjectTasks-LaborResourceAssignments-item-response"
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : Project Task Followers

Type: array

Title: Project Task Followers

The task follower resource is used to store values while adding or removing followers on project tasks. A project user can be assigned as a follower on a project task for viewing task details and tracking its completion.

Show Source

• Array of: object projectsUsers-ProjectTasks-TaskFollowers-item-response

{
    "title":"Project Task Followers",
    "type":"array",
    "description":"The task follower resource is used to store values while adding or removing followers on project tasks. A project user can be assigned as a follower on a project task for viewing task details and tracking its completion.",
    "items":{
        "$ref":"#/components/schemas/projectsUsers-ProjectTasks-TaskFollowers-item-response"
    }
}

Nested Schema : projectsUsers-ProjectTasks-LaborResourceAssignments-item-response

Type: object

Show Source

• DisplayName: string
  Title: Name

  Read Only: true

  Maximum Length: 240

  The name of the resource assigned to the task.
• ElementVersionId: integer (int64)
  Read Only: true

  The unique identifier of the element version of the task.
• Email: string
  Title: Email

  Read Only: true

  Maximum Length: 240

  The e-mail address of the resource.
• LaborResourceAssignmentId: integer (int64)
  Read Only: true

  The unique identifier of the resource assignment on the task.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• Phone: string
  Title: Phone

  Read Only: true

  Maximum Length: 240

  The telephone number of a resource.
• PrimaryResource: string
  Read Only: true

  Indicates whether a resource is the primary resource on the task.
• Quantity: number
  Title: Planned Effort in Hours

  Read Only: true

  The number of hours that the resource is assigned to work on a task.
• ResourceAllocationPercent: number
  Title: Resource Allocation Percentage

  Read Only: true

  The percentage of total time that resources are planned to work on the task they are assigned to.
• ResourceId: integer (int64)
  Read Only: true

  The unique identifier of the resource assigned to the task.
• TaskId: integer (int64)
  Read Only: true

  The unique identifier of the task.

{
    "type":"object",
    "properties":{
        "PrimaryResource":{
            "type":"string",
            "description":"Indicates whether a resource is the primary resource on the task.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "ResourceAllocationPercent":{
            "title":"Resource Allocation Percentage",
            "type":"number",
            "description":"The percentage of total time that resources are planned to work on the task they are assigned to.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "Email":{
            "title":"Email",
            "maxLength":"240",
            "type":"string",
            "description":"The e-mail address of the resource.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskId":{
            "type":"integer",
            "description":"The unique identifier of the task.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "ResourceId":{
            "type":"integer",
            "description":"The unique identifier of the resource assigned to the task.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "Phone":{
            "title":"Phone",
            "maxLength":"240",
            "type":"string",
            "description":"The telephone number of a resource.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "ElementVersionId":{
            "type":"integer",
            "description":"The unique identifier of the element version of the task.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "DisplayName":{
            "title":"Name",
            "maxLength":"240",
            "type":"string",
            "description":"The name of the resource assigned to the task.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "Quantity":{
            "title":"Planned Effort in Hours",
            "type":"number",
            "description":"The number of hours that the resource is assigned to work on a task.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "LaborResourceAssignmentId":{
            "type":"integer",
            "description":"The unique identifier of the resource assignment on the task.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18",
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : link

Type: object

Show Source

• href: string
  Title: hyperlink reference

  The URI to the related resource.
• kind: string
  Title: kind

  Allowed Values: [ "collection", "item", "describe", "other" ]

  The kind of the related resource.
• name: string
  Title: name

  The name of the link to the related resource.
• properties: object properties
• rel: string
  Title: relation

  Allowed Values: [ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]

  The name of the relation to the resource instance. Example: self.

{
    "type":"object",
    "properties":{
        "kind":{
            "title":"kind",
            "type":"string",
            "description":"The kind of the related resource.",
            "enum":[
                "collection",
                "item",
                "describe",
                "other"
            ]
        },
        "rel":{
            "title":"relation",
            "type":"string",
            "description":"The name of the relation to the resource instance.  Example: self.",
            "enum":[
                "self",
                "lov",
                "parent",
                "canonical",
                "child",
                "enclosure",
                "action",
                "custom"
            ]
        },
        "name":{
            "title":"name",
            "type":"string",
            "description":"The name of the link to the related resource."
        },
        "href":{
            "title":"hyperlink reference",
            "type":"string",
            "description":"The URI to the related resource."
        },
        "properties":{
            "type":"object",
            "properties":{
                "changeIndicator":{
                    "type":"string",
                    "description":"Change indicator or the ETag value of the resource instance."
                }
            }
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• changeIndicator: string
  Change indicator or the ETag value of the resource instance.

{
    "type":"object",
    "properties":{
        "changeIndicator":{
            "type":"string",
            "description":"Change indicator or the ETag value of the resource instance."
        }
    }
}

Nested Schema : projectsUsers-ProjectTasks-TaskFollowers-item-response

Type: object

Show Source

• DisplayName: string
  Title: Name

  Read Only: true

  Maximum Length: 240

  The name of projects user.
• ElementVersionId: integer (int64)
  Read Only: true

  The unique identifier of the element version of the task.
• Email: string
  Title: Email

  Read Only: true

  Maximum Length: 240

  The e-mail address of the resource.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• Phone: string
  Title: Phone

  Read Only: true

  Maximum Length: 240

  The telephone number of the projects user.
• ResourceId: integer (int64)
  Read Only: true

  Unique identifier of the resource assigned to the task.
• TaskFollowerId: integer (int64)
  Read Only: true

  The unique identifier of the task follower.

{
    "type":"object",
    "properties":{
        "Email":{
            "title":"Email",
            "maxLength":"240",
            "type":"string",
            "description":"The e-mail address of the resource.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "ResourceId":{
            "type":"integer",
            "description":"Unique identifier of the resource assigned to the task.",
            "format":"int64",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "ElementVersionId":{
            "type":"integer",
            "description":"The unique identifier of the element version of the task.",
            "format":"int64",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "Phone":{
            "title":"Phone",
            "maxLength":"240",
            "type":"string",
            "description":"The telephone number of the projects user.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "DisplayName":{
            "title":"Name",
            "maxLength":"240",
            "type":"string",
            "description":"The name of projects user.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "TaskFollowerId":{
            "type":"integer",
            "description":"The unique identifier of the task follower.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18",
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Links

LaborResourceAssignments

Operation: /fscmRestApi/resources/11.13.18.05/projectsUsers/{ResourceId}/child/ProjectTasks/{ProjectTasksUniqID}/child/LaborResourceAssignments

Parameters:

• ProjectTasksUniqID: $request.path.ProjectTasksUniqID
• ResourceId: $request.path.ResourceId

The labor resource assignment includes attributes used to store values while creating or updating labor resource assignments for a project task. For example, a DBA may be assigned as a labor resource for a project task.

TaskFollowers

Operation: /fscmRestApi/resources/11.13.18.05/projectsUsers/{ResourceId}/child/ProjectTasks/{ProjectTasksUniqID}/child/TaskFollowers

Parameters:

• ProjectTasksUniqID: $request.path.ProjectTasksUniqID
• ResourceId: $request.path.ResourceId

The task follower resource is used to store values while adding or removing followers on project tasks. A project user can be assigned as a follower on a project task for viewing task details and tracking its completion.

Back to Top

Examples

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

curl -i -u "<username>:<password>" -X PATCH https://<host>:<port>/fscmRestApi/resources/latest/projectsUsers/<ResourceId>/child/ProjectTasks/<ProjElementId>

Example of Request Header

The following shows an example of the request header.

{
"TaskRemainingQuantity" : 60,
"ObjectType" : "PJF_TASKS",
"ElementType" : "EXECUTION"
}

Example of Response Body

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

{
  "TaskName" : "Task  4",
  "ProjElementId" : 300100090030088,
  "ObjectType" : "PJF_TASKS",
  "ElementType" : "EXECUTION",
  "ExecutionDisplaySequence" : 400000,
  "ElementVersionId" : 300100090030086,
  "ProjectId" : 300100090030066,
  "TaskActualFinishDate" : null,
  "TaskActualStartDate" : null,
  "TaskPlannedFinishDate" : null,
  "TaskPlannedStartDate" : null,
  "TaskPriority" : null,
  "TaskPercentComplete" : 0,
  "ProjectName" : "Tet schedule mode",
  "TaskDescription" : "Manual in both",
  "TaskProposedFinishDate" : null,
  "TaskProposedStartDate" : null,
  "TaskProgressStatus" : "Not started",
  "TaskQuantity" : 8,
  "TaskProposedQuantity" : 8,
  "TaskRemainingQuantity" : 8,
  "TaskResourceAllocationPercent" : 100,
  "ProjectStatusName" : "Active_1",
  "ProjectStatusCode" : "ACTIVE",
  "ProjectSystemStatusCode" : "ACTIVE",
  "PlanVersionId" : 300100090030071,
  "TaskPrimaryResourceId" : 300100024326655,
  "TaskProgressStatusCode" : "NOT_STARTED",
  "TaskProgressEnteredDate" : null,
  "ParentTaskName" : "Tet schedule mode",
  "MilestoneFlag" : false,
  "TaskExceptions" : null,
  "TaskId" : 300100090030088,
  "TaskActualQuantity" : 0,
  "TaskCurrentActualQuantity" : 8,
  "TaskCurrentFinishDate" : null,
  "TaskCurrentStartDate" : null,
  "LastUpdatedBy" : "ABRAHAM.MASON",
  "LastUpdateDate" : "2017-01-03T21:16:30-08:00",
  "CreatedBy" : "ABRAHAM.MASON",
  "CreationDate" : "2017-01-03T21:16:30-08:00",
  "links" : [ 
...
     {
    "rel" : "child",
    "href" : "https://slc11iiy.dev.oraclecorp.com:10606/projectsManagementApi/resources/11.1.13/projectsUsers/300100024326655/child/ProjectTasks/00030000000EACED00057708000110F07F4368080000000EACED00057708000110F07F4368070000000EACED00057708000110F07F43683B/child/LaborResourceAssignments",
    "name" : "LaborResourceAssignments",
    "kind" : "collection"
  }, 
		...
]
}

Back to Top