Project Task Version 2
Service to operate on a project task and maintain the project related data. A Project represents the effort and resources required to achieve a significant business objective within a specific, usually finite, time frame. Projects are used to plan, track, manage and control both the financial aspects and the work effort required.
Life Cycle Status: Active
QName: {http://xmlns.oracle.com/apps/projects/foundation/projectDefinition/publicService/maintainProjectV2/}ProjectTaskService
Service WSDL URL: https://servername/fscmService/ProjectTaskServiceV2?WSDL
Logical Business Objects
-
Projects : Project Foundation : Project
Relationships
The following table describes how this service data object is related to other service data objects or business object services.
| Relationship Type | Object or Service |
|---|---|
|
Handles |
|
|
Handles |
|
|
Handles |
|
|
Handles |
|
|
Handles |
|
|
Handles |
|
|
Handles |
|
|
Handles |
|
|
Handles |
|
|
Handles |
|
|
Handles |
Operations
getTasksRead
Retrieves all tasks for the selected project.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
projectInParamList |
Project Task Search Criteria Version 2 |
Project that tasks are retrieved for. |
|
lastUpdateDate |
{http://xmlns.oracle.com/adf/svc/types/}dateTime-Timestamp |
Date when the task was last updated. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the tasks matching the criteria. |
getLowestLevelTasksRead
Retrieves lowest-level tasks for the selected project.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
projectInParamList |
Project Task Search Criteria Version 2 |
Project that tasks are retrieved for. |
|
lastUpdateDate |
{http://xmlns.oracle.com/adf/svc/types/}dateTime-Timestamp |
Date when the task was last updated. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the lowest-level tasks matching the criteria. |
setProjectPlanBaseline
Sets a baseline for the project plan of the selected project.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
projectId |
long |
Identifier of the project. |
|
autoBaselineBdgt |
string |
Specifies whether to automatically create a baseline version when generating the budget. |
|
finPlanTypeId |
long |
Identifier of the financial plan type used to generate a budget version when setting a baseline for the project plan. |
|
genBdgtDuringBsln |
string |
Specifies whether to generate a budget when setting a baseline for the project plan. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the status, success or failure, of the operation. |
CheckTasksForDelete
Verifies whether specified tasks can be deleted.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
projectName |
string |
Name of the project. |
|
productCode |
string |
Specifies the third-party application from which the project originates. |
|
ProjectKey |
string |
Project key of the project. |
|
TaskKey |
string |
Task key of the selected task. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the status, success if task can be deleted, or failure if otherwise. |
DeleteTask
Deletes tasks on the selected project.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
projectName |
string |
Name of the project. |
|
productCode |
string |
Specifies the third-party application from which the project originates. |
|
ProjectKey |
string |
Project key of the project containing the task to be deleted. |
|
TaskKey |
string |
Task key of the selected task. |
|
TaskNumber |
string |
Task number of the selected task. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the status, success or failure, of the operation. |
UpdateTask
Updates tasks on the selected project.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
project |
Project Detail Update Criteria Version 2 |
Attributes of a project, such a project name, project ID, and project number. |
|
tasks |
Task Detail Update Criteria Version 2 |
Attributes of the tasks to be updated, including task name, task number, and task ID. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the status, success if task is updated, or failure if otherwise. |
UpdateFinancialTaskStructure
Updates selected tasks for a project.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
project |
Project Detail Update Criteria Version 2 |
Attributes of a project, such a project name, project ID, and project number. |
|
tasks |
Task Detail Update Criteria Version 2 |
Attributes of the tasks to be updated, including task name, task number, task description, and task ID. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the status, success if task is updated, or failure if otherwise. |
CreateTask
Creates tasks on the selected project.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
project |
Project Detail Update Criteria Version 2 |
Attributes of a project, such a project name, project ID, and project number. |
|
tasks |
Task Detail Update Criteria Version 2 |
Attributes of the tasks to be created, including task name, task number, task description, and task ID. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the status, success or failure, of the operation. |
CreateFinancialTaskStructure
Creates tasks for a project.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
project |
Project Detail Update Criteria Version 2 |
Attributes of a project, such a project name, project ID, and project number. |
|
tasks |
Task Detail Update Criteria Version 2 |
Attributes of the tasks to be added to the project plan, including task name, task number, task description, and task ID. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the status, success or failure, of the operation. |
getTaskStructureServicePropertyPaths
Gets the service property.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
productType |
string |
Value of product type. |
|
segmentCodes |
string |
List of segment codes. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
string |
Returns the task structure service property path. |
getTaskStructureServiceNamespaceAndName
Gets the service name.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
productType |
string |
Value of product type. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
string |
Returns the task structure service namespace and name. |
getTaskStructureProductTypeServicePropertyPath
Gets the Product Type Service.
Life Cycle Status: Active
Request Payload
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
string |
Returns the task structure product type service property path. |
getTask
Retrieves a task on the project plan.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
projElementId |
long |
Identifier of the project task element. |
|
projectId |
long |
Identifier of the project. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the tasks matching the criteria. |
findTask
Finds a task on the project plan.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
findCriteria |
{http://xmlns.oracle.com/adf/svc/types/}FindCriteria |
Criteria used to filter query results. |
|
findControl |
{http://xmlns.oracle.com/adf/svc/types/}FindControl |
Reserved for future use. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the task matching the criteria. |
findTaskByProjectNumberNameWBSNumberTaskNameNumber
Retrieves tasks with specified attributes.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
findCriteria |
{http://xmlns.oracle.com/adf/svc/types/}FindCriteria |
Criteria used to filter query results. |
|
projectNumber |
string |
Number of the project. |
|
projectId |
long |
Identifier of the project. |
|
projectName |
string |
Name of the project. |
|
wbsNumber |
string |
The outline number of the task. |
|
taskName |
string |
Name of the task. |
|
taskNumber |
string |
Task number of the selected task. |
|
findControl |
{http://xmlns.oracle.com/adf/svc/types/}FindControl |
Reserved for future use. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the first task matching the criteria. |
updateTaskStructureDff
Updates Task Structure descriptive flexfields (DFF).
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
taskStructure |
Project Task Structure Version 2 |
Descriptive flexfields attributes of the tasks to be updated. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
Returns the status, success if task is updated, or failure if otherwise. |
getDfltCtrlHints
Retrieves user interface hints, such as the service data object label and object attribute labels, for the specified service data object and locale. As a prerequisite, invoke the getEntityList operation defined on this service to get the list of possible values for the viewName request payload element.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
viewName |
string |
The service view usage name, an internal name for the service data object. Specify the value of the element from the getEntityList operation response payload. |
|
localeName |
string |
The locale to use when evaluating locale-based user interface hints. The localeName is in ISO 639-1 format. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
{http://xmlns.oracle.com/adf/svc/types/}AttrCtrlHints |
Returns the label and user interface hints for the specified service data object and its attributes in a name-value pair format. |
getDfltObjAttrHints
Retrieves object attribute hints, such as the service data object label and object attribute labels, for the specified service data object and locale. As a prerequisite, invoke the getEntityList operation defined on this service to get the list of possible values for the viewName request payload element.
Life Cycle Status: Active
Request Payload
| Element Name | Type | Description |
|---|---|---|
|
viewName |
string |
The service view usage name, an internal name for the service data object. Specify the value of the element from the getEntityList operation response payload. |
|
localeName |
string |
The locale to use when evaluating locale-based user interface hints. The localeName is in ISO 639-1 format. |
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
{http://xmlns.oracle.com/adf/svc/types/}ObjAttrHints |
Returns the label and user interface hints for the specified service data object and its attributes in a name-value pair format. |
getServiceLastUpdateTime
Reserved for future use.
Life Cycle Status: Active
Request Payload
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
{http://xmlns.oracle.com/adf/svc/types/}dateTime-Timestamp |
Returns the date and time when the service definition last changed in ISO 8601 format. |
getEntityList
Gets the list of service data objects defined on this service.
Life Cycle Status: Active
Request Payload
Response Payload
| Element Name | Type | Description |
|---|---|---|
|
result |
{http://xmlns.oracle.com/adf/svc/types/}ServiceViewInfo |
Returns a list of service data objects defined on this service. For each service data object, the result includes the QName, internal name, and Boolean values indicating whether create, update, merge, and delete operations can be performed on the object. |
Security
The following tables list the privileges required to perform the service operations, and the duty roles that each privilege is granted to.
Service Operations to Privileges Mapping
| Operation Name | Privilege Code | Privilege Name | Privilege Description |
|---|---|---|---|
|
All Operations |
PJF_MANAGE_PROJECT_TASK_STRUCTURE_PRIV |
Manage Project Task Structure for Billable Tasks |
Allows creation, update, and deletion of billable project tasks and task attributes. |
Privileges to Duty Roles Mapping
| Privilege Code | Granted to Duty Role Code | Granted to Duty Role Name | Granted To Duty Role Description |
|---|---|---|---|
|
PJF_MANAGE_PROJECT_TASK_STRUCTURE_PRIV |
ORA_PJF_PROJECT_TEAM_MEMBER_ABSTRACT |
Project Team Member |
Identifies the person assigned to a project as a team member to perform specific roles and functions for that project. |
|
PJF_MANAGE_PROJECT_TASK_STRUCTURE_PRIV |
ORA_PJO_PROJECT_PLAN_MANAGEMENT_DUTY |
Project Plan Management |
Creates, edits, and deletes task assignments and views project progress. |
|
PJF_MANAGE_PROJECT_TASK_STRUCTURE_PRIV |
ORA_PJF_PROJECT_DEFINITION_DUTY |
Project Definition |
Edits project and task attributes. |