Optional Uptake of New Features (Opt-In) Update 19A
Optional Uptake of New Features (Opt-In) Update 19A
Optional Uptake of New Features (Opt-In) Update 19A
2
OPTIONAL UPTAKE OF NEW FEATURES (OPT-IN)
The features in the table below were originally delivered Disabled. That is, the features required you to take
action in the Opt-In UI to enable for end users (plus possibly take additional setup or configuration steps).
Column A shows when these features were originally delivered.
Beginning in the update version specified in Column B, these features will no longer require the Opt-In UI to
enable for end users. However, you may still need to take additional setup or configuration steps to enable the
feature, per Column C. If additonal customer action is still required to enable, click on the feature name to get
more information.
Important Note: If you have already enabled these features in the Opt–In UI then NO further action is
necessary.
UPDATE 19A
REVISION HISTORY
This document will continue to evolve as existing sections change and new information is added. All updates
appear in the following table:
OVERVIEW
This guide outlines the information you need to know about new or improved functionality in this update, and
describes any tasks you might need to perform for the update. Each section includes a brief description of the
feature, the steps you need to take to enable or begin using the feature, any tips or considerations that you
should keep in mind, and the resources available to help you.
GIVE US FEEDBACK
We welcome your comments and suggestions to improve the content. Please send us your feedback
at oracle_fusion_applications_help_ww_grp@oracle.com.
3
OPTIONAL UPTAKE OF NEW FEATURES (OPT-IN)
We continue to add many new features to the Oracle Cloud Applications, and for some features, you can take
advantage of new functionality at a pace that suits you by “opting in” to the feature when you’re ready. You can
opt-in to a feature in two ways: by using the New Features work area, or by using the Setup and Maintenance
work area.
1. Click the Navigator, and then click New Features (under the My Enterprise heading).
2. On the New Features page, select the offering that includes new features you’d like to review.
3. Click Opt-In for any feature that you want to opt-in to.
4. On the Edit Features page, select the Enable option for the feature, and then click Done.
4
FEATURE SUMMARY
Column Definitions:
Customer Action Required = You MUST take action before these features can be used by END USERS. These features are delivered disabled and you choose if and when
to enable them. For example, a) new or expanded BI subject areas need to first be incorporated into reports, b) Integration is required to utilize new web services, or c) features
must be assigned to user roles before they can be accessed.
New Features Delivered Ready to Use New Features That Customer Must Take Action to
(Delivered Enabled) Use (Delivered Disabled)
Reports plus Small Scale UI or Process-Based new features Not disruptive as action is required to make these features
will have minimal user impact after an update. Therefore, ready to use. As you selectively choose to leverage, you
customer acceptance testing should focus on the Larger set your test and roll out timing.
Scale UI or Process-Based* new features.
UI or UI or
Process-Based: Process-Based:
Feature Report Small Scale Larger Scale* Customer Action Required
COMMON TECHNOLOGY AND USER EXPERIENCE
REST APIs for Oracle PPM Cloud
Project Foundation
Manage Project Templates Using a REST Service
View Project Roles Using a REST Service
View and Add Resources to Planning Resource
Breakdown Structures at the Project Level Using a
REST Service
Project Control
Manage Financial Project Plan Using a REST Service
View and Create Project Forecasts Using a REST
Service
Project Costing
5
New Features Delivered Ready to Use New Features That Customer Must Take Action to
(Delivered Enabled) Use (Delivered Disabled)
Reports plus Small Scale UI or Process-Based new features Not disruptive as action is required to make these features
will have minimal user impact after an update. Therefore, ready to use. As you selectively choose to leverage, you
customer acceptance testing should focus on the Larger set your test and roll out timing.
Scale UI or Process-Based* new features.
UI or UI or
Process-Based: Process-Based:
Feature Report Small Scale Larger Scale* Customer Action Required
Manage Unprocessed Project Costs Using a REST
Service
Project Billing
Release Invoices Using a REST Service
Grants Management
Manage Awards Using a REST Service
Project Resource Management
Manage Project Resource Assignments Using a REST
Service
Manage Project Resource Requests Using a REST
Service
Search and Evaluate Resources Using a REST Service
Manage Issues and Action Items Using a REST Service
Project Management
Update and Delete Project Enterprise Resources Using
a REST Service
View Project Labor and Expense Resources Using a
REST Service
Add Tasks to Projects with a Work Plan Template
Using the Projects REST Service
Create and Update Tasks Within a Project Plan Using
REST Service
ORACLE PPM CLOUD
Project Foundation
Search Projects Using Faceted Search in Project
Financial Management
6
New Features Delivered Ready to Use New Features That Customer Must Take Action to
(Delivered Enabled) Use (Delivered Disabled)
Reports plus Small Scale UI or Process-Based new features Not disruptive as action is required to make these features
will have minimal user impact after an update. Therefore, ready to use. As you selectively choose to leverage, you
customer acceptance testing should focus on the Larger set your test and roll out timing.
Scale UI or Process-Based* new features.
UI or UI or
Process-Based: Process-Based:
Feature Report Small Scale Larger Scale* Customer Action Required
Gain Real-Time Insight from Analyses Using Project
Team Member Dimension
Manage External Project Party Contacts Efficiently
Project Control
Manage Project Forecast Lines Descriptive Flexfields
Using File-Based Data Import
Manage Financial Project Plan Resource Assignment
Descriptive Flexfields Using File-Based Data Import
Manage Project and Award Budget Lines Descriptive
Flexfields Using File-Based Data Import
Automatically Update Tolerance Percentage and Date
Rate Type on Control Budgets
Enhance Financial Plan Approval to Support Additional
Integrations
Project Costing
Capture the Cost of the Goods Shipped on a Project
Sales Order
Project Billing
Create Project Cost Analysis Based on the Project
Contract Association
Use Additional Bill Plan Attributes with Real-Time
Analysis
Validate Invoice Approval from the Worklist,
Notifications, and Email
Recalculate Released Invoices During Generate
Invoice
7
New Features Delivered Ready to Use New Features That Customer Must Take Action to
(Delivered Enabled) Use (Delivered Disabled)
Reports plus Small Scale UI or Process-Based new features Not disruptive as action is required to make these features
will have minimal user impact after an update. Therefore, ready to use. As you selectively choose to leverage, you
customer acceptance testing should focus on the Larger set your test and roll out timing.
Scale UI or Process-Based* new features.
UI or UI or
Process-Based: Process-Based:
Feature Report Small Scale Larger Scale* Customer Action Required
Allow Updates to Associated Projects with Billing
Transactions
Amend Internal Billing for an Interproject Contract Line
Improved Usability for Contract Revenue Overview
Page
Task Management
Set User Preferences on PPM Mobile
Grants Management
Allow Negative Funding Amount for Supplement
Funding
Project Management
Generate Public Events on Project Milestone
Completion
Generate Public Events on Project Deliverable Status
Changes
Generate Public Events on Project Task Progress
Status Changes
Track Task for Change Orders
Quickly Add Resources to a Project
Define Project Roles with Limited Actions for Managing
Resources on a Project
8
COMMON TECHNOLOGY AND USER EXPERIENCE
PROJECT FOUNDATION
You can review payload examples for the Project Templates and child resources in the REST API for Oracle
Project Portfolio Management Cloud guide.
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
You can view and create the project template header as well as child entities listed above using the
respective REST resource.
Other child entities for the project template will be available in the upcoming releases.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
ROLE INFORMATION
Project Application Administrator (ORA_PJF_PROJECTS_APPLICATION_ADMINISTRATOR_JOB)
Project Integration Specialist (ORA_PJF_PROJECT_INTEGRATION_SPECIALIST_JOB)
The project role field is used when adding project related parties to projects and project templates for both
project financial management and project management work areas.
9
You can review payload examples for the Project Templates and child resources in the REST API for Oracle
Project Portfolio Management Cloud guide
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
You can review payload examples for the Planning Resource Breakdown Structures for Projects and child
resources in the REST API for Oracle Project Portfolio Management Cloud guide.
10
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
You can view the details of the planning resource breakdown structure (PRBS) assigned to a project and
the selected resource formats for the PRBS using the Planning Resource Breakdown Structures for
Projects and Formats resources respectively.
You can view and add new resources to the non-centrally controlled PRBS using the Elements resource.
A non-centrally controlled PRBS has the "Allow Resource Changes at Project Level" option enabled in
the PRBS definition.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
ROLE INFORMATION
Project Application Administrator (ORA_PJF_PROJECTS_APPLICATION_ADMINISTRATOR_JOB)
Project Integration Specialist (ORA_PJF_PROJECT_INTEGRATION_SPECIALIST_JOB)
Project Manager (ORA_PJF_PROJECT_MANAGER_JOB)
Project Administrator (ORA_PJF_PROJECT_ADMINISTRATOR_JOB)
Principal Investigator (ORA_PJF_PRINCIPAL_INVESTIGATOR_JOB)
Grants Administrator (ORA_PJF_GRANTS_ADMINISTRATOR_JOB)
Grants Department Administrator (ORA_PJF_GRANTS_DEPARTMENT_ADMINISTRATOR_JOB)
PROJECT CONTROL
11
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
You can view the current working versions of financial project plans using the financialProjectPlans resource.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide.
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
You can use the following finders to quickly perform searches on the projectForecasts resource:
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide.
12
PROJECT COSTING
You can view unprocessed project costs that belong to both predefined and third-party transaction sources
using the unprocessedProjectCosts resource. Additionally, you can view the unprocessed project costs that
belong to unreleased expenditure batches.
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
13
Expenditure Type
Expenditure Organization
Contract Number
Funding Source Number
Billable
Capitalizable
Work Type
Quantity
Unit of Measure
Original Transaction Reference
Comment
Transaction Currency
Raw Cost in Transaction Currency
Burdened Cost in Transaction Currency
Raw Cost in Provider Ledger Currency
Burdened Cost in Provider Ledger Currency
Provider Ledger Currency Conversion Rate Type
Provider Ledger Currency Conversion Date Type
Provider Ledger Currency Conversion Date
Provider Ledger Currency Conversion Rate
Provider Ledger Currency Conversion Rounding Limit
Raw Cost Debit Account
Raw Cost Credit Account
Burden Cost Debit Account
Burden Cost Credit Account
Burdened Cost Debit Account
Burdened Cost Credit Account
Reversed Original Transaction Reference
Converted
Unmatched Negative Transaction
Nonlabor Resource
Nonlabor Resource Organization
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
ROLE INFORMATION
Project Integration Specialist (ORA_PJF_PROJECT_INTEGRATION_SPECIALIST_JOB)
Project Accountant (ORA_PJF_PROJECT_ACCOUNTANT_JOB)
Grants Accountant (ORA_PJF_GRANTS_ACCOUNTANT_JOB)
PROJECT BILLING
14
You can review payload examples for the Release Project Contract Invoice resources in the REST API for
Oracle Project Portfolio Management Cloud guide.
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
GRANTS MANAGEMENT
Child resources:
Award Attachments,
Award Budget Periods
Award Certifications
Award CFDAs
Award Department Credits
Award Descriptive Flexfields
Award Funding Sources
Award Fundings
Award Keywords
Award Personnel
Award Projects
Award References
Award Terms
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
15
ROLE INFORMATION
The REST service endpoint is protected by the GMS_MANAGE_AWARD_SERVICE_PRIV. Add this to your
custom roles to gain access.
You can create multiple project resource assignments at once using the batch mode of this REST service.
You can review payload examples for the Project Resource Assignment resource in the REST API for Oracle
Project Portfolio Management Cloud guide.
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
If you need to update an existing record and you want to clear a value in a field, you can pass the payload
attribute with null value. If you do not want to change the value of the field, you do not need to pass that
attribute itself in the payload.
Example:
"Comment" : null
will update the request with clearing the text from the Comment field on the
existing record.
It will only update the Location and not touch the Comment or any other field on the record.
16
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
Resource Description
You can review payload examples for the Project Resource Requests and child resources in the REST API for
Oracle Project Portfolio Management Cloud guide.
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
If you need to update an existing record and you want to clear a value in a field, you can pass the payload
attribute with null value. If you do not want to change the value of the field, you do not need to pass that
attribute itself in the payload.
17
Example:
"ProjectRoleName" : null
will update the request with clearing the Project Role on the existing record.
It will only update the Request Name and not touch they project role or any other field on the record.
KEY RESOURCES
Related Help Topic: See the REST API for Oracle Project Portfolio Management Cloud guide.
ROLE INFORMATION
The REST service endpoint is protected by the privilege Manage Project Resource Requests
(PJR_MANAGE_PROJECT_RESOURCE_REQUESTS_PRIV). Add this to your custom roles to gain
access.
This is a unique REST service where you get the search results once you pass Request ID to the service. There
is no create, update, or delete operation allowed via this REST service.
You can use this service to get the list of resources that meet the search criteria given on a request. The search
results are sorted based on the overall score of the resources returned. Any new user interface where you want
to display resources based on the search results can call this service to get the resources.
You can review payload examples for the Project Resource Request Matches resource in the REST API for
Oracle Project Portfolio Management Cloud guide.
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
18
TIPS AND CONSIDERATIONS
The search takes in the Request ID and searches based on the search criteria already saved on the request.
The service does not take in additional search criteria.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
When using the rest service you can set parameters to query the resource such as issue number, status, and
project ID .
KEY RESOURCES
Related Help Topic: See the REST API for Oracle Project Portfolio Management Cloud guide.
ROLE INFORMATION
Project Application Administrator (ORA_PJF_PROJECTS_APPLICATION_ADMINISTRATOR_JOB)
Project Integration Specialist (ORA_PJF_PROJECT_INTEGRATION_SPECIALIST_JOB)
Team Collaborator (ORA_PJF_TEAM_COLLABORATOR_ABSTRACT)
PROJECT MANAGEMENT
This feature extends the project managers ability to quickly update labor resources and overall manage project
planning. Project managers will be able to update non HCM Linked project enterprise labor resources.
Consider the following attributes when updating a project enterprise labor resource.
19
PATCH:
URL: https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/projectEnterpriseLaborResource
/<ResourceUniqueId>
Request:
"FirstName": "Mark",
"LastName": "Manson",
"Email": "mark.manson@oracle.com",
"FromDate": "2018-12-10",
"ToDate": "2019-12-10",
"PhoneNumber": 9861098610,
"ManagerEmail": "Dennis.Patterson@Oracle.com",
"BillRate": 100,
"BillRateCurrencyCode": "USD",
"CostRate": 200,
"CostRateCurrencyCode": "USD",
"ManageResourceStaffingFlag": true,
"PoolMembershipFromDate": "2018-12-10"
Request:
"FromDate": "2013-08-13",
"ToDate": "2029-12-10",
"PhoneNumber": 9861098610,
20
"CalendarName": "PJT Standard US Calendar",
"ManagerEmail": "Dennis.Patterson@Oracle.com",
"BillRate": 100,
"BillRateCurrencyCode": "USD",
"CostRate": 200,
"CostRateCurrencyCode": "USD"
DELETE :
URL: https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/projectEnterpriseLaborResource
/<ResourceUniqueId>
=================================================
PATCH:
URL: https://your_organization.com:port/fscmRestApi/resources/11.13.18.05
/projectEnterpriseExpenseResources/<ResourceID>
Request:
DELETE:
URL: https://your_organization.com:port/fscmRestApi/resources/11.13.18.05
/projectEnterpriseExpenseResources/<ResourceID>
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
KEY RESOURCES
Related Help: REST API for Oracle Project Portfolio Management Cloud guide
21
ROLE INFORMATION
This feature enables the project managers to quickly view labor and expense resources with various statuses on
projects using external applications thus increasing the ability to better plan resources on projects. You can use
many attributes to view project labor and expense resources such as:
Expense Resource ID
Labor Resource ID
Resource Status
projectLaborResources GET
URL : {{local}}/projectLaborResources
Response Payload :
"items": [
"ProjectId": 300100169662966,
"ProjectRoleId": 300100025498083,
"DefaultStaffingOwnerFlag": null,
"ResourceId": 300100023180799,
"Email": "prj_george_white_in_grp@oracle.com",
"ProjectResourceAssignmentId": null,
"CreatedBy": "Connor.Horton",
"CreationDate": "2018-12-14T18:02:45.205+00:00",
"LastUpdatedBy": "Connor.Horton",
"LastUpdateDate": "2018-12-14T18:02:48.309+00:00",
"Allocation": 100,
22
"LaborEffort": null,
"AssignmentStatusCode": "PLANNING_ONLY",
"AssignmentStatus": "Planned",
"LaborBillRate": null,
"LaborCostRate": null,
"FromDate": "2018-12-24",
"ToDate": null,
"ProjResourceId": 300100169662997,
"ProjectCurrencyCode": "USD",
"links": [
"rel": "self",
"href": "https://fuscdrmsmc265-fa-ext.us.oracle.com:443/fscmRestApi/resources/11.13.18.05
/projectLaborResources/300100169662997",
"name": "projectLaborResources",
"kind": "item",
"properties": {
"changeIndicator":
"ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000
},
"rel": "canonical",
"href": "https://fuscdrmsmc265-fa-ext.us.oracle.com:443/fscmRestApi/resources/11.13.18.05
/projectLaborResources/300100169662997",
"name": "projectLaborResources",
"kind": "item"
},
23
SAMPLE PAYLOAD FOR PROJECT EXPENSE RESOURCES
projectExpenseResources GET
URL : {{local}}/projectExpenseResources
Response Payload:
"items": [
"ProjectId": 300100059404520,
"ResourceId": 300100033414519,
"ExpenseAmount": 20000,
"CreatedBy": "Mark.Otbi",
"CreationDate": "2015-03-20T12:46:53.148+00:00",
"LastUpdatedBy": "Mark.Otbi",
"LastUpdateDate": "2015-03-20T12:52:39.903+00:00",
"ProjResourceId": 300100059404546,
"ProjectCurrencyCode": "USD",
"links": [
"rel": "self",
"href": "https://fuscdrmsmc265-fa-ext.us.oracle.com:443/fscmRestApi/resources/11.13.18.05
/projectExpenseResources/300100059404546",
"name": "projectExpenseResources",
"kind": "item",
"properties": {
"changeIndicator":
"ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A657
87000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F7818738020001490005
76616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
},
"rel": "canonical",
24
"href": "https://fuscdrmsmc265-fa-ext.us.oracle.com:443/fscmRestApi/resources/11.13.18.05
/projectExpenseResources/300100059404546",
"name": "projectExpenseResources",
"kind": "item"
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
ROLE INFORMATION
Project Application Administrator (ORA_PJF_PROJECTS_APPLICATION_ADMINISTRATOR_JOB)
Project Integration Specialist (ORA_PJF_PROJECT_INTEGRATION_SPECIALIST_JOB)
ADD TASKS TO PROJECTS WITH A WORK PLAN TEMPLATE USING THE PROJECTS REST
SERVICE
Add tasks to an existing project from a work plan template using the Projects REST Service. For example, after
you create a project from a sales opportunity, each line on the opportunity needs a corresponding set of tasks
in the project to complete the work. You can use a service to create the project from the sales opportunity, and
then incrementally add tasks to automate the creation of the project's complete work breakdown structure.
This feature enables the project managers to quickly create tasks from the work plan template from external
systems thus increasing project planning efficiency.
Use the custom operation "addTasksFromWorkplanTemplate" to add tasks from work plan templates to your
projects. You can create tasks from work plan templates as peer tasks or child tasks to the reference task. Here
is the sample payload to create tasks from the work plan template “Report Design and Test” with task prefix as
“RDT” as child tasks to task "DESIGN" in a project:
"name" : "addTasksFromWorkplanTemplate",
"parameters":
"taskNumberPrefix": "RDT",
"referenceTaskNumber":"DESIGN",
"isPeer":"false"
25
STEPS TO ENABLE
You must uptake the REST service change in any integrations to leverage this new feature. Review the
changes to the Projects service, and update your REST client. Existing use of the service is not impacted.
In order to create tasks directly under the project root task, do not pass any reference task number in
the payload.
You can specify either a valid Work Plan Template ID or Work Plan Template Name in the payload to
create tasks from a work plan template. Optionally, you can also specify task number prefix for the tasks
created from the work plan template.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
ROLE INFORMATION
Project Manager (ORA_PJF_PROJECT_MANAGER_JOB)
The user must also be a project manager or a custom project manager of the project in order to
have data access to the project information (data privilege:
PJT_MANAGE_PROJECT_WORK_PLAN_DATA).
CREATE AND UPDATE TASKS WITHIN A PROJECT PLAN USING REST SERVICE
Create and update tasks, gates, and milestones as a project manager using the Project Plans REST service.
You can also use this service to read extensible fields for projects.
You can use many attributes to create and update project task such as:
Task Description
Task Name
Changing a task to Billable
SAMPLE PAYLOAD
/projectPlans/{projectID}/child/Tasks
/projectPlans/{projectID}/child/Tasks
/projectPlans/{projectID}/child/Tasks/{taskID}
{ "PhysicalPercentComplete": 25}
26
STEPS TO ENABLE
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
KEY RESOURCES
Related Help Topic: REST API for Oracle Project Portfolio Management Cloud guide
ROLE INFORMATION
Manage Project Work Plan (ORA_PJT_MANAGE_PROJECT_WORK_PLAN_DATA)
PROJECT FOUNDATION
Allow users to search projects using faceted search in Project Financial Management, and provide additional
navigation functionalities to project related pages such as a list of recently accessed projects.
Key enhancements:
27
STEPS TO ENABLE
You must opt in to enable this feature. For instructions, refer to the Optional Uptake of New Features section of
this document.
ROLE INFORMATION
Anyone that has access to the Project Financial Management work area, and My Projects page will have
access to this functionality.
GAIN REAL-TIME INSIGHT FROM ANALYSES USING PROJECT TEAM MEMBER DIMENSION
Create reports using Oracle Transactional Business Intelligence (OTBI) by the project team member dimension
to provide business users with real-time insight into project team membership data.
28
With the new Project Team Member dimension, you can build reports focused around custom or pre-defined
project roles.
STEPS TO ENABLE
You can add the new Project Team Member dimension to your existing analyses or create new analyses that
use the broader Project dimension. For details about creating and editing reports, see the Creating and
Administering Analytics and Reports for PPM guide.
KEY RESOURCES
Subject Areas for Oracle Project Portfolio Management Real-Time Analyses: Overview in the Creating
and Administering Analytics and Reports for PPM guide
29
Available Dimensions for Oracle Project Portfolio Management Subject Areas: Overview in the Creating
and Administering Analytics and Reports for PPM guide
ROLE INFORMATION
Project Manager (ORA_PJF_PROJECT_MANAGER_JOB)
Project Administrator (ORA_PJF_PROJECT_ADMINISTRATOR_JOB)
30
Add Internal Team Members Only In the Team Members Region
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
If you are using REST services with your Oracle Cloud implementation for the first time, then follow the
instructions in the Quick Start section of the REST API for Oracle Project Portfolio Management Cloud guide.
Click the Customer, Partner or Supplier Contact to View the Contact Details
31
KEY RESOURCES
Project Customers: Explained in the Defining and Managing Financial Projects guide
FAQ: What's a partner organization? in the Defining and Managing Financial Projects guide
ROLE INFORMATION
Project Manager (ORA_PJF_PROJECT_MANAGER_JOB)
Project Administrator (ORA_PJF_PROJECT_ADMINISTRATOR_JOB)
PROJECT CONTROL
STEPS TO ENABLE
Download and review the latest import template in the File-Based Data Import for Oracle Project Portfolio
Management Cloud guide. To prepare and import data using the template, follow the instructions in the
Instructions and CSV Generation tab within the template.
KEY RESOURCES
Related Help Topic: File-Based Data Import for Oracle Project Portfolio Management Cloud guide
32
STEPS TO ENABLE
Download and review the latest import template in the File-Based Data Import for Oracle Project Portfolio
Management Cloud guide. To prepare and import data using the template, follow the instructions in the
Instructions and CSV Generation tab within the template.
KEY RESOURCES
Related Help Topic: File-Based Data Import for Oracle Project Portfolio Management Cloud guide
MANAGE PROJECT AND AWARD BUDGET LINES DESCRIPTIVE FLEXFIELDS USING FILE-
BASED DATA IMPORT
Capture additional information on project and award budget lines when you create or import project and award
budgets using the Import Project Budgets file-based data import feature. You can use up to 30 alphanumeric
descriptive flexfield attributes to capture this additional information.
STEPS TO ENABLE
Download and review the latest import template in the File-Based Data Import for Oracle Project Portfolio
Management Cloud guide. To prepare and import data using the template, follow the instructions in the
Instructions and CSV Generation tab within the template.
KEY RESOURCES
Related Help Topic: File-Based Data Import for Oracle Project Portfolio Management Cloud guide
Update the tolerance percentage and default rate type in the Budgetary Control Settings tab of the Budget
Creation Details section on the Edit Budget page.
33
Default Rate Type and Tolerance Percentage Options on the Edit Budget Page
STEPS TO ENABLE
You can set or update these options for budget versions that belong to financial plan types that are enabled for
budgetary controls.
KEY RESOURCES
Related Help Topic: Creating Control Budgets: Points to Consider in the Defining and Managing
Financial Projects guide
The payload for the ApprovePlanVersion BPM task now includes the details of the current baseline budget
versions and current approved forecast versions of a project.
34
Payload Attributes for All Current Baselined Project Budget Versions
35
Payload Attributes for All Current Approved Project Forecast Versions
STEPS TO ENABLE
To integrate the approval process of project budget and forecast versions with other budget or
forecast versions originating from third party or other Oracle applications, perform the following steps:
36
KEY RESOURCES
Budgets and Forecasts: How They Are Copied from Project Templates or Projects in the Defining and
Managing Financial Projects guide
Manage Project Budgets and Forecasts in the Defining and Managing Financial Projects guide
FAQs for Manage Project Budgets and Forecasts in the Defining and Managing Financial Projects guide
ROLE INFORMATION
Project Manager (ORA_PJF_PROJECT_MANAGER_JOB)
Project Administrator (ORA_PJF_PROJECT_ADMINISTRATOR_JOB)
PROJECT COSTING
Create a sales order under Order Management work area, add project details to the sales order line. This
information will be available as part of the transaction imported into Project Portfolio Management (PPM).
Sales Order
Once the item is shipped and the transaction is accounted by Cost Management, you can import Sales Order
Issue transactions into PPM using the Import Costs process available in Project Costing. This is the integration
point between Project Costing and Cost Management.
37
After the transaction is imported into PPM, you can perform budget versus actual costs analysis, including the
cost of goods shipped against a project sales order. View the transaction detail by using the Manage Project
Costs page that is available in the Costs and the Project Management work areas. Use the view menu to add
Sales Order Number and Shipment Number details to identify the transaction source.
Sales Order references can also be viewed in the Manage Unprocessed Costs page, and you can search by
Sales Order Number or Shipment Number on the Manage Cost Distributions page.
Open the Expenditure Item to have a complete overview of the transaction, including the Source Document
Details. You can also create an analysis in OTBI using the Sales Order Issue Details available in Project
Costing - Actual Costs Real Time subject area.
38
The Accounting Period Close Exceptions Report processes also give visibility to the Sales Order Issue
transactions that are pending to be imported into PPM. You can either view the Sales Order Issue details in the
Accounting Period Close Exceptions output report or through an analysis in OTBI using Projects - Period Close
Exceptions subject area.
Project Exceptions
Invoice your customer using project contract invoicing based on the percentage of completion or milestones
achieved on the project. You can follow the billing process that is currently available in Project Billing.
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
39
TIPS AND CONSIDERATIONS
The Expenditure Item Date of the Sales Order Issue transaction is the Shipment Date.
PPM receives the cost of the item as defined in Manufacturing Costing.
PPM does not support billing by material item and service item, such as coverages and subscriptions.
Drop shipment, Back to Back processing for project sales order lines are not supported.
KEY RESOURCES
Defining an Additional Segment in the Cost Collection Flexfield in the Applications Help
Oracle Supply Chain Management Cloud Using Order Management Guide
ROLE INFORMATION
Project Accountant (ORA_PJF_PROJECT_ACCOUNTANT_JOB)
Grants Accountant (ORA_PJF_GRANTS_ACCOUNTANT_JOB)
Project Manager (ORA_PJF_PROJECT_MANAGER_JOB)
Project Costing Transaction Analysis Duty
(FBI_PROJECT_COSTING_TRANSACTION_ANALYSIS_DUTY)
PROJECT BILLING
The following dimensions have been added to the Project Costing - Actual Costs Real Time subject area:
STEPS TO ENABLE
Add attributes from the associated project contract header and detail dimensions in BI analytics where you
want to view the expenditure item detail based on the contract lines associated to the project and task on the
expenditure item.
KEY RESOURCES
Related Help Topic: Creating and Administering Analytics and Reports for PPM guide
40
The following screenshot shows how you can add the descriptive flexfields in the Additional Information area of
a Bill Plan to an analysis:
Descriptive Flexfields in the Projects - Cross Subject Area Analysis - Real Time
STEPS TO ENABLE
1. Select the BI Enabled check box in setup on the Edit Segment page to enable bill plan descriptive
flexfields for reporting.
2. Run the Import Oracle Fusion Data Extensions for Transactional Business Intelligence process.
3. Add the descriptive flexfield to your existing reports or create new reports.
41
KEY RESOURCES
Define Transactional Business Intelligence Configuration: Overview in the Creating and Administering
Analytics and Reports for PPM guide
Importing Changes to Flexfields Automatically: Procedure in the Creating and Administering Analytics
and Reports for PPM guide
Creating and Administering Analytics and Reports for PPM guide
STEPS TO ENABLE
This makes the recalculate action consistent, whether you perform it from the Manage Project Cost, Manage
Invoices, or Edit Invoice page. It also makes the adjustment processing consistent, since the Generate Invoice
process is performing the recalculation in its entirety.
STEPS TO ENABLE
Previously when you recalculated an invoice, invoice line, or transaction on a released or higher status invoice
already adjusted, the results were not always accurate, depending on the exact keystrokes you made.
KEY RESOURCES
Related Help Topic: Editing Invoice Transactions: Points to Consider in the Using Project Revenue and
Billing guide
ROLE INFORMATION
Project Billing Specialist (ORA_PJF_PROJECT_BILLING_SPECIALIST_JOB)
42
ALLOW UPDATES TO ASSOCIATED PROJECTS WITH BILLING TRANSACTIONS
You can inactivate the association of projects and tasks with a contract line that has billing transactions. You
can also associate a task at a different level within the same branch of task hierarchy for the same contract line
or a different contract line.
When you amend a contract and inactivate an association of projects and tasks with a contract line, you
inactivate the association for both the new under amendment version as well as the previously active version of
the contract. This prevents you from inadvertently generating invoice or revenue adjustments against the now
inactive project and task association.
Inactive associations doesn't prevent the creation of new associations at a different level within the same branch
of task hierarchy for the same contract line or a different contract line.
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
Inactivating the association of projects and tasks with a contract line updates the projects and tasks
associations for a previously active version to inactive. This prevents revenue and invoice generation of the
transactions that were created for the associated projects or tasks whose association is now inactive.
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
43
Offering: Project Financial Management
When you amend internal billing attributes on an interproject contract line, you don't affect the billing amount of
previously generated internal invoices. Therefore, no transactions with transaction dates on or after the
contract amendment effective date are marked for adjustment processing.
1. Mass adjust the applicable expenditure items to put them on invoice hold.
2. Run the Generate Invoice process to create credit memos to reverse the original interproject invoices.
3. Process the credit memos to released status.
4. Mass adjust the same expenditure items to remove the invoice hold.
5. Run the Generate Invoice process to create new interproject invoices, using the newly amended internal
billing attribute values.
ROLE INFORMATION
Customer Contract Administrator (ORA_OKC_CUSTOMER_CONTRACT_ADMINISTRATOR_JOB)
Customer Contract Manager (ORA_OKC_CUSTOMER_CONTRACT_MANAGER_JOB)
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
As part of the enhancement to improve the Contract Revenue Overview page response time, the fields in the
Totals section in the Exceptions region have been removed.
ROLE INFORMATION
This enhancement is available to all roles and users given access to the Revenue Overview work area.
44
TASK MANAGEMENT
STEPS TO ENABLE
1. Search for Oracle PPM Cloud Mobile in the Google Play or Apple App Store to find the application.
2. Ensure that user has Projects Time Entry Profile for their time card.
This feature is enabled by giving users the Project Time Entry Mobile Duty. This duty has all the privileges
needed to access PPM and HCM rest services. The duty is rolled-up to the employee and contingent worker
abstract roles out of the box.
Project Name, Task Name, and Expenditure type fields when capturing time
Ensure the logged in user can enter and submit time on the web application (Navigator > About Me > Time >
Manage Time Cards > Create Time Card)
45
KEY RESOURCES
Release Training for Oracle Project Portfolio Management Cloud Release 13: Oracle Project Costing
Cloud Enhancements: Mobile Time Capture
ROLE INFORMATION
Employee (ORA_PER_EMPLOYEE)
Contingent Worker (ORA_PER_ CONTINGENT_WORKER)
GRANTS MANAGEMENT
Adding Funding
46
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
1. Select the BI Enabled check box in setup on the Edit Segment page to enable bill plan descriptive
flexfields for reporting.
2. Run the Import Oracle Fusion Data Extensions for Transactional Business Intelligence process.
3. Add the descriptive flexfield to your existing reports or create new reports.
When you add a negative amount to an award, ensure that there is enough funding allocated to the award,
projects, budget, and other award related entities. The application performs a check to ensure that the reduced
amount is not lesser than the existing allocated amount, based on existing spending rules such as expanded
authority.
For example, if there is a base funding amount of $50,000 allocated to an award for a budget period, one
cannot decrease by more than $50,000, and likewise if $20,000 of the $50,000 is allocated to a project or
budgeted, one cannot decrease the funding amount by more than $30,000.
Other considerations:
When an Award is under Expanded authority, the total funding across budget periods needs to remain
positive. Otherwise the funding amounts within each budget period must remain positive.
Check the decrease against your budgeted amount, amount allocated to the project.
KEY RESOURCES
Related Help Topic: Adding Funding to an Award: Procedure topic in the Using Grants Management
guide
ROLE INFORMATION
Grants Administrator (ORA_PJF_GRANTS_ADMINISTRATOR_JOB)
Principal Investigator (ORA_PJF_PRINCIPAL_INVESTIGATOR)
Grants Department Administrator (ORA_PJF_GRANTS_DEPARTMENT_ADMINISTRATOR_JOB)
PROJECT MANAGEMENT
You can use the public business event to orchestrate your business processes based on milestone completion.
For example:
47
Raise a Business Event on Milestone Completion
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
KEY RESOURCES
Related Help Topic: Project Milestone Event in the Using Project Execution Management guide
ROLE INFORMATION
Project Application Administrator (ORA_PJF_PROJECTS_APPLICATION_ADMINISTRATOR_JOB)
You can use the public business event to orchestrate your business processes based on deliverable status or
priority changes. For example you can create a notification to the owners of associated tasks when a deliverable
is set to Complete status.
48
Raise a Business Event on Project Deliverable Status Changes
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
KEY RESOURCES
ROLE INFORMATION
Project Application Administrator (ORA_PJF_PROJECTS_APPLICATION_ADMINISTRATOR_JOB)
You can use the public business event to orchestrate your business processes based on task progress status
changes. For example:
49
Create a notification to resources on successor tasks when a task moves to Complete status.
Create a notification to the project manager anytime a task moves backwards in status, such as from
Complete to In Progress.
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
KEY RESOURCES
ROLE INFORMATION
Project Application Administrator (ORA_PJF_PROJECTS_APPLICATION_ADMINISTRATOR_JOB)
50
TRACK TASK FOR CHANGE ORDERS
You can associate a task to the change order. Allowing project managers the capability to track tasks for
change orders helps in better reporting and detailed analysis of change orders. For example, you can report on
new, approved, and rejected change orders by task in a project.
You can associate a task from the change order details page and view the task information on the Manage
Change Orders page. This feature also allows you to search or sort the change orders by task.
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
51
Offering: Project Execution Management
KEY RESOURCES
Related Help Topic: Change Orders: Explained in the Using Project Execution Management guide
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
52
TIPS AND CONSIDERATIONS
The project manager navigates to the Manage Project Resources page to add a project resource and can
add multiple resources continuously. The project manager does not need to leave the Add Project
Resource dialog box as the resource is displayed in the foreground of the Manage Project Resources page.
ROLE INFORMATION
Project Manager (ORA_PJF_PROJECT_MANAGER_JOB)
You can create a set of project manager roles that provide differential access to the resources. The same user
may have different access on different projects. For example, an individual can be the senior project manager
on one project with complete access and be the assistant project manager on another project with limited or no
ability to edit project resources on the Manage Project Resources page.
Assign Project Managers with Different Levels Access for Managing Resources on a Project
STEPS TO ENABLE
Use the Opt-In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section
of this document.
Add attributes from the associated project contract header and detail dimensions in BI analytics where you want
to view the expenditure item detail based on the contract lines associated to the project and task on the
expenditure item.
53
appropriate functional and data security policies. In particular, you must add the Manage Project Work
Plan Resource Assignments Data privilege to these roles where appropriate.
Security changes apply to both the card and list views on the Manage Project Resources page.
The ability for a project manager to directly confirm a resource or edit a confirmed resource is available
only to users with a role that includes the Assign Project Resource to Project and Assign Project
Resource to Project Data privileges. This set of privileges is not new and unchanged with this feature,
but included here to provide a complete picture of the security options available for managing resources.
Use case examples:
Add Resource
Manage Project Edit Project Team Update
Assistant Project Manager
Resource Assignment Members for Project Delete
Replace Resource
Add Resource
Update
Delete
Replace Resource
Create Resource
Request
View Resource
Request Details
Manage Project View Assignment
Manage Project Details
Senior Project Manager Resource Assignment
Resource Assignment Request Extension
Data
Cancel
Assignment
Search (in case of
placeholder
resources)
Manage Project
Resource
Requests (panel
drawer link)
KEY RESOURCES
Project Roles in Project Execution Management Applications: Explained in the Implementing Project
Execution Management guide
See the guide Security Reference for Oracle PPM Cloud on Oracle Help Center
54
ROLE INFORMATION
Project Manager (ORA_PJF_PROJECT_MANAGER_JOB)
Project Execution (ORA_PJF_PROJECT_EXECUTION_ABSTRACT)
---
55
Copyright © 2019, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as
expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or
display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.
S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use,
duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation,
shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous
applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all
appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC
International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The
Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not
responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between
you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or
services, except as set forth in an applicable agreement between you and Oracle.
56