Administering Planning Modules
Administering Planning Modules
Administering Planning Modules
E94267-20
Oracle Cloud Administering Planning Modules,
E94267-20
Copyright © 2016, 2020, 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.
Contents
Documentation Accessibility
Documentation Feedback
1 Welcome
Introduction 1-1
About Financials 1-2
About Workforce 1-2
About Projects 1-3
About Capital 1-4
About Strategic Modeling 1-4
Learning More 1-5
iii
Getting Descriptions of the Predefined Artifacts 4-3
5 Configuring Financials
Enabling Financials Features 5-1
About the Financials Chart of Accounts 5-2
Enabling Revenue and Gross Margin 5-3
Enabling Expense 5-3
Enabling Income Statement 5-4
Enabling Balance Sheet 5-4
Enabling Cash Flow 5-4
Enabling Rolling Forecast 5-5
Enabling Weekly Planning 5-6
Enabling 53-Week Planning 5-7
Enabling Map/Rename Dimensions 5-8
Associating Custom Dimensions with Financials Features 5-8
About the Internal Aggregation Rules 5-9
About the Account and Plan Element Dimensions 5-9
Configuring Financials 5-10
Planning and Forecast Preparation 5-11
Weekly Configurations 5-12
Setting Global Assumptions: Exchange Rates 5-13
About Exchange Rates and Weekly Planning 5-14
About Adding and Modifying Accounts and Drivers 5-14
Adding and Managing Accounts and Drivers 5-14
Adding KPIs 5-15
Adding Accounts for Integration with Projects 5-15
Adding Custom Expense Driver Categories 5-16
Post Configuration Tasks 5-16
Specifying Days in Period for Driver-Based Balance Sheet 5-16
Modifying Account Signage for Alternate Reporting Methods 5-16
Financials Rules 5-17
6 Configuring Workforce
Enabling Workforce Features 6-1
Identifying the Level of Workforce Detail to Capture 6-4
Enabling Map/Rename Dimensions 6-5
Configuring Workforce 6-5
Planning and Forecast Preparation 6-11
About Adding and Modifying Accounts and Drivers 6-11
iv
Adding and Managing Accounts and Drivers 6-12
Setting Global Assumptions: Exchange Rates 6-12
Configuring Benefits, Taxes, and Additional Earnings 6-13
Before You Use the Benefits and Taxes Wizard 6-13
About the Benefits and Taxes Wizard 6-14
Common Properties for the Components 6-14
Component Types in the Wizard 6-15
About One-time Pay Options 6-16
About Maximum Value Type 6-16
About Earning Type 6-17
About Taxable Component 6-17
About Entering Rates 6-17
About Rates and Threshold Scope 6-17
Applying Rates by Hierarchy 6-18
Calculations in a 13-Period Calendar 6-18
Creating Custom Calculation Logic in a Component 6-19
After Configuring Using the Wizard 6-24
Example - Adding a Fringe Benefit 6-24
Post Configuration Tasks 6-27
Setting Assumptions 6-27
Setting Defaults 6-28
Synchronizing Defaults 6-29
Post Update Tasks 6-29
Workforce Rules 6-31
Performance Considerations with Workforce Rules 6-32
7 Configuring Projects
Enabling Projects Features 7-1
Enabling Project Type 7-3
Enabling Project Revenue 7-3
Enabling Project Benefits 7-3
Enabling Project Expense 7-4
Enabling Rolling Forecast 7-5
Enabling Map/Rename Dimensions 7-6
Configuring Projects 7-6
Planning and Forecast Preparation 7-8
About Adding and Modifying Accounts and Drivers 7-9
Adding and Managing Accounts and Drivers 7-10
Setting Global Assumptions: Exchange Rates 7-11
Entering Global Project Rates 7-11
v
Post Configuration Tasks 7-12
Mapping Projects to Programs 7-12
Projects Rules 7-12
8 Configuring Capital
Enabling Capital Features 8-1
Enabling New Capital Investment 8-2
Enabling Manage Existing Assets 8-2
Enabling Map/Rename Dimensions 8-2
Configuring Capital 8-3
Planning and Forecast Preparation 8-5
About Adding and Modifying Accounts and Drivers 8-6
Adding and Managing Accounts and Drivers 8-7
Setting Global Assumptions: Exchange Rates 8-7
Post Configuration Tasks 8-8
Capital Rules 8-8
Creating a Custom Depreciation or Amortization Method 8-10
vi
Integrating Data Between Strategic Modeling and Financials 9-18
Managing Metadata with Model Change Management 9-20
Defining Target Models for Model Change Management 9-21
Defining Metadata to Copy with Model Change Management 9-22
Copying Metadata from Source to Target 9-25
Editing or Deleting a Model Change Management Definition 9-25
A Business Scenarios
IT Financial Management in EPM Cloud A-1
Configuring Planning Modules for IT Planning A-7
B Importing Data
About Importing Data B-2
Importing Financials Data B-2
Importing Workforce Data B-4
Loading and Calculating Incremental Workforce Data B-6
Preparing the Source Data File B-7
Configuring the Incremental File Adapter in Data Management B-8
Deciding Which Workforce Rules to Add B-12
Executing an Incremental Workforce Data Load B-13
Importing Projects Data B-14
Importing Capital Data B-32
C Updating Artifacts
Updating Workforce Artifacts to Use New Features C-1
vii
Updating Capital Artifacts C-12
viii
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=docacc.
Access to Oracle Support
Oracle customers that have purchased support have access to electronic support
through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/
lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs
if you are hearing impaired.
ix
Documentation Feedback
Documentation Feedback
To provide feedback on this documentation, send email to [email protected],
or, in an Oracle Help Center topic, click the Feedback button located beneath the
Table of Contents (you may need to scroll down to see the button).
Follow EPM Information Development on these social media sites:
LinkedIn - http://www.linkedin.com/groups?gid=3127051&goback=.gmp_3127051
Twitter - http://twitter.com/hyperionepminfo
Facebook - http://www.facebook.com/pages/Hyperion-EPM-Info/102682103112642
YouTube - https://www.youtube.com/oracleepminthecloud
x
1
Welcome
Related Topics
• Introduction
• Learning More
Introduction
Planning provides five complete, planning and budgeting solutions for Financials,
Workforce, Capital, Projects, and Strategic Modeling. They include built-in best
practice predefined content including forms, calculations, dashboards, drivers, and key
performance indicators (KPIs). You can get up and running quickly by enabling only
the features you need, and later enable additional features to enhance your
application. You can integrate to plan at the detail level you need. Configurable help
provides default descriptions for forms and members, which you can customize for
your business needs.
• Financials— Enhance your ability to manage and analyze finances at any
business level using driver or trend-based income statement, balance sheet, and
cash flow planning, or simply plan revenue and expenses. With the best practice,
out of box key performance indicators, drivers, and accounts, Financials
accelerates your planning process. See About Financials.
• Projects— Bridge the gap between project planning systems and the financial
planning process. Assess the impact organizational projects and initiatives have
on overall corporate resources and ensure they align with short and long term
financial targets. See About Projects.
• Workforce—Headcount and compensation planning to link financial plans with the
workforce plan. Budget for future headcount and related personnel expenses such
as salary, benefits, and taxes. See About Workforce.
• Capital— Planning for the long-term impact of capital assets on financial plans.
Manage, prioritize, and plan for capital expenses. See About Capital.
• Strategic Modeling—For long-term strategic planning, this solution combines a set
of rich financial forecasting and modeling features with built in on-the-fly scenario
analysis and modeling capabilities. See About Strategic Modeling.
Watch this overview video to learn more.
Overview Video
Watch this overview video to learn how to enable, configure, and maintain the
application.
Overview Video
After you enable features, predefined artifacts are created including:
1-1
Chapter 1
Introduction
About Financials
Financials delivers tools to help you quickly develop plans and forecasts, and generate
core financial statements such as balance sheets, cash flow statements, and income
statements for internal analysis. Financials provides these components that you can
enable incrementally to best meet your business needs:
• Revenue / Gross Margin
• Expense
• Balance Sheet
• Cash Flow
• Income Statement
• Analysis
Financials integrates with Capital, Workforce, and Projects so that planners can create
very granular plans, forecasts, and financial reports that include different types of data.
Watch this overview video to learn more about Financials.
Overview Video
About Workforce
Workforce enables planners to align critical corporate resources—people and dollars
—with the strategies that best leverage a competitive advantage. Using Workforce,
departments collaborate to plan headcount and related expenses such as salaries,
health care, bonuses, and taxes. Planners can see up-to-date graphics that show
expenses and trends.
Depending on the features that you enable, planners can manage and track
headcount expenses by:
• Analyzing, calculating, and reporting on headcount, salary, bonuses, taxes, and
health care expenses
• Planning for hires, transfers, promotions, terminations, and so on
• Defining country-appropriate taxes and benefits
To integrate corporate strategy with execution, enable the Strategic Workforce
option. Strategic Workforce enables Human Resource departments to plan long-
1-2
Chapter 1
Introduction
range headcount and required skills. Planners can analyze future demands on the
workforce by exploring scenarios that impact those demands.
Tip:
To augment your workforce strategies, see Administering and Working with
Oracle Strategic Workforce Planning Cloud.
You can enable Workforce stand-alone, or integrate it with Financials and Projects.
See Integration Scenarios and Workflow.
You can also align and pull data from Oracle Human Capital Management Cloud,
using Data Management to load data. Data Management provides an out-of-the-box
solution that enables you to apply predefined mappings from the Oracle HCM Cloud
model to target dimensions in Workforce. (See Integrating Oracle HCM Cloud.) You
can also customize and extend these integrations, for example, by applying other
mappings to meet your business needs.
Workforce provides these components that you can enable incrementally to best meet
workforce planning needs:
• Compensation Planning
• Other Expenses
• Demographics
• Analysis
• Strategic Workforce
Watch this overview video to learn more about Workforce.
Overview Video
About Projects
Use Projects to evaluate how assets and resources related to corporate initiatives are
allocated, and analyze their probable return on investment. Projects unifies the
decision-making process between corporate financial planning and project financial
planning processes. Because the approval processes for projects are tied to the
approvals for financial plans and forecasts, Projects ensures agreement between
project sponsors, key stakeholders, and financial decision makers. This aligns project
plans and financial plans with financial targets and corporate long-range financial
plans.
Projects supports several types of projects:
• Indirect, or internal projects—Projects that are run internally by your company,
such as IT, RD, and marketing projects.
• Contract projects—Projects that generate revenue; used for companies such as
engineering companies that make money from contract projects.
1-3
Chapter 1
Introduction
Overview Video
About Capital
Use Capital to manage, prioritize, and plan for capital expenses. Capital helps
decision-makers and front-line managers communicate throughout the request,
justification, review, and approval process. Use Capital to perform tasks such as:
• Perform driver-based calculations to assess the impact of changes and additions
on profit, cash flow, and funding
• Request and approve capital expense plans
• Anticipate the impact to financial statement given transfers, impairments,
retirements, and replacement
Capital provides these components that you can enable incrementally to best meet
your capital planning needs:
• Investments
• Existing Assets
• Intangibles
• Analysis
Watch this overview video to learn more about Capital.
Overview Video
1-4
Chapter 1
Learning More
Overview Video
Learning More
To get more information or help:
• Review best practices and watch tutorial and overview videos by clicking
1-5
2
Setting Up Your Application
Related Topics
• Getting Started Checklist
Perform the tasks in this checklist to set up Capital, Financials, Projects, and
Workforce.
• Creating an Application
Follow these steps to create an application.
• Converting a Standard or Reporting Application to an Enterprise Application
Learn about converting an application in this topic.
• Integration Scenarios and Workflow
Planning uses data maps and Smart Push for out of box integration between
Financials, Workforce, Projects, Capital, and Strategic Modeling. This section
describes the integration scenarios and the overall process for integrating.
• Setting User Variables
• About 13-Period Calendars
Learn about setting up an application's calendar that uses 13 periods instead of 12
months.
2-1
Chapter 2
Getting Started Checklist
detected, they are displayed; you must resolve these errors before features can be
enabled.
5. Configure and run any required rules. See:
• Configuring Capital
• Configuring Financials
• Configuring Projects
• Configuring Workforce
Note:
Because entities are common across all modules, you can
simultaneously import all Entity members.
6. After you configure, and whenever you make configuration changes or import
, and then from the Actions menu, select Refresh Database, then
Create, and then Refresh Database.
7. Set required user variables. See Setting User Variables.
8. Import data. See Importing Data.
9. Create the required user and group accounts and grant permissions. See Getting
Started with Oracle Enterprise Performance Management Cloud for
Administrators.
10. Make the application available to planners. From the Home page, click
Overview Video
2-2
Chapter 2
Creating an Application
Creating an Application
Follow these steps to create an application.
1. If you purchased EPM Cloud before June 4, 2019, log in and click Start under
Finance, click Planning and Budgeting, and then select Enterprise.
If you purchased EPM Standard Cloud Service or EPM Enterprise Cloud Service
after June 4, 2019, log in and click Select under Planning, click Start to create a
Planning business process, and then select Module. For more information, see
New EPM Cloud Services in Getting Started with Oracle Enterprise Performance
Management Cloud for Administrators to get started with the new services.
2. Enter an application name and description and then click Next.
3. Specify this information, noting that only monthly planning is supported.
• Time Period—Select whether to set up the calendar for 12 month or 13 period
planning. For information about planning with 13 periods, see About 13-Period
Calendars.
• Start and End year—Years to include in the application. Make sure to include
the year that contains the historic actuals required for planning and analysis.
For example, for an application beginning in 2020, select 2019 as the start
year so that the latest actuals are available for trending and reporting
purposes.
• For 12 month calendars, select these options:
– First Month of Fiscal Year—Month in which your fiscal year begins
– Weekly distribution—Sets the monthly distribution pattern, based on the
number of fiscal weeks in a month.
• For 13-period calendars, select these options:
– Distribution—Define the distribution of periods within quarters, indicating
which quarter has four periods. (In a 13-period calendar, three quarters
have three periods and one quarter has four periods.)
For example, if you select 3-3-3-4, the additional period is added into the
4th quarter.
– Fiscal Year Ends On— Define the end of the fiscal year by selecting the
Day of the Week, and whether the end of the fiscal year is Last
Occurring in the Fiscal Year or Closest to the Last Day of the Fiscal
Year in the selected month.
– Add Extra Week to Fiscal Period—Select which period should have five
weeks. (With 13-period planning, each period is exactly four weeks long
(except every five or six years, when one period has five weeks.)
These options determine in which year the 53rd week occurs and how system
member formulas are calculated.
For example, if you define the end of the fiscal year as Friday, Last
Occurring in the Fiscal Year, in December, and select 13 for Add Extra
Week to Fiscal Period, the calendar is created with December 27 2019,
which is the last Friday of December in 2019, as the last day of the fiscal year.
Based on this date, subsequent year calendars are set up based on a 13
2-3
Chapter 2
Creating an Application
period calendar, adding the extra week that occurs every few years to the 13th
period.
Based on the selections in this example, FY19 has 52 weeks—13 periods with
four weeks each. FY20 also has only 52 weeks—13 periods with four weeks
each. FY21 has 53 weeks. Because we selected to add the extra week to
period 13, the fifth week is in the last period (November 27 to December 31).
After you create the application, you can preview the calendar and see each
period's dates. To do so, on the Home page, click Application, then
Overview, then Actions, and then 13 Period Preview Calendar. At the top,
you can select the year's calendar to preview. Here is the calendar for FY21
for the example described. Note the fifth week in P13 (November 27 to
December 31):
2-4
Chapter 2
Converting a Standard or Reporting Application to an Enterprise Application
Tutorial Video.
For more information, see About Simplified Multicurrency.
• Prefix—For 13-period applications, define the prefix for time periods. The
default is TP. If you keep the default, time periods are named TP1, TP2, and
so on.
• Name of Input Cube—Name for data entry (block storage) cube. You can’t
later change the cube name.
• Name of Reporting Cube—Name for the reporting (aggregate storage) cube.
You can’t later change the cube name.
• Sandboxes—When you create an application, a block storage cube is
created, which you can enable for sandboxes by selecting the Sandboxes
option.
If you create a custom block storage cube in the application, you can use
sandboxes in that cube. When creating the custom cube, select Enable
Sandboxes. (Sandboxes aren't supported in the cubes created by default for
the modules.) To learn more about setting up and using sandboxes, see
Administering Planning and Working with Planning.
4. Click Next and then click Create.
For additional details about creating applications, see Administering Planning.
3. Open the application, and then click Application , and then Overview
2-5
Chapter 2
Converting a Standard or Reporting Application to an Enterprise Application
Conversion Considerations
You can convert a Standard or Reporting application to an Enterprise application if:
• You are commercially authorized to implement an application of type "Enterprise".
• It does not use weekly, quarterly, or custom time periods.
• You rename the Year dimension to Years prior to converting.
• It uses simplified multicurrency (that is, it's not a standard currency application), if
it's a multicurrency application.
• Artifact names don't use these prefixes:
2-6
Chapter 2
Integration Scenarios and Workflow
Tutorial Video.
Integration Scenarios
Integrate modules to take advantage of these scenarios:
• In Financials, see a rollup of Workforce employee details and integrate Workforce
expenses (such as salary, benefits, and so on) into Financials reporting.
• In Financials, see a rollup of Projects details and integrate project expenses and
revenue into your Financials reporting.
• In Financials, see a rollup of capital asset details and integrate capital asset values
(such as fixed asset values, depreciation, and other asset-related expenses as
well as cash flows) into financial reporting.
• In Workforce, see the utilization of employees across projects or on a per project
basis.
• In Projects, allocate project expenses partially or fully to create one or more capital
assets.
• In Projects, use jobs, employee names, and other assumptions from Workforce for
labor expense planning.
• In Projects, use Equipment Rates from Capital.
• Integrate data between models in Strategic Modeling and income statements in
Financials.
2-7
Chapter 2
Integration Scenarios and Workflow
Note:
To push data between models in Strategic Modeling and income statements
in Financials, see Integrating Data Between Strategic Modeling and
Financials.
Note:
Entities are common across all modules. Ideally, import the entities all at
one time.
If you are integrating Financials with Projects, note that aggregated data
for total projects is pushed to Financials. You do not need to add a
Project dimension in Financials.
2-8
Chapter 2
Integration Scenarios and Workflow
• For integration with Capital, on the Enable page, enable projects of type
Capital.
• For Expense, enable Integration from Workforce, and Employee (for
Workforce integration) and for equipment, Integration from Capital (for
Capital integration).
• If you are integrating Projects with Workforce, you don't need to import
Resource Class in Projects; instead you'll use the Jobs from Workforce using
the Import Job Configuration task in Workforce.
• In Map/Rename Dimensions, you should see a mapping between Project
and Project.
Tip:
If you inadvertently named the custom dimension Projects instead of
Project when you created it in Workforce or Capital, you can rename
it here.
2-9
Chapter 2
Setting User Variables
• Ability to drill through from Financials to Projects for project level financial data
• Assign project benefits for indirect projects to financial impacts for increased
revenue or cost impacts
2-10
Chapter 2
About 13-Period Calendars
Note:
You can create a new application with 13 periods. Creating a new application
with a 13-period calendar requires Hybrid Block Storage to be enabled.
• Legacy Cloud Service customers must request that their environment
be enabled for Hybrid Block Storage (BSO) before they can create a 13-
period application. Submit a Support Request in My Oracle Support.
Once the request is fulfilled, Hybrid Block Storage is enabled
automatically when you create a 13-period application. After the
environment is enabled for hybrid, you can create a new application with
13 periods.
• EPM Enterprise Cloud Service and EPM Standard Cloud Service
Planning business processes are deployed with Hybrid Block Storage
(BSO) cubes by default. For these customers, no additional steps are
required to be able to create a 13-period application.
You can't enable a 13 period calendar for an existing application.
Tip:
If you choose to plan by 13 periods, the application creates periods TP1
through TP13. However, when you create the application, you can rename
the prefix TP. The numbers 1 through 13 are added to the prefix, for
example, P1 through P13. You can also create aliases for Period member
names if you want them to be easier to recognize.
2-11
Chapter 2
About 13-Period Calendars
Note:
The creator of the application sets the period in which the 53rd week is
added in the Add Extra Week to Fiscal Period setting. (This setting can't be
changed later). The application then automatically applies the fifth week in
leap years to the period defined during application creation.
For information on setting up your calendar when creating an application, see Creating
an Application.
Tip:
If you select a 13-period calendar, you can see each period's dates. To do
so, on the Home page, click Application, then Overview, then Actions, and
then 13 Period Preview Calendar. At the top, you can select the year's
calendar to preview. For example:
2-12
Chapter 2
About 13-Period Calendars
2-13
3
Setting up Strategic Modeling
Related Topics
• Getting Started Checklist for Strategic Modeling
3-1
4
Familiarizing Yourself With Planning
Modules
Related Topics
• Navigating
• Reviewing Modified Artifacts
You can check which original application artifacts, such as forms and menus, have
been modified.
• Getting Descriptions of the Predefined Artifacts
Navigating
Useful navigation tips:
• To return to the Home page when you’ve navigated away from it, click the Oracle
logo in the upper left corner (or your custom logo) or the Home icon
.
• To see additional administrator tasks in the Navigator, click the horizontal bars
Maximize .
• In a subcomponent, use the horizontal and vertical tabs to switch tasks and
categories.
For example, use the vertical tabs to switch between reviewing Overview
dashboards and planning Expenses. The vertical tabs differ, depending on the
features that you’ve enabled.
4-1
Chapter 4
Reviewing Modified Artifacts
Use the horizontal tabs to switch categories within a task. For example, in
Expense planning, choose between entering expense drivers and reviewing trend-
based planning expenses.
In Financials and Capital, the icon indicates a reporting form for reviewing
data, not for data entry. The icon indicates that a form is a data entry form for
entering planning details.
4-2
Chapter 4
Getting Descriptions of the Predefined Artifacts
2. Click Filter .
3. From Artifact, select Member or Form.
4. If you selected Member, select Account from the Dimension list.
5. For Property, select Formula Description for member formulas or Description
for form descriptions and click Apply.
6. Select a language from the Add Language list.
Artifacts for the features you’ve enabled are displayed, prefixed with one of the
following:
• OFS — Financials
• OWP — Workforce
• OPF — Projects
• OCX — Capital
Note:
Scroll to the right until you can see the <Language> column.
For information about modifying the description, changing the language, or adding
instructions for planners, see Customizing Help for Predefined Artifacts.
4-3
5
Configuring Financials
This chapter includes these topics:
• Enabling Financials Features
• Configuring Financials
• Post Configuration Tasks
• Financials Rules
Note:
• You must define all custom dimensions the first time you enable
features. You can’t define these later.
• While you can enable more features later, Oracle recommends that you
enable only the features that planners currently require.
• You can’t disable features later.
For information about how provided drivers calculate accounts, see About the Internal
Aggregation Rules and About the Account and Plan Element Dimensions.
Watch this tutorial video to learn more about enabling and configuring Financials.
Tutorial Video
1. From the Home page, click Application , and then click Configure
.
2. From the Configure list, select Financials, and then Enable Features.
3. Select the features to enable.
5-1
Chapter 5
Enabling Financials Features
Enable Description
Revenue / Gross Enable revenue planning. Use your own accounts or select the
Margin provided Accounts and Drivers.
See Enabling Revenue and Gross Margin.
.
Expense Enable expense planning. Use your own accounts or select the
provided Accounts and Drivers.
See Enabling Expense.
Income Statement Enable income statement planning. Use your own format or a
predefined income statement format.
See Enabling Income Statement.
Balance Sheet Enable balance sheet planning. Use your own accounts or select the
provided Accounts and Drivers.
See Enabling Balance Sheet.
Cash Flow Statement Enable cash flow planning and select a method. Use your own chart
of accounts or select the provided Accounts.
See Enabling Cash Flow.
Rolling Forecast Enables rolling forecast for revenue, expense, balance sheet, and
cash flow (depending on what you've enabled) to allow continuous
forecasting beyond a one year timeframe.
See Enabling Rolling Forecast.
Weekly Planning Enables planners to plan and forecast at the weekly level. You can
enable weekly planning at any time. See Enabling Weekly Planning.
Map/Rename • Add up to five custom dimensions to your application.
Dimensions • For each custom dimension, specify to which features it applies
—Revenue, Expense, Balance Sheet, or Cash Flow. See
Associating Custom Dimensions with Financials Features.
• Map custom dimensions to existing dimensions.
• Rename base dimensions.
You must perform this step the first time you enable Financials. You
can’t do it later.
See Enabling Map/Rename Dimensions.
The Financials artifacts are populated, including dimensions, forms, and accounts.
5-2
Chapter 5
Enabling Financials Features
If you initially create your own chart of accounts, you can incrementally enable the
standard, provided chart of accounts.
• To use the provided chart of accounts, select accounts and drivers under each
feature name.
If you choose to use a standard chart of accounts or to use driver-based planning,
select which accounts and drivers to enable. Selecting this option enables a
complete chart of accounts for the selected feature and enables driver-based
planning.
Whether you create your own chart of accounts or use the provided accounts, you
can:
• Use existing forms and dashboards
• Work with existing integrated financial statement
• Use existing calculations, such as trend-based planning
• Integrate Financials with Capital, Projects, and Workforce.
Notes if you are using your own chart of accounts:
• For information about importing the accounts, see Importing Metadata. You can
use the Dimension Editor to see the key accounts provided.
• If you want to use the dashboards that graphically depict total results, you must
add your accounts as shared members under the appropriate parent: OFS_Total
Revenue, OFS_Total Cost of Sales, OFS_Total Operating Expenses,
OFS_Cash. The share can be at the level of detail required for your business.
Other charts and dashboards use the key members that are provided.
Watch these tutorial videos to learn more about enabling and configuring Financials
with your own chart of accounts.
Tutorial Video
Tutorial Video
Enabling Expense
Select Expense to enable Expense planning. Selecting only Expense creates an
account structure with key members for you to add your own chart of accounts for
expense planning. Selecting this option enables direct entry and trend-based planning.
5-3
Chapter 5
Enabling Financials Features
5-4
Chapter 5
Enabling Financials Features
• The Indirect method derives cash flow from Operating, Investing, and Financing
activities. To use this method, you must also enable Income Statement and
Balance Sheet.
Selecting only Cash Flow Statement and a method creates an account structure with
key members for you to add your own chart of accounts for cash flow planning.
Select account categories to add account groups to support cash flow reporting.
Overview Video.
5-5
Chapter 5
Enabling Financials Features
Watch this tutorial video to learn more about planning using a rolling forecast.
Tutorial Video.
5-6
Chapter 5
Enabling Financials Features
Financials. If you enable weekly periods for other cubes and want currency
conversion to work for weekly time periods, you must enter exchange rates for
weekly periods for that cube.
Weekly currency conversion is supported for BSO cubes only. (It is not supported
for ASO cubes even if weekly periods are enabled for ASO cubes.)
• If you are integrating with Capital, Projects, or Workforce, the granularity of the
data in each must match in order to view the integration-related reports.
These batch rules must be run after planning at the weekly level, to convert weeks to
months or months to weeks, and before performing trend calculations if the actuals
data is at a monthly granularity. Give planners access to these rules and instruct them
to run the rules after performing weekly planning:
• Convert Weekly Data to Monthly. You must run this rule before planners can view
monthly data in dashboards.
• Convert Monthly Data to Weekly.
Before you run the rules Prepare Plan, Prepare Forecast, or Prepare Rolling
Forecast, make sure to perform any required conversions from months to weeks or
weeks to months.
Watch this tutorial video to learn more about weekly planning.
Tutorial Video.
5-7
Chapter 5
Enabling Financials Features
5-8
Chapter 5
Enabling Financials Features
Custom dimensions are added to the Page in forms for features to which the custom
dimension applies. For example, if a custom dimension is applicable to Expense only,
it appears on the Page for Expense forms. In forms for other features, such as
Revenue, NoMember for the dimension is on the POV.
You can incrementally associate custom dimensions with additional features after you
first enable Financials.
Watch this tutorial video to learn more about associating custom dimensions with
Financials features.
Tutorial Video.
5-9
Chapter 5
Configuring Financials
Cash Flow Calculated is the result of Cash Flow Direct planning in which planners
define the payment terms used in cash calculations.
Configuring Financials
Perform these steps after enabling Financials features.
1. From the Home page, click Application , and then click Configure
.
2. From the Configure list, select Financials. Use the Filter to check the status of
Configure Description
Planning and Forecast Set the timeframe and granularity for plans.
Preparation Configures the timeframe, the starting period, and the level of
granularity for planning and forecasting. Gives you the ability to plan
and forecast on a different basis for different years.
If you enabled Rolling Forecast, configures the rolling forecast time
periods.
See Planning and Forecast Preparation.
Weekly Configurations You can use this configuration task after you enable weekly planning
to customize the planning granularity for entity and account
combinations.
See Weekly Configurations.
Revenue Accounts, Set up accounts, drivers, and KPIs based on the features you
Expense Accounts, enabled. You can add, modify, import, and export these artifacts. If
Balance Sheet required, you might need to add logic or calculations related to
Accounts, Cash Flow custom accounts and drivers. You can also add custom expense
Accounts driver categories.
See Adding and Managing Accounts and Drivers, Adding KPIs, and
Adding Custom Expense Driver Categories.
5-10
Chapter 5
Configuring Financials
Configure Description
Entities Import Entities.
Import the Entity dimension members that reflect your business
hierarchy, such as departments, cost centers, and business units.
Select the location of the file containing the members (Local or
Planning inbox), click Browse to find the file, specify the file type, and
then click Import.
Tip:
Entities are common across modules,
so import all entities together.
5-11
Chapter 5
Configuring Financials
7. For Financials or Projects: If you enabled Rolling Forecast, click Rolling Forecast
to select the basis for continuous planning. Select the planning frequency (monthly
or quarterly), the number of periods, and the number of actual periods.
For Financials, you can also select a weekly planning frequency and choose
whether to plan at a weekly level for 13, 26, or 52 weeks.
The number of actual periods defines how many time periods of actual data to
show in forms and dashboards in conjunction with the rolling forecast time periods.
The Rolling Forecast Range is updated based on your selections.
If you are using a 12-period calendar with 53 weeks, Rolling Forecast Range is
updated to include Week 53 in ranges that include it.
When you configure rolling forecast, forms and dashboards are set up based on
the planning frequency and number of periods. When you change the current
planning period, the rolling forecast forms and dashboards are updated—time
periods are added or dropped and actuals time periods are updated to reflect the
new rolling forecast range.
You can plan using a combination of standard forecasting and rolling forecasting.
8. If you enabled weekly planning for Financials, specify the current week. You need
to update this value on a weekly basis.
• In 13-period applications, there is a 53rd week every five to six years, based
on the options you selected in Create Application.
• In 12-period applications, on the Plan and Forecast tabs, a 53rd week is
added to the Current Week list in the year and period determined by your
selections when you enabled 53 weeks.
This configuration task sets all required substitution variables.
Weekly Configurations
You can use this configuration task after you enable weekly planning to customize the
planning granularity for entity and account combinations.
When you enable weekly planning, by default all entity and account combinations are
set up for weekly planning. You can specify that some entity/account combinations use
monthly planning. This is useful when most entities use weekly planning, but certain
entities use monthly planning; or when an entity plans at the monthly level except for
certain accounts. For example, Operations might plan at a weekly level, whereas IT
plans at a monthly level. Or, for Sales US, revenue planning is at the weekly level but
expense planning is at the monthly level.
Before you set up weekly configurations, perform Planning and Forecast
Preparation to set the timeframe and granularity for plans. See Planning and Forecast
Preparation.
To set up custom configuration for planning granularity for entities and accounts:
1. From Configure, click Weekly Configurations.
2. In the Entity column, expand the Entities list until you see the entity you want to
modify.
You see entities and accounts only for the features you've enabled.
3. Change the planning granularity for an entity or for entity/account combinations:
5-12
Chapter 5
Configuring Financials
• To switch to monthly planning for an entity and all of the accounts for the
entity, clear the Weekly Planning check box for the entity. To return to weekly
planning for all entities, or all accounts for the selected entity, from the
Actions menu, select Set All Entities as Weekly or Set All Accounts as
Weekly.
• To switch to monthly planning for only some accounts for an entity, in the
Accounts column for the entity you want to change, click the link, expand to
see the accounts you want to change, and clear the Weekly Planning check
box for the account. To return to weekly planning for all accounts for the entity,
from the Actions menu, select Set All Accounts as Weekly.
4. Click Save.
Weekly configuration considerations:
• Forms are updated to display in the granularity you specified for the entity/account
combination.
• Weekly configuration for entities and accounts is supported only for the Plan and
Forecast scenario; it is not supported for the Rolling Forecast scenario.
• All drivers involved in a calculation must be at the same granularity.
• Oracle recommends that all related driver accounts be at the same granularity. For
example, for a particular entity, all Revenue drivers could be weekly and all
Expense drivers could be monthly. But all revenue drivers should be the same
granularity, and all expense drivers should be the same granularity.
• If a parent entity has a combination of weekly and monthly child entities, then you
must launch the Convert Weekly Data to Monthly or Convert Monthly Data to
Weekly rule for each entity before reviewing consolidated data on forms and
dashboards.
• When a form includes both monthly and weekly data, non-valid intersection cells
are not editable.
5-13
Chapter 5
Configuring Financials
Note:
If you add a new Version member, you must enter exchange rates in that
version.
Tutorial Video
See Adding and Managing Accounts and Drivers for more details.
5-14
Chapter 5
Configuring Financials
• To modify a group of artifacts, or to add many new ones, export the set of
predefined artifacts (select Export from the Actions menu), and then modify
the export file in Microsoft Excel. You can edit predefined artifacts, make a
copy of an artifact and modify it to create a new one, or add new artifacts.
Then, import the modified file (select Import from the Actions menu). If
available, use categories and subcategories to group functionally related
artifacts.
• To export or import all drivers, regardless of their category or grouping, use
Batch Export or Batch Import.
• To export or import only certain kinds of drivers, specify a Category or a
Component, and then use Import or Export.
Notes:
• Specify unique member names and aliases for custom members so they don’t
conflict with any provided members.
• If you must delete a driver, check the formulas of the other account drivers in its
group to see if they reference the driver that you want to remove. If they do,
update their logic accordingly.
Adding KPIs
You add and edit KPIs in the same way you add or edit accounts and drivers.
To add or edit KPIs:
1. Check that your KPI member aliases and names don’t conflict with those of the
provided KPIs.
2. From the Configure page, select <Subcomponent> Accounts, and then select
KPIs from the Category list.
3. Perform a task:
• To add a small number of KPIs, select Add from the Actions menu and then
enter details in the new row. Click Edit Formula to enter the formula for
the metric.
• To add a group of KPIs, export the set of predefined KPIs (select Export from
the Actions menu), and then modify the export file in Excel. You can edit
predefined KPIs, make a copy of a KPI and modify it to create a new one, or
add new KPIs. Then, import the modified file (select Import from the Actions
menu).
4. Refresh the database.
5-15
Chapter 5
Post Configuration Tasks
5-16
Chapter 5
Financials Rules
Financials Rules
Run rules to calculate values in the application. From the Home page, click Rules.
Tip:
To see only Financials rules, click All Cubes next to the Filter, and from the
Cube list select OEP_FS.
Financials rules:
• OFS_Calculate Actuals—Calculates drivers and aggregates data. Run this rule
to ensure that you're working with the latest figures and calculations.
• OFS_Calculate Cash Flow—Used for Cash Flow Direct only. Calculates Cash
based on the sources and uses of cash.
• OFS_Prepare Forecast—Copies selected months of Actual results to the
Forecast scenario and recalculates drivers and trends based on the new periods
of actual results. You can also use this rule when rolling over to a new year as the
starting point for a forecast.
• OFS_Prepare Plan—Calculates Plan based on the trends and drivers set up in
the application. Use this to either create or update a plan or use this as a starting
point for rolling over to a new year.
• OFS_Prepare Rolling Forecast—Similar to OFS_Prepare Forecast; use when
the Rolling Forecast feature is enabled.
• OFS_Trend Based Calculation / OFS_Rolling Trend Based Calc—Rules are
run on save for driver and trend forms to calculate accounts based on the selected
trend. OFS_Rolling Trend Based Calc is available only if Rolling Forecast is
enabled.
• OFS_Rollup—Roll up values for any scenario (actual, plan, forecast or rolling
forecast). Run this rule when you want to see values at the top of the dimension
hierarchy.
• OFS_Rollup Project Integration Data / OFS_Clear Project Integration Data—
Use when integrating Financials with Projects.
5-17
6
Configuring Workforce
This chapter includes these topics:
• Enabling Workforce Features
• Configuring Workforce
Tip:
If your company doesn’t use Union Code, you can rename the Union
Code dimension to a dimension that's more meaningful for your
business. You must do so when you first enable features.
Tutorial Video
1. From the Home page, click Application , and then click Configure
.
2. From the Configure list, select Workforce, and then click Enable Features.
Select the features you want to enable. Except as noted, you can come back later
and enable additional features, so enable only the features you need to use now.
6-1
Chapter 6
Enabling Workforce Features
Feature Description
Granularity Select the level of workforce detail to manage:
• Employee—Manage workforce expenses
at the employee-only level.
• Job—Manage job workforce expenses at
the job-only level.
• Employee and Job—Manage workforce
expenses by both employees and jobs.
Note:
You must select
a level of
granularity.
Note:
For integration
with Projects, for
tracking
employee
utilization, the
granularity must
be either Job or
Employee and
Job.
6-2
Chapter 6
Enabling Workforce Features
Feature Description
Headcount Planning Select which headcount-related details to
manage. Headcount Planning options:
• Employee Demographics—Select to
analyze such employee attributes as
veteran status, gender, and age band. If
you want to use Employee
Demographics, you must select it the
first time you enable features.
• Strategic Workforce—Select to align
corporate strategy with execution by
planning long-range headcount and
required skills.
Note:
To enable Strategic
Workforce requires either
Employee and Job or Job
granularity.
6-3
Chapter 6
Enabling Workforce Features
Feature Description
Map/Rename Dimensions • Enable up to three additional custom
dimensions in your application.
• Map custom dimensions to existing
dimensions.
• Rename base dimensions.
You must perform this step the first time you
enable Workforce.
For example, on the first pass, you select the
top-level Headcount Planning checkbox
without selecting options under it (such as
Employee Demographics). Then you later
enable Employee Demographics. You can’t
rename its associated dimensions Age Band,
Gender, and Highest Degree of Education.
If you are integrating Workforce with Projects,
add a custom dimension called Project, the
default dimension name in Projects. If you
name it anything else, make sure the
dimension name is the same in all modules.
Option Description
Employee If you select Employee, the Employee
dimension is added, which stores the
organization's employees. Calculations for
salary and related compensation can be
performed for existing employees or in
planning for new hires. Oracle anticipates that
you import existing employees from a Human
Resources system, such as PeopleSoft.
If you select this option, you must set defaults
for Pay Type (for example, Exempt or Non-
exempt) and Employee Type (Regular,
Contractor, and Temporary). Or, if you don't
use this information, set them to null (the No
<member name>). See Setting Defaults.
Job If you select Job, the Job dimension is added,
which stores the roles assigned to employees.
Examples of jobs: Engineer, Software
Developer, and Mechanic.
If you select this option, you must set defaults
for Pay Type and Skill Set. Or, if you don't use
this information, set them to null (the No
<member name>). See Setting Defaults.
6-4
Chapter 6
Configuring Workforce
Option Description
Employee and Job With this option, the Job dimension is used
with the Employee dimension to facilitate
analysis of roles across the organization, to
track new hire requests, and to identify
employees by role.
If you select this option, you must assign
defaults for Job and Union Code. See Setting
Defaults.
If you don't track Union Codes, when you
enable Workforce, you can use Map/Rename
Dimension to rename Union Code to
something that's meaningful to your business.
If you rename Union Code when enabling
Workforce, you must still assign a default for
the renamed dimension.
Configuring Workforce
Perform these configuration tasks after you’ve enabled Workforce features.
1. From the Home page, click Application , and then click Configure
.
2. From the Configure list, select Workforce.
6-5
Chapter 6
Configuring Workforce
3. Perform all mandatory tasks. Perform the optional tasks required for your
business. Use the Filter to check the status of configuration actions. Use Actions
Configure Description
Component Optional
Import selected Grades, Taxes, Benefits, and
Additional Earnings, which are considered
Workforce components. After importing a
component, configure it with the appropriate
Configure option.
Tip:
You can import
metadata and
data into
components in a
batch file. You
can also use a
template to
import data. See
Importing Data.
Entities Mandatory
Import the Entity dimension members that
reflect your business hierarchy, such as
departments, cost centers, and business units.
Salary Grades Mandatory
Define the salary basis (for example, Annual
or Hourly) and the pay rates for the Salary
Grades that you imported.
Options and Tiers Optional
Set options for Additional Earnings such as
overtime or bonus and for Benefits such as
medical benefit rates. Set tiers for Taxes, such
as employer-paid taxes. After setting options
and tiers, use the Benefits and Taxes Wizard
to configure Additional Earnings, Benefits, and
Taxes.
See Adding and Managing Accounts and
Drivers and Configuring Benefits, Taxes, and
Additional Earnings.
6-6
Chapter 6
Configuring Workforce
Configure Description
Planning and Forecast Preparation Optional
Set the timeframe, the starting period, and the
level of granularity for planning and
forecasting. You can plan and forecast on a
different basis for different years.
See Planning and Forecast Preparation.
Benefits and Taxes Mandatory
Set up Benefits, Taxes, and Additional
Earnings. A component is a tax, a benefit, or
an additional earning. A wizard guides you
through setting up a component with business-
based questions. See Configuring Benefits,
Taxes, and Additional Earnings.
Workforce Assumptions Mandatory
Set default assumptions such as hours worked
per day, week, and year. Also, set the partial
payment factor, which sets the pay percentage
to apply to Maternity status. You can set these
assumptions by Scenario, Version, Entity, and
Currency. For more information, see Setting
Assumptions.
Employee Type Optional
Import more employee types in your
organization as members into the Employee
Type dimension. The provided employee type
members are Regular, Contractor, and
Temporary. This option is available for the
Employee-only level of granularity.
Pay Type Optional
Import pay types in your organization as
members into the Pay Type dimension. The
provided pay types are Exempt and Non-
Exempt. This option is available for the
Employee-only level of granularity.
6-7
Chapter 6
Configuring Workforce
Configure Description
Employee Demographics Optional
Set up employee demographics such as
Highest Education Level. Demographics
enable you to analyze data based on
individual employee characteristics. You can
select, add, import, or export a demographic,
such as ethnic group.
If you enable Employee Demographics,
Workforce provides the Gender, Age Band,
and Highest Education Degree attributes, and
you can add employee demographics such as
veteran status. You typically import
demographic attributes for existing employees,
and planners assign demographics after new
employees are hired.
Workforce provides data maps for reporting on
such information as demographics.
See Adding and Managing Accounts and
Drivers.
Employee Properties Optional
Set up employee properties such as Employee
Type. Add, import, or export properties such
as Skill Set, FT/PT, Start Month, Merit Month,
and Hiring Status. Then to view and edit
employee properties, use Compensation
Planning, then the Manage Employee
Details tab.
See Adding and Managing Accounts and
Drivers.
Non Compensation Expenses Optional
Set up noncompensation expenses such as
training or travel expenses. Add, import, or
export a noncompensation expense. After
noncompensation expenses are added, enter
the data in the form (Other Expenses, and
then Non Compensation Expenses).
See Adding and Managing Accounts and
Drivers.
Performance Metrics Optional
Add, import, export, or delete a performance
metric for a component. For example, add
performance ratings such as Meets
Expectations and Exceeds Expectations.
See Adding and Managing Accounts and
Drivers.
Merit Rates Mandatory
Define merit rates by year. Select the
scenario, version, and currency to which to
apply the merit rates.
6-8
Chapter 6
Configuring Workforce
Configure Description
Employees Optional
Import employee names or employee numbers
in your organization as members into the
Employee dimension.
Jobs Optional
Import jobs in your organization as members
into the Job dimension.
Skill Sets Mandatory for Job Granularity
Import skill sets used in your organization by
importing members into the Skill Set
dimension.
Union Codes Mandatory for Employee and Job Granularity
Import union codes used in your organization
by importing members into the Union Code
dimension. If you don't track Union Codes, you
can rename the dimension to something that's
meaningful to your business. However, you
must still assign a default to the renamed
dimension.
Gender Optional
Import members into the Gender dimension
Highest Education Degree Optional
Import highest education degrees used in your
organization by importing members into the
Highest Education Degree dimension.
6-9
Chapter 6
Configuring Workforce
Configure Description
Age Band Optional
Import members into the Age Band dimension.
Employees’ ages are calculated and assigned
to an age band as it changes over time.
Note:
Oracle
recommends
that you use the
default age
bands instead of
loading your
own.
Note:
If you are an
existing
customer,
continue to use
your existing age
bands and
members.
For information on importing data, see Importing Data. You can also add members
using the Dimension Editor.
Tip:
After importing dimensions and members, you can view the hierarchical
structure in the Dimension Editor.
6-10
Chapter 6
Configuring Workforce
Note:
You can't add members to the Property dimension.
6-11
Chapter 6
Configuring Workforce
Watch this tutorial video to learn more about importing custom accounts and drivers.
Tutorial Video
See Adding and Managing Accounts and Drivers for more details.
Tutorial Video
See Adding and Managing Accounts and Drivers for more details.
6-12
Chapter 6
Configuring Workforce
Note:
If you add a new Version member, you must enter exchange rates in that
version.
Tip:
You can set up valid intersections for Options and Tiers to their respective
parents in the Components dimension. For information on setting up valid
intersections, see Defining Valid Intersections in Administering Planning.
6-13
Chapter 6
Configuring Workforce
Note:
If the application is based on a 13-period calendar, set the Payment Terms
to Monthly. See Calculations in a 13-Period Calendar.
To launch the wizard, from Configure, click the Benefits and Taxes link. Use Filter to
select the component to configure. You are guided through three steps: Details, Rates,
and Review.
Note:
• Ensure that all entities have a rate and threshold (if the component uses a
threshold). If the same rates and thresholds apply globally, run the rule Copy
Rates Across Entities from a source entity. See Applying Rates by Hierarchy.
• Whenever you update an entity default for a benefit, tax, or additional earning, you
must run the Synchronize Defaults rule to apply the entity default at the
employee-job level. When you update an existing component (a benefit, tax, or
additional benefit) in the wizard, you must run the Synchronize Component
Definition rule to push the updated definition to employees and jobs.
6-14
Chapter 6
Configuring Workforce
Note:
If the application is set up for a 13-period calendar, select Monthly. Then
periods 1 through 13 become the payment terms. For more information
on working with a 13-period calendar, see Calculations in a 13-Period
Calendar.
• Payment Frequency, such as One-time Pay or Pay During Last Period. Payment
Frequency is tied to Payment Terms.
• Component Types: Simple, Rate Table, Rate Table with Threshold, and Custom.
Tip:
A threshold is a cap or maximum value on the resulting expense value. For
example, Car Allowance is a percent of salary up to a threshold of $4,000,
when the Car Allowance benefit would stop. The rate changes when a cap is
reached. For example, the tax rate in the first tier is 4.5% up to a threshold
of $50,000, and the second tier is 12.6% up to $100,000. Not only does a
threshold apply only to the tiered structure, but you can also set a maximum
value with the Additional Earning, Benefit, or Tax calculations.
6-15
Chapter 6
Configuring Workforce
If the Maximum Value Type isn't set to Threshold Amount, then the assignment of
each option or tier row is relevant and needs to be assigned appropriately.
For example, let’s use US FICA tax as an example of setting the Maximum Value
Type to Threshold Amount. No one row will be assigned as a default because all
rows apply. So the tax rate is 7.65% of salary for the first $118,500, then 1.45% of
salary over $118,500 up to $200,000. Then 2.35% tax is applied to salaries
over $200,00. (You still have to select an option or tier when assigning the default; it is
just ignored in the calculation.)
Example:
6-16
Chapter 6
Configuring Workforce
The earning types Add to Gross Pay and Do Not Add to Gross Pay drive the
Benefits and Taxes Value Type and Maximum Value Type of Overall Earnings. So if
the Earning Type is set to Add to Gross Pay, then those Additional Earnings will be
included in any Benefit or Tax based on % Overall Earnings.
If the Earning Type is set to Do Not Add to Gross Pay, then any Benefit or Tax using
% Overall Earnings for the Value Type and Maximum Value Type will exclude those
Additional Earnings from any Benefit or Tax calculations based on % Overall Earnings.
6-17
Chapter 6
Configuring Workforce
For example, an insurance program may apply rate tiers that start from zero each
month.
Note:
If the application is set up for a 13-period calendar, selecting Monthly
applies the calculation logic to periods 1 through 13.
In this example, assume employees in Finance earn $4,000, where tax is defined as
Percent of Salary, with a Threshold Scope of Monthly and three rate tiers:
Their tax rate is 12% for the first 1,000 monthly compensation, 20% between 1,000
and 3,000 earned, and 30% between 3,000 and 5,000.
6-18
Chapter 6
Configuring Workforce
• Calculation logic assumes that component expenses occur in the period with the
last day of the month.
Examples:
• When Payment Terms is Annually (Calendar Year) and the Payment
Frequency is Pay During First Period, the expense is incurred in the period with
January 31.
• When Payment Terms is Annually (Calendar Year) and the Payment
Frequency is One-time Pay and One Time Pay Options is set to First Month,
the expense is paid in the period with January 31.
• When Payment Terms is Annually (Fiscal Year) and the Payment Frequency is
One-time Pay and One Time Pay Options is set to First Month, the expense is
paid in the first period (TP1).
See also:
• About 53-Week Years
• Summary Time Periods and 13 Periods
6-19
Chapter 6
Configuring Workforce
For example, you could create a bonus calculation that applies to new hires who start
in the first 6 months of a calendar year, but not for those who start in the last 6 months
of the calendar year in their first year of hire. You can also select a value driver other
than the predefined ones (for example, Flat Amount, Percentage of Salary, and so on).
So, for example, you could base an additional earning such as commissions on a
custom member that you create, for example, Revenue. To specify a member as the
Value Type driver, you include it in the member formula for the custom component.
To customize logic in a custom component:
1. In the Benefits and Taxes Wizard, on the Details page, edit an existing
component, and for Component Type, select Custom.
2. Continue setting up the component, optionally entering rates to be used in your
custom logic.
Include any thresholds in the member formula.
3. Create a member formula for the OWP_Custom Expense member in the Property
dimension:
a. On the Home page, select Application, then Overview, and then
Dimensions.
b. Click the down arrow to the right of Cube, and then select OEP_WFP.
c. Click Property, right-click in the Member Name column header, and then
clear Default mode.
d. Select the member OWP_Custom Expense, scroll right to the OEP_WFP
Formula column, and then click in the intersection cell.
e. In the upper left of the grid, click the Member Formula icon
.
f. Enter the member formula.
Notes:
• Before creating your own custom calculation logic, Oracle encourages you to first
do due diligence in using the predefined calculations.
• Evaluate the performance of your custom formula before taking the application into
production.
• To create and use multiple custom components, modify the OWP_Custom
Expense member formula to accommodate each component’s custom logic. For
example, use nested IF conditions for each custom component type.
Tip:
See the next topics for advice on customizing calculation logic and for
several sample formulas.
6-20
Chapter 6
Configuring Workforce
Use Case
You want to calculate commission as a percentage of the Commission Basis account,
which is a custom account not provided with Workforce. Commission is calculated by
multiplying the rate entered in the Benefits and Taxes Wizard times the custom
Commission Basis account.
Sample Formula
IF("No Property"->"BegBalance"==[OWP_EarningList.Commission])
IF(@ISMBR(@RELATIVE("OWP_Existing Employees",0)))
"Commission Basis"->"No Property" * ("OWP_Value"/100);
ELSE
#Missing;
ENDIF
ENDIF
Use Case
Building on the previous example, you want to add a benefit called Insurance, which is
calculated as a percentage of the Merit account, with the following values selected in
the Benefits and Taxes Wizard:
• Component Type—Custom
• Payment Terms—Quarterly (Calendar Year)
• Payment Frequency—Pay During First Period
• Maximum Value Type—Flat Amount
6-21
Chapter 6
Configuring Workforce
• Threshold Scope—YTD
• Taxable Component—Yes
• Rate for all months—10
• Threshold—400
• Value Type—You can select any value for Value Type as we are calculating the
benefit as a percentage of Merit in the custom logic.
Sample Formula
IF("No Property"->"BegBalance"==[OWP_EarningList.Commission])
IF(@ISMBR(@RELATIVE("OWP_Existing Employees",0)))
"Commission Basis"->"No Property" * ("OWP_Value"/100);
ELSE
#Missing;
ENDIF
ELSEIF("No Property"->"BegBalance"==[OWP_BenefitList.Insurance])
IF("Cal TP-Index"==1 OR "Cal TP-Index"==4 OR "Cal TP-Index"==7 OR "Cal
TP-Index"==10)
"OWP_Expense amount"="OWP_Merit"->"OWP_Expense
amount"*("OWP_Value"/100);
ENDIF;
IF("OWP_Expense amount"!=#MISSING)
IF("OWP_Calculated Max Value"!=#MISSING)
IF("OWP_CYTD(Prior)"+"OWP_Expense amount">"OWP_Calculated Max
Value")
IF("OWP_CYTD(Prior)"<="OWP_Calculated Max Value")
"OWP_Expense amount"="OWP_Calculated Max
Value"-"OWP_CYTD(Prior)";
ELSE
"OWP_Expense amount"=#MISSING;
ENDIF;
ENDIF;
ENDIF;
ENDIF;
ENDIF;
Use Case
Building on the previous examples, you want to add a Tax (Tiered Tax) named SUTA,
which is calculated as a percentage of Benefit1, Benefit2, Benefit3, and Benefit4, with
the following values selected in the Benefits and Taxes Wizard:
• Component Type—Custom
• Payment Terms—Monthly
• Maximum Value Type—Threshold
• Threshold Scope—Monthly
• No rates are provided in the Rates page.
• For the custom tiered tax, rates need to be provided as part of the custom formula.
6-22
Chapter 6
Configuring Workforce
Sample Formula
IF("No Property"->"BegBalance"==[OWP_EarningList.Commission])
IF(@ISMBR(@RELATIVE("OWP_Existing Employees",0)))
"Commission Basis"->"No Property" * ("OWP_Value"/100);
ELSE
#Missing;
ENDIF
ELSEIF("No Property"->"BegBalance"==[OWP_BenefitList.Insurance])
IF("Cal TP-Index"==1 OR "Cal TP-Index"==4 OR "Cal TP-Index"==7 OR "Cal
TP-Index"==10)
"OWP_Expense amount"="OWP_Merit"->"OWP_Expense
amount"*("OWP_Value"/100);
ENDIF;
IF("OWP_Expense amount"!=#MISSING)
IF("OWP_Calculated Max Value"!=#MISSING)
IF("OWP_CYTD(Prior)"+"OWP_Expense amount">"OWP_Calculated Max
Value")
IF("OWP_CYTD(Prior)"<="OWP_Calculated Max Value")
"OWP_Expense amount"="OWP_Calculated Max
Value"-"OWP_CYTD(Prior)";
ELSE
"OWP_Expense amount"=#MISSING;
ENDIF;
ENDIF;
ENDIF
ENDIF
ELSEIF("No Property"->"BegBalance"==[OWP_TaxList.SUTA])
IF("OWP_Benefit1"->"OWP_Expense amount"+"OWP_Benefit2"->"OWP_Expense
amount"+"OWP_Benefit3"->"OWP_Expense amount"+"OWP_Benefit4"->"OWP_Expense
amount"<=1000)
"OWP_Expense amount"=("OWP_Benefit1"->"OWP_Expense
amount"+"OWP_Benefit2"->"OWP_Expense amount"+"OWP_Benefit3"->"OWP_Expense
amount"+"OWP_Benefit4"->"OWP_Expense amount")*(10/100);
ELSEIF("OWP_Benefit1"->"OWP_Expense amount"+"OWP_Benefit2"-
>"OWP_Expense amount"+"OWP_Benefit3"->"OWP_Expense amount"+"OWP_Benefit4"-
>"OWP_Expense amount"<=1200)
"OWP_Expense amount"=(("OWP_Benefit1"->"OWP_Expense
amount"+"OWP_Benefit2"->"OWP_Expense amount"+"OWP_Benefit3"->"OWP_Expense
amount"+"OWP_Benefit4"->"OWP_Expense amount")-1000)*(20/100) +
1000*(10/100);
ELSEIF("OWP_Benefit1"->"OWP_Expense amount"+"OWP_Benefit2"-
>"OWP_Expense amount"+"OWP_Benefit3"->"OWP_Expense amount"+"OWP_Benefit4"-
>"OWP_Expense amount"<=1300)
"OWP_Expense amount"=(("OWP_Benefit1"->"OWP_Expense
amount"+"OWP_Benefit2"->"OWP_Expense amount"+"OWP_Benefit3"->"OWP_Expense
amount"+"OWP_Benefit4"->"OWP_Expense amount")-1200)*(30/100) +
(1200-1000)*(20/100) + 1000*(10/100);
ELSE
"OWP_Expense amount"=(1300-1200)*(30/100) + (1200-1000)*(20/100) +
1000*(10/100);
ENDIF
ENDIF
6-23
Chapter 6
Configuring Workforce
6-24
Chapter 6
Configuring Workforce
2. Click Filter .
3. Select the Scenario and Version for the fringe benefit and from Components, click
Benefits, and then Apply:
6-25
Chapter 6
Configuring Workforce
6-26
Chapter 6
Post Configuration Tasks
6. Click Launch.
Now, whenever you add a hiring requisition (using the Add TBH business rule) to
Sales Italy, the new fringe benefit rate that we set up for EMEA (for example, 34% for
2017) is applied. Compensation is automatically calculated, including the fringe
benefit. (The fringe benefit rate is also applied when you run the Synchronize Default
business rule.) If you update the fringe benefit rate using the Benefits and Taxes
Wizard, to apply the updated rate, run the Synchronize Component Definition
business rule.
Setting Assumptions
Assumptions (and defaults) drive the calculations for workforce-related expenses.
Assumptions include:
• Hours worked per day, week, and month, which drive salary expenses for hourly
employees.
• The partial payment factor (that is, the pay percentage to apply to Maternity
Status).
• The salary basis (for example, annual) and rate for Salary Grades.
• Set merit rates, which are added to salary calculations.
You can set assumptions by entity or at the No Entity level (for default assumptions). If
you set assumptions for the entity, then they are used for calculations; otherwise, the
assumptions set for No Entity (at the organization level) are used. The exception to
this is Merit Rate, which must be set at the entity level.
6-27
Chapter 6
Post Configuration Tasks
Setting Defaults
Defaults (and assumptions) drive the calculations for workforce-related expenses.
If you want a default for salary, additional earnings, benefits, or taxes to be used for all
employees in a specific job, select that job when adding the default. For example, if
you select Accountant when adding the default for Job, then all employees who are
Accountants are assigned that default.
If Employee and Job granularity is enabled, you must set defaults based on Job and
Union Code. This setting defaults compensation elements for new hires for a specific
job. For example, you might set the default Salary Grade to Grade 3 for a Warehouse
Worker with the Union Code of Teamster.
To apply a compensation element default to all employees in all jobs, such as when
setting defaults for salary, additional earnings, benefits, and taxes, select the OWP_All
<member>. For example, select the OWP_All Union Code member and the OWP_All
Jobs member if you want the default compensation element to be used for all
employees in any job and in any union. So for example, if you select the OWP_All
Union Code member and the OWP_All Job member, then Sue Doe in Accounting
(whose Union Code is Default No Union Code) would get the same compensation
element default as Tom Blue in the Warehouse (whose Union Code is Teamsters).
Note:
Workforce seeds a level 0 member named No Union Code as a sibling to
Total Union Code. However, when you add defaults for salary, additional
earnings, benefits, and taxes, No Union Code isn't available for selecting in
the runtime prompt. To meet this need, Workforce expects you to add at
least one sibling null metadata member (such as OWP_Unspecified Union
Code) to OWP_All Union Code.
If your company doesn't use Union Code, you can rename that dimension to
something that’s meaningful to your business when you enable Workforce. If
you didn’t rename Union Code when you enabled Workforce, you can create
whatever members you want in the Union Code dimension and change the
alias of the dimension to your preferred name.
6-28
Chapter 6
Post Configuration Tasks
• To set Salary defaults, click Salary. These defaults are used for new hires or job
Synchronizing Defaults
Whenever you update the entity defaults for benefits, taxes, or additional earnings
using the Benefit and Taxes wizard on the Configure page, you must push the
updated data to the input forms by running the Synchronize Defaults business rule.
1. Click Compensation Planning, then Manage Employees, and then Existing
Employees.
2. Highlight a row with an individual or a blank row.
If you intend to execute the business rule for:
• Only one person, highlight the row containing that person's name, and then
run the rule
• Multiple people or to select the dimensionality with a runtime prompt, highlight
a blank row and then run the rule
3. Click Actions, then Business Rules, and then Synchronize Defaults.
The business rule recalculates and updates data in the forms.
Note:
When you update the metadata for a component (for example, salary grades,
benefits, taxes, and additional earnings), run the Synchronize Component
Definition business rule to push the updated definition to already-assigned
employees and jobs. This rule doesn't update the entity defaults.
6-29
Chapter 6
Post Configuration Tasks
and Version combinations whose data you want to recalculate. For example, you
may not want to recalculate historical data.
For optimum performance, before running 1xPopulate New Properties, change
the FIX Parallel dimension to use the dimension that is appropriate to parallelize
the process by moving the dimension from FIX statement to FIX Parallel and move
the entity member selection to FIX statement in the place of the dimension that's
moved to FIX Parallel statement. This change needs to be made in
OWP_Populate New Properties_T template in Calculation Manager. Save the
changes and then deploy the OWP_Populate New Properties rule.
Note:
If you don’t run this rule immediately after updating, the consequence of
running any rules is the possibility of losing some data. If you
inadvertently run rules before running 1X Populate New Properties, run
1X - Populate New Properties and then rerun the rules that you
previously ran.
• Immediately after updating the Workforce May 2019 content, you must run the
new rule 1X Copy Compensation Details from BegBalance to Periods, which
copies compensation details from the BegBalance member to all months. Run this
rule only once for each active Scenario and Version combination with data,
immediately after updating content. To run this rule, on the Home page, click
Rules, then All Cubes, and then select OEP_WFSC from the Cube drop-down
list. Then click Launch for the rule Copy Compensation Details from
BegBalance to Periods.
• Immediately after updating the Workforce July 2018 content, you must run the new
rule One Time - Copy Rates to Months, which copies rates from the BegBalance
member to all months. Run this rule only once for each active Scenario and
Version combination with data, immediately after updating content. To run this
rule, on the Home page, click Rules, then All Cubes, and then select OEP_WFSC
from the Cube drop-down list. Then click Launch for the rule One Time - Copy
Rates to Months.
• Enhancements available in certain releases include updates to some provided
artifacts. If you haven’t modified these artifacts, then the artifacts and features are
available to you automatically with the release. Because customized artifacts are
not updated during releases, if you have customized these artifacts and want to
take advantage of the new features, review the information in the appendix
Updating Workforce Artifacts to Use New Features.
Also, check this appendix to see the list of new rules. To make new rules available
to users, you must give users access to the rules. To do so, on the Home page,
select Rules, the OEP_WFP cube, the new rule, and then the Permission icon.
• For components configured with the Payment Frequency set to One-time Pay:
Unless you select a One-time Pay Option, your component expenses continue to
occur in the first month of your selected payment frequency.
• Workforce provides four forms for quickly updating and processing data on
existing employees. Each form is associated with a Groovy rule that processes
only the changed data. The forms are designed for optimal processing efficiency,
depending on the kind of data being updated. You access these forms from the
Mass Update tab. See Updating Employees and Jobs Details in the Working with
Planning Modules.
6-30
Chapter 6
Workforce Rules
On these forms, all the Flex dimensions and the Entity dimension are initially on
the Page. Oracle recommends that you analyze the form load performance and
then modify the layout of these forms, moving certain dimensions from the Page to
the rows based on your requirements. Year and Period are also on the Page;
Oracle assumes you'll use the selected Year and Period for loading and
processing the changed data. Your Year and Period selection is equivalent to the
runtime prompt values for the Process Loaded Data rule.
To provide processing efficiency for multiple simultaneous users, the default
parallelism for the Groovy rule is set to 2. However, if you don't provide access to
these forms for planners or if you expect a low level of concurrency, then you can
adjust a design-time prompt (DTP) value to increase the parallelism to 4. Doing so
will increase processing speed for large-scale changes in data.
Workforce Rules
Run the Workforce business rules in the situations described here.
Tip:
For suggestions on enhancing the execution performance of rules, see
Performance Considerations with Workforce Rules.
To launch a business rule, click Actions, then Business Rules, and then the rule.
• Synchronize Defaults—Run this rule after you update the entity defaults for a
benefit, tax, or additional earning. For example, you set up a new benefit or
removed an existing benefit from entity defaults. Running this rule from the New
Hires or Manage Existing Employees form pushes the updated entity default at the
employee-job level. If you launch Synchronize Defaults using the right-click
menu, you use it for a selected employee-job combination.
If you intend to execute the Synchronize Defaults rule for:
– Only one person, highlight the row containing that person's name, and then
run the rule.
– Multiple people, or to select the dimensionality with a runtime prompt, right-
click in the white space, and then run the rule.
• Synchronize Component Definition—Run this rule after you update an existing
benefit, tax, or additional earning. For example, you updated a rate table, payment
frequency, salary grade, or maximum value. Running Synchronize Component
Definition pushes the updated component definition to employees and jobs. This
rule doesn't update the entity defaults.
• Calculate Compensation—When you update data on a form, to recalculate
expenses, run the Calculate Compensation rule. For example, if you change an
employee's status, review that employee's FTE, and then run Calculation
Compensation.
• Process Loaded Data—After you import new compensation data, run the rule
Process Loaded Data to copy the data to the necessary periods in the planning
year range. Running this rule sets the Headcount to 1 and the Partial Payment
Factor to 100% for every employee unless you've loaded different values at the
processing month.
6-31
Chapter 6
Performance Considerations with Workforce Rules
Tip:
You can quickly make changes to the source data for existing employees,
entities, and jobs in four Workforce Mass Update forms. Each form is
associated with a Groovy rule that processes only the changed data. See
Updating Multiple Employees and Jobs Details in Working with Planning
Modules.
Note:
You can run the rules Synchronize Defaults, Synchronize Component
Definition, and Process Loaded Data for multiple entities at a time by
selecting the parent entity under Total Entity. Oracle recommends that for
performance reasons, you run multiple instances of rules by selecting
different children under Total Entity instead of running rules for all entities in
one pass.
Note:
If you get an error message about invalid data when running a business rule,
see Troubleshooting a Rule’s Error Message.
Tip:
To determine the best dimension to include in the FIXPARALLEL
statement, Oracle recommends that you do some testing using realistic
and representative data.
6-32
Chapter 6
Performance Considerations with Workforce Rules
FIXPARALLEL(4,@RELATIVE({Department},0))
FIXPARALLEL(4,@RELATIVE(“All Project”,0))
Note:
When you modify the template, ensure that the syntax (for example,
the placement of commas) is valid and balanced by reviewing the
Design-time Prompts (DTP).
Note:
Test your changes in your Test instance before applying the
changes in Production.
6-33
Chapter 6
Performance Considerations with Workforce Rules
6-34
7
Configuring Projects
This chapter includes these topics:
• Enabling Projects Features
• Configuring Projects
• Post Configuration Tasks
Note:
After you enable a feature, you can’t later disable it.
Watch this tutorial video to learn more about enabling and configuring Projects.
Tutorial Video
1. From the Home page, click Application , and then click Configure
.
2. From the Configure list, select Projects, and then click Enable Features.
3. Select the features you want to enable and then click Enable. Except as noted,
you can come back later and enable additional features, so enable only the
features you need to use now.
7-1
Chapter 7
Enabling Projects Features
Enable Description
Project Type Select the project types for planning.
Enable only the project types you need. You
can later enable additional project types if
needed.
You must enable Capital before you can
enable Capital projects, and add a custom
dimension in Capital called Project (the
default dimension name in Projects). If you
plan to rename and use a different name for
the Project dimension in Projects, use that
same dimension name in Capital.
See Enabling Project Type.
Revenue Provides the ability to manage revenue.
Available only for Contract projects. You can
track revenue by directly entering it (Direct
Input) or by setting up revenue drivers (Driver
Based). Adds artifacts (forms, calculations,
and reporting) to support revenue planning.
See Enabling Project Revenue.
Project Benefits Tracks qualitative and quantitative project
benefits.
See Enabling Project Benefits.
Expense Select project related expenses to plan.
Track expenses by entering them (Direct
Input) or by setting up expense drivers (Driver
Based). Adds forms, calculations, and
reporting to support expense planning. To use
Job Rates from Workforce, you must first
enable Workforce. To track utilization of
Employees, you must enable Workforce
before Projects, and for Granularity, select
either Job or Employee and Job. To use
Equipment Rates from Capital, you must first
enable Capital.
See Enabling Project Expense.
Rolling Forecast Enables rolling forecast for projects to allow
project reporting and analysis over a rolling
forecasting time period range.
See Enabling Rolling Forecast.
Map/Rename Dimensions • Enable up to three additional custom
dimensions in your application. For
Projects, suggested dimensions are
provided: Vendor, Phase, and Program.
• Map custom dimensions to existing
dimensions.
• Rename base dimensions.
You must perform this step the first time you
enable Projects.
See Enabling Map/Rename Dimensions.
7-2
Chapter 7
Enabling Projects Features
The Projects artifacts are populated, including dimensions, forms, and accounts.
7-3
Chapter 7
Enabling Projects Features
benefits to help justify the need for the project. You can also plan the non-financial
benefits of a project, which can be used to justify a project and help measure a
project's success.
Select Project Benefits and then specify the type of project benefits to enable:
• Financial—You can define financial benefits associated with projects; users can
track project performance. For example, if you are setting up a new web site, you
can track financial benefits that might come out of the project. For example, you
might get incremental revenue from leads from the web site, or, if you handle
queries on the web site, you might see call center savings. Or a new video
conferencing facility can lead to savings on travel expenses.
• Non-Financial—You also can define non-financial benefits. For example, a new
web site might improve the customer satisfaction index, or you might see an
incremental increase in your user base by investing in the project. You can
quantify the benefits and map them to various project accounts.
Once you define the benefits, users can track the performance.
Users can also capture additional qualitative project benefits that aren't trackable with
numbers that can help justify projects. For example, you could note that customers will
have a better user experience with the improved web site design.
7-4
Chapter 7
Enabling Projects Features
Overview Video.
Watch this tutorial video to learn more about planning using a rolling forecast.
Tutorial Video.
7-5
Chapter 7
Configuring Projects
Configuring Projects
Perform this task after you’ve enabled Projects features.
1. From the Home page, click Application , and then click Configure
.
2. From the Configure list, select Projects.
3. Perform all mandatory tasks. Perform the optional tasks required for your
business. Use the Filter to check the status of configuration actions. Use Actions
Configure Description
Project Import projects.
Populate the application with projects by
importing members to the Projects dimension.
7-6
Chapter 7
Configuring Projects
Configure Description
Resource Class Import resource class. The Resource Class
consists of labor, material, and equipment
codes.
Import detailed jobs to use for planning project
expenses. You can import members, or, if
Workforce is enabled, you can use jobs from
Workforce.
Note:
If you are
integrating
Workforce and
Projects, you
don't need to
import jobs. The
Jobs are
automatically
imported from
Workforce.
Note:
Entities are
common across
modules, so
import all entities
together.
7-7
Chapter 7
Configuring Projects
Configure Description
Revenue Accounts Configure revenue accounts.
Select the defined artifacts to use. Add or
import custom drivers or accounts to manage
project revenue for your business needs. If
required, you might need to add logic or
calculations related to any custom accounts.
See Adding and Managing Accounts and
Drivers.
Planning and Forecast Preparation Set the timeframe and granularity for plans.
Configures the timeframe, the starting period,
and the level of granularity for planning and
forecasting. Gives you the ability to plan and
forecast on a different basis for different years.
See Planning and Forecast Preparation.
Project Properties Configure project properties.
Select the defined artifacts to use. Add or
import custom project properties using the
same process used for adding and importing
accounts and drivers.
See Adding and Managing Accounts and
Drivers.
Global Assumptions Set exchange rates.
Enter foreign exchange rates in a
multicurrency application.
Additionally, enter global assumptions for
projects including standard labor rates,
overhead, working days and hours, discount
rate,
See Setting Global Assumptions: Exchange
Rates and Entering Global Project Rates.
Projects Financials Mapping If you are integrating Projects and Financials,
for each Projects account, select the
corresponding Financials account from the
Smart List.
You can do the mapping at No Entity level, the
default, which is used if an entity level
mapping isn’t set up.
Available only if Financials is enabled.
<customName> Dimension Import members for the <customName>
dimension.
Use if you enabled the <customName>
dimension, for example to associate projects
with a vendor.
7-8
Chapter 7
Configuring Projects
7-9
Chapter 7
Configuring Projects
Tutorial Video
See Adding and Managing Accounts and Drivers for more details.
7-10
Chapter 7
Configuring Projects
Note:
If you add a new Version member, you must enter exchange rates in that
version.
7-11
Chapter 7
Post Configuration Tasks
• Working Days and Hours—Specify the working days and hours in a month; it
can vary by entity. For example, you can set different working days and hours
for different regions or for different departments.
The forms that are loaded are based on the features and integration you’ve enabled.
1. From the Home page, click Navigator and then select Dimensions from the
Create and Manage category.
2. Select Project from the Dimension drop-down list.
3. From the Actions menu, select Custom Attributes.
4. Click Programs to move it to the Attribute Values pane.
5. Click + to add the program members.
6. Select a program, and then in Attribute Values, select the project you want to
associate with the program.
7. Refresh the database.
Projects Rules
Run rules to calculate values in the application. From the Home page, click Rules.
Tip:
To see only Projects rules, click All Cubes next to the Filter, and from the
Cube list select OEP_PFP.
Projects rules:
• OPF_Add Project—Adds a new project on the fly.
• OPF_Add Expense Line Item—Adds a new expense line item in a project.
• OPF_Add Revenue Line Item—Adds a new revenue line item in a project.
• OPF_Approve Project—Sets the status of the project to Approved; copies the
plan data to the forecast scenario, since this project is likely to move forward.
7-12
Chapter 7
Projects Rules
7-13
Chapter 7
Projects Rules
7-14
8
Configuring Capital
This chapter includes these topics:
• Enabling Capital Features
• Configuring Capital
• Post Configuration Tasks
Note:
After you enable a feature, you can’t later disable it.
Watch this tutorial video to learn more about enabling and configuring Capital.
Tutorial Video
1. From the Home page, click Application , and then click Configure
.
2. From the Configure list, select Capital, and then click Enable Features.
3. Select the features you want to enable. Except as noted, you can come back later
and enable additional features, so enable only the features you need to use now.
Enable Description
New Capital Investment Select new capital investments.
See Enabling New Capital Investment.
8-1
Chapter 8
Enabling Capital Features
Enable Description
Manage Existing Assets Select existing capital assets.
See Enabling Manage Existing Assets.
Map/Rename Dimensions • Enable up to three additional custom
dimensions in your application.
• Map custom dimensions to existing
dimensions.
• Rename base dimensions.
You must perform this step the first time you
enable Capital.
If you are integrating Capital with Projects, add
a custom dimension called Project, the default
dimension name in Projects. If you name it
anything else, make sure the dimension name
is the same in all modules.
See Enabling Map/Rename Dimensions
The Capital artifacts are populated, including dimensions, forms, and accounts.
8-2
Chapter 8
Configuring Capital
Configuring Capital
Perform this task after you’ve enabled Capital features.
1. From the Home page, click Application , and then click Configure
.
2. From the Configure list, select Capital.
3. Perform all mandatory tasks. Perform the optional tasks required for your
business. Use the Filter to check the status of configuration actions. Use Actions
8-3
Chapter 8
Configuring Capital
Configure Description
Entities Import Entities.
Import the Entity dimension members that
reflect your business hierarchy, such as
departments, cost centers, and business units.
Select the location of the file containing the
members (Local or Planning inbox), click
Browse to find the file, specify the file type,
and then click Import.
Note:
Entities are
common across
modules, so
import all entities
together.
8-4
Chapter 8
Configuring Capital
Configure Description
Planning and Forecast Preparation Set the timeframe and granularity for plans.
Configures the timeframe, the starting period,
and the level of granularity for planning and
forecasting. Gives you the ability to plan and
forecast on a different basis for different years.
See Planning and Forecast Preparation.
Expense and Cash Flow Assumptions Set up assumptions for tangible asset
expenses, depreciation and amortization, and
funding assumptions. Used as drivers for
expense calculations for Tangible Assets.
You can only remove predefined expense
assumptions; you can’t add or import new
ones.
See Adding and Managing Accounts and
Drivers.
Assumptions for Intangibles Set up assumptions for depreciation method
and convention, useful life, and cash flow and
funding assumptions. Used as drivers for
expense calculations for Intangible Assets.
You can only remove predefined expense
assumptions; you can’t add or import new
ones.
See Adding and Managing Accounts and
Drivers.
Global Assumptions Set exchange rates.
Enter foreign exchange rates in a
multicurrency application. See Setting Global
Assumptions: Exchange Rates.
Map Capital Accounts to Financials Map asset accounts from Capital to Financials
accounts to allow for integration and
movement of data from detail assets in Capital
to account level in Financials. For each asset
account, select the corresponding Financials
account from the Smart List.
Select the horizontal tabs to map assets for
Tangible Assets, Intangible Assets, and Lease
Assets.
Available only if Financials is enabled.
Import <customName Dimension> Import <customName Dimension>.
Import members to populate the
<customName Dimension> dimension. Use if
you enabled a custom dimension.
8-5
Chapter 8
Configuring Capital
8-6
Chapter 8
Configuring Capital
This export and import process speeds up the design and maintenance of the
application. When requirements change, you can repeat this process as many times
as needed. For example, you might see a predefined marketing driver that is similar to
a driver for a new social media campaign you plan to run. You can easily export the
drivers, make a copy of the marketing driver, modify it as needed for your social media
campaign, and then re-import it.
Watch this tutorial video to learn more about importing custom accounts and drivers.
Tutorial Video
See Adding and Managing Accounts and Drivers for more details.
8-7
Chapter 8
Post Configuration Tasks
Note:
If you add a new Version member, you must enter exchange rates in that
version.
Capital Rules
To run rules, from the Home page, click Rules.
Tip:
To see only Capital rules, click All Cubes next to the Filter, and from the
Cube list select OEP_CPX.
Capital rules:
• Add Asset—Adds new assets for asset class; for tangible assets.
8-8
Chapter 8
Capital Rules
• Add Asset Dynamic—Adds new assets with member names given in the runtime
prompt.
• Add Intangibles—Adds intangible assets for asset class.
• Add Intangible—Adds new assets when Named Asset is not selected in Enable
Features
• OCX_Add Intangibles Dynamic—Adds new assets with member names given in
the runtime prompt.
• Add LeasedAsset—Adds leased assets at the entity level including determining
whether it's operating or capital lease.
• Add LeasedAssets—Adds a named leased asset at the entity level including
determining whether it's operating or capital lease.
• Assign Driver for a plan year—Sets percentage driver for a target year either
based on source year or simply based on value provided.
• OCX_Add LeasedAsset Dynamic—Adds leased asset with member names
given in the runtime prompt.
• Calculate All Existing Intangible Assets—This rule is now obsolete. Use this
rule instead: Calculate Intangible Asset.
• Calculate All Existing Tangible Assets—This rule is now obsolete. Use this rule
instead: Calculate Tangible Asset.
• Calculate Existing Intangible Assets—Calculates the amortization and all other
expenses and cash flow for the specified existing intangible asset.
• Calculate Intangible Asset—Calculates the amortization and all other expenses
and cash flow for the specified intangible asset.
• Calculate Tangible Asset—Calculates the depreciation and all other expenses
and cash flow for the specified asset.
• Calculate All Leased Assets—Calculates PV value of lease, depreciation,
interest, and cash flows for all leased assets for an entity.
• Calculate Leased Assets—Calculates PV value of lease, depreciation, interest,
cash flows for a specified leased asset.
• Impair Intangible—Calculates impairment (reduction of asset value) for
intangibles.
• Improve Asset—Allows for adding improvements to existing assets by splitting
the asset and creating the value of the improvement.
• Reconcile Asset—Reconciles the new asset request against an existing asset. All
values are pushed to the assigned asset.
• Reconcile Leased Asset—Reconciles the new leased asset request against an
existing leased asset. All values are pushed to the assigned asset.
• Remove Named Asset—Removes a named asset that's no longer relevant.
• OCX_Remove Asset Dynamic—Removes a planned named asset investment
that's no longer relevant.
• Remove Leased Asset—Removes a planned lease asset investment that's no
longer relevant.
• OCX_Remove Leased Asset Dynamic—Removes a planned named leased
asset investment that's no longer relevant.
8-9
Chapter 8
Creating a Custom Depreciation or Amortization Method
• Retire Asset—Retires the existing asset, where the asset can be sold or written
off, with corresponding accounting implications.
• Retire Intangible—Retires the existing intangible, where the asset can be sold or
written off, with corresponding accounting implications.
• Roll up Capital—Rolls up Accounts, Asset Details, Asset Class, Entity.
• Sync FS Account Mapping—Synchronizes the mapping of financial statement
accounts between Capital and Financials.
• Synchronize drivers—Synchronizes asset assumptions to level 0 assets.
• Transfer Asset—Transfers existing tangible assets from one entity to another; all
costs/expenses are pushed to the new entity.
• Transfer Intangibles—Transfers existing intangibles from one entity to another;
all costs/expenses are pushed into the new entity.
• Push Data To Financials—Runs the data map Financial Statement Integration
to push data from Capital to Financials.
Note:
You must use the custom rules with the Custom depreciation or amortization
Smart List entry, and use provided rules for the provided methods.
8-10
Chapter 8
Creating a Custom Depreciation or Amortization Method
Tip:
To change the name of the Custom method, change the artifact label: From
the Home page, click Tools, then click Artifact Labels, and then apply the
filter to see Smart List Entry. Select your language, and then change the
label for the custom OCX_AmortizationMethod or OCX_DeprMethod
entry.
8-11
9
Configuring Strategic Modeling
Related Topics
• Enabling Strategic Modeling
• Working with Templates
• Creating a Strategic Modeling Model
• Setting Up Model Access Permissions
• Changing Model Properties
• Pushing Data Between Strategic Modeling and Planning
• Managing Metadata with Model Change Management
Use Model Change Management to copy metadata from a source model to one or
more target models.
1. From the Home page, click Application , and then click Configure
.
2. From the Configure list, select Strategic Modeling, and then click Enable
Features.
3. Log out and log in again to see the newly enabled feature.
There are no configuration tasks required for Strategic Modeling.
The Strategic Modeling provided templates are populated.
9-1
Chapter 9
Working with Templates
• Utility
• Healthcare
• Retail
• Higher Education
These templates are available when you enable Strategic Modeling so you can get up
and running quickly. You can't modify the templates provided by Oracle, but you can
save a copy of a template and modify it for your business use case.
To review the account structure of the provided templates and any custom templates
you've uploaded:
1. From the Home page, click Strategic Modeling , and then click
Templates .
2. From the Actions menu for the template you want to review, click Open.
3. Change the Scenario, Dataview, or Account Groups to show different sets of
accounts.
You can also review and edit the account structure in the templates provided by
Oracle using Strategic Modeling in Oracle Smart View for Office.
1. From the Home page, click Strategic Modeling , and then click
Templates .
2. From the Actions menu next to the template you want to modify, click Properties.
9-2
Chapter 9
Creating a Strategic Modeling Model
5. Click to add users or groups and assign them access to the template.
For information about user and group permissions, see Setting Up Model Access
Permissions.
6. To replace the current permissions with default permissions, click Inherit Default
Access.
7. Click Apply to save the changes.
Tutorial Video
To create a Strategic Modeling model:
1. From the Home page, click Strategic Modeling , and then click Model
View .
2. Click Create.
3. On the General page, specify the following options and then click Next.
• Specify a model name and description.
• Select whether to create the model from a template, from an existing model in
the current application, or from a local .alc file, and then select the template,
model, or file.
If you are creating a model from a local .alc file, the file must have already
been converted in Smart View for use on the Cloud.
9-3
Chapter 9
Setting Up Model Access Permissions
Note:
You set up currency conversions in Smart View. See "Translating
Currencies" in Working with Strategic Modeling in Smart View.
• If you created the model from an existing model, select Keep Time Structure
if you want the new model to use the same time period structure as the
existing model.
If you selected Keep Time Structure, you can select Keep Source Model
Data to include the source model's data values in the accounts.
If you select Keep Time Structure, skip to step 5.
• If you created a model using the Financial template for integration with
Financials, in Select Entity, select a Financials Entity dimension member. The
model will be mapped to the selected Entity dimension member.
This option is available only when creating a model from the Financial
template. For more information, see Integrating Data Between Strategic
Modeling and Financials.
4. On the Calendar, Time Period, and Configure Years pages, specify the options
for building the calendar for this model.
5. Review the model creation options, and then click Create Model.
The model is created with a chart of accounts and a calendar structure based on the
options you selected.
You can convert an Oracle Hyperion Strategic Finance model to a Strategic Modeling
model in Smart View. See Working with Strategic Modeling in Smart View.
9-4
Chapter 9
Setting Up Model Access Permissions
If a model is inheriting access permissions (either from the global level or from a
parent), as long as you have not made any changes to the individual model's access
permissions, it will continue to inherit any changes to access permissions. However,
once you modify an individual model's access permissions, it no longer inherits any
permission changes from either the global level or the parent (depending on where it
inherited permissions from).
Available roles include Modeler, Analyst, Viewer, and No Access. See About Model
Access Permissions for more information about these roles. These permissions also
apply to models when you work with Strategic Modeling in Oracle Smart View for
Office.
Model access details:
• Planning users (except Administrators) are available in the Users list to assign
model access. Note that access permissions in Strategic Modeling are unrelated
to those in Planning. You must give users access to Strategic Modeling models
even if they have access to the Planning application.
• When a model is first created, it is set up with Default permissions and Owner
permissions. You can't delete these. Any newly added user or group gets the
default permissions.
By default, the Default permissions and new users and groups have the No
Access role. If you assign global access, all new models inherit that access.
• When a user has no access to a model, no model actions or options are available.
When a user has no access to a menu item, it doesn't appear on the Actions
menu.
Watch this tutorial video to learn more about setting up model access permissions.
Tutorial Video
9-5
Chapter 9
Setting Up Model Access Permissions
Role Access
Modeler • Models:
– Create
– Open - Check out and check in
– Open As Copy
– Delete
• Account View: All options are available
– Find Account
– Account Forecast
– Subaccounts
– Goal Seek
– Scenario Manager
– Audit Trail
– Simulations
– Enter data, Calculate, and Save
– Change the Point of View to display
different account groups, scenarios,
and dataviews
• Consolidations: All options are available
• Templates: View templates, delete
custom templates, import templates
• Reports: All options are available
• In Oracle Smart View for Office:
– Models: Copy Local File to Server,
Delete Model, Input Status, Account
Groups, Funding Options, Required
Elements, Template Name
– Time management: Time tab. All
options are available
– Scenarios: All options are available
– Dimensions: All options are available
Analyst • Models:
– Open - Check out and check in
– Open As Copy
• Account View
– Find Account
– Account Forecast
– Goal Seek
– Audit Trail
– Enter Data, Calculate, and Save
– Change the Point of View to display
different account groups, scenarios,
and data views
• Templates: View templates
• Reports: View reports
9-6
Chapter 9
Setting Up Model Access Permissions
Role Access
Viewer • Models: Open As Copy
• Account View
– Find Account
– Goal Seek
– Audit Trail; however, viewers can't
make changes to inputs
– View the grid in read only mode (can't
Enter Data or Save)
– Change the Point of View to display
different account groups, scenarios,
and data views
• Templates: View templates
• Reports: View reports
No Access No access
1. From the Home page, click Strategic Modeling , then Model View
9-7
Chapter 9
Changing Model Properties
1. From the Home page, click Strategic Modeling , and then Model View
.
2. From the Actions menu next to the model you want to modify, click Properties.
3. Click Permissions and then specify the user and group permissions for the
model.
4. Click to add users or groups and assign them access to the model.
5. To replace the current permissions with default permissions, click Inherit Default
Access.
6. Click Apply to save the changes.
1. From the Home page, click Strategic Modeling , and then Model View
.
2. From the Actions menu next to the model you want to modify, click Properties.
3. Change the owner, and then click Apply.
1. From the Home page, click Strategic Modeling , and then Model View
.
2. From the Actions menu next to the model you want to modify, click Properties.
3. Change the properties, and then click Apply:
• Owner—Specify the account owner.
9-8
Chapter 9
Pushing Data Between Strategic Modeling and Planning
Note:
• Groovy is available with EPM Enterprise Cloud. You can create and edit
Groovy rules in all of the application types (Custom, Module, and Free
Form).
• You can also use Groovy rules with Enterprise PBCS and PBCS Plus
One.
• In addition, you can use Groovy rules with Oracle Strategic Workforce
Planning Cloud and Oracle Sales Planning Cloud.
Groovy business rules allow you to design sophisticated rules that solve use cases
that normal business rules can't solve; for example, rules to prevent users from saving
data on forms if the data value is above a predefined threshold.
You create Groovy rules in Calculation Manager and execute them from any place that
you can execute a calc script rule in a Planning application; for example, on the Rules
page, within the context of a form, in the job scheduler, in dashboards, in task lists,
and so on.
9-9
Chapter 9
Pushing Data Between Strategic Modeling and Planning
Groovy rules are also supported in rulesets. You can have a combination of calc script
rules and Groovy rules within a ruleset.
Groovy rules are not supported in composite forms.
You can execute jobs of type rules, rulesets, and templates synchronously from a
Groovy rule.
Oracle supports two types of Groovy rules:
• Rules that can dynamically generate calc scripts at runtime based on context other
than the runtime prompts and return the calc script which is then executed against
Essbase.
For example, you could create a rule to calculate expenses for projects only for the
duration (start and end dates) of the project.
Another example is a trend-based calculation that restricts the calculation to the
accounts available on the form. You could use this calculation for various forms in
Revenue, Expense, Balance Sheet, and Cash Flow. This allows for optimization
and reuse.
• Pure Groovy rules that can, for example, perform data validations and cancel the
operation if the data entered violates company policies.
Tutorial Video
• Under All Classes in the left pane, click a class to see the examples for that
class.
For example, to see Strategic Modeling examples, click the StrategicModel
class in the left pane.
9-10
Chapter 9
Pushing Data Between Strategic Modeling and Planning
9-11
Chapter 9
Pushing Data Between Strategic Modeling and Planning
Tip:
Account members with the same name are automatically mapped
(based on the Description in Strategic Modeling and the Name in
Planning.) Click Map in the Account row to see the mappings.
Tip:
If you know all of the member names, you can skip this step and
enter the member names directly in Advanced Data Maps. See
Defining Advanced Data Maps.
a. Click Actions next to a mapping row and then select Add Source
Mapping or Add Target Mapping.
b. Select the additional dimension to map, and then select the members to map.
For example, you might want to map the Time dimension in Strategic
Modeling to the Years and Period dimensions in Planning.
Or, you might want to map the Business Case in Strategic Modeling to
Scenario and Version in Planning. Including the Version dimension allows
run-time input when you run the consolidation.
10. To exclude source members from the data map, click Actions next to a
mapping row and then select Add Exclusion. Define the member or members to
9-12
Chapter 9
Pushing Data Between Strategic Modeling and Planning
exclude and then click OK. The excluded member or members are shown on the
Data Maps page.
Excluding members while moving data is useful if you don't want to overwrite
certain data at the target location or if you want to avoid getting warnings if data at
the target location is not present. Also, exclusions can ignore specific source
member data while data is required for all other source members.
When excluding members from a dimension, the member list for the dimension
must contain at least one member that is not on the excluded member list in order
for the data map to successfully save and run.
To remove one or more excluded members from the exclusion list, click the
members in the exclusion list, and remove the member or members from the list
using the Member Selector.
To remove the entire exclusion, click Actions next to a mapping row and then
select Remove Exclusion.
Tip:
If you set up Smart Push for a form, you can also exclude members from
the Smart Push. See Configuring Smart Push for a Simple Form. When
you define Smart Push for a Planning form to push data to Strategic
Modeling, the members defined for the Smart Push must match the
members defined in the data map.
11. If the member names don't match in the source and target, or when mapping to or
from multiple dimensions to or from a single dimension, you must define an
advanced data map. See Defining Advanced Data Maps. You can also use
advanced data maps to define mappings when you know all the member names.
12. Click Save and Close at any time. If the data map definition is not yet complete,
you will receive an error, but you can save the data map as a draft so you can
continue to work on it at another time.
13. Associate the data map with a model or consolidation:
• If the source is a model, you can optionally associate the data map with a
model. See Associating a Data Map with a Model.
• If the source is a consolidation, you must associate the data map with a
consolidation. See Associating a Data Map with a Consolidation.
You can associate up to three data maps with a model or consolidation.
14. Optionally, specify options that define how to execute the data map. See Defining
Data Map Options.
For information about running data maps, see Running a Data Map.
Watch these tutorial videos to learn more about creating data maps to move data
between Strategic Modeling and Planning.
Overview Video
Overview Video
9-13
Chapter 9
Pushing Data Between Strategic Modeling and Planning
• You can Copy Rows or Paste Rows or copy and paste data from
one tab to another.
9-14
Chapter 9
Pushing Data Between Strategic Modeling and Planning
• Add as many rows as needed to define all the members to map. Click Insert
Row to add a mapping definition between a source and target member.
• If needed, click Delete Invalid Entries to clear any mapping rows where
the source is invalid and clear any invalid target members.
3. When mapping from multiple dimensions to a single dimension, for example from
Years and Period in Planning to Time in Strategic Modeling, the Edit Data Map
page is populated the all the possible source combinations. Select the
corresponding target members for each source combination you need.
If you've defined any exclusions, the excluded members are not listed.
If there are some source combinations you don't need to map to, select the row
and then click Delete Row . This source combination will not be automatically
populated again if you return to the Edit Data Map page.
If you later want to see the deleted source combinations, click Populate Detailed
Mappings . The Edit Data Map page is updated to show all possible source
combinations.
4. Click Done.
Note the following about mapping members:
• When member names in source and target match and are automatically mapped,
they are not listed on the Mapping Details page.
• You can only select target members that are listed on the Target Selection tab. If
you need a different member, return to the Data Maps page and select it from the
Target member list. (If you didn't enter members on the Data Maps page, you're
not restricted in this way.)
To simplify defining an advanced data map, you can export the data map definition to
Excel, edit the data map template in Excel, and then import it. See Using Microsoft
Excel to Define Advanced Data Maps.
9-15
Chapter 9
Pushing Data Between Strategic Modeling and Planning
Overview Video
Overview Video
1. From the Home page, click Strategic Modeling and then click Model
View .
2. From the Actions menu next to the model you want to associate, click Properties,
and then click Data Maps.
9-16
Chapter 9
Pushing Data Between Strategic Modeling and Planning
3. Click Add .
Any data maps that have this model as a source are listed.
4. Click the data map, and then click Associate.
You can associate multiple data maps with a model.
5. To run the data map when the model is checked in, select Run on Check-In.
6. Click Apply.
You can also delete a data map association with a model.
1. From the Home page, click Strategic Modeling and then click
Consolidation View .
2. Open the consolidation you want to associate with a data map.
3. From the Actions menu, select Set Data Maps.
4. In the Data Maps column, click None if no data maps are already associated with
this consolidation. Or click the data map name if a data map is already associated
with the consolidation.
5. Click Add .
Any data maps that have this consolidation as a source are listed.
6. Click the data map, and then click Associate.
7. For a child model in the consolidation, select an option for Use Default Data Map:
• By default, Use Default Data Map is selected for child models. If the child
model is specified in the data map selected for the parent, selecting Use
Default Data Map runs the data map for the child model to push to the target
scenario defined in the data map, using the child's contributing scenario as
defined in the consolidation view.
Use Default Data Map has no effect if the child model is not specified in the
data map for the parent.
• If you clear the selection for Use Default Data Map, you can:
– Have no data map run for the child model.
– Associate a different data map with the child model. Click Add , click
the data map to associate (any data maps that have this child
consolidation as a source are listed), and then click Associate.
8. Make sure Run on Consolidation is selected so the data map runs when you run
the consolidation by selecting Run and Push Data.
9-17
Chapter 9
Pushing Data Between Strategic Modeling and Planning
9. Click Close.
Maps page: From the Home page, click Application , then Data Exchange
, and then click Data Maps. From the Actions menu for the data map you
want to run, select Clear and Push Data.
To check the status of the data map and Smart Push job, from the Home page, click
Application , and then click Jobs . Click the job name to see
information and status about the Smart Push job. If there is an error, click Error to see
details to help you resolve the error.
9-18
Chapter 9
Pushing Data Between Strategic Modeling and Planning
• In Select Entity, select a Financials Entity dimension member. The model will
be mapped to the selected Entity dimension member.
• If the Planning application is multi-currency, select a currency from the
Currency list. If the Planning application is single currency, this option is not
available, and it defaults to the application's currency.
• The Calendar, Time Period, and Configure Years pages of the Create New
Model wizard are not available when you create a model from the Financial
template. The Start and End Period dates are set based on the Planning
application. Year Configuration is monthly.
When you create the model, two data maps are created. The data maps' detailed
mappings are automatically populated between the dimension members in
Strategic Modeling and in Financials. You can optionally view the detailed data
maps: From the Home page, click Application, then click Data Exchange, and
then click Data Maps.
• <Model_Name>_SMtoPLDatamap pushes data from Strategic Modeling to
the Target version in Financials. By default, the data map is associated with
the model you just created and is set to run when you check in the model.
• <Model_Name>_PLtoSMDatamap pushes data from the Working version in
Financials to Strategic Modeling.
For more details about enabling Strategic Modeling, see Enabling Strategic
Modeling.
For more details about creating a Strategic Modeling model, see Creating a
Strategic Modeling Model.
3. To push data from Strategic Modeling to Financials:
a. Check out the Strategic Modeling model, enter data, and then calculate the
scenario or all scenarios.
b. Check in the model.
If the data map is set to run on check-in (the default), when you check in the
model, the data map runs and the Smart Push job is submitted.
Tip:
To check the status of the job, from the Home page, click
Application and then click Jobs.
In Financials, open the income statement to review the data that was pushed.
From the Home page, click Financials, then click Revenue, and then click
Income Statement.
4. To push data from Financials to Strategic Modeling use one of these methods:
• Run the data map from the Data Maps page: From the Home page, click
9-19
Chapter 9
Managing Metadata with Model Change Management
Note:
You can make a copy of the data maps before editing them so you can keep
the original data map definition.
Note:
Custom dimensions in Strategic Modeling and a custom chart of accounts in
Financials are not supported when pushing data between Strategic Modeling
and Financials.
9-20
Chapter 9
Managing Metadata with Model Change Management
• Scenarios
See Defining Metadata to Copy with Model Change Management.
3. Run Model Change Management to copy the metadata from the source model to
target model or models.
See Copying Metadata from Source to Target.
4. If needed, you can edit or delete a Model Change Management definition.
See Editing or Deleting a Model Change Management Definition.
Watch this tutorial video to learn more about copying subaccounts and account
attributes with Model Change Management.
Tutorial Video.
Watch this tutorial video to learn more about copying account groups with Model
Change Management.
Tutorial Video.
Watch this tutorial video to learn more about copying scenarios with Model Change
Management.
Tutorial Video.
Watch this tutorial video to learn more about copying time periods with Model Change
Management.
Tutorial Video.
3. On the Map Target Model tab , click Add Target , select the target
model or models you want to copy metadata to, and then click OK.
The list includes all the models in the application.
Click Exclude to prevent a target model from being included when Model Change
Management runs; metadata is not copied to this model.
4. Define the metadata to copy, and then click Save.
See Defining Metadata to Copy with Model Change Management.
9-21
Chapter 9
Managing Metadata with Model Change Management
2. Define the subaccounts to copy: On the Accounts tab, click Add and then
click Add Subaccount Change. The list displays all the accounts that have
subaccounts. Select the accounts that have the subaccounts that you want to copy
to the target models, and then select from additional options for copying
subaccounts:
• Keep account details in the target—Keeps account hierarchy details in the
target even if they do not exist in the source.
• Copy account attributes—Copies the attributes of the selected account to the
target.
For all accounts, copies:
– Account Name
– Forecast Method
– Subtotal Method
– Account Note
– Exchange Rate
For Memo accounts, copies:
– Account Name
– Calculation Method
– Aggregation Method
– Output Type
– Output Unit
• Delete accounts not in the source—Deletes any accounts in the target that are
not in the source. Oracle recommends that you select this option. Clearing this
selection can cause errors during consolidation.
All of the subaccounts from the selected accounts are copied to the target.
3. Define the account attributes to copy: On the Accounts tab, click Add and
then click Add Account Attribute Change. Select the accounts that have the
attributes that you want to copy to the target models, select the scenarios to copy
for the selected accounts, and then select from additional options for copying
account attributes:
• Rename Accounts—Renames accounts in the target to match those in the
source.
• Copy Other Account Attributes—When you select this option, these account
attributes are copied from the source to the target:
9-22
Chapter 9
Managing Metadata with Model Change Management
Tip:
To edit the selections for accounts, click the link in the Change Details
column on the Accounts tab.
4. Define the account groups to copy: On the Account Groups tab, click Add
Account Group . Select the account groups you want to copy to the target
models, and then select from the following options:
• Do not overwrite account group in the target—Does not overwrite the account
group if it already exists in the target.
• Overwrite account group in the target—Overwrites the account group if it
already exists in the target.
• Delete account group in the target—Deletes any account groups in the target
that are not in the source.
Tip:
Use Search Account Groups to easily find the account groups to copy.
5. Define how to handle custom dimensions when copying to the target: On the
Custom Dimensions tab, click Copy Custom Dimensions to copy the custom
dimensions to the target, and then select from the following options:
• Assign accounts to custom dimensions in the target—Copies the account
assignments along with the custom dimension structure to the target. For
example, if the Sales account in the source is associated with a custom
dimension, when the custom dimension structure is copied to the target,
selecting this option assigns the custom dimension to the Sales account in the
target.
• Keep subhierarchies in custom dimensions in the target—When a custom
dimension is in the target and in the source, allows you to keep child
dimension members that are in the custom dimension in the target that are not
in the source.
9-23
Chapter 9
Managing Metadata with Model Change Management
Tip:
Click Preview Source Custom Dimensions to review the custom
dimensions in the source model before making your selections.
6. Define how to handle time periods when copying to the target: On the Time tab,
click Copy Time Structure to copy the time structure to the target, and then select
one or more of the following options for retaining time structure details in the
target:
• Allow the target to keep time period details—Allows the target to retain time
detail that is not in the source. For example if the source contains only years
but the target also contains quarters, selecting this option retains the quarters
in the target when you copy the time structure.
• Allow the target to keep years earlier than years defined in the source—For
example if the source model's time structure includes 2018 - 2022, and the
target model includes 2015 - 2020, selecting this option results in the target
model time structure to include 2015 - 2022.
• Allow the target to keep years later than years defined in the source—For
example if the source model's time structure includes 2017 - 2022, and the
target model includes 2018 - 2025, selecting this option results in the target
model time structure to include 2017 - 2025.
If you leave these options cleared, the time structure of the source completely
replaces the time structure of the target.
Tip:
Click Preview Source Time Periods to review the time periods in the
source model before making your selections.
7. Define how to handle scenarios when copying to the target: On the Scenarios tab,
click Add Scenario Change , select the scenarios to copy to the target, select
from the following options, and then click Add:
• Do not overwrite scenario in the target—Keeps any scenarios already in the
target, even if they are not in the source.
• Overwrite scenario in the target—Overwrites scenarios in the target.
• Delete scenario in the target—Deletes scenarios in the target that aren't in the
source.
If needed, after you've defined the scenarios to copy, you can change the options
on the Scenarios tab: Click Change Details next to the scenario, and select a
new option.
8. Click Save and Close.
9-24
Chapter 9
Managing Metadata with Model Change Management
9-25
10
Followup Administrative Tasks
This chapter includes these topics:
• Pushing Data Using Data Maps
• Mapping Data for Reporting
• Entering Assumptions
• Maintaining Your Application
• Updating Planning Modules
• Customizing Predefined Artifacts
10-1
Chapter 10
Mapping Data for Reporting
Entering Assumptions
Financials, Workforce, Projects, and Capital let planners define assumptions such as
revenue drivers, expense drivers, rates, and so on that drive calculations. As an
administrator, you can define these assumptions as a starting point for your planners.
Planners can modify them as needed.
For information about setting up assumptions, see Working with Planning Modules.
10-2
Chapter 10
Updating Planning Modules
Note:
If you plan to modify the navigation flows, Oracle recommends that you make
a copy of the predefined navigation flows and work in the copy, not the
original. When you update, Oracle applies the update to the original
navigation flows and leaves your modified navigation flows unchanged.
Before updating, the application is put in maintenance mode and only administrators
can use the application.
If any metadata changes are detected, the database is refreshed before content
update. If any validation errors are detected, you must resolve the errors before you
can update content.
Use the Job Console to review the errors.
10-3
Chapter 10
Customizing Predefined Artifacts
• Accounts—You can add more accounts. For predefined accounts, you can
change the alias and member formula, and enable the members for other plan
types. You can't delete or rename predefined members.
• Forms —You can add new forms and change the layout of predefined forms. You
can't rename or delete the predefined forms.
• Calculations—You can add member formula/rules or change predefined member
formula/rules.
• Dashboards—You can change dashboard layout, and add more dashboards. You
can't rename or delete predefined dashboards.
• Navigation flows—Change navigation flows by renaming or adding new tasks.
For additional information about requirements for preserving modified navigation
flows during content update, see Customizing Navigation Flows.
• Aliases for predefined drivers—You can only modify, not delete or rename.
• Map reporting definitions for integrations—You can only modify, not delete or
rename.
• Driver and KPI formulas—You can only modify, not delete or rename.
• Labels—You can change the label for all predefined artifacts.
• Variables—You can add new variables.
When you customize artifacts, you might need to adjust calculations and related
content to ensure the application’s integrity.
Note:
When you modify artifacts, they are tracked internally. Oracle maintains
these customizations during content updates.
Some artifacts are locked to ensure that internal calculations work properly and you
can’t modify them.
See Administering Planning for details about customizing artifacts.
10-4
Chapter 10
Customizing Predefined Artifacts
Reversing Customizations
To undo customizations to predefined artifacts:
2. From the Actions menu, select Review Modified Artifacts. Click Filter to
select different artifact types.
3. Select the artifacts, and then click Restore.
Watch this tutorial video to learn more about restoring artifacts to their predefined
state.
Tutorial Video
2. Click Filter .
3. From Artifact, select Member or Form.
4. If you selected Member, select Account from the Dimension list.
5. For Property, select Formula Description for member formulas or Description
for form descriptions and click Apply.
6. Select a language from the Add Language list.
7. To customize the help, click Actions, then Export, modify the content as required,
and then click Import to integrate the help in the application.
8. To change the help language, click Add Language and select a language.
You can also add descriptions for other artifacts or instructions to planners. See
Administering Planning.
10-5
Chapter 10
Customizing Navigation Flows
Note:
If you plan to modify the navigation flows, Oracle recommends that you make
a copy of the predefined navigation flows and work in the copy, not the
original. During content updates, Oracle applies the update to the original
navigation flows and leaves your modified navigation flows unchanged.
If you incrementally enable additional features, any new forms or other artifacts are
added to the original and the copy of the navigation flows.
10-6
A
Business Scenarios
Related Topics
• IT Financial Management in EPM Cloud
• Configuring Planning Modules for IT Planning
A-1
Appendix A
IT Financial Management in EPM Cloud
Business users can use Rule Balancing to review the rules and their impact on the
data. Click the Smart View links to see the details. The ability to perform step by step
validation of rules with access to details provides transparency and auditability. It gives
you access to the operational data outside of the General Ledger where you can
model the data using pre-built analytics, without impacting the General Ledger.
After defining the rules, you can review more than ten reports provided with the IT
Costing and Chargeback Template. Reports include:
• Bill of IT Services—Shows chargeback and charge rate and drivers. You can
choose whether to charge back to consuming organizations. If you chose to
perform chargebacks, you can push the charges back to the General Ledger.
A-2
Appendix A
IT Financial Management in EPM Cloud
• Service Costing—Shows the cost per supported user and project and resource
consumption.
• Project Costing—Lets you analyze the costs for run versus build, and capital
expenditures versus operating expenditures.
After modeling the IT costs and allocating costs in Profitability and Cost Management,
push the data to Planning Modules using Oracle Enterprise Data Management Cloud
and perform further planning and analysis in Financials and Projects.
In Financials, you can perform high level IT spend planning, by Services and
Applications.
In Projects, you can perform more detailed project planning to plan by resource, and
understand project costs and benefits before submitting plans for approval. You can
then compare the plan against what is actually spent and review variations and
deviations using IT Costing.
Customize Projects for IT with custom forms, dashboards, drivers, and navigation flow.
Add a custom dimension for Service, and share the members from the IT Service
Catalog in Profitability and Cost Management.
A-3
Appendix A
IT Financial Management in EPM Cloud
For example, this custom navigation flow in Projects provides a workflow for:
• Entering IT spends for services applications.
• Allocating IT spends to projects.
• Analyzing IT project costs and benefits.
• Performing chargeback planning.
• Reviewing IT Spends overview in a dashboard.
Enter IT spends for services applications in the data entry form:
A-4
Appendix A
IT Financial Management in EPM Cloud
A-5
Appendix A
IT Financial Management in EPM Cloud
By importing data from the General Ledger, modeling and allocating costs in
Profitability and Cost Management, and then pushing the data to Planning Modules
using Oracle Enterprise Data Management Cloud, you create an IT Financial
Management system with pre-built analytics that is easy to use, gives you
transparency of results and auditability, helps you optimize IT investment decisions,
and promotes partnership with the business.
Watch this overview video to learn more about IT Financial Management in EPM
Cloud.
Overview Video
A-6
Appendix A
Configuring Planning Modules for IT Planning
Tutorial Video.
Here's an example of a customized navigation flow:
Let's take a look at each card and its custom dashboards and forms.
A-7
Appendix A
Configuring Planning Modules for IT Planning
IT Spending
The IT Spending tab helps you monitor expenses across new and existing IT projects.
The IT Spending dashboard lets you monitor expenses at a high level, such as IT
spending by category and trend. You can review top down IT spending targets and
design reliable IT spending forecasts.
Monitor additional detail that relates to expenses and income statement on the
Expense and Income Statement tabs.
A-8
Appendix A
Configuring Planning Modules for IT Planning
On the Driver and Trend based tab , expenses are calculated using driver-
based or trend-based assumptions.
For example, the acquisition of server machines requires drivers for the number of IT
Server Machines and the maintenance cost per machine.
A-9
Appendix A
Configuring Planning Modules for IT Planning
Analysis
In Analysis, you can monitor progress and performance, and review financial and non-
financial benefits, which allows you to determine if it's worth investing in a specific IT
Project
The Analysis dashboard contains a summary of charts used to monitor the project.
IT Project Summary
In IT Project Summary, you can monitor IT projects and related labor costs.
A-10
Appendix A
Configuring Planning Modules for IT Planning
This section allows you to manage and plan for resource assignments.
A-11
Appendix A
Configuring Planning Modules for IT Planning
This section allows you to identify other costs related to the project, and determine
financial and non-financial benefits that help justify investing in IT projects.
A-12
Appendix A
Configuring Planning Modules for IT Planning
For information about creating custom navigation flows, see Designing Custom
Navigation Flows in Administering Planning.
A-13
B
Importing Data
You can download data import templates from within the application. The templates
are generated based on the features you’ve enabled and the custom dimensions that
were added.
To download the data import templates:
1. From the Home page, click Application and then click Configure
.
2. From the Configure list, select the module for which you want to download
templates, and then from the Actions menu, select Download Data Load
Templates.
3. Save the ZIP file locally, and then extract the CSV files.
Perform these tasks to import data:
1. Before importing data, configure the application as described in this help system
and use Configure to import the dimensional metadata.
Note:
Oracle recommends that you use Configure to import metadata, which
ensures that metadata is loaded correctly to work with the provided rules
and forms. If you choose to use the Dimension Editor to load metadata,
the primary hierarchy for a dimension should go under the All member
for the dimension. You can add alternative hierarchies under the Root
member as well, but the member should be a Parent or rollup type
member. No parent or member should be set to aggregate to the root
member of a dimension, because the root member can't be displayed on
any form, dashboard, or report.
2. Specify the appropriate data import settings. See Administering Data Load
Settings.
3. Optional: Make a backup copy of the data import templates to which you can
revert, if necessary.
4. Optional: Back up the application.
5. If you created custom Smart Lists, import them before the associated data
(available only for some modules.)
To identify the Smart List to import and their entry names:
B-1
Appendix B
About Importing Data
a. Click Navigator , and then from Create and Manage, click Smart Lists.
b. Select the Smart List, click Edit, and then Entries.
c. Note the associated names.
6. Open the templates in Microsoft Excel and customize them to specify your
business data.
Tip:
For 13-period applications, you can customize the templates to include a
row for the 13th period.
7. Optional: To ensure that your data will import and calculate correctly, import it into
a test application first.
8. Import the data into your production application.
9. For the first data import, run the rules required to process and calculate the data.
When customizing the templates:
• Don’t enter zeros.
• To import data, you must have at least one member from all dimensions in the file
to import.
• Remove columns for which you have no data. For example, if your periodocity is
monthly, you can delete columns for Qtrly 1 - 4.
• If member names start with zeros (0), change numeric columns to text.
Tutorial Video
B-2
Appendix B
Importing Financials Data
B-3
Appendix B
Importing Workforce Data
– Columns C-F set the cash collection or cash disbursements timing for the
particular account. The values entered must equal 100% for the four columns.
• Point of View—identify where to load BegBalance, No Product, No Services, No
Channel, No Customer, No Segment, OEP_No Entity, No Year, OEP_Plan,
OEP_Working, USD
– BegBalance—Cash flow Direct assumptions are loaded to BegBalance.
– No Product, No Services, No Channel, No Customer, No Segment—Indicate
the applicable custom dimensions that you set up when you enabled features.
If you don't use custom dimensions, these members will not be seeded.
– OEP_NoEntity—Member in the Entity dimension that identifies the
departments in the business hierarchy to which to load data.
– NO Year— Indicate the Year dimension member.
– OEP_Plan—Scenario dimension member.
– OEP_Working—Version dimension member.
– USD—The exchange rate (for a multicurrency application).
• The Data Load Cube Name must be OEP_FS.
• For the first data import, run the rules required to process and calculate the
data:Financials: Calculate Actuals, and Rollup.
Note:
If you want to load only changed and new Workforce data since the last load,
you can improve load performance using Data Management. See Loading
and Calculating Incremental Workforce Data.
Note:
As of the February, 2020 Release, Workforce supports a new Start Date
property. The data import templates include headers and examples for
loading data such as Hire Date to OWP_Start Date rather than to OWP_Start
Month. You can still load data to Start Month, and the Process Loaded Data
rules convert the data to Start Date using the first of the month provided in
the Start Month account. So, existing data integrations based on Start Month
data continue to work. You'll get more accurate calculations, however, if you
load data into Start Date.
The templates reflect the CurYr that you set in the Planning and Forecast
Preparation configuration task. After importing your data and refreshing the cube, run
B-4
Appendix B
Importing Workforce Data
the rule Process Loaded Data to copy the data to the necessary periods in the
planning year range.
The prefix of each template name depends on the application's granularity:
• EJ_ precedes template names for Employee and Job applications. For example:
EJ_EmployeePropertiesDataLoad_Plan.csv.
• EO_ precedes template names for Employee-only applications. For example:
EO_EmployeePropertiesDataLoad_Plan.csv.
• JO_ precedes template names for Job-only applications. For example:
JO_JobOtherCompensationDataLoad_Plan.csv.
Note:
For the EJ_EmployeePropertiesDataLoad_Plan.csv template,
don't load to No Union Code or to OWP_All Union Code. Instead add
and use new child metadata member of Total Union Code. Otherwise,
the synchronize rules may not work properly.
1. From the Home page, click Navigator , and then under Integration, click
Data Load Settings.
2. Set these parameters for importing data:
• Data Load Dimension: Account
• Driver Dimension: Period. Member:
BegBalance,ILvl0Descendants(YearTotal)
• Data Load Dimension Parent:
– OWP_Total Earnings. Driver Dimension Unique Identifier: BegBalance
B-5
Appendix B
Importing Workforce Data
Importing Properties and Rates for Additional Earnings, Benefits, and Taxes
Use these templates as examples when importing properties and rates for additional
earnings, benefits, and taxes into the Benefits and Taxes Wizard.
• Earnings,Benefits and Taxes-Properties.csv—Import properties for
additional earnings, benefits, and taxes.
• Earnings,Benefits and Taxes-Rates.csv—Import rates for additional
earnings, benefits, and taxes.
B-6
Appendix B
Importing Workforce Data
After the Data Management load process, the changed and new data displays in the
appropriate Workforce forms. The data reflects calculations applied in the load
process.
To learn how to load and calculate incremental Workforce data in Data Management,
watch this tutorial video.
Note:
Whenever you load data from Data Management, to copy data to future
periods, you must select one of these Workforce rules: OWP_Incremental
Process Data and Synchronize Defaults or OWP_Incremental Process
Data and Synchronize Definition. See Deciding Which Workforce Rules to
Add.
Tip:
You'll experience better performance if you provide a presorted source file.
B-7
Appendix B
Importing Workforce Data
• Only single Period data loads are supported for an incremental load. Multi-period
loads are not supported.
• Drill down is not supported for incremental loads because incremental files are
loaded in Replace mode and only the last version of the file comparison is present
in the staging table. As a workaround, you can load the same data file to another
location using the full data load method. In this case, you should import data only
and not export it to the target application.
• Copies of the source data file are archived for future comparison. Only the last 5
versions are retained. Files are retained for a maximum of 60 days. If no
incremental load is performed for more than 60 days, then set the Last Process ID
to 0 and perform the load.
You can load data using the Incremental File Adapter multiple times.
Note:
Options when defining the Data Load Rule in Data Management enable you
to decide if you're loading only incremental data into Workforce or loading all
data every time.
B-8
Appendix B
Importing Workforce Data
2. Set up the Import Format, which describes the source file structure and is
executed when the source file is imported:
a. On the Setup tab, under Integration Setup, click Import Format.
b. Under Import Format Summary, click Add.
c. Under Details, enter a name for the Import Format.
d. In Source, browse to select your source.
e. From File Type, select the delimited file type.
Oracle recommends selecting Delimited - All Data Type, which is common
for loading text as well as numeric data.
f. From the File Delimiter drop-down list, select the delimiter type in the source
data file: comma, vertical bar, exclamation, semicolon, colon, tab, and tilde.
g. In Target, browse to select your Planning application, and then click Save.
h. Under Mappings, map dimensions between the Source Column and the
target application, and then click Save.
The Source Column is populated with the dimensions from the header row in
your source data file.
Note:
Only single-period loads are supported.
For more information on Import Formats, see Working with Import Formats in
Administering Data Management for Oracle Enterprise Performance
Management Cloud.
3. Define the Location, which is the level at which a data load is executed in Data
Management. The Location specifies where to load the data and is associated with
the Import Format.
a. On the Setup tab, under Integration Setup, select Location.
b. Under Location, click Add.
c. Under Details, on the Location Details tab, enter a name for the Location.
d. Browse to select your Import Format.
e. Enter the Functional Currency, and then click Save.
For more information, see Defining Locations in Administering Data Management
for Oracle Enterprise Performance Management Cloud.
4. Create member mappings:
a. On the Workflow tab, under Data Load, select Data Load Mapping.
b. At the bottom of the page, verify the POV for the Location.
i. Click the link for Location, which displays the Select Point of View dialog
box.
ii. Select your Location, Period, and Category (Scenario).
iii. Optional: Select Set as Default to retain this POV.
B-9
Appendix B
Importing Workforce Data
c. Map the members from the source that you are loading to the target
application:
i. At the top of the page, from Dimension, select a dimension in your source
file.
ii. Click one of the five member mapping tabs (for example, the Like tab),
and then click Add.
iii. Enter an asterisk (*) in the Source Value column and also in the Target
Value column to represent all values.
iv. Click Save after mapping members for each dimension.
You must create a member mapping for each dimension in the source
data file.
For more information, see Creating Member Mappings in Administering
Data Management for Oracle Enterprise Performance Management
Cloud.
5. Select the data load rule: On the Workflow tab, under Data Load, select Data
Load Rule.
a. At the bottom of the page, verify the POV for the Location, just like you did in
Step 4b.
b. In the Data Rule Summary area, click Add.
c. Under Details, enter the data load rule name.
d. In Category, select the category to map source system data to target
Scenario members.
e. In Period Mapping Type, select Default.
f. You don't need to specify an Import Format, because the Import Format from
the Location is used. Specify an Import Format only when you want to override
the Import Format for the Location.
g. From the Target Plan Type drop-down list, select OEP_WFP.
h. On the Source Filters tab, in Source File, browse to select the data file that
contains the data you're loading. It may be the same one from which you
created the data source application, or another file that has data as well as the
appropriate header.
It may have the same name as the original file, or it may have a new name.
The differences in the incremental load file are created automatically between
the two loaded files. So if file A.txt has 100 rows and file B.txt has 300 rows
where the first 100 are identical, your first load should select file A.txt when
the Last Process ID is 0. The second load will be against file B.txt, and the
ID automatically points to the Last Process ID that was assigned to A.
i. In Incremental Processing Option, select whether to sort data in the source
file:
• Do not sort source file—The source file is compared as provided. This
option assumes that the source file is generated in the same sort order
each time. Data Management compares the files, and then extracts the
new and changed records. This option makes the incremental file load
perform faster.
• Sort source file—Data Management sorts the source file before
performing the file comparison for changes. The sorted file is then
B-10
Appendix B
Importing Workforce Data
compared to the previous sorted version of this file. Sorting a large file
consumes many system resources. If the source system provides a sorted
file, avoid using this option because it consumes computer resources and
slows performance.
Note:
If you have a rule that uses the Do not sort source file option
and then switch to a Sort option, then the first load will have
invalid results because the files are in different order.
Subsequent runs load data correctly.
Note:
Copies of the source data file are archived for only the last 5
versions and retained for a maximum of 60 days. After 60 days,
set the Last Process ID to 0 and then perform the load.
j. Click Save.
6. Select the Load Method for the target application and add the Workforce business
rules that execute the logic for the incremental load when the data load rule is run:
a. Click the Setup tab, and under Register, click Target Application.
b. Under Target Application Summary, from the Type column, select
Planning.
c. Under Application Details, click the Application Options tab.
d. For Load Method, select All data types with security, and then click OK.
e. Click the Business Rules tab, and then click Add.
f. Under Business Rule, enter or paste the Workforce business rule name.
For information on Workforce rules, see Deciding Which Workforce Rules to
Add. For more information on adding business rules in Data Management see
Adding Business Rules in Administering Data Management for Oracle
Enterprise Performance Management Cloud.
g. Under Scope, select Data Rule.
h. Under Data Load Rule, select the data load rule you created, and then click
Save.
7. Preview the data before exporting it.
B-11
Appendix B
Importing Workforce Data
Tip:
After loading data, to quickly update and process data on multiple existing
employees, jobs, or entity defaults in Workforce, you can use the Mass
Update forms. These forms enable you to quickly review and edit
employees, jobs, and entity defaults after data is loaded. Designed for
optimal processing efficiency, each form is associated with a Groovy rule that
processes only the changed data. See Updating Multiple Employees and
Jobs Details in Working with Planning Modules.
Table B-1 Deciding Which Workforce Rule to Add to the Integration File
B-12
Appendix B
Importing Workforce Data
Table B-1 (Cont.) Deciding Which Workforce Rule to Add to the Integration File
For more information, see Adding Business Rules in Administering Data Management
for Oracle Enterprise Performance Management Cloud.
B-13
Appendix B
Importing Projects Data
B-14
Appendix B
Importing Projects Data
• Project details are imported to the No Project Element and No Resource class
members.
• If the application uses simplified multiple currency, Project Details goes to the No
Currency member.
• OEP_No Entity is from the Entity dimension.
• OEP_Plan is from Scenario dimension.
• OEP_Working is from the Entity dimension.
• No Vendor is from the Vendor dimension, if it was added when you enabled
features.
• No Phases is from the Phases dimension, if it was added when you enabled
features.
B-15
Appendix B
Importing Projects Data
• No Vendor is from the Vendor dimension, if it was added when you enabled
features.
• No Phases is from the Phases dimension, if it was added when you enabled
features.
• USD is a member from the Currency dimension.
B-16
Appendix B
Importing Projects Data
B-17
Appendix B
Importing Projects Data
– OPF_Equipment—Sets the Job Smart List member for the line item. The Job
list found in the Resource Element dimension under Detailed Jobs.
– OPF_Equipment Description is textual.
– OPF_Equipment Units—Number of units.
• No Project is a member from the Project dimension.
• OPF_Equipments is the appropriate member from the Resource Element
dimension.
• OEP_No Entity is from the Entity dimension.
• Equipment Expense assumptions are imported to the No Year member from the
Year dimension and BegBalance from the Period dimension.
• OEP_Plan is from the Scenario dimension.
• OEP_Working is from the Version dimension.
• No Vendor is from the Vendor dimension, if it was added when you enabled
features.
• No Phases is from the Phases dimension, if it was added when you enabled
features.
• USD is a member from the Currency dimension.
B-18
Appendix B
Importing Projects Data
B-19
Appendix B
Importing Projects Data
B-20
Appendix B
Importing Projects Data
The accounts that actual data is imported to is dependent on the type of project. Other
Expenses – Billable should be used for Contract Project Time Material type only, all
other project types should use Other Expenses account.
Column
Months. You can import one month at a time or multiple months simultaneously.
Point of View
• Line 1 represents the Project Element dimension. If multiple lines of Other
expense you must use a different Line member.
• No Project is from the Project dimension.
• OPF_Base Resource is from the Resource Class dimension.
• OEP_No Entity is from the Entity Dimension.
• FY16 is from the Year dimension. You can import multiple years simultaneously .
• No Vendor is for dimensions of Vendor dimension, if it is added during enable
time.
• No Phases is for dimensions of Phase dimension, if it is added during enable time.
• OEP_Actual is from the Scenario dimension. If you want to import Plan or forecast
information set this field to the corresponding member.
• OEP_Working is from the Version dimension.
• USD is from the currency dimension if the application uses simplified multiple
currency.
B-21
Appendix B
Importing Projects Data
B-22
Appendix B
Importing Projects Data
B-23
Appendix B
Importing Projects Data
B-24
Appendix B
Importing Projects Data
B-25
Appendix B
Importing Projects Data
Global assumptions can either be manually entered via forms or can be imported into
Projects.
Row
Field 1 represents the Account dimension.
Column
OPF_Overhead Method—Sets the Smart List for the Overhead method for each type
of overhead. The accounts to be imported using this file format can be found under
OPF_Indirect Expense in the account dimension.
Point of View
• No Project is from the Project dimension.
• No Resource Class Resource is from the Resource Class dimension.
• OEP_No Entity is from the Entity Dimension.
• BegBalance is from the Period dimension.
• OEP_Plan is from the Scenario dimension. If you want to import historical Actuals
or forecast information set this field to the corresponding member.
• OEP_Working is from the Version dimension.
• No Currency is from the currency dimension if the application uses simplified
multiple currency.
• No Vendor is from the Vendor dimension, if it was added when you enabled
features.
• No Phases is from the Phase dimension, if it was added when you enabled
features.
Row
B-26
Appendix B
Importing Projects Data
Line 1 represents the Account dimension. The account members that you import are
loaded to OPF_Indirect Expense.
Column
Years for the overhead rates.
Point of View
• OPF_Overhead Rate—Account to which to import rates.
• No Project is from the Project dimension.
• No Resource Class Resource is from the Resource Class dimension.
• OEP_No Entity is from the Entity Dimension.
• BegBalance is from the Period dimension.
• No Vendor is from the Vendor dimension, if it was added when you enabled
features.
• No Phases is from the Phase dimension, if it was added when you enabled
features.
• OEP_Plan is from the Scenario dimension. If you want to import historical Actuals
or forecast information set this field to the corresponding member.
• OEP_Working is from the Version dimension.
• No Currency is from the currency dimension if the application uses simplified
multiple currency.
B-27
Appendix B
Importing Projects Data
• OEP_Plan is from the Scenario dimension. If you want to import historical Actuals
or forecast information set this field to the corresponding member.
• OEP_Working is from the Version dimension.
• OPF_Material Standard Cost, OPF_Equipment Standard Cost, OPF_Labor
Standard Hourly Cost.
• USD is from the currency dimension if the application uses simplified multiple
currency.
• No Vendor is from the Vendor dimension, if it was added when you enabled
features.
If rates vary by vendor, the file should contain multiple rows for the same
Resource Class.
• No Phases is from the Phases dimension, if it was added when you enabled
features.
B-28
Appendix B
Importing Projects Data
• USD is from the currency dimension if the application uses simplified multiple
currency.
• No Vendor is from the Vendor dimension, if it was added when you enabled
features.
• No Phases is from the Phase dimension, if it was added when you enabled
features.
B-29
Appendix B
Importing Projects Data
B-30
Appendix B
Importing Projects Data
OPF_PB Line 1 is from the Project Element dimension. Each Benefit should go to a
different benefit line.
Column
• OPF_Non Financial Benefits sets the Smart List to your non financial benefit
items. Non Financial Benefit Smart List needs to be populated with the customized
list of perceived benefits.
• OPF_Benefit Description is a text field.
• OPF_ OPF_Quantative Measure is the value of the benefit. This assumption
needs to be entered in the applicable month or months.
Point of View
• No Project is from the Project dimension.
• OPF_Base Resource is a member from the Project Resource dimension.
• Impacted Account and Financial Benefit textual value are entered to BegBalance
No Year. OPF_Quantative Measure should be entered per month.
• OEP_No Entity is from the Entity Dimension.
• OEP_Plan is from the Scenario dimension. If you want to import forecast
information, set this field to the corresponding member.
• OEP_Working is from the Version dimension.
• No Vendor is from the Vendor dimension, if it was added when you enabled
features.
• No Phases is from the Phase dimension, if it was added when you enabled
features.
• USD is from the currency dimension if the application uses simplified multiple
currency.
B-31
Appendix B
Importing Capital Data
• OPF_Asset Details—Sets the Smart List value for the CIP asset to which
allocation is being done. The assets correspond to the Asset Detail members in
Capital.
Point of View
• No Project is from the Project dimension.
• No Resource Class is from the Resource Class dimension.
• OEP_No Entity is from the Entity Dimension.
• No Year is from the Years dimension.
• OEP_Working is from the Version dimension.
• USD is from the currency dimension if the application uses simplified multiple
currency.
• No Vendor is from the Vendor dimension, if it was added when you enabled
features.
• No Phases is from the Phase dimension, if it was added when you enabled
features.
• BegBalance is from the Period dimension.
Note:
For the first data import, run the rules required to process and calculate the
data: OPF_Rollup Projects and Rollup Project Cube. If you imported
actuals, run Prepare Detailed Forecast Data and Prepare High Level
Forecast Data.
B-32
Appendix B
Importing Capital Data
• ExistingTangibleLoad.csv
• ExistingLeaseLoad.csv
• ExistingIntangibleload.csv
Use these guidelines:
• Columns—Column1 refers to the Asset Class dimension.
• Rows—Each asset detail must have data for three rows.
– Row 1 imports data at NoYear, USD, BegBalance. Modify these values to
specify the correct year, currency, and so on.
– Row 2 imports data to FY16, No currency, Begbalance. Modify these values
as required.
– Row 3 imports data to No year, No currency, Begbalance. Modify these values
as required.
• Point of View
Replace OEP_No Entity in the Point of View with the actual Entity.
Importing Actuals
Use these templates to import actuals for assets:
• PeriodTangibles.csv
• PeriodIntangibles.csv
• PeriodLease.csv
Use these guidelines:
• Columns— refers to Account members.
• Rows
– Rows 5 - 16 (Jan, Dec) refer to one year's calculated actual expense to be
imported for FY16. If data for FY15 has to be imported, then you must add a
new set of rows for FY.
– Row 17: NoYear-> Begbalance-USD combination has computed basic cost.
For each asset detail there needs to be only one row.
– Row 18: Data at NoYear->BegBalance->NoCurrency. Import asset detail
information such as purchase date, inservice date, description, and
justification.
• Point of View
– Use actual children of OCX_Total Major Assets for OCX_Total Major Assets.
– Use actual members of OCX_Tangible Assets for OCX_Tangible Assets.
– Use actual members of Entity in place of OEP_No Entity.
B-33
C
Updating Artifacts
Related Topics
• Updating Workforce Artifacts to Use New Features
• Updating Capital Artifacts
Tip:
For any artifacts listed below that you have modified, consider creating a
copy of your modified artifact and using that as a reference for the
changes you made to it.
Note:
Obsolete artifacts remain available for your use but will no longer be
enhanced and could be removed from active forms, menus, dashboards,
and so on.
3. After the update, reverse the customizations to the artifacts you've identified to
restore the artifacts to the provided format. See Reversing Customizations.
4. Reimplement your customizations to the artifacts, if necessary.
5. For any restored Calculation Manager rules or templates, after they are final, be
sure to deploy the updated rules or templates to the application for any impacted
artifacts. See Showing the Usages of a Custom Template and Deploying Business
Rules and Business Rulesets.
C-1
Appendix C
Updating Workforce Artifacts to Use New Features
Table C-1 February 2020 Update - Workforce Modified and New Artifacts
C-2
Appendix C
Updating Workforce Artifacts to Use New Features
Table C-1 (Cont.) February 2020 Update - Workforce Modified and New
Artifacts
C-3
Appendix C
Updating Workforce Artifacts to Use New Features
Table C-1 (Cont.) February 2020 Update - Workforce Modified and New
Artifacts
C-4
Appendix C
Updating Workforce Artifacts to Use New Features
C-5
Appendix C
Updating Workforce Artifacts to Use New Features
C-6
Appendix C
Updating Workforce Artifacts to Use New Features
C-7
Appendix C
Updating Workforce Artifacts to Use New Features
C-8
Appendix C
Updating Workforce Artifacts to Use New Features
C-9
Appendix C
Updating Workforce Artifacts to Use New Features
C-10
Appendix C
Updating Workforce Artifacts to Use New Features
C-11
Appendix C
Updating Capital Artifacts
C-12