FCCS Admin Guide
FCCS Admin Guide
E93973-35
Oracle Cloud Administering Financial Consolidation and Close,
E93973-35
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 embedded, installed or activated on delivered hardware, and modifications of such programs)
and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government
end users are "commercial computer software" or "commercial computer software documentation" pursuant
to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such,
the use, reproduction, duplication, release, display, disclosure, modification, preparation of derivative works,
and/or adaptation of i) Oracle programs (including any operating system, integrated software, any programs
embedded, installed or activated on delivered hardware, and modifications of such programs), ii) Oracle
computer documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in the
license contained in the applicable contract. The terms governing the U.S. Government’s use of Oracle cloud
services are defined by the applicable contract for such services. 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 Inside 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, Epyc,
and the AMD 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
3 Managing Security
Security Overview 3-1
Managing Artifact and Data Access 3-2
Assigning User Access to Artifacts 3-3
Assigning User Access to Data 3-3
Enabling or Disabling Security for Dimensions 3-4
Assigning Security to Dimension Members 3-4
Data Source Dimension Security 3-6
Managing Forms Security 3-6
Assigning Access to Forms and Folders 3-7
iii
Default Form Security 3-8
4 Managing Applications
Application Overview 4-1
Restrictions for Dimensions, Members, Aliases, and Forms 4-2
Managing Dimensions 4-5
Importing Metadata 4-6
Creating the Metadata Import File 4-6
Example: Entity Dimension Import File 4-7
Other Supported Delimiter Characters 4-7
Loading the Metadata Import File 4-9
Exporting Metadata 4-10
Validating Metadata 4-11
Metadata Validation Messages 4-12
Importing Data 4-17
Creating the Data Import File 4-18
Data Import File Format 4-18
Load Methods 4-18
Load Method Examples 4-19
Loading the Data Import File 4-21
Example: Data Import File - Periodic View 4-22
Example: Data Import File - YTD View 4-22
Example: Data Import File - YTD Input and Replace Mode 4-23
Example: Data Import File - Closing Balance Input and Replace Mode 4-24
Example: Data Import File - Overrides 4-25
Example: Data Import File - Exchange Rates 4-25
Exporting Data 4-26
Viewing Data Import and Export Status 4-27
Importing Data Using Data Management 4-27
Exporting Data Using Data Management 4-28
Data Integrations 4-29
Copying Data 4-30
Using Copy Data Profiles 4-32
Clearing Data 4-33
Using Clear Data Profiles 4-34
Refreshing the Database 4-35
Restructuring Cubes 4-37
Removing an Application 4-38
Scheduling Maintenance 4-38
Using the Inbox/Outbox 4-39
iv
Working with Activity Reports and Access Logs 4-39
v
Customizing Icons for Cards and Vertical Tabs 7-7
Hiding and Unhiding Cards and Tabs 7-7
Changing the Display Order of Cards on the Home Page 7-8
Adding Cards 7-8
Adding Tabs to a Tabular Page 7-10
Removing Navigation Flows, Cards, and Tabs 7-12
Grouping Cards into Clusters 7-13
Reloading a Navigation Flow 7-14
Switching Navigation Flows at Runtime 7-14
8 Designing Infolets
About Infolets 8-1
Anatomy of an Infolet 8-3
Determining Infolet Content 8-6
Designing Forms for Infolets 8-7
Designing Charts for Infolets 8-7
Using the Infolets Designer 8-8
Creating Infolets 8-10
Working with Infolets 8-11
Customizing the Interface to Access Infolets 8-12
vi
Intercompany 10-7
Movement 10-8
Scenario 10-10
Year 10-10
View 10-10
Multi-GAAP 10-11
Viewing and Editing Dimensions 10-11
Working with Dimension Hierarchies 10-12
Expanding and Collapsing Dimension Hierarchies 10-12
Navigating Dimension Hierarchies 10-12
Finding Dimensions or Members 10-13
Sorting Members 10-13
Moving Members Within the Dimension Hierarchy 10-13
Viewing a Member’s Ancestors 10-14
Showing Member Usage 10-14
Adding Custom Dimensions 10-15
Aggregation Options 10-16
Aggregation Options for Intercompany Entities 10-17
Data Storage Options 10-21
About Dynamic Calc 10-22
Store Data Storage 10-22
Shared Data Storage 10-22
Never Share Data Storage 10-22
Label Only Data Storage 10-22
Setting Dimension Properties 10-23
Setting Dimension Evaluation Order 10-23
Defining Accounts 10-24
Account Types 10-28
Time Balance Property 10-29
Summary of Account Types and Time Balance 10-29
Aggregation (Consolidation Operator) 10-29
Account Types and Variance Reporting 10-31
Saved Assumptions 10-31
Data Types and Exchange Rate Types 10-32
Defining Account Properties 10-32
Setting Account Attribute Values 10-35
Defining Entity Members 10-36
Intercompany Property for Entities 10-37
Base Currency 10-37
Creating Alternate Hierarchies 10-38
Financial Consolidation and Close Data Model Overview 10-39
vii
Working with Members 10-41
Seeded Dimension Members 10-41
Built-in Calculations 10-53
Adding or Editing Members 10-56
Deleting Members 10-59
Making Selections 10-59
Member Relationships 10-61
Deleting Parent Members 10-62
Viewing Member Properties from Forms 10-62
Working with Shared Members 10-62
Creating Shared Members 10-63
Setting Up Currencies 10-64
Working with Multiple Currencies 10-65
Number Formatting 10-66
Viewing Currency Usage 10-66
Creating Currencies 10-67
Editing Currencies 10-68
Deleting Currencies 10-69
Setting Up Scenarios 10-69
About Scenarios 10-69
Time Periods 10-69
Access Permissions 10-70
Creating Scenarios 10-70
Editing Scenarios 10-70
Deleting Scenarios 10-71
Copying Scenarios 10-71
Customizing Application Years 10-72
Adding Years to the Calendar 10-72
Editing Year Information 10-72
Working with Attributes 10-73
Understanding Attribute Data Types 10-74
Deleting Attributes 10-74
Working with Attribute Values 10-75
Creating Attribute Values 10-75
Assigning Attribute Values to Members 10-75
Modifying Attribute Values 10-76
Deleting Attribute Values 10-76
Working with User-Defined Attributes (UDAs) 10-77
Creating UDAs 10-78
Changing UDAs 10-78
Deleting UDAs 10-78
viii
Working with Member Formulas 10-78
Viewing Details of Formula Verification 10-79
Solve Order in Member Formulas 10-79
Applying SolveOrder for Metadata 10-81
Working with Alias Tables 10-82
About Aliases 10-83
About Alias Tables 10-83
Creating Alias Tables 10-84
Editing or Renaming Alias Tables 10-84
Deleting Alias Tables 10-84
Clearing Alias Tables 10-84
Copying Alias Tables 10-85
12 Managing Jobs
Jobs Overview 12-1
Viewing Pending Jobs and Recent Activity 12-1
Scheduling Jobs 12-2
ix
Editing and Deleting Jobs 12-4
x
Deleting an Invalid Intersection Report 14-14
15 Managing Forms
Predefined Forms 15-1
Form Components 15-3
Point of View 15-4
Page Axis 15-4
Rows and Columns 15-4
Form Design Considerations 15-4
Forms and Access Permissions 15-4
Forms and Currencies 15-5
Forms and Versions 15-5
Forms and Attributes 15-5
Forms and Shared Members 15-5
Forms and Calculations 15-5
Creating Simple Forms 15-5
Setting Form Layout 15-6
Setting Form Grid Properties 15-8
Setting Form Dimension Properties 15-9
Setting Display Properties 15-10
Setting Printing Options 15-11
Including Data Validation Rules in Forms 15-12
Setting Form Precision and Other Options 15-14
Creating Asymmetric Rows and Columns 15-15
Adding Formula Rows and Columns 15-15
Defining Simple Form Page and Point of View 15-16
Working with Forms and Form Components 15-17
Opening Forms 15-17
Previewing Forms 15-17
Editing Simple Forms 15-18
Moving, Deleting, and Renaming Forms 15-18
Working with Substitution Variables 15-18
About Substitution Variables 15-19
Creating and Assigning Values to Substitution Variables 15-19
Deleting Substitution Variables 15-19
Working with User Variables 15-19
About User Variables 15-20
Managing User Variables 15-20
Creating User Variables 15-20
Deleting User Variables 15-21
xi
Working with Smart Lists 15-21
Synchronizing Smart Lists in Reporting Applications 15-22
Adding or Changing Smart List Properties 15-22
Adding or Changing Smart List Entries 15-23
Previewing Smart Lists 15-24
Displaying #MISSING with Smart Lists 15-24
16 Managing Journals
Creating Journal Groups 16-1
Deleting Journal Groups 16-1
Managing Journal Periods 16-2
Setting Journal Options 16-2
Journal Referential Integrity 16-3
17 Consolidating Data
Consolidation Process 17-2
Data Flow 17-2
Consolidation Process Flow 17-7
Intercompany Eliminations 17-12
Consolidation Dimension 17-15
Translation Process 17-17
Translating Data 17-18
About Exchange Rates 17-20
Entering Exchange Rates 17-21
Entering Override Rates 17-23
Specifying Default Translation Settings 17-24
Consolidation and Translation Security Access 17-25
Calculation Status 17-26
Consolidating Data 17-28
Viewing Consolidation Progress 17-29
Running a Consolidation Report 17-29
Consolidation Examples 17-33
Example 1: Reconsolidating Data from a Form 17-33
Example 2: Consolidating Data from the Data Status Grid 17-34
Example 3: Consolidating Data for Multiple Periods 17-34
Advanced Consolidation Overview 17-34
Consolidation Logic 17-35
Managing Consolidation Methods 17-35
Modifying Consolidation Methods 17-37
xii
Adding Consolidation Methods 17-38
Importing and Exporting Consolidation Methods 17-39
Recomputing Ownership Data 17-41
Managing Ownership 17-41
Changing Manage Ownership Settings 17-42
Importing and Exporting Ownership Data 17-44
Ownership Settings Year to Year 17-46
Ownership Settings in Forms and Configurable Calculation Rules 17-47
Advanced Consolidation Rules 17-49
About Configurable Consolidation Rules 17-51
Managing Consolidation Rule-sets and Rules 17-55
Creating Consolidation Rule-sets 17-55
Creating Consolidation Rules 17-61
Consolidation Strings 17-65
Viewing Rule-Sets 17-65
Deploying and Undeploying Rule-Sets 17-66
Duplicating and Deleting Rule-Sets 17-67
Re-ordering Rule-sets and Rules 17-68
Seeded Consolidation Rules 17-69
Investment Rule-Set 17-70
Investment PP Rule-Set 17-72
Owner's Equity (Subsidiary/Proportional) Rule-Set 17-73
Owner's Equity (Subsidiary/Proportional) PP Rule-Set 17-75
Owner's Equity (Equity) Rule-Set 17-78
Owner's Equity (Equity) PP Rule-Set 17-79
Owner's Equity (Holding) Rule-Set 17-81
Net Income (Subsidiary) Rule-Set 17-82
Net Income (Equity) Rule-Set 17-83
Seeded Consolidation Rule Examples 17-85
Seeded Consolidation Rules - Example (January) 17-85
Seeded Consolidation Rules - Example (February) 17-88
Seeded Consolidation Rules - Example (March) 17-95
xiii
Creating Override Translation Rules 18-8
Deploying Override Translation Rules 18-9
Creating Rate Accounts for Translation Overrides 18-10
Editing User-Defined Rate Accounts 18-12
Deleting User-Defined Rate Accounts 18-13
Working with Configurable Calculations 18-13
Creating Configurable Calculations 18-14
Enabling Auto Create Blocks for Configurable Calculations 18-16
Configurable Calculation Rules 18-17
System Calculations 18-21
System Calculation Option for Custom Dimension Top Member 18-21
Opening Balance Carry Forward 18-23
Opening Balance Override Rules 18-23
Balance the Balance Sheet Calculation 18-26
Ratio Calculation 18-27
Working within Calculation Manager 18-28
Configurable Calculations Best Practices 18-29
Best Practices for Calculations in Extended Dimensionality Applications 18-51
Calculate Movements (from Closing Balance Input) 18-56
Equity Pickup Overview 18-57
Enabling Equity Pickup 18-59
Equity Pickup Processing 18-66
Working with On-Demand Rules 18-70
Guidelines for On-Demand Rules 18-71
Creating On-Demand Rules 18-73
Adding On-Demand Rules to Data Forms 18-75
Importing and Exporting On Demand Rules 18-77
Launching On-Demand Rules 18-77
Calculation Status for On-Demand Rules 18-79
Debugging On-Demand Rules 18-80
Renaming On-Demand Rules 18-82
Deleting On-Demand Rules 18-82
Working with Essbase Calc Script 18-83
Supported Essbase Functions 18-89
Financial Consolidation and Close Custom Functions 18-96
FCCSImpact Status Function 18-96
xiv
Selecting Approval Unit Hierarchy Members 19-3
Assigning Approval Unit Owners and Reviewers 19-4
Assigning Approval Unit Hierarchies to Scenarios 19-5
Editing Approval Unit Hierarchies 19-6
Viewing Approval Unit Hierarchy Usage 19-6
Synchronizing Approval Unit Hierarchies 19-7
Deleting and Renaming Approval Unit Hierarchies 19-8
Exporting Approval Unit Hierarchies 19-8
Importing Approval Unit Hierarchies 19-9
xv
Duplicating Holiday Rules 21-10
Deleting Holiday Rules 21-11
Changing Configuration Settings 21-11
Allowing Comment Deletions 21-11
Allowing Task Deletions 21-11
Displaying Upcoming Tasks 21-12
Enabling Email Notifications in Task Manager 21-12
Setting Task Manager Governors 21-13
Allowing Reassignment Request Approvals 21-14
Reopening Tasks 21-14
Specifying Task Display in Smart View 21-15
Managing Task Manager Attributes 21-15
Defining Task Manager Attributes 21-15
Defining Calculation Attributes 21-16
Importing List Attributes 21-20
Editing Attributes 21-21
Duplicating Attributes 21-21
Deleting Attributes 21-21
Viewing Attributes 21-22
Searching for Attributes 21-22
xvi
Editing Task Types 23-9
Viewing Task Types 23-9
Searching for Task Types 23-10
Importing Task Types 23-10
Exporting Task Types 23-11
Deleting Task Types 23-12
25 Managing Tasks
Creating Tasks 25-1
Setting Task Properties 25-2
Setting Task Parameters 25-3
Specifying Task Instructions 25-4
Selecting the Workflow 25-5
Adding Task Questions 25-7
Setting Task Access 25-9
Setting Task Predecessors 25-10
xvii
Applying Task Attributes 25-11
Working With Task Rules 25-12
Viewing Task History 25-14
Working with the Task Dialog Box 25-14
Importing and Exporting Tasks 25-15
Editing Tasks 25-16
Adding Attachments 25-17
Sorting Tasks 25-18
Searching for Tasks 25-18
Moving Tasks 25-18
Cutting, Copying, and Pasting Tasks 25-18
Reopening Tasks 25-19
Submitting Tasks 25-20
Approving or Rejecting Tasks 25-20
Managing Task Reassignments 25-20
Aborting Tasks 25-21
Deleting Tasks 25-21
26 Managing Schedules
Manually Creating Schedules 26-1
Setting Schedule Properties 26-2
Adding Instructions to Schedules 26-3
Assigning Schedule Viewers 26-3
Applying Schedule Attributes 26-4
Adding Day Labels 26-5
Working With Schedule Rules 26-5
Setting Required Task Parameters 26-7
Opening Schedules 26-7
Editing Schedules 26-7
Adding Tasks to Schedules 26-7
Importing Tasks into Schedules 26-8
Updating Tasks in Schedules 26-10
Reassigning Users in Schedules 26-11
Authorizing Process-Automated Tasks 26-11
Setting Schedule Status 26-12
Viewing Schedule History 26-14
Validating Schedules 26-14
Locking Schedules 26-14
Viewing Schedules 26-15
Searching for Schedules 26-15
xviii
Deleting Schedules 26-16
xix
Creating a Template 29-9
Setting Up a Report Group 29-9
Creating a Report 29-10
Searching and Filtering Queries, Report Groups, or Reports 29-12
Generating the Report 29-13
Using Task Manager Report Binders 29-14
Generating Report Binders 29-14
Viewing Report Binders 29-15
xx
Form Template Sections: History Tab 30-26
Assigning the Workflow 30-26
Specifying Form Template Questions 30-27
Setting Form Template Access 30-28
Viewing Form Template History 30-29
Editing Form Templates 30-29
Duplicating Form Templates 30-30
Deleting Form Templates 30-30
Deploying a Form Template to a Data Collection Period 30-30
Un-Deploying a Form Template to a Data Collection Period 30-32
Re-opening Supplemental Data Forms 30-33
Validating Supplemental Data Total Against an Account Balance 30-33
Working with Supplemental Data in Smart View 30-35
Using Currency Translation 30-36
Selecting Default Currency for Entity Members 30-37
Setting Up Currency Attributes for Translation 30-37
xxi
C Financial Consolidation and Close Best Practices
xxii
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.
xxiii
Documentation Feedback
Documentation Feedback
To provide feedback on this documentation, click the feedback button at the
bottom of the page in any Oracle Help Center topic. You can also send email to
[email protected].
xxiv
1
Financial Consolidation and Close
Overview
Financial Consolidation and Close is a subscription-based consolidation and reporting
solution built for and deployed on Oracle Cloud.
Financial Consolidation and Close is a subscription-based consolidation and reporting
solution built for and deployed on Oracle Cloud. It provides a simple and quick
deployment for users who want fast implementation with no hardware and minimal
IT support. It provides a user-friendly and intuitive interface along with built-in
functionality for consolidation and close process tasks.
Note:
This guide is designed for administrators implementing and maintaining the
Financial Consolidation and Close application.
Getting Started
1-1
Chapter 1
Overview of the Home Page
data, view reports, and control settings. Service Administrators can manage and
customize the business process, create forms, dashboards, and infolets, import
and export data and metadata, schedule jobs, define valid intersections, make
announcements, and create cross-environment connections.
You can change the general look and feel of your Oracle Enterprise Performance
Management Cloud environment on the Appearance page. The Theme setting
enables you to choose from a list of predefined themes with different background
colors, icon styles, and so on. You can also add a branding logo and background
images to the Home page. To change the Theme setting, see Customizing Your
Application Appearance.
Global Header
The global header is the area that stretches across the top of the user interface. It
contains navigation icons as well as access to accessibility settings and the Settings
and Actions menu. You can also switch between navigation flows from the global
header.
1-2
Chapter 1
Overview of the Home Page
Work Area
The work area on the Home page displays icons that link you to each functional area
of the business process to which you have access. The three dots above an icon label
denotes that the icon opens a grouping of sub-icons, called a cluster.
The Academy icon links you to a variety of resources about using the business
process.
Infolet Navigation
If your business process uses infolets to show high-level, essential information, you
can explore them by clicking the dots that appear beneath the global header. Arrows
are also available on the sides of the Home page to help you navigate easily between
the Home page and infolet dashboard pages.
1-3
Chapter 1
Overview of the Home Page
Announcements Panel
The Announcements Panel displays your user name and profile picture (if set), any
system announcements entered by the Service Administrator, and helps you track
your activity.
1-4
Chapter 1
Overview of the Home Page
1-5
Chapter 1
Integrating with Other Services
• You can set your profile picture to display at the top of the Announcements
panel of the Home page. To set your profile picture, click Tools, and then User
Preferences. For more information, see Setting Your Profile Picture in Working
with Financial Consolidation and Close .
• Activity—Summarizes system announcements (the most recent announcement,
sorted by effective date, appears at the top) and lists your open tasks. Click
Announcements to flip the panel and view announcements. Click Tasks Due
Today to flip the panel and view your tasks.
• Recent—Displays a list of links to recently visited forms and dashboards (up to 15
items). Clicking a link will launch the item in a secondary window. Clicking the star
next to a link will tag it as a favorite.
• Favorites—Displays a list of links to forms or dashboards that were tagged as
favorites, and prevents them from being overwritten. Click a link in Favorites to
launch the item in a secondary window. To add items to Favorites, click Recent to
view your recent user activity, and then click the star to the right of the item.
• — Click the Tour icon to launch a video about key features in the business
process.
Videos
1-6
Chapter 1
Integrating with Other Services
EPM Automate
EPM Automate is a command-line utility that Service Administrators can use to
schedule jobs such as importing and exporting data and metadata from an application,
or executing business rules. You access EPM Automate from the Navigator menu, and
then execute commands from a command prompt.
Data Management
You use Data Management to integrate data from an enterprise resource planning
source system to an enterprise performance management target system. You access
Data Management through the Navigator menu. From the Setup tab, you create import
formats, locations, and mappings, and establish your source and target systems. From
the Workflow tab, you execute data integrations.
Smart View
Use Smart View to integrate with Microsoft Office applications such as Excel, Word,
and PowerPoint. You install it from the Download menu. If you want to edit your
dimensions in Smart View, you can also download the add-on for Administrators. After
you install Smart View, you can access your data directly in an Office application. For
example, you can open data forms directly in Excel.
Task Manager
Use Task Manager to define your templates, schedules, and tasks. You can specify
basic properties about a template or task, such as the name and period, as well as
instructions, attributes, labels, and rules.
1-7
2
Creating an Financial Consolidation and
Close Application
An application is a set of related dimensions and dimension members that are used
to meet a set of consolidation and close process needs. Each application has its own
accounts, entities, scenarios, and other data elements.
Application Prerequisites
• After analyzing available historical data, you have created a set of requirements
and developed an application design that supports your requirements.
• Security components have been set up. See "Managing Users and Roles" in
the Getting Started with Oracle Enterprise Performance Management Cloud for
Administrators guide.
• At least one user is granted the Service Administrator role of the service instance.
Creating an Application
Financial Consolidation and Close is a multi-dimensional consolidation application. By
default, the system provides a required set of pre-defined dimensions to store the
consolidation detail data. During application creation and configuration, you can select
additional optional dimensions based on your application needs.
2-1
Chapter 2
Creating an Application
Before you create your application, you can click Take a quick tour to access useful
information about designing and getting started with the application.
To create an application, you must be the Service Administrator.
After you create an application, you cannot rename it. For example, you cannot
rename your "xxx" Test application to "xxx" in Production. You must recreate and
rebuild your application.
To create an application:
1. Log on to Financial Consolidation and Close as a Service Administrator.
2. Under Finance, click Start.
3. Click Financial Close.
4. Click New.
5. On the Create Application: General page, enter a Name for the application.
The Application name cannot contain these characters:
Ampersand (&), Apostrophe ('), Asterisk (*), At sign (@), Backslash (\), Caret (^),
Colon (:), Comma (,), Curly brackets ({}), Dollar sign ($), Double quotation marks
("), " Equal sign (=), Exclamation mark (!), Forward slash (/), Greater than (>), Less
than (<), Line (|), Minus sign (-), Number sign (#), Parentheses ( ), Percent sign
(%), Period (.), Plus sign (+), Question mark (?), Semi-colon (;), Spaces, Square
brackets ([]), or Tabs.
6. For Description, enter an application description.
7. Click Next.
8. On the Details page, select the calendar and currency options for the application.
After you create an application, you cannot change or enable these options.
• Time Period - Number of Months: Select the number of months to include in
the year: 12 months or 13 months.
If you select 12 months, by default, the periods are January to December. You
can always add an alias to the period name if you want it to be different.
If you select 13 months, select the period Distribution for each quarter. The
default distribution is 3-3-3-4. You can select a prefix, and the numbers 1 to 13
will be added to the prefix, for example, P1 through P13.
• Start and end year: Select the period range for which you want to include
data in the application.
You can adjust the period range that you want for your application. You can
also add additional years to your application by creating additional members in
the Year dimension after the application is created.
• First month of fiscal year: From the drop-down, select the first month to use
for the fiscal year. For 12 months, the default is January. For 13 months, the
default is P1.
• Optional: Create HYTD Members: By default, the application provides the
following views of data: Periodic, YTD, QTD. To also include Half Year to Date
(HYTD) time periods, click Enable.
• Main Currency: From the drop-down, select the main currency for your
application. The system provides the standard ISO codes. The default
currency is USD.
2-2
Chapter 2
Enabling Application Features
• Multicurrency: Select this option if your application contains data for more
than one currency. If the Multicurrency option is not enabled, the Currency
dimension is not created for the application.
9. Click Next to enable application features. See Application Feature Descriptions.
10. After you select the features that you want to enable, click Next, and from the
Review page, review the selected application details.
11. To create the application, click Create, or to change any settings, click Back and
make changes.
When you click Create, the system creates the application shell and generates the
applicable dimensions and members for your application based on your selections.
12. From the Application Creation Status message, click OK.
Note:
You cannot disable features after application creation.
Configuring Applications
2-3
Chapter 2
Enabling Application Features
2-4
Chapter 2
Enabling Application Features
You can rename members to reflect the correct GAAP adjustment if needed. You
can also include additional members and hierarchies for other GAAP adjustments
if needed.
If the Multi-GAAP option is enabled, you can have one additional custom
dimension for your application.
If the Multi-GAAP option is not enabled, the system does not create the Multi-
GAAP dimension, so you can add two custom dimensions for your application.
– Enter Adjustment—Select this option to enter GAAP adjustments manually.
– Calculate Adjustment—Select this option to allow the system to calculate the
adjustment amount based on the Local GAAP and IFRS amount entered.
• Cumulative Translation Adjustment (CTA) Account
This option is only available for multi-currency applications.
The CTA account is used to store the Foreign Exchange (FX) calculation values
for historical accounts.
You can configure the application to include the CTA Account in the Balance Sheet
or in Comprehensive Income. For more information, see the "CTA and CICTA
Accounts" section in Seeded Dimension Members.
– Balance Sheet
– Comprehensive Income
After you enable either of these options, you cannot change them. You must
recreate the application to change the option.
Local GAAP
The system automatically uses the same option for Local GAAP.
For example, if you select CTA (Balance Sheet), the system selects CTA
(Balance Sheet) for Local GAAP. If you select CICTA (Comprehensive Income),
the system selects CICTA (Comprehensive Income) for Local GAAP.
• Accounts Reporting
Balance Sheet Hierarchy: Select the Balance Sheet hierarchy that is most
suitable for your application. You can also manually create additional hierarchies in
addition to the ones created by the system.
– Traditional Balance Sheet Approach—This option provides the account
hierarchy with Total Assets as a parent member and Total Liabilities and Equity
as a separate parent member. The aggregation of these two parent members
should be zero as Total Assets = Total Liabilities and Equity.
– Net Asset Approach—This option allows you to track your Net Assets
separately within the Balance Sheet hierarchy as Net Assets = Total Assets
- Total Liabilities.
– Basic—Available only for Extended Dimension applications. This option
provides a simplified hierarchy of the minimum required set of Account
and Movement dimension members based on the enabled features and a
minimum set of seeded forms. Note that Indirect cash Flow is an optional
enablement when the Basic option is selected but not when either Traditional
or Net Assets are selected.
Include Ratio Calculations
2-5
Chapter 2
Enabling Application Features
Select the applicable ratio calculations that you want to include in your application.
A separate Ratio hierarchy will be created in the Account dimension with
the specific ratio groups that you selected. Individual ratio accounts and the
corresponding calculations will be created as part of the application. You can add
additional ratio calculations to each group.
– Liquidity Ratio
* Current Ratio
* Quick Ratio
* Cash Ratio
– Asset Management Ratio
* Inventory Turnover
* Asset Turnover
* Days Sales in Receivables
* Days Sales In Inventory
– Profitability Ratio
* Gross Profit Margin
* Return on Sales
* Return on Equity
– Leverage Ratio
* Debt To Equity Ratio
* Debt Ratio
• Intercompany Data
Select this option if your application includes intercompany data. If enabled, the
system creates an Intercompany dimension containing system members. The
Entity dimension displays a property for members that specifies if the member
should be included in the Intercompany dimension. If the property is selected, a
member with the same name is created in the Intercompany dimension.
If you do not enable the Intercompany Data option, the Intercompany Dimension is
not displayed in your application.
Track Intercompany Elimination— If you select the Intercompany Data option,
you can additionally select this tracking option. This option enables you to track
your intercompany elimination data separately by data source. If this option is not
selected, then the total elimination value from all data sources is stored as one
total in the application rather than by the data source detail.
Note:
Both of these options are required to use the Ownership Management
feature.
2-6
Chapter 2
Enabling Application Features
Note:
Before you enable Ownership Management for an existing application,
you must review the migration considerations to avoid potential conflicts
with new seeded members. See Enabling Ownership Management in
Applications.
• Equity Pickup
Select this option to enable the Equity Pickup method of recording the value of
investments in subsidiaries.
• Partner Elimination
Select this option to enable rules to write data to a partner member. The
Partner Elimination rule writes data to the Elimination consolidation member
of a sibling of the entity being processed. See Creating Consolidation Rules.
When this option is selected, almost all entities (including parent entities) should
be flagged as Intercompany Partners in the metadata (select "ICP_Entity_Yes"
in the"Intercompany Entity" attribute). If these entities are not flagged as
Intercompany then Partner Elimination rules might fail. The only exceptions should
be the top Entity label ("Entity") and its immediate children, including "Global
Assumptions" and "Total Geography".
• Indirect Cashflow
If you select the Basic Accounts Reporting option, select this option to add the
Indirect Cashflow hierarchies into the Closing Balance hierarchy, and add the
Cash Flow hierarchies.
If you select the Traditional Balance Sheet Approach or Net Asset Approach for
Accounts Reporting, this option is selected by default and cannot be deselected.
2-7
Chapter 2
Enabling Application Features
Note:
The ability to add four Custom dimensions (or three if you enable
the Multi-GAAP reporting option) is available in all new provisioned
environments.
Two Custom dimensions are available in environments provisioned
before June 2019. If you want to use more than two Custom dimensions
in those environments, you must request the Extended Dimensionality
update from Oracle Support. After you apply the update, you must create
a new application. You cannot modify the number of dimensions in an
existing application.
2-8
Chapter 2
Enabling Application Features
Select this option if you want to collect additional supplemental details from
Supplemental Data. When it is enabled, you can configure your data collection
workflow using Supplemental Data Manager, and the approved data is stored in
a separate member of the Data Source dimension named "Supplemental Data"
for tracking purposes. You can drill back to the source to view all the supporting
details. If you do not enable Supplemental Data Collection, some supplemental
data-related features are not available. See Consolidation and Supplemental Data
Features.
Consolidation Features
The following features are only available if the Consolidation module is enabled. If it
is not enabled, you cannot access these features from either the Home page or the
Navigator.
• Balance Sheet Hierarchy
• Financial Dashboards
• Journals
• Approvals
• Rules
• Valid Intersections
• Data Management Integration
• Action Menus
• Smart Lists
• Variables
• Financial Reporting Web Studio
• Workflow
2-9
Chapter 2
Enabling Ownership Management in Applications
Note:
If you do not enable Ownership Management, there is no impact to your
existing application.
2-10
Chapter 2
Enabling Ownership Management in Applications
2-11
Chapter 2
Enabling Ownership Management in Applications
• You should either remove duplicate members from the referenced artifacts, or
update the artifacts to reference the proper member.
After enabling Ownership Management, if you encounter errors with members and
Aliases, check the Jobs console to see the details on which member Alias is in conflict.
2-12
Chapter 2
Enabling Ownership Management in Applications
In addition, the Data Storage property of the existing "FCCS_Percent Consol" member
is changed from "Store" to "Dynamic Calc". This account will be dynamically calculated
based on the entered Ownership information.
The updated FCCS_Total Assets hierarchy is shown below with these additional
accounts:
• FCCS_Dividends Receivable
• FCCS_Investment in Equity Companies
• FCCS_Investment in Equity Companies Investment
• FCCS_Investment in Equity Companies Equity Pickup
• FCCS_Investment Link
• FCCS_Intangible Assets
• FCCS_Goodwill
• FCCS_Goodwill Input
• FCCS_Goodwill Offset
The updated FCCS_Total Equity hierarchy is shown below with these additional
accounts:
• FCCS_Minority Interest
• FCCS_Owners Equity
• FCCS_Other Equity
• FCCS_Revaluation Reserves
• FCCS_Dividends Declared
• FCCS_Retained Earnings Current - Pre-Ownership Change
• FCCS_Owners Income
• FCCS Minority Interest Income
• FCCS_Net Discontinued Operations Income
• FCCS_Discontinued Operations Income
• FCCS_Discontinued Operations Tax
2-13
Chapter 2
Enabling Ownership Management in Applications
The updated FCCS_Drivers hierarchy is shown below with these additional accounts:
• FCCS_Percent Elim
• FCCS_Consol Method
• FCCS_Control
• FCCS_Control Input
• FCCS_Consol Method Input
• FCCS_Percent Consol Input
• FCCS_Percent Ownership Input
• FCCS_Percent Min Input
• FCCS_Percent Consol Prior Input
• FCCS_Percent Consol Change Input
• FCCS_Percent Consol- Property changed to Dynamic Calc
• FCCS_Percent Consol Prior
• FCCS_Percent Consol Change
• FCCS_Percent Owners
• FCCS_Percent Min
2-14
Chapter 2
Enabling Ownership Management in Applications
Note:
If any periods are locked, you must unlock them and then reconsolidate
the data.
2-15
Chapter 2
Copying Local Rate Account Data
2-16
Chapter 2
Migrating to Extended Dimensionality
This will upgrade the Essbase version and will also delete the application. See "
EPM Automate Commands " in Working with EPM Automate for Oracle Enterprise
Performance Management Cloud.
3. On the Legacy pod, import the application from the backup.
After you complete these steps, the Essbase version will be upgraded and the
Enable Hybrid Mode Application option will be available.
4. On the Home page, click Application, select Overview, and from the Actions
menu drop-down, select Enable Hybrid Mode Application.
Before the migration task runs, the system displays a warning that this action
cannot be undone and a validation screen showing a summary of changes. Before
launching the migration, click the Summary/Download link to view the changes.
Note the insertion rules and on-demand calculations that will be affected. You must
review these after the migration process.
5. Click Launch to start the migration task.
This task can take a long time to complete based on the amount of data that
needs to be migrated. You can view the status and job details in the Jobs console.
6. Make sure that the migration task completed successfully. If the task fails for some
reason, you can re-run the task from the Application Overview screen.
2-17
Chapter 2
Migrating to Extended Dimensionality
7. After the application has been migrated, export the application from the Legacy
pod and import it into the Enterprise pod.
When you run the Enable Hybrid Mode Application option, the migration process
results in the following changes in metadata:
• The DataStorage property for seeded Movement, Intercompany, and Multi-
GAAP top members changes to DynamicCalc.
• In the View Dimension, QTD, HYTD, YTD change to Stored members and
new members QTD_Rule, HYTD_Rule, YTD_Rule are seeded. In a custom
calculation such as an Insertion Rule (Configurable Calculation rule) or an On-
Demand rule, references to FCCS_YTD are converted to FCCS_YTD_RULE,
FCCS_QTD is converted to FCCS_QTD_RULE, and FCCS_HYTD is converted
to FCCS_HYTD_RULE.
• There is a change in Performance order for Dimensions.
• SolveOrder: Period, View, Movement, DataSource, Consolidation (only when
Ownership Management is disabled) dimension members are seeded with default
SolveOrders defined.
• For Multi-GAAP (if it exists) and Custom Dimensions(for example, Product): The
DataStorage properties for all the user-defined upper-level members are changed
to DynamicCalc.
2-18
3
Managing Security
Related Topics
• Security Overview
• Managing Artifact and Data Access
• Managing Forms Security
Security Overview
Financial Consolidation and Close implements several security layers to ensure
security. Infrastructure security components, which are implemented and managed
by Oracle, create a highly secure environment for the service. The service ensures
security with password-protected single sign-on, and role-based access to data and
artifacts.
Setting up security requires these steps:
• Create users and assign them access to the application. See the Getting Started
with Oracle Enterprise Performance Management Cloud for Administrators guide.
The Identity Domain Administrator creates the users and assigns them access to
the application.
• Assign users role access to the application. See the Getting Started with Oracle
Enterprise Performance Management Cloud for Administrators guide.
The Identity Domain Administrator assigns users role access to the application.
• Assign users access to artifacts. See Assigning User Access to Artifacts.
Users are assigned access to artifacts in the application. These artifacts include
forms, journals, task lists, and report. This access is given to users by the creators
of the artifacts or by the Service Administrator.
• Assign users access to data. See Assigning User Access to Data.
Users are assigned access to artifacts in the application. These artifacts include
forms, journals, task lists, and report. This access is given to users by the creators
of the artifacts or by the Service Administrator.
The Administrator assigns access to data through access to dimension members.
Users are assigned either Modify, View, or None access to members of a
dimension.
Watch the following video for an introduction to security:
Understanding Security
3-1
Chapter 3
Managing Artifact and Data Access
3-2
Chapter 3
Managing Artifact and Data Access
3-3
Chapter 3
Managing Artifact and Data Access
Data level security is based on the intersection of the security access to each
dimension. The most restrictive security access is the one used by the system.
For example, security is assigned to Scenario and Entity. A user has the following
access to individual members of the dimensions:
Scenario
Actual - Write
Budget - Read
Entity
UK - Write
France - Write
With the above access, the user can enter and load data to Actual/UK, but has Read
only access to Budget/UK and Budget/France.
Note:
If you do not select this option, there is no security on the dimension,
and users can access its members without restriction.
3-4
Chapter 3
Managing Artifact and Data Access
To modify access:
1. Click Edit Access.
2. For the selected member, select the type of access for the displayed users or
groups.
3. Optional: Select a member level:
For example, select Children to assign access to the children of the selected
member.
• Member
• Children
• Children (inclusive)
• Descendants
• Descendants (inclusive)
4. Click Set.
5. Click Close.
To remove access:
3-5
Chapter 3
Managing Forms Security
1. Select the users and groups for whom to remove access to the selected member.
2. Click Remove Access, and then click OK.
3. Click Close.
Note:
The Administrator should ensure that all the users in the application are part
of the DataSourceDefaultAccess user group, so that you do not need to
manually assign security on the Data Source dimension.
Note:
You should not enter data directly in forms or Oracle Smart View for
Office to Journals, Supplemental Data Manager (SDM), and FDMEE input
members (for example, Journal Input, SDM Input and FDMEE Input). It is
recommended to enter data through Journals, Supplemental Data Manager,
or FDMEE, respectively.
3-6
Chapter 3
Managing Forms Security
• Users and Power Users can view or enter data only into forms to which they have
access (and can work only with members to which they have access)
• Service Administrators and Power Users can design forms.
• Power Users can access forms they created or to which a Service Administrator
assigned them access.
• Service Administrators have Write access to all dimension members and to all
forms.
Form Folders
• Users who are assigned access to a form folder can access the forms in that
folder.
• When you assign access to a folder, all folders under it inherit that access.
• If you assign specific access (for example, None or Write) to a form folder, that
access permission takes precedence over its parent folder’s access permissions.
For example, if a user has Write access to Folder 1 that contains Folder 2 to which
the user has None access, the user can open Folder 1, but does not see Folder 2.
• If a user has None access to a form folder called Folder 1 that contains a form
called Form 1 to which the user has Write access, the user can see Folder 1 and
Form 1.
3-7
Chapter 3
Managing Forms Security
4. Click Close.
To remove access from forms or folders:
1. Select the users or groups for which to remove access, and click Remove
Access.
2. Click OK.
Note:
The forms that are displayed by default may depend on the features that are
selected for the application.
• Data Status
• Enter Exchange Rates - Multi Period
• Enter Exchange Rates - Single Period
• Exchange Rates
• Override Rates
• Percentage Consolidation
3-8
4
Managing Applications
Related Topics
• Application Overview
• Restrictions for Dimensions, Members, Aliases, and Forms
• Managing Dimensions
Dimensions enable you to categorize data values. For example, the Entity
dimension represents the organizational structure of the company.
• Importing Metadata
• Exporting Metadata
• Validating Metadata
• Metadata Validation Messages
• Importing Data
• Exporting Data
• Viewing Data Import and Export Status
• Importing Data Using Data Management
• Exporting Data Using Data Management
• Data Integrations
Data Integration is the mechanism by which integration processes are performed
in Financial Consolidation and Close.
• Copying Data
• Using Copy Data Profiles
• Clearing Data
• Using Clear Data Profiles
• Refreshing the Database
• Restructuring Cubes
• Removing an Application
• Scheduling Maintenance
• Using the Inbox/Outbox
• Working with Activity Reports and Access Logs
Application Overview
After you create an application, you can view and manage it by accessing Application
from the Home page.
To manage applications, you must be the Service Administrator.
4-1
Chapter 4
Restrictions for Dimensions, Members, Aliases, and Forms
The Application overview shows the application properties and application statistics,
such as the number of tasks, forms, rules, and approval hierarchies in your
application.
It also lists the dimensions used by the application. To manage dimensions, see
Managing Dimensions.
To view the Application overview, on the Home page, click Application and then
select Overview.
4-2
Chapter 4
Restrictions for Dimensions, Members, Aliases, and Forms
– underscores
– vertical bars
• Do not place spaces at the beginning or end of names. Such spaces are ignored.
• Do not use forward slashes in member names.
• For time periods in custom calendars, do not use spaces in prefixes.
• The ICP member label only supports up to 76 characters.
• Do not use these words as dimension or member names:
– Calculation script commands, operators, and keywords.
– Do not prefix an object name with any of the following: OEP_, OFS_, OCX_,
OWP_, OPF_, FCCS_, TRCS_, ARCS_, OQP_, OGS_. For example, the
prefix "FCCS_A" is invalid. However, you can use the acronyms within the
object name, for example, A_FCCS, BFCCS, or FCCSB.
– Function names and function arguments.
– Names of other dimensions and members (unless the member is shared).
– If Dynamic Time Series is enabled, do not use History, Year, Season, Period,
Quarter, Month, Week, or Day.
– These words:
* ALL
* AND
* ASSIGN
* AVERAGE
* CALC
* CALCMBR
* COPYFORWARD
* CROSSDIM
* CURMBRNAME
* DIM
* DIMNAME
* DIV
* DYNAMIC
* EMPTYPARM
* EQ
* EQOP
* EXCEPT
* EXP
* EXPERROR
* FLOAT
* FUNCTION
4-3
Chapter 4
Restrictions for Dimensions, Members, Aliases, and Forms
* GE
* GEN
* GENRANGE
* GROUP
* GT
* ID
* IDERROR
* INTEGER
* LE
* LEVELRANGE
* LOCAL
* LOOPBLOCK
* LOOPPARMS
* LT
* MBR
* MBRNAME
* MBRONLY
* MINUS
* MISSING
* MUL
* MULOP
* NE
* NON
* NONINPUT
* NOT
* OR
* PAREN
* PARENPARM
* PERCENT
* PLUS
* RELOP
* SET
* SKIPBOTH
* SKIPMISSING
* SKIPNONE
* SKIPZERO
* STATUS
4-4
Chapter 4
Managing Dimensions
* TO
* TOLOCALRATE
* TOP
* TRAILMISSING
* TRAILSUM
* TYPE
* UMINUS
* UPPER
* VARORXMBR
* XMBRONLY
* $$UNIVERSE$$
* #MISSING
* #MI
Managing Dimensions
Dimensions enable you to categorize data values. For example, the Entity dimension
represents the organizational structure of the company.
Dimensions categorize data values. These dimensions are provided with Financial
Consolidation and Close:
• Account
• Period
• Data Source
• Consolidation
• Currency (Only if Multi-currency was selected during application creation)
• Entity
• Intercompany (Only if Intercompany was selected during application creation)
• Movement
• Scenario
• Year
• View
You can create additional Custom dimensions. See Adding Custom Dimensions.
The Dimensions page lists dimensions in order of precedence. The order of
dimensions is critical for the structure and performance of an application and
determines how data calculations will perform.
To manage dimensions:
1. On the Home page, click Application.
2. Click Overview, and then click the Dimensions tab.
4-5
Chapter 4
Importing Metadata
3. Perform a task:
• Click the name of the dimension that you want to view or modify to open Edit
Dimension Properties .
• To import metadata, click Import. See Importing Metadata.
• To export metadata, click Export. See Exporting Metadata.
Importing Metadata
You can import metadata from a file in a comma-delimited, tab-delimited, or other
format. These artifacts are supported in imports:
• Dimensions
• Smart Lists
• Exchange rates
To import metadata, perform these tasks:
• Create an import file for each artifact that you want to import. See Creating the
Metadata Import File.
• Load the import file or files (you can import multiple dimension files at the same
time). See Loading the Metadata Import File.
4-6
Chapter 4
Importing Metadata
For an example import file, see Example: Entity Dimension Import File.
e1, Entity
e2, ,
Using this import file would result in this outline, assuming that no other members
exist:
Entity
e1
e2
e1 (Shared)
The first data record (e1, Entity) imports Entity member e1 as a child under the root
member Entity. Unspecified values assume the default. For example, if data storage
is not specified, it assumes the default value, Never Share. The next data record
(e2, ,) imports Entity member e2 under the dimension root member because no
parent is specified, and sets data storage to Never Share. The last data record (e1,
e2, Shared) imports a shared member of e1 under member e2, and sets the data
storage to Shared.
4-7
Chapter 4
Importing Metadata
• hyphen-minus (-)
• plus (+)
• colon (:)
• semicolon (;)
• angle brackets (< >)
• backslash (\)
• forward slash (/)
• vertical bar ( | )
• apostrophe (')
• braces ({ })
• underscore (_)
• brackets ([ ])
• at sign (@)
• period (.)
Only one character is supported for use as a delimiter. For example, one vertical bar
( | ) is supported, but two vertical bars (| |) are not supported.
Caution:
Not all of the characters listed can be used for all import and export
scenarios. Note the following exceptions.
Note:
Any character that conflicts with a character in a member name causes an
error.
4-8
Chapter 4
Importing Metadata
4-9
Chapter 4
Exporting Metadata
11. If the import process is successful, the Refresh Database dialog box prompts you
to refresh the database. To refresh, click OK.
You can view the import status in the Jobs console. See Viewing Pending Jobs and
Recent Activity.
Exporting Metadata
You can export metadata to a file in a .csv (comma-delimited) or .txt (tab-delimited or
other delimiter character) format. These artifacts are supported in the export process:
• Dimensions
• Smart Lists
• Exchange rates
The system creates an export file for each artifact (.csv or .txt, depending on the file
type), and all export files are consolidated into one zip file. You must extract the .csv
or .txt files from the zip file if you want to use the files as import files (for example,
when importing into another application).
When you export seeded members, these member properties are exported:
• Account
• Parent
• Data Storage
• Operation
Customizations that you make for seeded members, such as Alias changes, and
re-ordering of seeded members, are not exported as part of the metadata export.
These changes are exported through Customizations. See the "Exporting Module
Customization" procedure.
To export metadata to a file:
1. On the Home page, click Application.
2. Click Overview, click the Dimensions tab, and then click Export.
3. On the Export Metadata page, click Create.
4. Select the target location of the export file:
• Local—Saves the export file to a location on your local computer.
• Outbox—Saves the export file to the server.
5. Select the artifact or artifacts to export.
6. For File Type, select an option:
• Comma delimited—Creates a comma-delimited .csv file for each artifact.
4-10
Chapter 4
Validating Metadata
Validating Metadata
Incorrect or or inappropriate metadata properties can cause errors during
consolidation and cause poor performance.
Examples of metadata property validation include the default and Consol cube data
storage properties, whether the Consolidation operator is valid, and whether a Parent
member is Dynamic Calc or Label Only, or has a member formula.
A Best Practice is to validate metadata by running an on-demand Metadata Validation
report, and by checking metadata in the Dimension Editor.
Note:
If you have problems with your application, be sure to validate metadata and
correct all errors before contacting Oracle Support.
To ensure that your metadata is valid, you can run the Metadata Validation report at
any time. The Validate Metadata screen displays validation results in three categories,
with the count for each category:
• Error—These are errors that are expected to cause problems in the application
and must be fixed.
• Warning—These are warning messages of issues that might cause problems in
the application.
• Information—These messages are for informational purposes only.
The report displays the dimension name, the member name in [Parent].[Child] format,
and the validation description. After validating, you can expand the messages on
4-11
Chapter 4
Metadata Validation Messages
screen, or click Export to extract the messages to a CSV file. You can use the
Dimension Editor to modify metadata or correct errors.
For example, if an error occurs that an Entity dimension member has a Consolidation
Operator of other than Ignore in the Dimension Editor, select the member and change
the Consolidation Operator property to Ignore.
To validate metadata from the Metadata Validator:
1. On the Home page, click Application.
2. Click Overview, then from Actions, select Validate Metadata.
3. Click Run to validate the metadata.
The Validate Metadata screen displays a list of validation results. The number of
messages is listed next to each category: Error, Warning, Info.
4. Click on a tab (Error, Warning, or Info) to view the messages in each category.
5. Expand the dimension name to display the messages. The results are displayed
in [Parent].[Child] format with the error description. To review further details, see
Metadata Validation Messages.
6. To export and view the details for all messages in a CSV file, click Export and
then specify where to save the export file.
7. Navigate to the Dimension Editor to modify metadata.
To view a list of valid member properties, see Editing Member Properties in the
Simplified Dimension Editor.
8. Re-run the consolidation and check performance.
To validate metadata from the Simplified Dimension Editor for a single dimension:
1. On the Home page, click Application.
2. Click the Dimensions tab.
3. Click the Edit Member Properties tab on the left.
4. Select a dimension and, click the Zoom in All Levels icon on the toolbar.
5. From the top Actions menu, select Validate Metadata definitions.
6. The system displays the validation results in the currently selected dimension.
7. Modify the metadata as needed.
To view a list of valid member properties, see Editing Member Properties in the
Simplified Dimension Editor.
8. Re-run the consolidation and check performance.
4-12
Chapter 4
Metadata Validation Messages
Resolution:
Move the shared member to a position below the primary member.
Resolution:
Change the Data Storage selection as described above.
Note:
Currently the Metadata Validator will display an error for any Level 0
Dynamic Calc members of the Movement Dimension except for seeded
members.
In future releases, "Dynamic Calc" will be allowed except for FCCS_Closing
Balance hierarchy, as long as they have a valid Member Formula. As a first
step towards this change, Dynamic Calc is added to the list of valid Data
Storage selection options for Level 0 Movement members in the Simplified
Dimension Editor (SUIDE).
4-13
Chapter 4
Metadata Validation Messages
Resolution:
Add a valid formula to the Dynamic Calc member, or change the Data Storage
properties to Store, Never Share or Shared. For Rate Cube accounts, check whether
the account is needed in the Rates Cube. If it is not needed, then delete the account
from the Rates Cube using the Dimension Editor, or change "Rates Consol op" to "Not
Used for Cube" from the Simplified Dimension Editor.
Resolution:
Remove the Member Formula from the parent member.
4-14
Chapter 4
Metadata Validation Messages
The Consol Operator for all children of the dimension name should be
Ignore or Never.
Resolution:
Change the aggregation operator as described above. Note that the aggregation
operators for seeded members should already be correct.
4-15
Chapter 4
Metadata Validation Messages
Resolution:
Change the Account Type of parent or child or change the aggregation operator.
Note that the seeded balance sheet hierarchy must reflect the following structure:
The seeded balance sheet "grouping" account (FCCS_Balance Sheet) must be the
first member following the seeded system accounts and exchange rate accounts.
The first child of FCCS_Balance Sheet must be the seeded balanced Balance Sheet
top member. Currently either:
FCCS_Total Balance Sheet-Net Asset Approach
Or
FCCS_Total Balance Sheet-Traditional Approach
The aggregation operator for these accounts can be Addition, Subtraction, or
Ignore. Ignore is suggested (but not required) unless you intend to report from the
"grouping" member.
The aggregation operator for any other children of the FCCS_Balance Sheet grouping
should ideally be Ignore but can be Addition or Subtraction if reporting from the
"grouping" member is required.
Any descendants of the immediate children of FCCS_Balance Sheet must be
"Addition" or "Subtraction" and must match the combination of the child and parent
account types.
Note that this validation is applied to all hierarchies within the FCCS_Balance Sheet
grouping member (with the exception of the seeded Cash and Non-Cash hierarchy). If
you wish to create an alternative hierarchy that is not subject to this validation check,
the hierarchy can be placed under the FCCS_Income Statement grouping account.
4-16
Chapter 4
Importing Data
Resolution:
Remove the shared member from the alternative hierarchy, create a new parent in the
alternative hierarchy and share the level 0 members under the new parent.
Resolution:
Move the Intercompany Elimination or Total Eliminations members to the correct
location in the hierarchy.
Importing Data
After you import dimensions, you can populate data by importing data files.
Note:
When importing data, no validation is performed on intersections to
determine which are valid, and data is loaded to all intersections. To
review data that has been loaded into invalid intersections, run the
Invalid Intersection report before importing data to see and clear invalid
intersections. See Creating an Invalid Intersection Report.
4-17
Chapter 4
Importing Data
You can load data using a text file with sections that map the file data to dimensions.
When you load multiple data files, they are loaded in sequential order.
Note:
You should not run reports, books, or batches while data is being loaded.
Load Methods
These options are available for loading a data file into an application.
• Merge—Use this option to overwrite the data in the application with the data in the
load file. Each record in the data load file is imported into the cell, replacing the old
value, if any.
• Replace—Use this option to replace data in the application. In Replace mode,
before the first record for a specific Scenario/Year/Period/Entity/Mapped Data
Source is encountered, the entire combination of data for that Scenario, Year,
Period, Entity, and Mapped Data Source is cleared, whether manually entered or
previously loaded.
4-18
Chapter 4
Importing Data
You can load a data file that contains only the Closing Balance Input data to
reverse the prior period non-zero Closing Balance amounts. When you load a
data file in Replace mode that contains only the POV with Closing Balance Input,
the system will write a reversal of the prior period Closing Balance to the default
movement. See Example: Data Import File - Closing Balance Input and Replace
Mode.
• Accumulation Type—Select one of these options to accumulate the data in the
application with the data in the load file:
– None—Each record in the data import file replaces the existing value in the
database for the record.
– With Database—The data is added to the existing value of the cell.
– Within File—The system accumulates the cell values that are within the file.
These examples how the data after the import using these option combinations:
Merge, None
4-19
Chapter 4
Importing Data
Replace, None
Actual, FY15, Jan, California, Expenses : #MI (Replace clears all the
data before the import)
4-20
Chapter 4
Importing Data
4-21
Chapter 4
Importing Data
10. Optional: If the selected location is Inbox, click Save as Job to save the import
operation as a job, which you can schedule to run immediately, or at a later time.
11. Optional: If the selected location is Local, click Validate to test whether the
import file format is correct.
12. Click Import.
13. From the information message that the data was submitted successfully, click OK.
14. To view details about the import process, click Application, click Jobs, view
Recent Activity, and then click the link for the import to view the details.
A data import file would have these rows. The first row is the required file Column
Headers:
4-22
Chapter 4
Importing Data
When you load data in YTD_Input, if the current period value is the same as the prior
period value, the system does not store a zero (0) Periodic value, which helps to
improve the performance of the data load.
Closing Balance includes the impact of Opening Balance while YTD excludes Opening
Balance and encompasses movements for the current year only, excluding Opening
Balance. For Closing Balance Input, see the section on the Closing Balance Input
Hierarchy in Seeded Dimension Members.
Also, note that if you load data on a Quarterly basis in the YTD View, if there are
periods with NoData status between the current period and a period where data was
entered, the in-between periods with NoData calc status are changed to Impacted at
the start of the consolidation process and changed to OK on completion. All of the
ancestor's status are changed to Impacted for those periods if their status was NoData
prior to consolidation.
Suppose the following data exists in the application for the Sales account:
A data import file would have these rows. The first row is the required file Column
Headers:
4-23
Chapter 4
Importing Data
This feature is supported for Administrator, Power User and User data loads. If a
Power User or User performs the data load, the system will reverse the YTD values for
which the user has Write access.
This example shows a data load file to the YTD_Input member in Replace mode. The
first row is the required Column Headers:
Results:
The system reverses the YTD values for all the unspecified accounts (that is, all
accounts except Sales that have a value in Prior Periods) in the data load file.
Example: Data Import File - Closing Balance Input and Replace Mode
You can load a data file that contains only the Closing Balance Input data to reverse
the prior period non-zero Closing Balance amounts. When you load the data file, you
use the Replace mode.
In order for the system to execute the reversal:
• The file must contain only Closing Balance Input.
• It must be loaded using the Replace mode.
• The prior period must not have a status of Impacted. It should have a calculation
status of OK or System Change.
If the prior period is Impacted, the system displays a warning message that "No
reversal of the prior period Closing Balance will be executed" and it does not perform
the reversal.
If the Closing Balance Input data file contains data for multiple periods, the reversals
of the prior period Closing Balances will only be applied to the first period loaded,
because only the first period will have a prior period that is not impacted.
You can view the data load status and any error messages in the Jobs console.
4-24
Chapter 4
Importing Data
This example shows a Closing Balance Input data load file in Replace mode. The first
row is the required Column Headers:
Base Entity,40000,"Actual,FY19,FCCS_Periodic,Entity
Currency,Cash,FCCS_No Intercompany,FCCS_ClosingBalance_Input,FCCS_Data
Input,FCCS_Local GAAP,FCCS_Entity Input",Consol
Base Entity,4000,"Actual,FY19,FCCS_Periodic,Parent
Currency,Cash,FCCS_No Intercompany,FCCS_ClosingBalance_Input,FCCS_Data
Input,FCCS_Local GAAP,FCCS_Parent Input",Consol
4-25
Chapter 4
Exporting Data
A data import file could have these rows. The first row is the required file Column
Headers:
Period, Average Rate, Ending Rate, Point of View, Data Load Cube Name
Exporting Data
You export data from the Applications page.
As an alternative, you can export data using Data Management. Create a custom
application as the source using Financial Consolidation and Close, then export the
data and save the export file from within Data Management.
To export data:
1. On the Home page, click Application.
2. Click Overview, and from Actions, select Export Data.
3. Click Create.
4-26
Chapter 4
Viewing Data Import and Export Status
4. On the Export Data page, select the target location of the data export file:
• Local—Saves the data export file to a location on your local computer.
• Outbox—Saves the data export file to the server.
5. For Cube Type, select either Consol or Rates.
6. For File Type, select an option:
• Comma delimited—Creates a comma-delimited .csv file for each artifact.
• Tab delimited—Creates a tab-delimited .txt file for each artifact.
• Other—Creates a .txt file for each artifact. Enter the delimiter character that
you want to use in the export file. For a list of supported delimiter characters
and exceptions, see Other Supported Delimiter Characters.
7. For Smart Lists, specify Export Labels or Export Names.
8. For Dynamic Members, select whether to Include or Exclude.
9. Select the slice of data to be exported.
The Account dimension, which is the only dense dimension in the system, must be
in the Column.
10. Optional: If the selected location is Outbox, click Save as Job to save the export
operation as a job, which you can schedule to run immediately or at a later time.
11. Click Export, and then specify where to save the data export file.
To reduce the size of data export file, if a form has an entire row of #missing
values, the row will be omitted from the data export file.
4-27
Chapter 4
Exporting Data Using Data Management
system Period names and Keys to your application Periods and Years. Category
mappings map source system data categories to your application data categories and
frequencies.
Before using Data Management to load data from an external system, administrators
perform these setup tasks:
• Define Import Formats to define the layout of the source data files. Specify how
to map columns or fields in your data source to your Financial Consolidation and
Close data structure.
• Create Locations to associate with the data integration. Each location has its own
Data Load Mappings and Data Load Rules.
• Define Data Load Mappings for each location, which map source system member
names for each dimension to the corresponding application member names.
• Create Data Load Rules, which specify a data file to load into a selected Category
and Period. If you want to the Data Load Rule to run at a later time, you can select
from Schedule options such as Daily or Weekly.
The Setup process enables you to import the data to Data Staging tables so that you
can verify that your settings and member mappings are correct before loading into
your application.
After you define Data Management mappings, you can update the mappings and Data
Load Rules as needed. For example, if new accounts or dimension members have
been added for a Location, or if member names have changed, you can update the
mapping of source system member names to your application member names.
You can load data from Data Management if you have the Service Administrator or
Power User role.
After the data import process is finished, you can open a data form to verify that the
data was loaded correctly. You can Drill Through from a cell in the data form to view
the source data that was loaded into the cell.
To access Data Management:
1. Click the Navigator icon , and then under Integration, click Data Management.
2. Click the Setup tab, and follow the procedures in the Administering Data
Management for Oracle Enterprise Performance Management Cloud guide.
Watch the following videos for information on data integrations:
4-28
Chapter 4
Data Integrations
• Add a Custom Target Application. The data that you extract is stored in the Target
Application before export to a flat file.
• Specify Application Details and Dimension Details for the extract process.
• Define Import Formats to map data from the Source system to the dimensions in
your Target application.
• Create Locations to link the import formats to Data Load rules.
• Define Data Mappings for each location, which map source system dimension
member names for each dimension to the corresponding Target application
names.
• Create Data Load Rules to run the data extract process.
After you run the data export process, the Status column displays the current status.
The data is staged in Data Management. You can download the data file from the
Process Details page and save the data file.
To access Data Management:
1. Click the Navigator icon , and then under Integration, click Data Management.
2. Click the Setup tab, and follow the procedures in the Administering Data
Management for Oracle Enterprise Performance Management Cloud guide.
Watch the following video for information on exporting data using Data Management:
Data Integrations
Data Integration is the mechanism by which integration processes are performed in
Financial Consolidation and Close.
Data Integration is the mechanism by which integration processes are performed in
Financial Consolidation and Close. You can define file-based and direct integration
sources, create mapping rules to translate source data into the required target format,
and execute and manage the periodic data loading process. Common integration
tasks are done using an easy-to-navigate interface that supports and conforms to how
you work.
You can access Data Integration directly from Financial Consolidation and Close. From
the Data Integration page, you can create an integration. You can also run an existing
integration to extract data from the source and load it to target based on any filter
criteria.
See Administering Data Integration for Oracle Enterprise Performance Management
Cloud, and the "Customers Using Oracle Financial Consolidation and Close Cloud"
section in Administering Data Management for Oracle Enterprise Performance
Management Cloud.
To access Data Integration, you must be a Service Administrator, Power User, or User.
To access Data Integration:
1. On the Home page, select Applications, and then select Data Exchange.
The Data Integration page is displayed.
4-29
Chapter 4
Copying Data
2. To search for an integration, click Search and search by Name, Location, Source,
or Target.
3. To sort the list of integrations, specify a condition. Sort results can be listed in
Ascending order (A to Z) or Descending order (Z to A).
4. To create an integration, click Create Integration
, and use the Create Integration wizard to specify the integration details.
5. To edit an integration, double-click an integration from the list and edit integration
details as needed.
6. To run an integration, select an integration from the list and click Run
Copying Data
You can copy data from a source POV to a target POV to assist with your business
planning and analysis. You can copy specific Scenario, Year, Period, and Entity
dimension members to target dimension members. This enables you to perform a bulk
copy of data along with the supporting details such as journals and Supplemental Data
Manager details. For example, you can copy Actual data into a Budget or Forecast
scenario to start your planning process. You can copy data from one or more periods,
from one scenario to another, and from one or more entities. You cannot copy data to
a locked entity.
To copy data, you must be a Service Administrator with Write access to the data.
You can copy these types of data:
• Regular Data (including journals)
• Override Data— rates and amounts entered on the Override Rates form for
historical rate override accounts
• Rate Data— data for global currency rates
For Regular data, you can specify whether to merge or replace the data during the
copy process. You select Merge to add the source data set to the target data set, or
Replace to replace the target data set with the Source data set. If you select Replace,
data that does not exist in the source data set is cleared in the target. For example, if
the Sales account for January does not have data in the source data set, then existing
data in Sales for January will be cleared in the target data set. You can copy data to
level 0 Target members only.
You can include journal detail in the copy process for Regular Data if you select a
journal Data Source member. When you copy data that includes posted journals, the
system creates the journal in the target POV and automatically posts the journal.
You must select members for Scenario, Year, Period, Entity, and Data Source.
You can optionally select members for the Account, Movement, Intercompany, Multi-
GAAP and Custom dimensions. If you do not select members for these dimensions, all
level 0 members are included.
4-30
Chapter 4
Copying Data
For the Data Source dimension, the target member is always the same as the source
member; it cannot be redirected. An exception is the Supplemental Data member.
The Supplemental Data member allows drill through from the summarized data in
Financial Consolidation and Close to the underlying detail in Supplemental Data
Manager. Because the underlying detail is not copied from the source to the target
POV during the Copy process, and therefore is not available for drill through, when
you select Supplemental Data as a source, you must select a target member other
than Supplemental Data to store the copied value. The member that you select as a
target for Supplemental Data cannot also be selected as a source.
After you select members for the Copy Data process, you can save them as a Copy
Data Profile. This enables you to later retrieve the information for the Copy Data
process without needing to make member selections again. See Using Copy Data
Profiles.
The following members in these dimensions are fixed and not available for selection in
the Copy process:
• View - Periodic
• Currency - Entity Currency
• Consolidation - Entity Input
After the Copy process, the Calculation Status for all target entity data changes to
Impacted. You must run consolidation to update the values.
The system does not include entities with NoData as part of the Copy process.
To copy data:
1. On the Home page, click Application.
2. Click Overview, then from Actions, select Copy Data.
3. Select the items that you want to copy:
• If you previously saved your Copy Data member selections as a profile, the
Copy Data Profiles list displays the available profiles. You can select a profile,
update it if need be, or click Run to run the saved Copy Profile.
• If you do not have any saved Copy Data Profiles, select the type of data, and
specify the Source and Target members.
4. Select the type of data to copy:
• Regular Data
• Override Data
• Rate Data
5. For Regular Data, from Copy Options, select an option:
This option is only available for Regular Data. Rate Data and Override Data are
always copied using Replace mode.
• Replace—All target data cells are replaced by the source data cell values.
• Merge—The source data cell values are merged into the target data cell
values. Any existing target data cells that are not part of the source copy will
remain after the merge.
6. For Source, select the members to copy, and click OK.
4-31
Chapter 4
Using Copy Data Profiles
If you copy a range of periods, the number of source periods must equal the
number of target periods. Only Input base members below "FCCS_Total Data
Source" are available for selection.
If you copy Rate Data, you do not need to select any Entity members.
7. Optional: To copy Supplemental Detail, select one or more Supplemental Detail
Data Source members to copy, then from Supplemental Data Member, select
a base Data Source member other than Supplemental Data for the target. The
member selected as a target for Supplemental Data cannot also be selected as a
source.
8. For Target, select the members to which to copy data.
9. Click Run to submit the Copy Data task, and at the prompt, click Yes to continue.
The system displays a message that the Copy Data task is submitted. You can
monitor the task status from the Jobs console. From the Application page, click
Jobs, and then click on the job for more details.
4-32
Chapter 4
Clearing Data
4. Click Save As to save the modified profile as a new profile, then enter a Name
and Description.
Clearing Data
You can clear data for selected entities from a specific Scenario, Year, and period or
range of periods. You cannot clear data for a locked entity.
To clear data, you must be a Service Administrator with Write access to the data.
You can clear these types of data:
• Regular Data (including journals)
• Override Data— rates and amounts entered on the Override Rates form for
historical rate override accounts
• Rate Data— data for global currency rates
To clear data with journal detail, select the "Journal Input" data source member for
Data Source. The system unposts the posted journal and clears the data cell value.
It does not delete the supporting unposted journal. If you want to later remove the
unposted journal, you can do so manually.
If you select the Supplemental Data member for data source, any data posted from a
Supplemental Data form reverts to an unposted status.
You must select members for Scenario, Year, Period, Entity, and Data Source.
You can optionally select members for the Account, Movement, Intercompany, Multi-
GAAP and Custom dimensions. If you do not select members for these dimensions, all
level 0 members are included.
After you select members for the Clear Data process, you can save them as a Clear
Data Profile. This enables you to later retrieve the information for the Clear Data
process without needing to make member selections again. See Using Clear Data
Profiles.
The following members in these dimensions are fixed and not available for selection in
the Clear process:
4-33
Chapter 4
Using Clear Data Profiles
• View - Periodic
• Currency - Entity Currency
• Consolidation - Entity Input
After the Clear process, the Calculation Status of the entities changes to Impacted.
You must run consolidation to update the values. The status of a parent entity also
changes to Impacted if you clear data of its children. The system does not include
entities with NoData as part of the Clear process.
To clear data:
1. On the Home page, click Application
2. Click Overview, then from Actions, select Clear Data.
3. Select the items that you want to clear:
• Regular Data
• Override Data
• Rate Data
4. For Target, select members for which to clear data, and click OK.
5. Click Run to submit the Clear Data task, and at the prompt, click Yes to continue.
The system displays a message that the Clear Data task is submitted. You can
monitor the task status from the Jobs console. From the Application page, click
Jobs, and then click on the job for more details.
4-34
Chapter 4
Refreshing the Database
4-35
Chapter 4
Refreshing the Database
Caution:
Before you refresh, a best practice is to back up your outline file and export
data from all databases.
4-36
Chapter 4
Restructuring Cubes
Note:
If you schedule a recurring refresh database job, the refresh job
options that you select are applicable each time the job is run. To
edit your selections, click the name of the job in the Jobs console,
and then click Save.
Restructuring Cubes
You can run the Restructure Cube job to perform a full restructure of a block storage
cube to eliminate or reduce fragmentation. This will also remove empty blocks.
This feature is not applicable for an Aggregate Storage cube (ASO).
Note:
You should not run this job during the application maintenance time. You also
should not launch a consolidation process while the Restructure Cube job is
running.
4-37
Chapter 4
Removing an Application
The Restructure Job is submitted on the Jobs page. Make sure that the job is
completed by periodically refreshing the page.
Removing an Application
Removing an application deletes it and all of its contents. Any scheduled jobs for the
application will also be deleted. This action cannot be undone. As a best practice, you
should back up the application first.
To remove an application:
1. On the Home page, click Application.
2. Click Overview, then from Actions, select Remove Application.
3. Review the confirmation message. To continue, click Yes.
Scheduling Maintenance
By default, Financial Consolidation and Close automatically performs daily
maintenance starting at midnight local time. During the nightly maintenance window,
the system performs backups, applies any patches, recycles the application, and so
on. If you prefer, you can schedule daily maintenance to occur at another time.
During daily maintenance, the service automatically creates a backup snapshot of data
and artifacts. When daily maintenance executes, it replaces the prior backup snapshot
with a new backup snapshot. You should schedule the execution of the EPM Automate
Utility on a daily basis to download the backup snapshot to a local computer.
To schedule maintenance:
1. On the Home page, click Tools.
4-38
Chapter 4
Using the Inbox/Outbox
4-39
Chapter 4
Working with Activity Reports and Access Logs
• Top 10 most active users and top least active users by duration
• Top 5 worst performing calculation script commands over 1 minute
• Top 10 calculation scripts by duration
This table identifies the business rules that took the longest time to run. Available
information includes the name of the calculation script, the number of times the
script was run, and the duration.
• Unsupported browser versions and the number of users who used them
• Browser versions that were used to access the service and the number of users
who used them
• Application design changes that occurred during the report period
This section provides an audit trail of application design changes, if any.
Information includes application name, type and name of the modified design
artifact, identity of the user who modified the artifact, and the time the changes
were made. Data changes are not reflected in this table.
• Oracle Smart View for Office versions being used and the number of users who
use them
• 10 most active Smart View users who not use the current version of Smart View
Note:
The Application Activity Report uses the administrator’s time zone, which is
set in the Maintenance Window screen.
4-40
Chapter 4
Working with Activity Reports and Access Logs
• To download an access log, click Download under Access Log in the row
that indicates the day for which you want to download the log.
4-41
5
Managing Application and System Settings
Related Topics
• Specifying Application Settings
• Uploading Fonts in Enterprise Performance Management Cloud Deployments
Oracle recommends that the report designer upload any TrueType fonts that
your company uses to produce reports. You can upload individual font files or
zipped files containing multiple TrueType fonts to the Fonts folder via Application
Settings.
• Specifying a Default Alias Table, and Setting Member and Alias Display Options
• Specifying Number Formatting Preferences
• Defining User Variables
• Customizing Your Application Appearance
• Making Announcements
• Specifying Artifact Labels
• Working With the Artifact Labels Grid
• Adding Languages and Defining Localized Artifact Labels
• Exporting and Importing Artifact Labels for Editing
• Reviewing Artifacts
Note:
Administrators specify defaults for the current application. However, users
can override these application defaults by setting preferences to control
many aspects of the application, such as their profile photo and how
numbers display in the application.
To set user preferences, see " Setting Your Preferences " in Working with
Oracle Financial Consolidation and Close Cloud.
5-1
Chapter 5
Specifying Application Settings
Note:
The Number of Items on the Page Drop-down option lets you
shorten the member list so that the Search box can be more easily
seen. If the list is shortened to 10 members, for example, then you
won't need to scroll to see the Search box.
• Other Options—Set options for date format, attribute dimension date format,
partial grid fetch size ,whether to suppress application management options
in Oracle Smart View for Office, whether to enable data loads for ad hoc
read-only roles, and whether to enable Consolidation Rules Logging.
– Date Format—Select a date format, or select Automatically Detect to
use your system's locale settings.
5-2
Chapter 5
Specifying Application Settings
5-3
Chapter 5
Specifying Application Settings
5-4
Chapter 5
Specifying Application Settings
Note:
HSP_LINK and HSP_NOLINK UDAs on specific account members
override the XREF setting for those account members. For example,
if this option is set to No and you use the @XREF function to look up
a data value in another cube to calculate a value from the current
cube, you can add theHSP_LINK UDA to such members to create the
@XREF function only for these specific members. If this option is set to
Yes, HSP_NOLINK works the same way it worked in earlier releases
and prevents XREFs from being created on specific members.
5-5
Chapter 5
Uploading Fonts in Enterprise Performance Management Cloud Deployments
Note:
If more than one font is to be uploaded, create a zip file.
Be aware that it may take some time to perform the upload depending on
the size of the font file.
5-6
Chapter 5
Specifying Number Formatting Preferences
Option Example
Thousands Separator None: 1000
Comma: 1,000
Dot: 1.000
Space: 1 000
You can enter values with or without a
thousands separator.
Decimal Separator Dot: 1000.00
Comma: 1000,00
You can enter values with or without a
decimal separator.
Negative Sign Prefixed Minus: -1000
Suffixed Minus: 1000-
Parentheses: (1000)
Negative Color Black: Negative numbers are black
Red: Negative numbers are red
3. Click Save.
5-7
Chapter 5
Defining User Variables
Note:
Formatting selections take effect when you click outside the cell. If you
select a setting other than Use Application Defaults for the Thousands
separator or the Decimal separator, you must change both separators.
You cannot select the same option for the Thousands and Decimal
separators.
Note:
You can set your profile picture to display at the top of the Announcements
panel of the Home page in User Preferences. Click Tools, and then User
Preferences.
5-8
Chapter 5
Making Announcements
Making Announcements
Administrators can create and send announcements to users about upcoming events,
such as system maintenance. Announcements are displayed in the Announcements
area on the application's Home page.
To create an announcement:
1. On the Home page, click Tools, and then click Announcements.
2. Click Create.
3. Enter the announcement information:
Subject - the purpose of the announcement
Start Date - when to send the announcement.
End Date - optional.
5-9
Chapter 5
Specifying Artifact Labels
Content. You may need to select an editing mode (rich text or source code) before
entering text.
4. To save the announcement, click Save and Close.
Related Links
• Working With the Artifact Labels Grid
• Adding Languages and Defining Localized Artifact Labels
• Exporting and Importing Artifact Labels for Editing
a. Click , and then select the artifacts you want to work with. For some
artifacts, you can further filter by property type.
b. Click Apply to close the Filter window and display the artifact grid filtered by
artifact type and property type.
5-10
Chapter 5
Adding Languages and Defining Localized Artifact Labels
Tip:
Use this method to add labels directly in the artifact labels grid. This method
is ideal if you only need to add or update a few labels at a time. For bulk
changes or edits on artifact labels; for example, terminology changes that
affect multiple labels, use the export feature to edit in Excel, then import. See
Exporting and Importing Artifact Labels for Editing.
To add a language:
1. Click Tools, and then click Artifact Labels.
2. Click , and then select the artifacts you want to work with. For some artifacts,
you can further filter by property type.
3. Click Apply.
4. Click Add Language.
5. Select from the list of supported languages.
6. In the language-specific column, enter artifact labels into the editable cells for each
artifact property (Name, Description, and so on).
7. Click Save.
Note:
When you define a localized artifact label for the Default navigation flow
(for example, editing the name of an icon on the Home page), your update
will automatically propagate to all navigation flows. However, if you define a
localized artifact label for another navigation flow that isn't the Default flow,
then that update will override the label coming from the Default flow.
5-11
Chapter 5
Reviewing Artifacts
Tip:
Use this method for bulk changes or edits on artifact labels by language;
for example, terminology changes that affect multiple labels. For updates to
individual artifact labels, you can edit them directly in the artifact grid.
2. Click , and then select the artifacts you want to work with. For some artifacts,
you can further filter by property type.
3. Click Apply.
4. Click Actions.
• To export artifact labels:
a. Click Export.
b. Select the target environment of the export file:
– Local—Saves the export file to a location on your local computer.
– Outbox—Saves the export file to the server.
c. Choose a language.
d. Click Export.
• To import artifact labels:
a. Click Import.
b. Select the location of the import file:
– Local—Loads the import file from a location on your computer. For
Source File, click Browse to select the import file on your computer
for the artifact you're importing.
– Inbox—Loads the import file from the server. Enter the name of the
file in Source File.
c. Click Import.
Reviewing Artifacts
To review the artifacts in your application:
1. Click Application, then Configure, and then select a business process.
2. From the Actions menu, select Review Modified Artifacts.
5-12
Chapter 5
Reviewing Artifacts
4. To undo customizations to predefined artifacts, select the artifacts, and then click
Restore.
5-13
6
Connecting Environments in EPM Cloud
Related Topics
• About Connecting EPM Cloud Environments
• Considerations for Migrating EPM Cloud Connections
• Creating, Editing, and Deleting Connections to Other EPM Cloud Environments
• Connecting to External Web Services
• Specifying Advanced Options for External Connections
• Navigating Across EPM Cloud Environments
• Customizing Navigation Flows to Access Other EPM Cloud Environments
• Using Direct URLs to Integrate Connected Environments
6-1
Chapter 6
About Connecting EPM Cloud Environments
Note:
You can also connect directly Oracle Analytics Cloud Enterprise Edition or
Professional Edition 5.6 to EPM Cloud Platform, provided you have both
services. When you've configured the connection, you can visualize data
from EPM Cloud business processes in Oracle Analytics Cloud. You no
longer have to model EPM data in a metadata repository (RPD) file to create
visualizations and dashboards in Oracle Analytics Cloud.
See the following topics in the Oracle Analytics Cloud documentation:
• Connect to Oracle Enterprise Performance Management Cloud in
Connecting Oracle Analytics Cloud to Your Data
• Add Authentication and Embed Your Content in Other Applications in
Visualizing Data and Building Reports in Oracle Analytics Cloud
What are the ways I can connect to other EPM Cloud environments?
• Toggle between the source environment and the target environment on the
Navigator menu. See Navigating Across EPM Cloud Environments.
• Customize navigation flows in the source environment to access clusters, cards,
and artifacts in other target environments from the Home page. See Customizing
Navigation Flows to Access Other EPM Cloud Environments.
• Use direct URLs to seamlessly integrate connected environments. See Using
Direct URLs to Integrate Connected Environments.
Considerations
• Only Service Administrators create cross-environment connections.
6-2
Chapter 6
Considerations for Migrating EPM Cloud Connections
Users click a navigation link to open the linked environment. Access within the
linked environment is determined by the predefined role and access permissions,
if any, assigned to the user.
• For cross-environment navigation to be seamless, all environment instances to
which cross-environment navigation flows are setup must belong to the same
identity domain.
Note:
If the target and source environment instances are not on the same
identity domain, then you'll not be able to establish a connection between
them.
Videos
6-3
Chapter 6
Creating, Editing, and Deleting Connections to Other EPM Cloud Environments
Service Administrator creates for migrating the Planning test environment will include
connections and navigation flows, including the connection to Financial Consolidation
and Close test environment.
On migrating the snapshot into the Planning production environment, Planning
will have an undesirable connection to the Financial Consolidation and Close
test environment. You must manually change undesirable connections to point
to the corresponding production environment either before or after migrating the
environment.
6-4
Chapter 6
Creating, Editing, and Deleting Connections to Other EPM Cloud Environments
Note:
These credentials are used only to define and validate the
navigation link. When a user logs in, their own role and
access will be applied to access the target environment.
Note:
If you edit the URL to connect to a new service type, you could
cause navigation flows to break. If you want to connect to a
different service, Oracle recommends creating a new connection
instead.
c. Click Validate.
d. If the validation is successful, click Save and Close.
• To duplicate a connection:
a. On the Manage Connections page, in the Action column next to the
connection you want to duplicate, click .
b. Click Duplicate.
c. Enter a name for the duplicate connection, then click OK.
• To delete a connection:
a. On the Manage Connections page, in the Action column next to the
connection you want to delete, click .
b. Click Delete.
When target environments are connected to an EPM Cloud source environment, they
are listed in the My Connections pane on the Navigator menu of the source
environment. The My Connections pane on the Navigator menu is where you
can navigate across environments. See Navigating Across EPM Cloud Environments.
For troubleshooting assistance, see Handling Issues with Cross-Environment
Connections in Oracle Enterprise Performance Management Cloud Operations Guide .
6-5
Chapter 6
Connecting to External Web Services
Note:
The Other Web Service Provider connection type is only available for use
with those business processes that allow Groovy Rules to be created. See
the Oracle Enterprise Performance Management Cloud, Groovy Rules Java
API Reference.
Before you can create connections to external Web services, you must ensure you
have access to the Web service you're connecting. You must also have URLs for the
Web service and any login details, if required.
To create a connection to an external Web service:
1. Login to the source environment.
2. From the Home page, click Tools, and then click Connections.
3. On the Manage Connections page, click Create.
4. Click Other Web Service Provider.
5. Enter a Connection Name and a Description for the connection.
6. Enter the URL for the target connection.
7. Enter optional advanced options for the URL.
Note:
The optional advanced options enable you to specify query or header
parameters when defining an external connection. See Specifying
Advanced Options for External Connections.
8. Enter User and Password login credentials for the connection, if required. In
some cases, such as connecting to Oracle Cloud services, the domain name may
need to be prefixed to the user name; for example, <Identity Domain>.<User
Name>.
9. Click Save and Close.
6-6
Chapter 6
Specifying Advanced Options for External Connections
Note:
The ability to define query parameters for an external connection is only
available for use with those business processes that allow Groovy Rules
to be created. See the Oracle Enterprise Performance Management Cloud,
Groovy Rules Java API Reference.
• —Add query
• —Delete query
• Type—Select Header or Parameter.
Header sets a default header that will be sent on every request made for this
connection. Parameter sets a default query parameter that will be sent on
every request made for this connection.
• Secure—If selected, the value entered in the Value field will be encrypted.
Clearing the Secure check box for a row will remove the value.
An example header that one would secure is the Bearer Token for external
Web services that supports Bearer Authentication, or the API Key query
parameter for external Web services that supports API keys for authentication.
• Name—Enter a name for the header or query parameter.
• Value—Enter the value for the header or query parameter.
6-7
Chapter 6
Customizing Navigation Flows to Access Other EPM Cloud Environments
You can toggle between the environments from this location. You must have access to
the other environments in order to open them. Artifacts are accessible based on the
user's role.
To open another Oracle Enterprise Performance Management Cloud environment:
Note:
Click the icon to the right of the environment name to open the
environment in a new window.
6-8
Chapter 6
Customizing Navigation Flows to Access Other EPM Cloud Environments
To learn more about designing navigation flows, see "Designing Custom Navigation
Flows" in your EPM Cloud Administering guide.
Cards from multiple environments can also be included within the same cluster on a
source environment. For example, a Tax Reporting user can launch a Journals icon
from Financial Consolidation and Close without leaving Tax Reporting.
6-9
Chapter 6
Customizing Navigation Flows to Access Other EPM Cloud Environments
You create clusters and add cards to clusters by customizing navigation flows. For
general information about navigation flows, see "Designing Custom Navigation Flows"
in your EPM Cloud Administering guide.
To create a cluster made up of cards from other EPM Cloud environments:
1. Launch the Navigation Flow page and create a navigation flow or edit an existing
navigation flow:
Note:
To create a navigation flow, you must first select an existing navigation
flow and make a copy of it. Then edit the duplicate navigation flow details
and save them.
then in the upper right-hand corner of the page, click , and then select
Create Copy. Enter a name for the navigation flow, and then click OK.
Note:
New flows are marked Inactive until they are activated by the
Service Administrator. To activate or deactivate a navigation flow,
in the Active column, click Active or Inactive. Only one navigation
flow at a time can be active.
c. To edit an existing navigation flow, click the name of the navigation flow you
want to edit.
6-10
Chapter 6
Customizing Navigation Flows to Access Other EPM Cloud Environments
Note:
Editing is only possible if the navigation flow is inactive. If the
navigation flow you want to edit is active, ensure you mark it
Inactive before editing.
b. To the right of the card that you want to move, in the Order column, click .
c. Select the cluster, and then click OK.
The cards will appear in the listing as children of the cluster. Use the up and down
arrows next to the cards to reorder the cards within the cluster, if needed.
4. Click Save and Close.
You must activate the navigation flow and reload it to view your design time changes.
To reload a navigation flow, click the down arrow next to your user name. Then on the
Setting and Actions menu, click Reload Navigation Flow.
6-11
Chapter 6
Customizing Navigation Flows to Access Other EPM Cloud Environments
If you can't see your referenced artifacts after activating and reloading the navigation
flow, see Why Is My Referenced Card, Tab, or Cluster Not Visible?
You create tabular cards by customizing navigation flows. For general information
about navigation flows, see "Designing Custom Navigation Flows" in your EPM Cloud
Administering guide.
To configure a card made up of tabs and sub-tabs from other EPM Cloud
environments:
1. Launch the Navigation Flow page and create a navigation flow or edit an existing
navigation flow:
6-12
Chapter 6
Customizing Navigation Flows to Access Other EPM Cloud Environments
Note:
To create a navigation flow, you must first select an existing navigation
flow and make a copy of it. Then edit the duplicate navigation flow details
and save them.
then in the upper right-hand corner of the page, click , and then select
Create Copy. Enter a name for the navigation flow, and then click OK.
Note:
New flows are marked Inactive until they are activated by the
Service Administrator. To activate or deactivate a navigation flow,
in the Active column, click Active or Inactive. Only one navigation
flow at a time can be active.
c. To edit an existing navigation flow, click the name of the navigation flow you
want to edit.
2. Add a tabular card with artifacts from various target environments:
a. If there is an existing card you want to add from another environment, from
the Navigation Flow page, click Add Existing Card/Cluster, select the target
environment under My Connections, and then choose the card you want to
add to your navigation flow.
Note the following:
• Cards can't be directly selected from Narrative Reporting and Profitability
and Cost Management using the Add Existing Card/Cluster option.
• Cards that are added from another navigation flow or from another
environment will display the localized labels that were defined in the
source navigation flow. To update the card labels in your navigation flow,
on the Home page, click Tools, and then click Artifact Labels. See
"Specifying Artifact Labels" in your EPM Cloud Administering guide.
b. To add a new tabular card to the navigation flow, from the Navigation Flow
page, click Add Card, and then select details for the card:
• Name—Enter a label for the card.
• Visible—Select whether the card is visible to users on the Home page.
• Cluster—If clusters exist, select a cluster for the card or select None.
• Icon—Select the icon that will be displayed for the card you're creating.
Choose from the available icons provided in the icon library.
• Content—Select from the following options:
– Page Type—Select a multiple page (tabular) format.
– Orientation—Select Vertical or Horizontal.
6-13
Chapter 6
Customizing Navigation Flows to Access Other EPM Cloud Environments
d. For Artifact, click to select an artifact in the Artifact Library; for example,
if the artifact is a form, then select the specific form from the artifact listing.
Available artifacts include forms, dashboards, and reports. To select an
artifact from another environment, select the target environment under My
Connections, and then choose the artifact you want to add to your tab.
e. Repeat adding tabs and sub tabs until the card is complete.
4. Click Save and Close.
Note:
• For cards with multiple tabs or sub tabs, the last tab accessed by a user
will be retained the next time the user accesses the card in the same
session. If the user logs out and then logs back in, the default tab will be
displayed.
• Tabs or sub tabs that are added from another navigation flow or from
another environment will display the localized labels that were defined in
the source navigation flow. To update the tab labels in your navigation
flow, on the Home page, click Tools, and then click Artifact Labels. See
"Specifying Artifact Labels" in your EPM Cloud Administering guide.
You must reload the navigation flow to view your design time changes. To reload a
navigation flow, click the down arrow next to your user name. Then on the Setting and
Actions menu, click Reload Navigation Flow.
If you can't see your referenced artifacts after reloading the navigation flow, see Why
Is My Referenced Card, Tab, or Cluster Not Visible?
6-14
Chapter 6
Using Direct URLs to Integrate Connected Environments
Exporting URLs
To export EPM Cloud URLs to a CSV file:
1. Log into an EPM Cloud environment.
2. From the Home page, click the down arrow next to the user name (upper right
corner of the screen).
3. On the Settings and Actions menu, click Export URLs, and then click Save.
The system saves a CSV file to the default download folder on your local machine,
and the filename is automatically generated with the current date and time of the
server; for example, 19_Feb_2021 13_15_38 Navigation Flow URLs.csv. Find the file
in your download folder, and open it with a text editor or with Microsoft Excel.
Note:
Only cards, tabs, and sub-tabs have URLs. Navigation flows and clusters
don't have URLs.
See the following example direct URLs export file as viewed in Notepad:
6-15
Chapter 6
Using Direct URLs to Integrate Connected Environments
The URLs export file provides the following information separated by a vertical bar or
pipe ( | ) delimiter character:
• Navigation Flow Name
• Status
• Type
• Name of the cluster, card, tab, or sub-tab
• URL
• Visible
• Role/Group
• Description
To view the URLs export file in Microsoft Excel:
1. Open Excel, and then click the Data menu.
2. Click New Query, then From File, and then click From CSV.
3. Find and select the CSV file you exported, and then click Import. A new window
displays the data in the CSV file.
4. To make the first row of the CSV file the header row, click Edit, click Use First
Row as Headers, and then click Close and Load.
The resulting Excel file will look like the following example:
Find and copy the unique URL for the card, tab, or sub-tab that you wish to have
integrated into the other connected environment. Only the URL target will open and
users with access to the targeted artifact can perform the same actions as if they're
working within the target business process.
6-16
7
Designing Custom Navigation Flows
Customize the business process interface using navigation flows. Navigation flows
enable designers to control how roles or groups interact with the business process.
Related Topics
• Understanding Navigation Flows
• Viewing and Working with Navigation Flows
Videos
Related Topics
• What Can Be Customized in the Business Process Interface?
• Navigation Flow Customization Categories
• Navigation Flow Permissions
• Predefined Navigation Flows
• Viewing and Working with Navigation Flows
7-1
Chapter 7
Understanding Navigation Flows
7-2
Chapter 7
Viewing and Working with Navigation Flows
These are the operations you can and cannot perform on the Default navigation flow:
• Name—You can't modify the name.
• Delete—You can't delete the navigation flow.
• Edit—You can view the navigation flow details, but you can't change anything.
• Activate or Deactivate—You can activate or deactivate the navigation flow.
• Duplicate—You can make a copy of the navigation flow.
Caution:
There are naming restrictions for navigation flows, cards, clusters, tabs, and
infolets (if your business process uses infolets) in navigation flows. You
cannot use these special characters:
• ampersand ( & )
• less than sign ( < )
• greater than sign ( > )
• quotation mark ( " )
• backslash ( \ )
• plus sign ( + )
7-3
Chapter 7
Viewing and Working with Navigation Flows
• To change the display order of cards on the Home page, see Changing the
Display Order of Cards on the Home Page.
• To add cards, see Adding Cards.
• To add tabs, see Adding Tabs to a Tabular Page.
• To remove navigation flows, cards, and tabs, see Removing Navigation Flows,
Cards, and Tabs.
• To group cards into clusters, see Grouping Cards into Clusters.
Note:
Ensure that you adhere to the navigation flow naming restrictions
outlined in Viewing and Working with Navigation Flows.
4. Edit details for the navigation flow. See Editing a Navigation Flow.
Note:
New flows are marked Inactive until they are activated by the
Service Administrator. To activate a navigation flow, see Activating and
Deactivating Navigation Flows.
To reload a navigation flow to view design time changes, see Reloading a Navigation
Flow.
7-4
Chapter 7
Viewing and Working with Navigation Flows
Note:
The predefined navigation flow isn't editable. However, you can create a
copy of a predefined navigation flow and edit the copy. See Predefined
Navigation Flows.
Note:
Ensure that you adhere to the navigation flow naming restrictions
outlined in Viewing and Working with Navigation Flows.
Note:
Each business process requires one active global navigation flow. To make
a different global navigation flow active, select another global navigation flow
and activate it.
7-5
Chapter 7
Viewing and Working with Navigation Flows
Note:
• You can edit the label here. However, if the label is defined in
the Artifact Labels page on the Tools cluster, that definition will
take precedence and will display during runtime. To change a
label permanently, redefine it in the Artifact Labels page. See
"Specifying Artifact Labels" in your EPM Cloud Administering
guide.
• Ensure that you adhere to the naming restrictions outlined in
Viewing and Working with Navigation Flows.
7-6
Chapter 7
Viewing and Working with Navigation Flows
b. In the tab listing on the Manage Tab page, click the name of the tab you want
to edit.
c. Enter a new name for the tab and save it.
To reload a navigation flow to view design time changes, see Reloading a Navigation
Flow.
7-7
Chapter 7
Viewing and Working with Navigation Flows
b. In the tab listing on the Manage Tab page, click the name of the tab you want
to edit.
c. Set Visible to Yes or No.
To reload a navigation flow to view design time changes, see Reloading a Navigation
Flow.
Adding Cards
The icons you see on the Home page are called cards. Cards are specific to
each functional area of the business process. Each card navigates users to the
corresponding area, where other information is displayed as one or more tabbed
pages. You can create single page or multiple page (tabular) cards.
You can also group cards into clusters. See Grouping Cards into Clusters.
To add cards to a navigation flow:
1. Open the Navigation Flow page and click the name of the navigation flow you
want to edit. See Viewing and Working with Navigation Flows.
2. To add an existing card to the navigation flow, click , click Add Existing Card/
Cluster, and then select a card. If there is an existing card you want to add from
another environment, click , click Add Existing Card/Cluster, select the target
environment under My Connections, and then choose the card you want to add
to your navigation flow.
Note the following:
• Cards can't be directly selected from Narrative Reporting and Profitability and
Cost Management using the Add Existing Card/Cluster option.
• Cards that are added from another navigation flow or from another
environment will display the localized labels that were defined in the source
navigation flow. To update the card labels in your navigation flow, on the Home
page, click Tools, and then click Artifact Labels. See "Specifying Artifact
Labels" in your EPM Cloud Administering guide.
• A reference card is a card that is already referenced from another navigation
flow. References to already referenced cards are not supported in navigation
flows and will not be available for selection in the Object Library when adding
an existing card; for example:
7-8
Chapter 7
Viewing and Working with Navigation Flows
– A card referring to a remote artifact or remote tab will not be available from
the Object Library when adding an existing card.
– A card referring to a tab from another navigation flow will not be available
from the Object Library when adding an existing card.
3. To add a new card to the navigation flow, click , click Add Card, and then
select details for the new card:
Label Description
Name Enter a label for the card.
Ensure that you adhere to the naming
restrictions outlined in Viewing and Working
with Navigation Flows.
Visible Select whether the card is visible to users on
the Home page.
Cluster If clusters exist, select a cluster for the card
or select None.
Icon Select the graphic that will be displayed for
the card you're creating. Choose from the
available graphics provided in the graphics
library.
Page Type Select Single Page or Tabular Page format.
Content Source If you selected the Single Page format,
select Artifact or URL:
7-9
Chapter 7
Viewing and Working with Navigation Flows
Label Description
Orientation If you selected the Tabular Page format,
select Vertical or Horizontal, and then add
new or existing tabs and sub tabs. See
Adding Tabs to a Tabular Page.
Note:
A reference tab is a tab that is already referenced from another
navigation flow. References to already referenced tabs are not
supported in navigation flows and will not be available for selection in
the Object Library when adding an existing tab; for example:
• A tab referring to a remote artifact or remote sub-tab will not be
available from the Object Library when adding an existing tab.
• A tab referring to a sub tab from another navigation flow will not
be available from the Object Library when adding an existing tab.
b. To add a new tab, click Add New Tab, and then edit tab details.
c. Select the content for the new tab:
7-10
Chapter 7
Viewing and Working with Navigation Flows
7-11
Chapter 7
Viewing and Working with Navigation Flows
Note:
• For cards with multiple tabs or sub tabs, the last tab accessed by a user
will be retained the next time the user accesses the card in the same
session. If the user logs out and then logs back in, the default tab will be
displayed.
• Tabs or sub tabs that are added from another navigation flow or from
another environment will display the localized labels that were defined in
the source navigation flow. To update the tab labels in your navigation
flow, on the Home page, click Tools, and then click Artifact Labels. See
"Specifying Artifact Labels" in your EPM Cloud Administering guide.
b. In the upper right-hand corner of the page, click , and then select Delete.
Note:
You can't delete the predefined navigation flow, called Default.
3. If removing a card:
a. Click the name of the navigation flow you want to edit.
b. In the Remove column for the card you want to remove, click .
4. If removing a tab:
a. Click the name of the navigation flow you want to edit.
b. Click the name of the card you want to edit.
7-12
Chapter 7
Viewing and Working with Navigation Flows
c. In the tab listing at the bottom of the Manage Tab page, in the Remove
b. To create a new cluster, click , click Add Cluster, enter or select the cluster
details, and then choose a graphic for the cluster.
Note:
Ensure that you adhere to the naming restrictions outlined in Viewing
and Working with Navigation Flows.
Note:
7-13
Chapter 7
Viewing and Working with Navigation Flows
a. To the right of each card that you want to move, in the Order column, click .
b. Select the cluster, and then click OK.
The cards will appear in the listing as children of the cluster. Use the up and down
arrows next to the cards to reorder the cards within the cluster, if needed.
To reload a navigation flow to view design time changes, see Reloading a Navigation
Flow.
7-14
Chapter 7
Viewing and Working with Navigation Flows
7-15
8
Designing Infolets
Related Topics
• About Infolets
• Anatomy of an Infolet
• Determining Infolet Content
• Using the Infolets Designer
• Creating Infolets
• Working with Infolets
• Customizing the Interface to Access Infolets
About Infolets
Infolets enable users to view and interact with high-level, essential information
generated from different sources so that they can quickly assess where to direct their
attention. Service Administrators create, redesign, delete, and assign permissions to
infolets.
What is an Infolet?
An infolet is a self-contained, interactive box-shaped container used to display
information using text and charts. Infolets are interactive and use progressive
disclosure to display high-level, aggregated, essential information for quick
consumption at a glance, and then can be acted upon as needed. Infolets can be
flipped and resized to display up to three charts or sets of values.
8-1
Chapter 8
About Infolets
Note:
Not all features pictured in the preceding image are supported in this update.
Oracle plans to support these features in a later update.
8-2
Chapter 8
Anatomy of an Infolet
Videos
Anatomy of an Infolet
Infolet Views
An infolet supports up to three views:
1. Front view (required)
8-3
Chapter 8
Anatomy of an Infolet
Note:
If only one view is presented, it must be a front view.
8-4
Chapter 8
Anatomy of an Infolet
• Provides enough information to help you decide if you're ready to take action and
move to a focused context on a work area page
• Transitions smoothly from other views. You see a smooth, seamless expansion, as
one infolet pushes others into new positions.
• Must be sized bigger than the front or back views
• Includes an Actions menu icon available only on hover, and a collapse icon in the
lower-right corner
Infolet views honor the access permissions assigned to the underlying forms and
dimensions. Therefore, the same infolet may display varying views from user to user if
they have different access permissions.
Infolet Sizes
Infolets can be sized as follows:
Note:
1x1 refers to a box that spans one column and row width (170 pixels).
• 1x1
• 2x1
• 3x1
• 2x2
• 3x2 (expanded view only)
The size of the front and the back views are always the same. Changing the size of
the front view will automatically reset the size of the back view. Because the size of the
expanded view must always be greater than the size of the front/back views, if the size
of the front/back view of an infolet is enlarged, the expanded view automatically resets
to a larger size than the front/back view.
Note:
Front and back views cannot use the 3x2 size. This size is applicable for the
expanded view only.
The size, title, and subtitle of a view is set by the designer in the properties panel. See
Using the Infolets Designer.
8-5
Chapter 8
Determining Infolet Content
Related Links
Designing Forms for Infolets
8-6
Chapter 8
Determining Infolet Content
Note:
Tile charts can only use the 1x1 size. You cannot resize an infolet using
the tile chart until the chart type is changed. If you drag and drop a
tile chart to an infolet that is greater than 1x1, you will be prompted to
change either the size of the infolet or the chart type.
8-7
Chapter 8
Using the Infolets Designer
page. You can toggle from runtime view to designer view by clicking .
Infolets Designer
Infolets Toolbar
On the upper right is the Infolets Toolbar.
8-8
Chapter 8
Using the Infolets Designer
Note:
The access permissions set for forms are honored in infolets.
• Chart Types—Select the chart types to include in the infolet. Infolets display
sample data in the charts until you associate the chart with a form as its data
source. When you link a chart to a form, users can see the impact of changing
8-9
Chapter 8
Creating Infolets
data in the form on the associated charts. To associate a chart with a form,
highlight a chart and drag and drop it onto the drop zone, in the Properties panel,
click Sample, and then click Forms to select the data source. For details about
charts, see Designing Charts for Infolets.
Infolet Menu
The infolet menu contains the infolet delete and clear actions. To view the infolet
menu, hover over the upper right corner of the infolet, and then click the down arrow to
display the menu options:
• Delete—Removes the infolet from the page
• Clear—Clears infolet details
Properties Panel
The properties panel on the right side of the Infolets Designer enables you view and
work with these infolet properties:
Note:
The header you specify is the same for all views of an infolet, but you can
specify a different subtitle for each view; for example, the front, back, and
expanded views of an infolet can each have different subtitles, but they must
have the same header.
• Header
• Subtitle
• Size—Displays the infolet in the selected size
• Chart Type—Displays the infolet data as the selected chart type
• Data—Displays the associated data source (Sample or Form)
• Form—Displays the selected infolet form
Actions such as delete and clear are on the infolet menu.
By default, the front view of an infolet is displayed in the properties panel. You can
see the other views by selecting them from the drop-down. If you flip or expand an
infolet to view the back or expanded views, the properties for those views display in
the properties panel. In addition, the properties for the corresponding chart type are
also displayed in the properties panel.
Creating Infolets
To create infolets:
1. From the Home page, click Infolets, and then click Create.
2. Click Infolets Page Name, and enter a title for the new infolets page you are
creating.
8-10
Chapter 8
Working with Infolets
3. From the designer palette on the left, choose either the Forms tab or the Charts
Type tab, highlight an object, and then drag and drop it onto the infolets drop
zone.
4. Customize the infolet using selections made in the properties panel, and then click
Save.
You can easily duplicate and modify an infolet using the Copy As action on the Infolet
list page. From the list page, click the Actions icon next to the infolet you want to copy,
and then click Copy As.
Then you can search for infolets using Search . The flat view displays
only the artifacts that meet the search criteria, not the folders that contain
them. The tree (or hierarchical) view displays artifacts in the context of the
folders that contain them.
To search on another keyword, clear the search criteria by clicking X in the
Search box.
• To refresh the infolets listing, click Refresh.
• To create infolets, click Create. See Creating Infolets.
• To perform the following actions on infolet pages, click the Actions icon next
to the infolet page, and then select:
– Create Folder—Creates a folder in the listing
– Edit—Opens the infolet page in the Infolets Designer
– Rename—Renames the infolet page
– Copy As—Duplicates an infolet page
– Delete—Deletes the infolet page from the listing
– Move To—Moves an infolet page to another folder
– Default or Unmark—Default marks an infolet page as default and makes
it accessible directly from the Home page by clicking the second infolet dot
that is displayed beneath the global header on the Home page. Unmark
removes the default designation from the infolet page.
8-11
Chapter 8
Customizing the Interface to Access Infolets
Note:
You can mark either an infolet page or a dashboard as default.
If a dashboard is marked as default first and then you mark an
infolet page as default, the default dashboard will be overwritten.
Conversely, if an infolet is marked default first, then any
dashboard marked default later will overwrite the default infolet.
Users will only see dots displayed on the Home page for infolet pages to which they
have access. The types of infolet dots displayed are as follows:
• Home dot—This dot always appears first and it links to the Home page. There can
only be one home dot. If you are not viewing the Home page, clicking the home
dot will bring you back to the Home page.
• User dot—Links to an infolet page marked by an end user as the default infolet
page. There can only be one user dot and it always appears after the Home
dot on the user's Home page. User dots cannot be added using the Navigation
8-12
Chapter 8
Customizing the Interface to Access Infolets
Flow Designer. For more information about marking an infolet as the default, see
Working with Infolets.
• Customizable dot—Links to infolet pages created by Service Administrators.
Customizable dots can be integrated into navigation flows and their visibility and
the order in which they appear is determined by the navigation flow designer.
There can be up to seven customizable dots and they always appear after the
home and user dots.
To add infolet dots to your business process interface using the Navigation Flow
Designer:
1. From the Home page, click Tools, and then click Navigation Flows.
2. Select an inactive navigation flow in the listing, and then click the Infolets tab on
the Navigation Flow Designer.
3. Click .
4. In Manage Infolet, name the infolet dot, set visibility, and then click to select
an infolet in the Artifact Library.
Note:
You can select an infolet from another EPM Cloud environment if
you've created connections to other environments. First select the
environment under My Connections, and then navigate to the infolet
in that environment.
Note:
Infolets can also be associated with a tab or a card in a navigation flow.
While adding or updating a tab or a card, select an infolet in the Artifact
Library.
To view design time changes to the navigation flow, activate the navigation flow, and
then from the Home page, click the down arrow next to the user name (upper right
corner of the screen) and click Reload Navigation Flow.
To learn more about designing navigation flows, see "Designing Custom Navigation
Flows" in your EPM Cloud Administering guide.
To learn more about connecting EPM Cloud environments, see "Connecting
Environments in EPM Cloud" in your EPM Cloud Administering guide.
8-13
9
Designing Financial Dashboards
Related Topics
• Designing Dashboards
• About Your Dashboard's Layout
• About the Gauge Chart Type
• About the Tile Chart Type
• Customizing Dashboard Colors
• Setting Line Width in Line and Combination Charts
• About Global and Local POVs
• Dashboard POVs and Valid Intersections
Designing Dashboards
Financial dashboards typically provide an overview by showing summary data. The
versatility of dashboards enables you to chart, evaluate, highlight, comment on, and
even change key business data. For example, you can change a driver such as
Volume in a form that is in a dashboard and immediately see its impact in other forms
and charts:
You can create a dashboard by selecting existing data forms and external artifacts
such as comments or an external URL. You can specify a chart type to display the
data, for example, a Pie chart, bar chart, or other chart type.
Note:
For details on Task Manager and Supplemental Data Manager Overview
and Compliance dashboards, see "Monitoring Dashboards" in Working with
Financial Consolidation and Close .
9-1
Chapter 9
About Your Dashboard's Layout
• When a new dashboard is created, the borders are hidden by default. To show
borders, in Settings, change the Borders setting to Show.
4. From the design palette on the left, drag and drop objects onto the dashboard
canvas.
Select from these objects:
Object Description
Forms Select simple forms to include in the dashboard by navigating
the forms folders or by searching for them by name.
The access permissions set for forms are honored in
dashboards.
Chart Types Select the chart types to include in the dashboard. When first
added, a selected chart has sample data. You then associate it
with a form as its data source. When you link a chart to a form,
users can immediately see the impact of changing data in the
form on the associated charts.
The Combination chart type alternates displaying row data with
vertical bars and lines in the chart. For example, the data in
row 1 of a form is displayed as a bar and the data in row 2 as
a line, with alternating chart types for even and odd-numbered
rows. Although the Combination chart type can display up to 20
rows of data, it’s particularly useful when you want to compare
two categories of data. For example, you want to compare
Germany and France’s average exchange rates over several
years, so the form has Germany rates in row 1 of the form, and
France’s rates are in row 2.
For information on the Gauge chart type, see About the Gauge
Chart Type.
Tile Sometimes called performance tiles, a tile is a chart type that
lets you select specific values from the cube to display. See
About the Tile Chart Type.
Commentary Select External Artifacts, and then Commentary. Enter text
that explains the data or charts.
URL Dynamic web page summary. Select External Artifacts, and
then URL. Insert only external site URLs starting with the
https:// security protocol. Don't use internal or relative
URLs or URLs for unconsenting third party sites such as
google.com.
5. Customize the dashboard using the dashboards settings and the objects’ hover
toolbar, and then click Save.
See About Your Dashboard's Layout.
You can easily duplicate and modify a dashboard using Copy As on the Dashboard
list page. Select the dashboard, and then click Actions.
9-2
Chapter 9
About the Gauge Chart Type
• Then drag objects to the left, the right, the top, or the bottom of the existing object.
• The dashboard canvas provides two types of drop zones: One to place two objects
next to each other, each occupying half the space, and the other to place three
objects, each occupying a third of the space.
• You can design a dashboard with objects to display vertically, horizontally, and
each can have its own size.
• To resize an object that uses Flexible layout, drag the object’s border.
• To resize an object that uses Fixed layout, set its width or height percentage in
Settings.
• The form layout can be asymmetric.
• In runtime mode, if a user doesn't have access to a form or if the form is missing,
then an adjacent object takes its space. In designer mode, all empty objects are
displayed so that the designer can choose to remove them.
9-3
Chapter 9
About the Gauge Chart Type
9-4
Chapter 9
About the Tile Chart Type
Note:
If a cell in the form is missing a value, no gauge is displayed for that cell.
Also, you must specify at least 2 consecutive thresholds. The application
needs the middle threshold value to calculate the chart.
Note:
Sometimes in a form, the first column may be collapsed (hidden) when
viewed as a grid. But the collapsed column is still considered when the
tile gets its values from the form.
• The tile’s title is the row’s title, and it gets its values from the first column, then by
row.
• You can set the tile’s title, the tile’s height percentage, legend, and can select
which axes from the form to include. For example, if you select a form with three
rows, the tile displays three values.
With a cell intersection as the data source for a tile, you can have only one tile per
object.
9-5
Chapter 9
About the Tile Chart Type
Tip:
To select a tile chart type, expand the list of chart types by clicking the link at
the bottom of the list.
Here are options you can set for a tile chart type. Note that you can set whether the
displayed value is horizontally aligned in the tile to the left, the center, or the right.
9-6
Chapter 9
Customizing Dashboard Colors
3. Clear the Default check box, and then click the down arrow for the Series you
want to change.
Check the chart in the background to see the data type that each series
represents.
4. Click the colors you want for the selected Series, and then click Close.
Note:
To select more shades of colors than the ones initially displayed, click
Custom Color....
Your selections apply only to the current chart. Follow these steps to change the colors
of other charts in the dashboard.
.
2. Click the Line Weight counter to set the line width.
You can see the effect of your setting on the chart in the background.
9-7
Chapter 9
About Global and Local POVs
Note:
The default width of lines in a Line and Combination chart type is 5
pixels. You can select from 1 to 12 pixels.
9-8
Chapter 9
About Global and Local POVs
With a global POV bar, if you change a page in the global POV bar and then click
GO, the page changes for all objects that are based on forms. The global POV bar
displays at the top of the dashboard above all the objects, while the local POV bar
displays within the object. User variables are supported in both global and local POVs
in dashboards.
In dashboard Settings, you can set whether to show or hide POVs and whether to
enable or disable global POV bars. (If you select Hide for POV Bars, and Enable for
Global POV Bar, the Hide option overrides the Enable option.) The global POV bar is
enabled by default; if you disable it, the complete POV is displayed for each local POV
as applicable.
About global POV bars:
• The POV Bar is made up of local POV dimensions, Page dimensions and user
variables.
• Depending on the local POV and page of each form on the dashboard, the global
POV bar is automatically calculated.
• They are reflected in the other objects using forms in that dashboard. That is, they
apply to forms in a dashboard, to charts that are linked to forms, and to tiles that
use forms as a data source. So if the dashboard doesn’t include a form as a data
source, then neither the local nor global POV bar is available.
Here's an example of how the global POV bar is calculated, based on the local POV
dimensions for two forms:
The global POV bar is disabled:
• Form A local POV: Year, Entity, Product
• Form B local POV: Year, Entity, Project
The global POV bar is enabled:
• Global POV bar: Year, Entity
• Form A local POV: Product
• Form B local POV: Project
Because not all dimensions and page selections may be common to all forms on a
dashboard, the complete POV for a dashboard object may get split between the local
and global POV bar. The global POV bar and the local POV together contain the
complete intersection information for each form on a dashboard.
If there is only one object on the dashboard that uses a form as a data source, then
the entire POV/page of the form can be moved to the global POV bar.
If there is more than one object on a dashboard that use forms as a data source, then
this is how the application determines which dimensions go in the global POV bar or
stay in the local POV:
• If the dimension is in the POV or page of all the forms, and the member selection
is the same in all the forms, the dimension goes in the global POV bar.
• If the dimension is in the POV on one form and in the page of another form, then
the dimension stays in the local POV.
• If the dimension is in the POV, then the same members must be selected in all the
forms for the dimension.
9-9
Chapter 9
Dashboard POVs and Valid Intersections
• If the dimension is a page dimension, then the selected page members must be
the same and display in the same order in all the forms.
The POVs in dashboards honor valid intersections by hiding invalid Page members.
See Dashboard POVs and Valid Intersections.
9-10
10
Working with Dimensions
Related Topics
• Dimensions Overview
• Viewing and Editing Dimensions
• Working with Dimension Hierarchies
• Adding Custom Dimensions
• Defining Accounts
• Defining Entity Members
• Creating Alternate Hierarchies
• Financial Consolidation and Close Data Model Overview
• Working with Members
• Setting Up Currencies
• Setting Up Scenarios
• Customizing Application Years
• Working with Attributes
• Working with Attribute Values
• Working with User-Defined Attributes (UDAs)
• Working with Member Formulas
• Working with Alias Tables
Dimensions Overview
Financial Consolidation and Close provides a set of consolidation and close features
that includes out-of-the-box translations, consolidation, eliminations and adjustments.
Depending on the functionality required for the application, the system enables only
the dimensions that are needed for the features.
By default, when you create an application, the system creates dimensions in this
order:
• Account
• Period
• Data Source
• Consolidation
• Currency (Only if Multi-currency is selected)
• Entity
• Intercompany (Only if Intercompany is selected during application creation)
10-1
Chapter 10
Dimensions Overview
• Movement
• Scenario
• Year
• View
• Multi-GAAP (Only if Multi-GAAP is selected during application creation)
The order of the dimensions has an impact on the performance of the consolidation.
Any change to the dimension order should first be carefully evaluated.
In addition to these dimensions, you can create custom dimensions. Add Custom
dimensions after the Intercompany dimension and before the Movement dimension.
You cannot make changes to the default properties of dimensions. The default
properties are used in seeded calculations. Each dimension is seeded with a set of
members. See Seeded Dimension Members.
The following sections describe the system-defined dimensions.
Watch the following video for information on dimensions:
Dimensions
Account
The Account dimension represents a hierarchy of natural accounts. Accounts store
financial data for entities and scenarios in an application. Each account has a type,
such as Revenue or Expense, that defines its accounting behavior. Every application
must include an Account dimension.
You define properties for Account dimension members, such as the Account type, the
number of decimal places to display, and whether the account is an Intercompany
Partner account. See Defining Accounts.
Period
The Period dimension represents time periods, such as quarters and months. It
contains time periods and frequencies by displaying the time periods in a hierarchy.
For example, if the Actual scenario maintains data on a monthly basis, 12 periods of
data are available for the year.
The system provides these options for the Period dimension:
• 12-months. If you select 12-months, you must then specify the first period of the
Fiscal Year. The default value is 12 months, with January as the beginning of the
Fiscal Year. If you use 12 months, all periods default to the calendar months with
period labels of January, February, March, and so on.
• 13-period. If you select 13-periods, all periods default to period labels P1, P2, P3,
and so on.
The system also creates Quarterly periods for both 12-month and 13-period options.
You can create Half-Yearly periods during application creation.
Depending on the fiscal year information, the system builds the Period hierarchy for
the application.
10-2
Chapter 10
Dimensions Overview
Data Source
The Data Source dimension is used to track the source of data, to determine whether
data is manually entered or loaded from a General Ledger, journal posting, or from
supplemental detail.
The system stores the different types of input in the Data Source dimension. It includes
journals input to provide a better audit trail when entity data is consolidated in the
consolidation path. You can view the separate data input journals input in both the
Proportion and Elimination members of the Consolidation dimension.
Watch this video to learn more about the Data Source dimension.
10-3
Chapter 10
Dimensions Overview
members. You can create Data Source members for journal entry, supplemental data
and data entry, and select Entity Currency or Input Currency for the new members.
Note:
The Currency dimension must be created prior to new members being added
to the Data Source dimension. See Setting Up Currencies.
You cannot remove any of the system-created members, or change the attrbutes for
seeded members under FCCS_TotalInputandAdjusted.
Note:
When you create a new member under FCCS_TotalInputandAdjusted, you
must assign these attributes to the member.
If there is no data or journal associated with the new member, then the attribute
selections can be modified. However, if data has been entered anywhere to a member,
or a journal has been created using a member, the attribute selections are read only.
10-4
Chapter 10
Dimensions Overview
If data is cleared from the application for that member or journals are deleted, then the
attributes can be modified.
Consolidation
The Consolidation dimension enables you to report on the details used to perform
the different stages of the consolidation process. It provides an audit trail of
the transactions applied to data during the consolidation process. It shows the
consolidation path for an entity reporting to its parent, from Entity Input to Contribution.
When you create an application, the system creates the Consolidation dimension with
the following hierarchy:
• Entity Input—This member represents input data and non-consolidation -related
business logic (for example, member formulas).
• Entity Consolidation—This is only available for a Parent entity. The amount in
this member represents the total of the Contribution from each of its child entities.
This is a system-calculated amount as a result of the consolidation process.
• Entity Elimination Adjustment— This is only available for a Parent entity. Entity
Elimination Adjustment entries are generated by the system if the aggregated
Entity Consolidation data requires adjustment. This could occur if the cumulative
consolidation % of a source level 0 entity increases due to the merging of shared
instances of the entity. Equity consolidations could then be required to change to
Proportional or Subsidiary at an intermediate parent entity.
• Translated Currency Input (optional) —This provides for data entry in an Input
Currency.
10-5
Chapter 10
Dimensions Overview
Note:
You cannot add members to this dimension except through the Enabling
Features option. After you add members, they cannot be removed.
The list of Consolidation dimension members is also dependent on
whether Advanced Consolidations are to be used by enabling Ownership
Management. If Advanced Consolidation is enabled, then an additional
child of Entity Total is created named Entity Elimination Adjustment. See
Managing Ownership.
10-6
Chapter 10
Dimensions Overview
Currency
Currencies store translated values for entities. Every application must include a
Currency. The Currency dimension must include a currency for each default currency
assigned to an entity in the Entity dimension.
When you create an application, the system creates the Currency dimension.
However, it is only displayed if the application is a Multi-currency application. See
Creating an Application.
You can create members in the Currency dimension for each currency needed in your
application. For each application, you specify a currency to use as the Application
Currency.
See Setting Up Currencies.
Entity
The Entity dimension stores the entity hierarchy and represents the organizational
structure of the company, such as the management and legal reporting structures.
Entities can represent divisions, subsidiaries, plants, regions, countries, legal entities,
business units, departments, or any organizational unit. You can define any number of
entities.
The Entity dimension is the consolidation dimension of the system. Hierarchies in the
Entity dimension reflect various consolidated views of the data. Various hierarchies
can correspond to geographic consolidation, legal consolidation, or consolidation
by activity. All relationships among individual member components that exist in an
organization are stored and maintained in this dimension. Entities in an organization
can be categorized as base, dependent, or parent entities. Base entities are at the
bottom of the organization structure and do not own other entities. Dependent entities
are owned by other entities in the organization. Parent entities contain one or more
dependents that report directly to them.
You define properties for Entity dimension members, such as the default currency,
and specify whether the entity allows adjustments and stores intercompany detail. See
Defining Entity Members.
Intercompany
The Intercompany dimension represents all intercompany balances that exist for
an account. It is used to store the Entity members for Intercompany transactions.
If you enable this option when you create an application, the system creates an
Intercompany dimension containing system members.
Note:
If you do not enable Intercompany Data when you configure features for the
application, the system does not create the Intercompany dimension. See
Creating an Application.
10-7
Chapter 10
Dimensions Overview
Entity dimension members have a member property called Intercompany that specifies
if the member should be included for intercompany transactions. If you select Yes
for this property, a member with the same name is created in the Intercompany
dimension.
When you create intercompany transactions, each group must have at least one
intercompany account and one plug account. A plug account is an account that, when
eliminations are completed, stores the difference between two intercompany accounts.
To set up an application for intercompany transactions, you must perform these
actions:
• When defining accounts, specify the accounts that perform intercompany
transactions and specify a plug account for each intercompany account
• When defining entities, specify the entities that perform intercompany transactions
By default, the system creates these Intercompany members:
• No Intercompany - This member is used in member intersections to store
information such as currency rates. It cannot be renamed or edited.
• Intercompany Entities - This member is the parent member under which all ICP
entities are created.
• Total Intercompany - This member is the top-most member in the hierarchy.
When an entity is enabled for Intercompany, the system automatically adds a new
member in the Intercompany dimension. You cannot manually add new members.
You cannot modify or delete Intercompany members.
Movement
The Movement dimension captures the movement details of an account. By default,
the system provides members in the Movement dimension to capture the Opening
Balance, Closing Balance, changes, and FX calculations.
See Seeded Dimension Members.
It is also used for Cash Flow Reporting. System members named
"FCCS_Mvmts_Operating", "FCCS_Mvmts_Investing", and "FCCS_Mvmts_Financing"
are created as parent accounts to enable you to create additional movement details as
needed for Cash Flow reporting.
The Movement dimension enables you to perform these tasks:
• View details of the cash flow movements when viewing the Balance Sheet
• Automatically generate the Cash Flow due to the segregation of movements
based on cash flow categories
When you create an application, the Movement dimension is created by default with
seeded members, and adds system members based on the optional features that
you enable. During application creation, the system creates cash flow members and
hierarchies for Cash Flow Reporting in the Movement and Account dimensions.
You can create your own Movement members, but only within the
FCCS_Mvmts_Subtotal parent, not within the FCCS_Mvmts_FX_Total parent.
Watch this video to learn more about setting up the Movement dimension.
10-8
Chapter 10
Dimensions Overview
Note:
As a best practice, it is not recommended that you create member formulas
for Movement dimension members, as they will have a significant impact on
consolidation performance.
10-9
Chapter 10
Dimensions Overview
amount (because as the Liability account movement entry aggregates up through the
account hierarchy, the Account Type changes from Liability to Asset and therefore the
sign of the data is flipped). You need to flip the sign of all non-cash movements when
presenting cash flow, regardless of the Account Type on which the original posting was
made.
Scenario
The Scenario dimension represents a set of data such as Actual, Budget, or
Forecast. For example, the Actual scenario can contain data that reflects current
business operations. The Budget scenario can contain data that reflects targeted
business operations. The Forecast scenario typically contains data that corresponds
to predictions for upcoming periods. A Legal scenario can contain data calculated
according to legal GAAP format and rules.
By default, the system creates the Actual system Scenario member. You can create
additional Scenario members.
See Setting Up Scenarios.
Year
The Year dimension represents the fiscal or calendar year for data.
When you create an application, you specify the range of years for the application.
The system builds the Year dimension based on the range that you specified. You
can increase the range of years after the application is created. However, you cannot
decrease the range. See Customizing Application Years.
View
The View dimension represents various modes of calendar intelligence such as
Periodic, Year-to-Date, and Quarter-to-Date frequencies. If you set the View to
Periodic, the values for each month are displayed. If you set the View to Year-to-Date
or Quarter-to-Date, the cumulative values for the year or quarter are displayed.
You load data into the system at the base-level view. Data is stored in the Periodic
member.
By default, when you create an application, the View dimension has these members:
• Periodic - Each period shows the data entered, calculated or derived for this
specific period.
• YTD - Year-to-Date view. Periods within a year are cumulative.
• QTD - Quarter-to-Date view. Periods within a quarter are cumulative.
• HYTD - Half-Year-to-Date view. Periods within a half-year are cumulative. HYTD is
only created it if you selected it during application creation.
You cannot remove any View dimension members or create new members. You can
edit member properties, such as Alias.
10-10
Chapter 10
Viewing and Editing Dimensions
Multi-GAAP
The Multi-GAAP dimension is an optional dimension that is used if you need to
report your financial statements in both local GAAP and in IFRS or other GAAP. This
dimension tracks the local GAAP data input as well as any GAAP adjustments.
If you select the Multi-GAAP dimension during application creation, you can select
from these additional options:
• Enter Adjustment—You can select this option to enter GAAP adjustments
manually. You enter data in the "FCCS_Local GAAP" member. Adjustments to
local GAAP for IFRS are entered in the "FCCS_Adjustments" member. The IFRS
amount will be calculated.
• Calculate Adjustment—Select this option to allow the system to automatically
calculate the adjustment amount based on the Local GAAP and IFRS amount
entered. You enter data in the "FCCS_Local GAAP" and "FCCS_IFRS" members.
The Adjustments amount will be calculated in the Adjustments member.
You can include additional members and hierarchies for other GAAP adjustments. You
can modify member aliases, but not member labels.
By default, if you select this dimension, the system provides the following dimension
members:
• FCCS_IFRS
• FCCS_Local GAAP
• FCCS_Adjustments
To specify Multi-GAAP reporting during application creation, see Creating an
Application.
10-11
Chapter 10
Working with Dimension Hierarchies
Note:
As a best practice, a limit of 20 levels of hierarchy depth is recommended.
10-12
Chapter 10
Working with Dimension Hierarchies
Sorting Members
You can sort members in ascending or descending order, by children or descendants.
Sorting members affects the outline.
To sort members:
10-13
Chapter 10
Working with Dimension Hierarchies
10-14
Chapter 10
Adding Custom Dimensions
7. Click Close.
Note:
If you are not using an Extended Dimension application, you can only create
a maximum of two Custom dimensions.
The Dimensions list displays all of the dimensions for the application. When you create
a dimension, the system adds it to the end of the Dimensions list.
When you add Custom dimensions, you define their properties, including name, alias,
security, and attributes.
Property Value
Dimension Enter a name that is unique across all
dimensions.
The Custom Dimension name cannot contain
these characters:
Ampersand (&), Apostrophe ('), Asterisk (*),
At sign (@), Backslash (\), Caret (^), Colon
(:), Comma (,), Curly brackets ({}), Dollar sign
($), Double quotation marks (" " Equal sign
(=), Exclamation mark (!), Forward slash (/),
Greater than (>), Less than (<), Line (|), Minus
sign (-), Number sign (#), Parentheses ( ),
Percent sign (%), Period (.), Plus sign (+),
Question mark (?), Semi-colon (;), Square
brackets ([]), or Tabs.
Alias Optional: Select an alias table. Enter a unique
alternate name for the dimension.
Description Optional: Enter a description.
Plan Type Select the application types for which the
dimension is valid. Clearing this option makes
all members of the dimension invalid for the
deselected type.
Apply Security Allow security to be set on the dimension
members; must be selected before assigning
access rights to dimension members.
Otherwise, dimensions have no security and
users can access members without restriction.
10-15
Chapter 10
Adding Custom Dimensions
Property Value
Data Storage Select a data storage option. The default is
Never Share.
Aggregation Options
You can define calculations within dimension hierarchies using aggregation options.
Aggregation options determine how child member values aggregate to parent
members:
• + Addition
• - Subtraction
• * Multiplication
• / Division
• % Percent
• ~ Ignore
• Never (do not aggregate, regardless of hierarchy)
Note:
For aggregation options for Intercompany Entities, see Aggregation Options
for Intercompany Entities.
All immediate children of the dimension name member must be set with an
aggregation option of Ignore or Never. Seeded dimension members should already
have the Consolidation Operator set as Ignore. Use the top dimension member rather
than the dimension name in forms and reports.
Children under a Parent member that has the Label Only data storage property must
have the aggregation operator set to Ignore.
Financial Consolidation and Close has a consolidation script that performs the
consolidation of one entity into another. Do not change the consolidation operator on
Entities. If this Entity property is anything other than Ignore, the results are incorrect.
You can change the Consolidation Operator for seeded members of the Account
dimension to customize them as needed. You can only change the members in the
Consol cube. Ensure that you run Metadata Validation after making the changes to
confirm that the changes are valid.
When you make changes to the seeded members, you cannot export or import them
using a dimension export CSV file. You must use the Module Customization Migration
artifact. Exporting and then importing CSV files will not retain your attribute changes
for seeded members.
10-16
Chapter 10
Adding Custom Dimensions
Note:
If you do not enable Intercompany Data, these options are not available.
10-17
Chapter 10
Adding Custom Dimensions
10-18
Chapter 10
Adding Custom Dimensions
10-19
Chapter 10
Adding Custom Dimensions
10-20
Chapter 10
Adding Custom Dimensions
Option Impact
Store Stores data values of members.
Dynamic Calc Calculates data values of members, and
disregards the values.
Never Share Ensures that stored parent members always
store data from the aggregation of child
members.
Shared Allows members in the same dimension to
share data values.
Label Only Displays the data of the first child member
regardless of the aggregation setting of the
children.
10-21
Chapter 10
Adding Custom Dimensions
10-22
Chapter 10
Adding Custom Dimensions
• Data Storage for children of label-only parents is set to Never Share by default.
Caution:
Do not design forms in which label-only parents follow their first child
member, as you cannot save data in the first child member. Instead,
create forms with label-only parents selected before their children, or do
not select label-only parents for forms.
Property Value
Dimension Enter a dimension name.
Description Optional: Enter a description.
Alias Optional: Select an alias table and enter an
alternate name of up to 80 characters.
Plan Type Select application types for which the
dimension is valid.
Apply Security Allow security to be set on dimension
members. If you do not select this option, there
is no security on the dimension, and users can
access its members without restriction. Must
be selected before assigning access rights to
dimension members.
Data Storage Select data storage options:
• Store
• Dynamic Calc
• Never Share
• Shared
• Label Only
See Data Storage Options.
Display Option Set application default display options for
the Member Selection dialog box. Select
Member Name or Alias to display members
or aliases. Member Name:Alias displays
members on the left and aliases on the right.
Alias:Member Name displays aliases on the
left and members on the right.
Enable custom attribute display Display available and selected attributes for
dimensions with associated attributes. Enable
custom attribute display for dimensions with
attributes.
10-23
Chapter 10
Defining Accounts
the Currency data type, and Product members are set to the Smart List data type, you
can set whether the Currency or Smart List data type prevails at an intersection.
To set the dimension evaluation order:
1. Select Application, then Overview, and then Dimensions.
Note:
CAUTION: To modify the dimension Evaluation Order, do not use the
Dimension Editor under the Navigator menu. You must modify the
Evaluation Order only from the Application Overview Dimensions tab.
In addition, the Service Administrator must always ensure that the
evaluation order for the Status Replacement Type dimension is set
to 2. This is required so that the seeded Data Status form displays
consolidation statuses.
2. Click the button on the Evaluation Order column next to a dimension to set the
order of precedence.
Defining Accounts
The Account dimension defines the chart of accounts for an application. When you
create an application, the system creates the Account dimension with a hierarchy
of system and seeded members, some based on the features that you enable for
the application. Seeded accounts are created with the prefix FCCS, for example,
FCCS_IncomeStatement.
Note:
You cannot change the member properties for most seeded members.
However, you can change the Account Type and Consolidation Operator
properties for seeded members of the Account dimension to customize them
as needed. You can only change the members in the Consol cube. Ensure
that you run Metadata Validation after making the changes to confirm that the
changes are valid.
When you make changes to the seeded members, you cannot export or
import them using a dimension export CSV file. You must use the Module
Customization Migration artifact. Exporting and then importing CSV files will
not retain your attribute changes for seeded members.
See Account Types and Aggregation Options.
10-24
Chapter 10
Defining Accounts
The structure of the Balance Sheet is created with Dynamic Calc parent members.
Two formats are available, the "Traditional" format (Assets = Liabilities + Owner’s
Equity) and the "Net Assets" format (Assets + Liabilities = Owner’s Equity).
It is recommended that the initial upper level structure of the Balance Sheet (down
to and including Total Assets, Total Liabilities and Total Equity) not be changed,
although lower level accounts can be re-organized. Other seeded artifacts (such
as seeded consolidation rules) rely on the basic Balance Sheet structure as
created by the system.
System Accounts
These accounts are provided by default when you create an application:
• FCCS_CSTATUS—Stores the calculation status value used by the system
• FCCS_CSTATUS FILTER—Stores the calculation status text for display in a data
form.
10-25
Chapter 10
Defining Accounts
Historical Accounts
The Historical Accounts group contains accounts that are considered Historical
Override accounts. Historical accounts are translated at a weighted average of the
movements over time rather than being translated at the current period ending rate.
Override accounts are designated as either a Rate Override or an Amount Override
for translation. Override accounts allow the user to enter either a Rate or an Amount
to override the default translation. These historical override accounts are created by
the system in the Historical Accounts grouping as shared members based on the
10-26
Chapter 10
Defining Accounts
Exchange Rate Type selected for the primary member. There might not be any seeded
Historical Override accounts depending on the application creation settings selected,
so there might initially only be "placeholder" accounts in this hierarchy. Placeholder
accounts are base members populated to ensure that the parent accounts are treated
as parent accounts and are not mistaken as base accounts. FCCS_Investment In Sub
is an example of an optional seeded Rate Override account.
If an account is a Historical Account, but does not contain an Override (for example,
FCCS_Retained Earnings Prior), it is not included in the Historical Accounts hierarchy.
To specify that an account is a Historical Override Account, you must assign the
"Historical Rate Override" or "Historical Amount Override" as the Exchange Rate Type.
If an Amount Override or a Rate Override is specified for the Historical account, the
system uses the applicable override entry for the account during translation. If you
do not enter an override rate or amount, the Historical Override account is translated
using the rate specified for default translations. This gives the same translated results
as for Historical (non-override) accounts.
A pre-built system form named Override Rates is generated from the Historical
account hierarchy to enable you to enter either the override amount or override rate for
each entity for each currency. See Predefined Forms.
Ratio Accounts
Ratio accounts are created under a separate account hierarchy if this option
is enabled during application creation. All associated member formulas for the
calculations are also created for the accounts. Additionally, you can create your own
ratio accounts.
Intercompany Account
For any Intercompany accounts that will be used for standard system eliminations,
you must assign attribute values to identify them as Intercompany accounts, as well
as selecting the Plug account to be used for elimination. The accounts that are to be
selected as Plug accounts must first be designated as Plug accounts by selecting the
Plug accounts attribute.
You can add additional hierarchies in the Account dimension to include shared
Balance Sheet accounts or any additional accounts required. For example, the seeded
Balance Sheet Cash and NonCash hierarchy is an additional hierarchy containing
shared copies of the Balance Sheet accounts.
Note:
As a best practice, a limit of 20 levels of hierarchy depth is recommended.
All additional hierarchies of the Balance Sheet that you create should be created after
FCCS_Total Balance Sheet - Cash and NonCash.
10-27
Chapter 10
Defining Accounts
All alternate hierarchies of Income accounts can be placed in the Income Statement
grouping.
Account Types
Each account is associated with an Account Type that represents the accounting
nature of the account.
Each account is categorized as either Flow or Balance. Flow Account types
accumulate over time. Balance Account types represent a balance at a specific period
and therefore do not aggregate over time.
• Flow account types: Revenue, Expense
• Balance account types: Asset, Liability, Equity
You can change the Account Type for seeded members of the Account dimension to
customize them as needed. You can only change the members in the Consol cube.
Ensure that you run Metadata Validation after making the changes to confirm that the
changes are valid.
When you make changes to the seeded members, you cannot export or import them
using a dimension export CSV file. You must use the Module Customization Migration
artifact. Exporting and then importing CSV files will not retain your attribute changes
for seeded members.
10-28
Chapter 10
Defining Accounts
Account Type Time Balance for Time Balance for Variance Reporting
accounts inside accounts outside
Balance Sheet of Balance Sheet
hierarchy hierarchy
Revenue Flow User-defined Non-Expense
Expense Flow User-defined Expense
Asset Flow User-defined Non-Expense
Liability Flow User-defined Non-Expense
Equity Flow User-defined Non-Expense
Saved Assumption Flow User-defined User-defined
Note that the Opening Balance movement of Flow accounts is calculated as the
Closing Balance of the prior periods. Closing Balance is an aggregation of Opening
Balance and all movement amounts for the period. No Opening Balance is calculated
for Balance accounts.
10-29
Chapter 10
Defining Accounts
Note:
Financial Consolidation and Close has a consolidation script that performs
the consolidation of one entity into another. Do not change the Consolidation
Operator on Entities. If this Entity property is anything other than Ignore, the
results will be incorrect.
The following table indicates how each Account Type behaves when totalled into
a specific type of parent account within the balanced Balance Sheet hierarchy. For
example, when aggregated, Asset account values are aggregated into parent Asset
and Expense accounts, and subtracted from parent Liability and Revenue accounts.
Table 10-8 Required Aggregation (Consol Operator) between Child and Parent Accounts
Note that Saved Assumption accounts should not be used within the balanced
Balance Sheet because they are non-financial accounts. Saved Assumption accounts
can be added or subtracted when aggregating to their parent accounts as required.
This example illustrates how different account types are aggregated into parent
accounts:
In this example, Total Assets is an Asset account and the parent of Fixed Assets
(an Asset account) and Amortization (a Liability account). When the accounts are
aggregated into the parent account, the Fixed Assets value of 100 is added, the
Amortization value of 20 is subtracted, and the resulting value for Total Assets is 80.
Changing the default Account Type and Consol Operator Settings
The default configuration of Financial Consolidation and Close assumes that for
Assets and Expenses, a positive value represents a DR and a negative value
represents a CR. For Revenue, Liabilities and Equity, a positive value represents a
CR and a negative value represents a DR. This is the "normal sign" of the account.
The system uses the combination of Account Type and Consol Operator in many of
the system calculations to ensure correct aggregation for different client configuration
requirements. The posting of journals (assigning DR and CR entries to a positive or
10-30
Chapter 10
Defining Accounts
negative value) also relies on the Account Type entry. Table 10-8 displays the default
settings applied to seeded accounts.
In order to load data where a positive value is always a DR and a negative
value is always a CR regardless of account (for example, a G/L extract), you will
need to change both the Account Type and the Consol Operator. So change all
"Revenue" accounts to Account Type "Expense" and change all "Liability" and "Equity"
accounts to Account Type "Asset". Then change all Consol Operators to "Addition."
For consistency, you should also change the parent accounts including the seeded
members. Then run Validate Metadata again to verify that all settings are consistent
and that system calculations will not be compromised.
Saved Assumptions
You use saved assumptions to identify key non-financial business drivers and ensure
application consistency, by selecting time balance and variance reporting properties.
• Variance reporting determines the variance between budgeted and actual data, as
an expense or non-expense.
• Time balance determines the ending value for summary time periods.
Examples of how time balance and variance reporting properties are used with saved
assumption account members:
• Create a saved assumption of an expense type for variance reporting, assuming
that the actual number of employees is less than the number budgeted. To
determine the variance, the system subtracts the actual amount from the budgeted
amount.
• Make an assumption about the number of units sold at the end of the time period.
Determine the final quantity for the summary time period by aggregating the
number of units sold across time periods.
10-31
Chapter 10
Defining Accounts
Property Description
Name Enter a name that is unique across all
dimension members.
Description Optional: Enter a description.
10-32
Chapter 10
Defining Accounts
Property Description
Alias Table Optional: Select the alias table to store the
alias name.
Alias Optional: Enter an alternate name for the
member.
Account Type Select the account type:
• Expense
• Revenue
• Asset
• Liability
• Equity
• Saved Assumption
See Account Types.
Variance Reporting Select an option:
• Expense
• Non-Expense
See Account Types and Variance Reporting.
Time Balance Specify how the system calculates the value of
summary time periods:
See Time Balance Property.
Exchange Rate Type Indicates the translation options for the
financial accounts.
• Historical
• Historical Amount Override
• Historical Rate Override
• No Rate (for non-historical accounts)
By default, the system uses Average Rate
for Flow accounts, and Ending Rate for
Balance accounts. The default settings can be
changed.
Source Cube Specify the source cube for the member.
Data Storage Select data storage options:
• Store
• Dynamic Calc
• Never Share
• Shared
• Label Only
See Data Storage Options.
Two Pass Calculation Select whether to calculate values of members
based on values of parent members or other
members.
Allow Upper-Level Entity Input Specify whether parent Entity input is allowed
for this account.
When you create a Local Rate account
and refresh the database, this attribute is
automatically enabled so that you can enter
Local Rate data for a base or a Parent entity
on the seeded Local Exchange Rate form.
10-33
Chapter 10
Defining Accounts
Property Description
Plan Type Indicates the application type for which the
member is valid.
Data Type Select a data type:
• Unspecified
• Currency
• NonCurrency
• Percentage
• Date
• Text
• Smart Lists
See Data Types and Exchange Rate Types.
Smart Lists Optional: Select a Smart List to associate with
the member.
Enable for Dynamic Children Enables users to create children for this
member by entering a member name in
the runtime prompt for a business rule that
has been configured with a dynamic parent
member).
Number of Possible Dynamic Children This option is available if Enable for Dynamic
Children is selected. Enter the maximum
number of dynamically-added members that
users can create. The default is 10.
Access Granted to Member Creator This option is available if Enable for Dynamic
Children is selected. Determines the access
that member creators have to dynamic
members that they create with a runtime
prompt:
• Inherit—The member creator will inherit
the closest parent's access to the newly-
created member.
• None—The member creator will not be
assigned any access to the newly-created
member. (An administrator can later
assign the member creator access to the
members.)
• Read—The member creator will be
assigned Read access to the newly-
created member.
• Write—The member creator will be
assigned Write access to the newly-
created member.
If an administrator changes these settings,
they affect only future dynamic members; they
do not retroactively affect dynamic members.
10-34
Chapter 10
Defining Accounts
Attribute Description
Intercompany Account Specify if the account is an Intercompany
account. If set to Yes, a level 0 Plug account
must also be specified for this account in
order for eliminations to be executed.
Note: This option is only available if
Intercompany is enabled for the application.
Is Plug Account Specify if this level 0 account can be a Plug
account.
Plug Account For the accounts that have Intercompany set
to Yes, and IsPlugAccount is not set, you
can specify a Plug account. Accounts with
this property set to Yes can be selected as
Plug Accounts.
3. Click Save.
4. To add a Plug account:
a. Select the Account dimension member and select the Custom Attributes
button.
b. Select the attribute Plug Account and click the Synchronize button.
The newly added Plug account will be displayed in the list of Plug Accounts on
the right side of the Plug Account Attribute Values tree.
10-35
Chapter 10
Defining Entity Members
Attribute Description
Is CICTA Account Specify if this account is a replacement for the
seeded FCCS_CICTA account.
CICTA Redirection Account To redirect the FX-To-CICTA posting to an
account other than the seeded FCCS_CICTA
account, specify the account to use. Available
accounts will have the "Is CICTA Account"
setting (above) enabled.
10-36
Chapter 10
Defining Entity Members
The system also creates the Total Geography member by default. This member is
used for system forms. You can create new members as siblings to Total Geography,
and you can create a hierarchy under it. You then need to change the Entity member
selector in the forms appropriately.
Shared entities must be entities that are also Intercompany Partners. If you share a
parent of an entity that is an Intercompany Partner, eliminations will not occur.
You define attributes for Entity dimension members, such as the default currency.
By default, the Consolidation Operator for the Entity dimension is Ignore. A seeded
consolidation script performs the consolidation of one entity into another. If the
Consolidation Operator property is anything other than Ignore, the results are
incorrect. See Aggregation (Consolidation Operator).
To define Entity properties, see Adding or Editing Members.
Note:
You define Entity properties in the same way as other dimensions. However,
for Entity names, you cannot include a combination of the period (.) and
square bracket ( [ ) characters. This combination of characters is reserved by
the system to denote a parent entity. For example:
EN_CONS4040.[CONS4040] EN_4040_TI.[CONS4050]
You can use either the period (.) or square bracket ( ]) individually, but not
combined consecutively in an Entity member name.
Base Currency
For a multicurrency application, specify each entity member’s base currency. The
default base currency for entity members is the currency specified when creating the
application. For example, if U.S. Dollars is the default currency, you may specify Yen
as the base currency for the Japan entity and U.S. Dollars for the United States entity.
When you use forms that have values for the Japan entity, if the display currency
is set to U.S. Dollars, values are converted to U.S. Dollars using the rates in the
exchange rate table (assuming Yen is the local currency and U.S. Dollars is the
reporting currency).
10-37
Chapter 10
Creating Alternate Hierarchies
In this example:
• Entity E111 is a child of both P11 and P12.
• Input data that is entered for E111 at either P11 or P12 is replicated to the
other entity after Save. You can enter the data at any of P11.E111 and P12.E111
members.
• After consolidation, the calculated values at P11.E111 and P12.E111 can be
different. For example, suppose the application is a multi-currency application,
where the currency of E111 is GBP. P11 currency is USD and P12 currency is
EUR. When entering data to E111, data is always entered in the entity currency
member of the Currency dimension. The parent currency member is calculated
and the values for Parent currency for P11.E111 and P12.E111 will be different, as
the exchange rates between GBP and USD, and GBP and EUR can be different.
You can also create an entity hierarchy where a parent level entity has more than one
parent. However, a hierarchy where the parent level has multiple parents that have
different children is not supported.
You build an alternate hierarchy by creating partial share Entity members, and
selecting "Shared" as the Data Storage member property. See Creating Shared
Members.
You can use shared hierarchies to meet your reporting needs, however, the number
of shared hierarchies affects performance, as they increase the database size and
consolidation times.
As a best practice:
• The top member of alternate hierarchies must have the Consol operator set as
Ignore, to avoid duplicate values.
10-38
Chapter 10
Financial Consolidation and Close Data Model Overview
10-39
Chapter 10
Financial Consolidation and Close Data Model Overview
As a result, base members of Net Income (or Owner's Income) have no Opening
Balance.
• All periods — Total Other Comprehensive Income / Closing Balance / Prior Period
is carried forward to FCCS_OR_OBFXCICTA / Opening Balance for Revenue and
Expense type accounts.
As a result, base Revenue/Expense members of Total Other Comprehensive
Income have no Opening Balance (other Asset / Liability / Equity accounts do
have a Closing Balance to Opening Balance carry forward on an account-by-
account basis).
So within the total Other Comprehensive Income hierarchy, accounts can be added
using the appropriate account type setting, based on how you expect the account to
be treated in terms of Closing Balance to Opening Balance carry forward. Revenue
and Expense will carry forward to one single account (FCCS_OR_OBFXCICTA), while
the remaining accounts will carry forward account-by-account. If Asset / Liability /
Equity are used, and parent / subtotal accounts are created in the hierarchy to provide
groupings (creating a "matrix" of data across the Account/Movement dimensions), then
a combination of the Account and the Movement member can provide any variation of
reporting that is required.
Movement members:
• FCCS_TotalOpeningBalance — provides the opening balance (including any prior
period adjustments posted in the current period)
• FCCS_Mvmts_Total — provides the changes for the current reporting period
(including the net effect of the FX calculations)
• FCCS_ClosingBalance — provides the "life-to-date" balances for all accounts that
have their own opening balance
FX Opening and FX Movements are calculated on all accounts (but written
to the OBFXCTA / OBFXCICTA for Revenue Expense accounts within the Net
Income / Total Comprehensive Income hierarchies). For any account flagged as
"historical" (Historical, Historical Rate Override, Historical Amount Override), the FX
is calculated but is then transferred to the Cumulative Translation Adjustment (CTA)
or Comprehensive Income Cumulative Translation Adjustment (CICTA) account. Note
that Revenue and Expense accounts within the Net Income / Total Comprehensive
Income hierarchies are assumed to be Historical accounts, translated at Average Rate,
and with any FX variation calculations transferred to CTA/CICTA. These metadata
Rate Type entry on these accounts is ignored and can be left as the default "No rate"
entry.
These FX calculations can be viewed by displaying the relevant movements:
• FCCS_Mvmts_FX_Opening
• FCCS_Mvmts_FX_Movement
• FCCS_Mvmts_FX_to_CTA
• FCCS_Mvmts_FX_to_CICTA
Closing Balance for all non-historical accounts will be brought to an Ending Rate
translation by the FX Opening and FX Movements calculations. Closing Balance of
all historical accounts at a translated currency will be a weighted average of the
periodic movements translated at Average Rate on a period-by-period basis. The FX
Opening and FX Movement are calculated on these accounts (to ensure that the
B/S still balances) but is then transferred to the CTA/CICTA account. The total of the
10-40
Chapter 10
Working with Members
FX-to-CTA/FX-to-CICTA system entries across the entire B/S (that is, viewed at the top
B/S account) must equal zero.
For reporting, Financial Reporting is a very powerful tool, and with a combination of
Account and Movement in the rows, any of the data points in the "matrix" of data
can be retrieved as required. The Movement dimension can be hidden from view for
presentation and if necessary, either direct over-typing or the use of "memo" (Label
Only) accounts can be used to provide alternative descriptions.
10-41
Chapter 10
Working with Members
If you want to add an Other Operating Income account, you can place it between the
two seeded members.
10-42
Chapter 10
Working with Members
• Multiple alternative hierarchies can be created for differing reporting needs. These
alternative hierarchies should include all base members in the primary hierarchy,
but can otherwise be organized differently.
• Be aware that various system and seeded calculations will be lost if the seeded
account hierarchy is ignored. Many calculations have been incorporated into the
system that rely on the account structure. As a minimum, the following calculations
rely on, and are applied to the seeded account members:
– Year-end transfer of prior period Retained Earnings Closing Balance to
Retained Earnings Prior Opening Balance
– Period end transfer of P&L Closing Balance to FCCS_REC_OBFXCTA
Opening Balance
– Period end transfer of Other Comprehensive Income (Revenue / Expense) to
FCCS_OR_OBFXCICTA
– Balance the Balance Sheet (can be disabled)
– Foreign Exchange (FX) transfer to Cumulative Translation Adjustment (CTA)
or Comprehensive Income Cumulative Translation Adjustment (CICTA)
– Seeded consolidation rules (can be un-deployed / disabled)
Note:
You should ensure that all base accounts are included in the seeded account
structure, whether that structure is used for reporting or not.
If you know that changing the account structures of dimensions with dynamic calc
parents will result in unwanted changes to the historical data, then you should not
change the structures. If however, you want to change the aggregation/calculation
to reflect the new hierarchies, then you should unlock the entities, reconsolidate,
and re-lock. If you want history to remain as it is, but use new aggregation/
calculations for future data, then you should create alternative hierarchies to provide
for both variations, change their rules if necessary (to make them time-specific) and
reconsolidate wherever applicable.
Watch the following tutorial for more information about modifying attributes for seeded
accounts.
10-43
Chapter 10
Working with Members
10-44
Chapter 10
Working with Members
10-45
Chapter 10
Working with Members
10-46
Chapter 10
Working with Members
Balance Sheet Accounts with Intercompany Data with Tracking and Ownership
Management Enabled
If you enable the Intercompany Data with Tracking option, additional options such as
Ownership Management are then available. If you enable Ownership Management,
the system adds the Ownership Management accounts and adds the CTA/CICTA
accounts if not already added, then adds the Driver accounts.
10-47
Chapter 10
Working with Members
10-48
Chapter 10
Working with Members
Note that two base (level 0) movements are created in addition to the Opening
Balance hierarchy. You can add any additional base movements as required.
Movement Members with Multi-Currency Enabled
If you enable the Multi-Currency option, the system adds the foreign exchange related
members.
10-49
Chapter 10
Working with Members
10-50
Chapter 10
Working with Members
10-51
Chapter 10
Working with Members
the total CTA adjustments. Calculation logic is included in the consolidation script for
the re-direction of the FX from the source historical accounts to the CTA account.
With one CTA account, all FX-CTA calculation results are accumulated to the single
CTA account. The CTA account is part of Owner's Equity on the Balance Sheet for
US-GAAP reporting purposes.
Comprehensive Income Cumulative Translation Adjustment (CICTA) Account
You can select to capture CTA adjustments in a single Comprehensive Income
CTA account (CICTA) as part of the Statement for Comprehensive Income for IFRS
reporting purposes. This account aggregates to the balance sheet Other Reserves
account.
You may want to report historical FX adjustments in a different account and in a
different section of the financial statements. This could be an account that is presented
as part of the Income Statement, and aggregates to Net Income and then to Retained
Earnings - Current. The seeded FCCS_CICTA account includes an optional CICTA
Redirection Account setting. By default, if CICTA is the selected method, then the
FX calculation from historical accounts is written to the FCCS_CICTA account. If you
select a different destination account by entering this account in the CICTA Redirection
Account attribute of FCCS_CICTA, then the destination for the FX to CICTA rule will be
the specified account. See Setting Account Attribute Values.
During application creation, both the FCCS_CTA and FCCS_CICTA accounts are
created. When you enable application features, you must specify which account to
use.
Note:
By default, the CTA (Balance Sheet) option is selected. If you change this
option to Comprehensive Income, you must run consolidation to move the
data to the CICTA account.
10-52
Chapter 10
Working with Members
The system applies the Opening Balance Carry Forward to all Level 0 accounts with a
time balance property of Flow, with these exceptions:
• All accounts that are Level 0 of Retained Earnings Total: OB Carry Forward are
re-directed to Retained Earnings Prior in the first period of the year only.
• All accounts that are Level 0 of the siblings of FCCS_REC_OBFXCTA: OB Carry
Forward are re-directed to FCCS_REC_OBFXCTA in all periods except the first
period of the year.
• Revenue and Expense type accounts that are Level 0 siblings or Level 0
descendants of the siblings of FCCS_OR_OBFXCTA: OB Carry Forward are re-
directed to FCCS_OR_OBFXCICTA in all periods.
For FX Variance calculations (FX Opening, FX Movements), the system applies the
Opening Balance Carry Forward to all Level 0 Flow type accounts, except Saved
Assumption accounts which are not translated.
For CTA calculations:
• Transferring FX Variance out of the individual accounts: OBCF is applied to all
Historical, Historical Amount Override and Historical Rate Override accounts.
• Transferring FX Variance into CTA or CICTA accounts: OBCF is applied to
all Historical, Historical Amount Override and Historical Rate Override accounts
within the balanced Balance Sheet hierarchy (that is, within Total Balance Sheet-
Traditional, Total Balance Sheet-Net Assets or the Basic version).
Built-in Calculations
• Opening Balance
10-53
Chapter 10
Working with Members
Opening balance is calculated from the prior period's Closing Balance. Opening
Balance of First Period of the year is retrieved from the Last Period of the Prior
Year's Closing Balance.
The Opening Balance Adjustment is translated at the same effective rate as the
Closing Balance from which the Opening Balance is carried forward. The Closing
Balance for Historical accounts is effectively a weighted average of the rates
applied to all of the past movements.
The Effective Rate equals the Entity Currency Closing Balance from the prior
period divided by the Parent Currency Closing Balance from the prior period. Note
that this effective rate must be calculated on an account-by-account basis because
the ratios will differ.
This translation applies to all Historical accounts and to any Historical Rate
Override accounts for which an override rate has not been entered, and to any
Historical Amount Override accounts for which an override amount has not been
entered.
The method of the translation calculation is based on the method set as the
Default Translation settings for the Flow type (either Flow or Balance). The method
is either Periodic or Year-to-Date. If the default translation method is Periodic,
the translation calculation applies the Periodic entity currency amount against the
effective rate and writes to the Periodic translated cell. If the default translation
method is Year-to-Date, the translation applies the Year-to-Date entity currency
amount against the effective rate, then subtracts the Year-to-Date translated
amount of the prior period and writes the result to the Periodic translated cell.
The prior period from which the effective rate is calculated also takes into account
any Opening Balance Carry Forward overrides. If the Opening Balance for the
current year Budget scenario is carried forward from the Actual scenario, then the
effective rate is calculated from the Actual scenario.
The translation of Opening Balance Adjustments based on the calculated effective
rate requires that Entity currency and Parent currency Closing Balance data exists
in the prior period. If Entity currency and Parent currency Closing Balance data
does not exist in the prior period, then the Ending Rate for the prior period is used.
If neither Closing Balance data nor Ending Rate data exists, then no translation is
carried out.
For Historical Rate Override or Historical Amount Override accounts, if an override
has been entered, the override rate is used before reverting to the effective rate,
then Ending rate and then no translation.
Due to the cumulative nature of some translation calculations, it is recommended
that any translation to a Reporting Currency that is neither an entity's Entity
currency or Parent currency be executed from the first period of the year.
• Opening Balance for Periodic View
For the First period of the year, Opening (translated) = Closing (translated) of Last
period of Prior year.
For any subsequent periods, Opening (translated) = Closing (translated) of Prior
period of current year.
• Opening Balance for YTD View
Opening (translated) = Closing (translated) of Last period of Prior Year.
Total Opening (translated) = Closing (translated) of Last period of Prior Year plus
year-to-date current year Opening Balance Adjustments.
10-54
Chapter 10
Working with Members
Note:
Do not perform FX calculations on Net Income Level 0 members.
• Historical Accounts
If an override amount or override rate is entered for a historical account, the
override entry is applied to the translation. Otherwise, the account is translated
using the application default method and rate.
• FCCS_Days Sales In Receivables and FCCS_Days Sales In Inventory
The following table shows where data is stored for FCCS_Days Sales In
Receivables and FCCS_Days Sales In Inventory. Both of these seeded
calculations are calculated at the following POV. Note that the table has the POV
10-55
Chapter 10
Working with Members
of Calculations. The other column shows options for reporting. Intercompany and
Custom dimensions must be displayed at the "No" members.
Property Value
Name Enter a name that is unique across all
dimension members.
Description Optional: Enter a description.
Alias Table Optional: Select the alias table to store the
alias name.
10-56
Chapter 10
Working with Members
Property Value
Alias Optional: Enter an alternate name for the
member.
For Entity members only: Base Currency Select the base currency for the Entity
member.
Data Storage Select a data storage property. The default
is Never Share for new custom dimension
members (except root members).
• Store
• Dynamic Calc
• Never Share
• Shared
• Label Only
Two Pass Calculation Specify whether to recalculate values of
members based on values of parent members
or other members. Available for Account and
Entity members with Dynamic Calc properties.
Allow Upper-Level Entity Input Specify whether parent Entity input is allowed
for this member.
When you create a Local Rate account
and refresh the database, this attribute is
automatically enabled so that you can enter
Local Rate data for a base or a Parent entity
on the seeded Local Exchange Rate form.
Plan Type Select the application type for which the
member is valid.
Data Type Select a data type:
• Unspecified
• Currency
• NonCurrency
• Percentage
• Date
• Text
• Smart Lists
See Data Types and Exchange Rate Types.
Smart Lists Optional: Select a Smart List to associate with
the member.
Enable for Dynamic Children Enables users to create children for this
member by entering a member name in
the runtime prompt for a business rule that
has been configured with a dynamic parent
member).
Number of Possible Dynamic Children This option is available if Enable for Dynamic
Children is selected. Enter the maximum
number of dynamically-added members that
users can create. The default is 10.
10-57
Chapter 10
Working with Members
Property Value
Access Granted to Member Creator This option is available if Enable for Dynamic
Children is selected. Determines the access
that member creators have to dynamic
members that they create with a runtime
prompt:
• Inherit—The member creator will inherit
the closest parent's access to the newly-
created member.
• None—The member creator will not be
assigned any access to the newly-created
member. (An administrator can later
assign the member creator access to the
members.)
• Read—The member creator will be
assigned Read access to the newly-
created member.
• Write—The member creator will be
assigned Write access to the newly-
created member.
If an administrator changes these settings,
they affect only future dynamic members; they
do not retroactively affect dynamic members.
10-58
Chapter 10
Working with Members
• To ensure that your metadata is valid, you can run the Metadata Validation
report at any time. See Metadata Validation Messages.
Deleting Members
Each data value is identified by a set of dimension member values and an application
type. Deleting dimension members or deselecting the application type results in data
loss when refreshing an application.
Caution:
Before starting this procedure, perform a backup. See the Oracle Enterprise
Performance Management System Backup and Recovery Guide .
Before deleting members, understand where in the application they are used (in which
forms, exchange rates, and so on) by using Show Usage.
To prevent a referential integrity problem with journals from occurring in the
application, Financial Consolidation and Close verifies and prevents the deletion of
any metadata member that is referenced in a journal. See Journal Referential Integrity.
You must delete the entity member throughout the application before deleting it from
Dimensions. For example, if the entity member is used in a form, you must delete it
from the form before deleting it from Dimensions.
To delete members:
Making Selections
Only members, substitution variables, and attributes to which you have access are
displayed. The Selections pane only displays if you invoke the member selector for
multiple member selection.
To make selections:
1. Click
.
2. Optional: Perform these tasks:
10-59
Chapter 10
Working with Members
• To enter search criteria (member name or alias only), press Enter (from the
desktop) or click Search (on mobile).
The search isn't case-sensitive. You can search for a word, multiple words, or
wildcard characters.
• To change display options such as viewing variables and attributes, showing
alias names, showing member counts, sorting alphabetically, refreshing the
member list, or clearing selections, click next to Search, and then select
from the list of display options.
• To filter the members that are displayed in the member list, under next to
Search, select Add Filter, and then select from the list of filter options.
3. Make selections by clicking a member in the member list.
To understand how related members are selected, see Member Relationships.
Selected members display a check mark and are moved to the Selections pane, if
applicable.
To expand a parent member to see its child members, click the expansion icon to
the right of the parent member name. Clicking the expansion icon will not select
the parent member.
To clear selections you have made, click and then select Clear Selection.
At times, you may find that a point of view and page axis member you want to
select is suppressed. This occurs because a dimension selection in the point of
view and page axis has invalidated other dimensions due to valid intersections
that were applied. To resolve this issue, use the Clear Selection option to clear
the Point of View and page axis members you previously selected. Then you can
use the Point of View and page axis again to select members that were previously
suppressed.
To show all the members that are suppressed due to valid intersection rules,
click and then select Show Invalid Members. Invalid members are displayed
but are unavailable for selection.
4. Optional: Perform these tasks:
• To further refine which related members are selected in the Selections pane,
click to the right of the member.
• If substitution variables or attributes are defined, below the member selection
area, click next to Members, and then select Substitution Variables or
Attributes to select members for substitution variables or attributes. Members
are displayed as children. Only members to which the user has read access
are displayed in forms.
10-60
Chapter 10
Working with Members
member name in the Selections pane, and then tap Locate under next
to Selections.
5. When you're done making selections, click OK.
Member Relationships
This table describes which members and related members are included during
member selection.
10-61
Chapter 10
Working with Members
Caution:
Before starting this procedure, perform a backup. See the Oracle Enterprise
Performance Management System Backup and Recovery Guide .
To delete a parent member and all its descendants from the dimension hierarchy:
10-62
Chapter 10
Working with Members
Note:
Primary members must exist before shared members ("above" the shared
member in the hierarchy) for the following dimensions: Scenario, Account,
Intercompany, Movement, Data Source, Multi-GAAP (if it exists), and
user-created Custom dimensions. The Entity dimension can have shared
members prior to primary members.
The Period dimension does not support alternate hierarchies.
Shared members share some property definitions with primary members, such
as member name, alias name, base currency, and application types for which
members are valid. Shared members must have unique parent members and different
rollup aggregation settings. Custom attributes, custom attribute values, and member
formulas are not allowed for shared members. Renaming primary members renames
all shared members.
Shared members cannot be moved to another parent member. You must delete
shared members and recreate them under different parent members.
You cannot share a parent member in Custom dimensions.
Shared members must be at the lowest level (level zero) in the hierarchy and cannot
have children. The primary member need not be level zero. You can enter data in
shared members, and values are stored with primary members.
Shared members are displayed similarly to primary members in the dimension
hierarchy for member selection in Oracle Smart View for Office.
See Creating Shared Members.
Note:
Period dimension members cannot have shared members.
You should not create shared members for the FCCS_No Data Source
member.
Shared members must be added after the non-shared member. For example, in the
following Account dimension, Cash and Cash Equivalents are under FCCS_Current
Assets as a non-shared member, and under FCCS_Total Cash as a shared member.
10-63
Chapter 10
Setting Up Currencies
Note that the non-shared member is first in the hierarchy and the shared member is
second.
Setting Up Currencies
Input Currencies
The Input currencies include the application currency and any currencies enabled for
the application. These currencies are used to assign as valid functional currencies for
the Entity and to enter exchange rates against.
When you create a currency for the application, the system provides a list of standard
ISO currency codes for selection. By default, the system creates Input currencies such
as USD, EUR, GBP, and so on. You should only enable the currencies that you need
for your application.
When you add a new currency to the Currency dimension, a new member is
automatically created under From Currency. The alias for the Default Alias table for
the new member must be set as the alias for the currency. If an alias is not defined, it
must be set as the name of the added currency.
For example, when a currency named GBP is added to the Currency dimension,
a new member called From_GBP is automatically created in the From Currency
dimension. If an alias is defined for GBP, the same alias must be set to From_GBP
also. If an alias is not defined for GBP, it must be set as GBP for From_GBP.
If the alias of a Currency member changes, the alias of the associated From Currency
member must also be changed to the new alias.
If a Currency member is removed, the associated From_Currency member must be
removed.
Reporting Currencies
A Reporting currency is the currency in which your company prepares financial
statements. When you create a currency for the application, you can enable it for
reporting purposes. You can also disable a currency as a Reporting currency.
The system supports currency conversion from local currencies to one or more
Reporting currencies. Converted Reporting currency values are stored and read-only
for all users. An application’s default currency is the default Reporting currency.
10-64
Chapter 10
Setting Up Currencies
Only Reporting currencies are available for translation in the application. All Reporting
currencies have a suffix of _Reporting, for example, USD_Reporting.
See Translation Process.
Each application is limited to 180 currencies, and each currency that is selected as a
Reporting currency counts as two currencies (Input currency and Reporting currency).
A Reporting currency has two mandatory members:
• Entity Currency—Used for data entry, when you manually enter data or load
data into the application. If your entity's functional currency is USD, and you
enter data for the Entity Currency member, when you want to report using the
Reporting currency member USD for the entity, you must perform a translation
to USD_Reporting, because there is no data stored in USD_Reporting until
translation occurs.
• Parent Currency—Used to store the translated data as related to its parent. It is
generated after consolidation and is a read-only member.
Reporting currency members are dynamic calculation members where the translation
occurs dynamically when the data is retrieved. The values are never stored for
Reporting currency members. The system only stores the Entity Currency and Parent
Currency values.
Note:
You cannot edit or delete the Entity Currency and Parent Currency members.
You can only specify an Alias.
10-65
Chapter 10
Setting Up Currencies
• Currency codes associated with input values are stored as numeric values. These
codes are calculated in dimension formulas and business rules. The calculated
values of these currency codes may translate to currency codes that are incorrect
or invalid. Where there are children with mixed currencies, review calculated
results on the upper levels.
• If a parent has multiple children, of whom only one child has an overridden
currency, the parent inherits the overridden currency code (which is not displayed
on forms).
• In certain cases, parent entities display #MISSING when trying to convert to a
selected currency. Ensure that a currency rate is entered for each combination
of local currencies and selected currencies on forms or reports. Currency
combinations must exist for all mixed-currency children entities and parent
members.
Number Formatting
You can determine the initial display of numerical values for non-currency and
currency data types in forms:
• Thousands separator:
– None: 1000
– Comma: 1,000
– Dot: 1.000
– Space: 1 000
• Decimal separator:
– Dot: 1000.00
– Comma: 1000,00
• Negative number sign:
– Prefixed minus: -1000
– Suffixed minus: 1000-
– Parentheses: (1000)
• Negative number color:
– Black
– Red
10-66
Chapter 10
Setting Up Currencies
Creating Currencies
You can create members in the Currency dimension for each currency needed in your
application.
Select from a predefined list or create your own. You can specify:
• The three-letter code
• The symbol
• A description of up to 256 characters
• The scaling factor to use when values are displayed
• The alias table to use to display aliases
• Number formatting, including thousands separator, decimal separator, negative
sign, and color
• Whether it is a reporting currency
Note:
The Triangulation currency to use for currency conversion is set from the
application currency.
To create currencies:
10-67
Chapter 10
Setting Up Currencies
Editing Currencies
To edit currencies:
10-68
Chapter 10
Setting Up Scenarios
– Use Default Setting: Apply the default setting for the currency.
• For Negative Color, select the display color.
7. Click Save.
Deleting Currencies
You cannot delete the default currency.
To delete currencies:
Setting Up Scenarios
Each scenario contains data for accounts and other dimensions of each entity. After
users enter data for an entity for a scenario, they can submit or promote the data for
the entity to other users for review and approval.
About Scenarios
Use scenarios to:
• Create forecasts.
• Enter data into scenarios.
• Associate scenarios with different time periods or exchange rates.
• Assign user access rights by scenario.
• Report on scenarios.
• Compare and analyze scenarios.
Time Periods
Assign each scenario a range of years and time periods, and specify the Beginning
Balance time period. When users access forms, they can enter into that scenario only
years and periods within the range. Years and periods outside of the range display as
read-only. You can modify the time range.
10-69
Chapter 10
Setting Up Scenarios
Access Permissions
Specify access permissions to Scenario dimension members for groups or users to
determine who can view or modify data. A user or group can have only one of these
access permissions: Read, Write, or None. Access permissions for a user can be
combined based on groups to which the user belongs.
Creating Scenarios
To create scenarios:
Editing Scenarios
To modify scenarios:
10-70
Chapter 10
Setting Up Scenarios
8. For Start Yr., Start Period, End Yr., and End Period, select the time period to
associate with the scenario.
9. Optional: For Exchange Rate Table, select an exchange rate table to associate
with the scenario.
If an application uses multiple currencies, associate a scenario with an exchange
rate table to enable currency conversion.
10. Optional: For Alias, select an alias table to associate with the scenario, and enter
the description.
11. Optional: Select Enabled for Process Management to use this scenario in
approvals.
12. Click Save.
Deleting Scenarios
When you delete scenarios, all references to the scenario are deleted. You cannot
delete scenarios assigned to an axis on a form. You must first remove references to
scenarios from forms and assign different scenarios.
To delete scenarios:
Copying Scenarios
Only scenario properties are copied. Data values and access rights associated with
the original scenario are not copied to the new scenario.
To copy scenarios:
10-71
Chapter 10
Customizing Application Years
9. Optional: For Exchange Rate Table, select an exchange rate table to associate
with the scenario.
If an application uses multiple currencies, associate a scenario with an exchange
rate table to enable currency conversion.
10. Optional: For Alias Table, select an alias table to associate with the scenario, and
enter a description.
11. Optional: Select Enabled for Process Management to include this scenario in
approvals.
12. Click Save.
10-72
Chapter 10
Working with Attributes
10-73
Chapter 10
Working with Attributes
Deleting Attributes
When you delete an attribute, all attribute values associated with the attribute are
also deleted. Attribute values are removed from members to which they had been
assigned, and the attribute is removed from dimensions to which it was assigned.
To delete attributes:
10-74
Chapter 10
Working with Attribute Values
8. To edit or delete an attribute, click the Actions ellipsis icon next to the
attribute.
10-75
Chapter 10
Working with Attribute Values
• To remove all values from the selected member, click Remove All .
9. Click Save.
10-76
Chapter 10
Working with User-Defined Attributes (UDAs)
10-77
Chapter 10
Working with Member Formulas
Creating UDAs
To create UDAs:
1. Navigate to the UDA tab in Dimensions.
2. On UDA, click Create.
3. Enter a name and click Save.
Changing UDAs
To change UDAs:
1. Navigate to the UDA tab in Dimensions.
2. On UDA, select a UDA and click Edit.
3. Change the name and click Save.
Deleting UDAs
Deleting a UDA removes it for the dimension.
To delete UDAs:
1. Navigate to the UDA tab in Dimensions.
2. Select the UDA and click Delete.
If you delete UDAs, you must update all member formulas, calculation scripts, and
reports that reference them.
10-78
Chapter 10
Working with Member Formulas
Note:
A formula entered for the default cube is applied to all cubes unless
it is overridden by a different formula entered for a specific cube.
To move the formula from the default cube to a specific cube, you
can use Smart View. Find the formula and cut it from the default
cube and paste it into a specific cube, for example, Consol.
10-79
Chapter 10
Working with Member Formulas
10-80
Chapter 10
Working with Member Formulas
10-81
Chapter 10
Working with Alias Tables
10-82
Chapter 10
Working with Alias Tables
About Aliases
You can assign alternate names, or aliases, to system dimensions and user-defined
dimension members. The application allows up to 30 aliases per dimension member,
including the default alias. Aliases can have the same name within an alias table and
across alias tables.
Aliases can also have:
• The same name as a member
• The same alias on members that are parent and child
• The same name for members from different dimensions or from the same
dimension
Note:
• You can't have the same alias for two members that are siblings because
there would be no way to uniquely identify the member. This rule
is enforced by the application for base members, but not for shared
members.
This rule isn't enforced for shared members because you can't directly
set aliases for shared members; shared member aliases are inherited
from the alias of their base member. It's possible to create an alternative
hierarchy where you can have two shared members that have the same
alias and are siblings. However, this situation is discouraged if you
want to reference these members by their aliases from an adhoc grid
because, when you type the alias into the grid and submit it to the
application, the application can't uniquely resolve this member and it will
return an error. If you're using the alias for display purposes only then
there will be no issue, but this design is discouraged because, visually,
there is no way to differentiate between these two members.
• Although aliases can have the same name as a member, be careful not
to set the alias of member1 to be the same name as member2. This can
lead to unintended results and will cause confusion on the form grids.
• Member names must be unique so that they can be used in rules and
form designs.
10-83
Chapter 10
Working with Alias Tables
Note:
You can set alias tables to display members in an application. To specify
Alias Table settings, see Managing Application and System Settings.
10-84
Chapter 10
Working with Alias Tables
10-85
11
Editing Dimensions in the Simplified
Dimension Editor
Related Topics
• About Editing Dimensions in the Simplified Dimension Editor
• Accessing the Simplified Dimension Editor
• Working with the Simplified Dimension Editor Grid
• Editing Dimension Properties in the Simplified Dimension Editor
• Editing Member Properties in the Simplified Dimension Editor
Related topics:
• Dimensions Overview
• Accessing the Simplified Dimension Editor
• Editing Dimension Properties in the Simplified Dimension Editor
• Editing Member Properties in the Simplified Dimension Editor
Watch the following video to learn more about adding and updating metadata using the
Dimension Editor:
11-1
Chapter 11
Accessing the Simplified Dimension Editor
11-2
Chapter 11
Working with the Simplified Dimension Editor Grid
Note:
To view all property columns in the grid, clear the Default mode check
box. Default mode is selected by default, and limits the properties that
are displayed. Clearing this option displays a larger (complete) set of
properties (as columns).
4. To change the size of the grid or the columns that are displayed on the grid, select
or clear the following resizing options:
• Force fit columns—Resizes the columns so that all columns are visible on
the grid without scrolling.
• Synchronous resize—Resets the size of the grid to original settings.
Viewing Ancestors
Ancestors are all the members above the selected member in the dimension hierarchy.
To view the ancestors for the selected member in the Simplified dimension editor grid:
1. View Edit Member Properties.
See Accessing the Simplified Dimension Editor.
2. Select a member on the dimension editor grid.
3. Click Show Ancestors.
11-3
Chapter 11
Working with the Simplified Dimension Editor Grid
To view where members are used in an application using the Simplified dimension
editor:
1. View Edit Member Properties.
See Accessing the Simplified Dimension Editor.
2. Select a member on the dimension editor grid.
3. Click Show Usage.
Finding Members
To find dimension members in the Simplified dimension editor grid:
1. View Edit Member Properties for a dimension.
See Accessing the Simplified Dimension Editor.
2. For Search, select Name, Alias, or Both.
3. Enter the search text (member name, alias, or partial string) for which to search.
4. Click Search Up or Search Down.
11-4
Chapter 11
Working with the Simplified Dimension Editor Grid
Sorting Members
You can sort members in ascending or descending order, by children or descendants.
Sorting members affects the outline.
To sort members using the Simplified dimension editor:
1. View Edit Member Properties.
See Accessing the Simplified Dimension Editor.
2. On the dimension grid, select the members whose children or descendants you
want to sort.
3. For Sort, select Children or Descendants.
Sorting by children affects only members in the level immediately below the
selected member. Sorting by descendants affects all descendants of the selected
member.
4. Click Sort Ascending or Sort Descending.
11-5
Chapter 11
Editing Dimension Properties in the Simplified Dimension Editor
• Click next to the formula bar, and then enter or edit the formula.
Tip:
To include member names in formulas, keep the focus on the formula
cell in the grid. Press Ctrl while clicking the member name you want to
include in the formula. The member name will display in the formula bar.
3. Optional: To check the validity of a member formula, click next to the formula
bar, and then click Validate.
4. Click Save.
11-6
Chapter 11
Editing Dimension Properties in the Simplified Dimension Editor
Property Value
Dimension Enter a name that is unique across all
dimensions.
Description Optional: Enter a description.
Alias Table and Alias Optional: Select an alias table. Enter an
alternate name for the dimension.
See Working with Alias Tables.
Cube Select the cubes for which the dimension
is enabled. Clearing this option disables all
members of the dimension for the deselected
cube.
Two Pass Calculation Recalculate values of members based on
values of parent members or other members.
Available for Account and Entity members with
Dynamic Calc properties.
Apply Security Allow security to be set on the dimension
members; must be selected before assigning
access rights to dimension members.
Otherwise, dimensions have no security and
users can access members without restriction.
Data Storage Select a data storage option. The default is
Never Share.
• Store—Stores data values of members.
• Dynamic Calc—Calculates data values of
members, and disregards the values.
• Never Share—Prohibits members in the
same dimension from sharing data values.
• Label Only—Has no data associated with
the member.
• Shared—Allows members in the same
dimension to share data values.
See Data Storage Options.
Display Option Set application default display options for
the Member Selection dialog box. Select
Member Name or Alias to display members
or aliases. Member Name:Alias displays
members on the left and aliases on the right.
Alias:Member Name displays aliases on the
left and members on the right.
11-7
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
Property Value
Hierarchy Type Available for dimensions bound to an
aggregate storage cube. Aggregate storage
dimensions are automatically enabled to
support multiple hierarchies. The first hierarchy
in a multiple hierarchy dimension must be
Stored.
For members with a Stored hierarchy type,
the only valid cube aggregation options are
Addition or Ignore. In a stored hierarchy, the
first member must be set to Addition. For
members with a Dynamic hierarchy type, all
cube aggregation options are valid. Stored
hierarchy members that are not children of
Label Only members must have Addition
set as the consolidation operator. Children of
Label Only members can be set to Ignore.
Custom Attributes Click to Create or Synchronize custom
attributes for a dimension.
Note:
Each column in the Simplified dimension editor grid represents a member
property. The list of properties (columns) that initially displays on the grid
can be different based on which dimension type you are editing. You can
customize the layout of columns by hiding, unhiding, or resizing columns.
You can also display the complete set of properties (all columns) by clearing
the Default mode option. To customize the column layout in the Simplified
dimension editor grid, see Customizing the Column Layout.
11-8
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
11-9
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
11-10
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
11-11
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
11-12
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
11-13
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
11-14
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
11-15
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
Tip:
To choose a different dimension, click the down arrow next to the
dimension name at the top of the page.
6. Add members:
• To add a child member, select the parent level member, and then click Add
Child.
• To add a sibling member, select a member, and then click Add Sibling.
7. To set or change member properties, click a cell in the Edit Member Properties
grid and make updates. See Editing Member Properties in the Simplified
Dimension Editor.
8. To undo the last change you made before saving, click Undo.
9. To undo all changes that were made since the last save, click Refresh.
10. To save your changes, click Save.
11. To apply your changes across the application after a save, click Refresh
Database.
12. After creating a dimension member, you typically complete these tasks:
11-16
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
Tip:
To choose a different dimension, click the down arrow next to the
dimension name at the top of the page.
6. Take an action:
• To add members, see Adding Members in the Simplified Dimension Editor.
• To navigate the dimension editor grid and to focus your editing on certain
members, rows, or columns, see Working with the Simplified Dimension Editor
Grid.
• To modify member properties, click within a cell on the dimension editor grid
and select an option from the drop-down list. For example, to edit the Account
Type for an Account dimension member, click within a cell in the Account Type
column. Click the down arrow that appears within the cell, and then select
an Account Type option. For descriptions of member properties, see Editing
Member Properties in the Simplified Dimension Editor.
• To delete members, see Deleting Members in the Simplified Dimension Editor.
7. To undo the last change you made before saving, click Undo.
8. To undo all changes that were made since the last save, click Refresh.
9. To save your changes, click Save.
10. To apply your changes across the application after a save, click Refresh
Database.
11-17
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
Before deleting members, understand where in the application they are used (in
which forms, approval units, exchange rates, and so on) by using Show Usage. See
Showing Member Usage in an Application.
You must delete the entity member throughout the application before deleting it from
dimension. For example, if the entity member is used in a form, you must delete it from
the form before deleting it from dimensions.
When deleting a large subtree of entities, you can improve performance if you first
exclude approval units for the subtree (by excluding the root member) for all scenarios
and versions.
To delete members:
1. From the Home page, click Application, and then click Overview.
2. Click Dimensions.
3. Click the down arrow next to Cube to filter the list of dimensions by cube.
4. Click the name of the dimension that contains the member you want to delete.
5. Click Edit Member Properties.
Tip:
To choose a different dimension, click the down arrow next to the
dimension name at the top of the page.
Note:
Deleting a base member also deletes its shared members.
11-18
Chapter 11
Editing Member Properties in the Simplified Dimension Editor
settings. Custom attributes, custom attribute values, and member formulas are not
allowed for shared members. Renaming base members renames all shared members.
Shared members cannot be moved to another parent member. You must delete
shared members and recreate them under different parent members. The base
member need not be level zero. You can enter data in shared members, and values
are stored with base members.
To add shared members in the Simplified dimension editor:
1. View Edit Member Properties.
See Accessing the Simplified Dimension Editor.
2. Add shared members:
a. Add a child member with the same name as the base member.
b. For Parent Name of the new member, type a new parent name.
c. For Default Data Storage of the new member, select Shared.
3. Click Save.
Data storage properties for all other cubes will automatically be set to Shared.
11-19
12
Managing Jobs
Related Topics
• Jobs Overview
Jobs are actions, such as exporting data or refreshing the database, which you
can start right away or schedule to run at intervals.
• Viewing Pending Jobs and Recent Activity
• Scheduling Jobs
• Editing and Deleting Jobs
Jobs Overview
Jobs are actions, such as exporting data or refreshing the database, which you can
start right away or schedule to run at intervals.
Jobs are actions, such as exporting data or refreshing the database, which you
can start right away or schedule to run at intervals. The Jobs console enables
administrators to manage jobs in a central location.
You can manage these types of jobs in the Jobs console:
• Run rules
• Import data
• Import metadata
• Export data
• Export metadata
• Refresh the database
• Run Invalid Intersection Reports
• Restructure a block storage cube (BSO)
• Import journals
• Import journal templates
• Export journals
• Export journal templates
• Non-consolidation jobs such as Task Manager and Supplemental Data jobs
12-1
Chapter 12
Scheduling Jobs
Note:
Jobs are retained in the Jobs console for 90 days.
• To filter the list of pending jobs and recent activity, click the Filter icon ,
select filter options, and then click Apply.
• To search for a job, enter text in the Search field, and then click the Search
icon .
• To view details for jobs, click the name of the job.
• To view details for Task Manager and Supplemental Data jobs:
a. Select the Non-Consolidation Jobs tab on the left.
b. Optional: Filter the Jobs list by Name, Job ID, Source, Status, Created
By (or Modified By), Start Date, or End Date.
Scheduling Jobs
You can schedule when to run jobs (now or at a future time) and how often (once,
daily, weekly, monthly, and yearly).
To schedule jobs:
1. On the Home page, click Application.
2. Click Jobs.
3. Click Schedule Jobs.
4. On the Schedule Job page, General tab, select the type of job:
12-2
Chapter 12
Scheduling Jobs
12-3
Chapter 12
Editing and Deleting Jobs
• Yearly
8. Optional: To enter an end date, click the End Date checkbox, and then select the
date and time.
9. Click Next to continue.
10. The Job Details page lists the operations that were saved as a job. Select a job,
and click Next.
11. From the Review page, review your selections.
3. To the right of a pending job, click the Actions icon, , and then select Edit or
Delete.
4. To edit a job:
a. On the Edit Job page, make selections for when to run the job and how often,
and then click Next.
Note:
You can only edit the schedule of the job. You cannot edit the job
type or the job name.
12-4
13
Auditing Tasks and Data
Related Topics
• Configuring Audit Tasks
• Auditing Information Overview
You can use the Audit Information feature to view tasks performed by users and
filter audited tasks by Task Group, Action, user ID, start time, and end time.
• Viewing Audit Details
• Viewing Task Manager Audit Details
13-1
Chapter 13
Auditing Information Overview
13-2
Chapter 13
Viewing Audit Details
13-3
Chapter 13
Viewing Task Manager Audit Details
Tip:
You can select Clear to clear your selections and return to the default
values.
Note:
To hide the filter bar, click the Filter
5. To display all columns, select View, then Columns, and then select Show All.
13-4
Chapter 13
Viewing Task Manager Audit Details
6. To display specific columns, select View, then Columns, and select or deselect
the column names.
7. To reorder columns, select View, and then Reorder Columns, select the columns
and use the Up or Down arrows or drag them to change the order.
8. Optional: To export the audit information to a Microsoft Excel spreadsheet, click
Export, and follow the download instructions.
When you select the Export option, the system exports all of the records matching
the filter criteria to an xlsx file (format for Microsoft Excel versions 2007 and later).
The best practice is to manually export and truncate the audit tables. Otherwise,
table size can become too large and users cannot log in to the application.
Note:
13-5
14
Defining Valid Intersections
Related Topics
• Understanding Valid Intersections
Valid intersections enable you to define rules, which filter certain cell intersections
to users when they enter data or select runtime prompts.
• Creating Valid Intersections
• Managing Valid Intersections
• Suppressing Invalid Data in Forms
• Working with Valid Intersections in Forms
• Managing Invalid Intersection Reports
14-1
Chapter 14
Understanding Valid Intersections
Note:
If you want to remove valid intersections regardless of what other valid
intersection groups allows, then this rule must be in a different valid
intersection group.
See Example: Redundant or Overlapping Valid Intersection Rules Within
the Same Valid Intersection Group.
14-2
Chapter 14
Understanding Valid Intersections
Group 1 means entities that are descendants of Manufacturing are valid only
with descendant products of Computer Equipment. No other products are valid
with descendants of Manufacturing. All other entities besides descendants of
Manufacturing are valid with all products, including descendants of Computer
Equipment.
Group 2 means products that are descendants of Computer Equipment are only valid
with descendant entities of Manufacturing. No other entities are valid with descendants
of Computer Equipment. All other products besides descendants of Computer
Equipment are valid with all entities, including descendants of Manufacturing.
Caution:
The choice of anchor dimension is significant. You will get dramatically
different results if you choose the wrong anchor dimension.
14-3
Chapter 14
Understanding Valid Intersections
In Group 1, the product dimension is not required, and unselected entities are valid.
Therefore, if the type of the form or business rule, at runtime, does not include the
product dimension, the system evaluates the entity dimension selections to mark all
entities as valid for a type that doesn’t contain the product dimension.
In Group 2, the product dimension is not required, and unselected entities are invalid.
Therefore, if a type does not include the product dimension, the system evaluates the
entity dimension selections to mark all entities except descendants of Manufacturing
as invalid. Thereafter, any type that doesn’t use the product dimension will only allow
data entry in the descendants of Manufacturing entities.
Caution:
Carefully consider whether a nonanchor dimension is required or not,
especially if the result leaves a valid intersection group with only one
effective dimension. Additionally, selecting the Unselected Members are
Valid option for anchor dimension members also plays a significant role
in the system behavior for valid intersections. See Example: Unselected
Members are Valid.
14-4
Chapter 14
Understanding Valid Intersections
Because Group 1 defines all unselected members are invalid, the system marks
noninclusive descendants of Balance Sheet invalid. Gross Profit is not an inclusive
descendant of Balance Sheet. So even though Group 2 explicitly states inclusive
descendants of Gross Profit are valid with inclusive descendants Sales entities, the
invalid definition from Group 1 overrides any further valid intersections of the same
anchor dimension member set.
14-5
Chapter 14
Understanding Valid Intersections
Evaluation Order
Evaluation order for valid intersection groups orders invalid results sets as quickly
as possible, increasing the speed and efficiency of the overall valid intersection
evaluation.
14-6
Chapter 14
Creating Valid Intersections
For example, the system evaluates the first valid intersection group in the list, then
the second group, and so on. If the system finds an invalid intersection in the second
group in the list, it will stop evaluating the rest of the list because, once an intersection
is defined as invalid, it will override other valid intersection rule results.
To change the order in which groups are evaluated, see Changing the Valid
Intersection Group Evaluation Order.
c. To select the anchor dimension, click the Down arrow, next to Select
Anchor Dimension.
d. Optional: By default, the anchor dimension members that are not specified in
the valid intersection rule are marked valid. To clear this option, click the Down
arrow, next to the anchor dimension, and then click Unselected members
are valid.
e. To select additional dimension (called nonanchor dimension), click Add
Dimension.
f. Optional: By default, nonanchor dimensions are not required. To make
a nonanchor dimension required, click the Down arrow, next to the
nonanchor dimension, and click Required.
4. Define the valid intersection rule:
a. Click Add Rule.
b. To select the range of members to include, exclude, or remove in the valid
intersection, click the Down arrow, next to the new rule:
• Click Edit to open the Select Members page and select members to
include in the valid intersection rule.
• Click Add Exclusion to define an exclusion in the rule. You can exclude a
subset of what is included for that dimension.
• Click Clear to clear the selection.
14-7
Chapter 14
Managing Valid Intersections
14-8
Chapter 14
Managing Valid Intersections
Tip:
You can also drag valid intersection groups to move them up and down
in the list.
Note:
The check mark is green if the group is enabled.
4. Ensure that any remaining groups that are enabled are still listed in the correct
evaluation order in the valid intersections list. If they are not, move them up or
down in the order.
• To edit dimension details, next to the dimension, click the Down arrow,
to select the members to include, exclude, or remove in the valid intersection
rule:
– Click Edit to open the Select Members page and select members to
include in the valid intersections rule. You can also type in the members or
functions.
– Click Add Exclusion to define an exclusion in the rule. You can select
members to exclude; for example, you can select or include all children of
YearTotal except children of Q1 by excluding children of Q1.
14-9
Chapter 14
Suppressing Invalid Data in Forms
3. Click the Actions icon, to the right of a valid intersection group that you want
to duplicate, and then select Duplicate.
4. Open the valid intersection group and edit it.
5. Reorder the valid intersection groups, if needed. See Changing the Valid
Intersection Group Evaluation Order.
3. Click the Actions icon, , to the right of a valid intersection group that you want
to remove, and then select Delete.
4. Reorder the remaining valid intersections, if needed. See Changing the Valid
Intersection Group Evaluation Order.
To delete a valid intersection rule from a valid intersection group, see Deleting a Valid
Intersection Group.
14-10
Chapter 14
Working with Valid Intersections in Forms
Note:
Valid intersection groups do not grant access to dimension members.
Valid intersection groups further restrict the valid intersections of dimension
members already granted to a user.
Action Behavior
Open a form The form renders with member selections as
defined in the form definition, adhering to
the user’s access rights for dimensions, and
applies valid intersection groups with the most
recently used as current selections.
14-11
Chapter 14
Managing Invalid Intersection Reports
Action Behavior
Select members from a point of view • Enables you to select a member on the
dimension point of view
• In the member selector for a point of view
dimension, enables you to select from a
filtered list of remaining valid intersections,
which is based on the members that
were selected for the other point of view
dimensions
• Ignores the order in which point of
view dimension members are selected
because selecting a member from
any dimension included in a valid
intersection group dynamically filters the
remaining dimension member lists for
those dimensions included in the valid
intersection group, as appropriate, when
that dimension is selected
• Provides the option to hide invalid
members from dimension lists or display
them as unselectable in the point of view
• Provides the ability to reset the point of
view to the fully unfiltered list without
closing and reopening the form by
clearing the selections
Ad hoc forms, both in Web and Smart View,
will not filter page or point of view members
according to valid intersection groups.
Select Go to render a form based on point of The form renders as defined based on the
view selections. You can also click the right valid point of view intersection.
arrow in the form point of view.
Enter and save data The form data is entered and saved.
14-12
Chapter 14
Managing Invalid Intersection Reports
Tip:
9. Select an option:
• Save and Run now - to run the report immediately.
• Save and Run later - to save the report as a job to be run at a later time. The
Schedule Job dialog box displays. Select when to run the job and how often,
and then click Submit.
14-13
Chapter 14
Managing Invalid Intersection Reports
Tip:
To search for a report, enter search criteria, and then click Search.
14-14
15
Managing Forms
Forms are grids for entering data that you can design to meet your needs.
See these topics:
• Form Components
• Form Design Considerations
For information on form security, see Managing Forms Security.
Predefined Forms
When you create an application, the system provides these forms. By default, the
Service Administrator and Power User have Modify access to these forms. A User or
Viewer can launch the form, but cannot modify the layout.
Note:
The forms that are displayed by default may depend on the features that are
selected for the application.
If you selected the Basic Balance Sheet option when you created the
application, all forms under the Balance Sheet, Cash Flow, and Income
Statement folders are excluded. Other seeded forms are retained.
FCCS_Balance Sheet
FCCS_Cash Flow
15-1
Chapter 15
Predefined Forms
FCCS_Income Statement
User-Defined Forms
Note:
The predefined Rate forms are only provided if the Multi-currency option was
selected during application creation.
15-2
Chapter 15
Form Components
Form Components
Related Topics
• Point of View
• Page Axis
15-3
Chapter 15
Form Design Considerations
Point of View
Select members for the Point of View to determine the context for pages, rows, and
columns. For example, if the Scenario dimension is set to Budget in the Point of View,
all data entered in pages, rows and columns is entered into the Budget scenario. The
Point of View is set to one member, which a user cannot change, for each Point of
View dimension.
To simplify the form, in the Point of View you can specify only relevant members or
include user variables.
Page Axis
Use the page axis to specify combinations of members that may span dimensions so
users can work with data in smaller, more logical views. Each item on the page axis
can have members selected from one or more dimensions. Users see only members
that they can access.
You can specify multiple page drop-down lists, and select members using relationship
functions or attributes. Switch between member sets by selecting them from the page
axis.
You display member names or aliases on the page axis. You can specify the number
of members in a page dimension that enables a search drop-down list on the data
entry page, which is useful if the dimensions contain many members.
15-4
Chapter 15
Creating Simple Forms
15-5
Chapter 15
Creating Simple Forms
15-6
Chapter 15
Creating Simple Forms
Note:
Initially, all dimension are in the form Point of View. You can drag
dimensions from the Point of View to rows, columns, or to pages. You
can also drag dimensions from any area in the grid (row column, Point of
View, or page) to any other area.
Option Description
Apply to all rows Apply settings to all rows; available when
there are two or more rows. Clear this option
to set different properties for each row.
Apply to all columns Apply settings to all columns; available when
there are two or more columns. Clear this
option to set different properties for each
column.
Hide Hides the column or row on the form.
Read-only Creates a read-only row or column, enabling
comparison of old, read-only data with new,
editable data
Show separator Creates a bold border before the segment to
visually distinguish it.
Suppress hierarchy Suppresses indentation
Suppress missing data Hides rows or columns without data. Clear
to display rows or columns with "#MISSING"
in cells when data is missing.
Column width • Default: Use the column width
defined at the grid level (under Grid
Properties)
• Small: Display seven decimal places.
• Medium: Display 10 decimal places.
• Large: Display 13 decimal places.
• Size-to-Fit: Force all columns to fit in
the displayed space based on the top
data cell value.
• Custom: Select a custom size to
display more than 13 decimal places,
up to 999 places.
15-7
Chapter 15
Creating Simple Forms
Option Description
Row height • Default: Use the row height defined at
the grid level (under Grid Properties)
• Medium: Display standard row height.
• Size-to-Fit: Force all rows to fit in the
displayed space.
• Custom: Select a custom size in pixels
for the row height.
Global Assumptions Form To enable transferring global assumptions
from a test to a production environment for
a simple form, select Global Assumptions
Form. Then update the form to store global
assumptions such as a tax rate.
Option Description
Suppress missing blocks (Rows only) Improves the performance of
the Suppress missing data setting when
suppressing many rows, for example, 90%
or more. The Suppress missing blocks
setting can degrade performance if few or no
rows are suppressed. Test forms before and
after using this setting to determine whether
performance is improved. Also test forms
whenever you make significant changes to
your application.
Suppress missing data Hides rows or columns without data. Clear
to display rows or columns with "#MISSING"
in cells when data is missing.
Suppress invalid data Hides rows or columns with invalid data.
Clear to display rows or columns that
contain cells with data that is invalid. Cells
with invalid data are read-only.
Default row height • Medium
• Size-to-Fit: Force all rows to fit in the
displayed space
• Custom: Select a custom size in pixels
for the row height
15-8
Chapter 15
Creating Simple Forms
Option Description
Default column width • Small: Display seven decimal places
• Medium: Display 10 decimal places
• Large: Display 13 decimal places
• Size-to-Fit: Force all columns to fit in
the displayed space based on the top
data cell value
• Custom: Select a custom size to
display more than 13 decimal places,
up to 999 places
Global Assumptions Form To enable transferring global assumptions
from a test to a production environment for
a simple form, select Global Assumptions
Form. Then update the form to store global
assumptions such as a tax rate.
Suppress invalid Scenario/Time Periods Hides invalid Scenario/Time Periods.
Suppress Missing also Suppresses Zero When this option is selected along with the
Suppress missing data option for forms, all
rows or columns containing both #Missing
and zeroes are suppressed.
When selected, this setting overrides the
runtime suppression selections made for
suppressing missing data or zeroes in
Oracle Smart View for Office
3. Click Save to save your work and continue, or click Finish to save your work and
close the form.
Property Description
Apply to all row dimensions Applies properties to all row dimensions
Apply to all column dimensions Applies properties to all column dimensions
Apply to all page dimensions Applies properties to all page dimensions
Apply to all POV dimensions Applies properties to all Point of View
dimensions
Member Name Displays the member name
15-9
Chapter 15
Creating Simple Forms
Property Description
Alias Displays the member alias
Member Formula Displays member formulas
Hide dimension Hides the dimension
Show consolidation operators Displays consolidation operators
Start expanded Available only for dimensions on rows
or columns, choosing this option initially
displays the dimension member list
expanded
Enable custom attributes Available only for dimensions on rows or
columns; enables custom attributes
Drill on Shared Members For row or column dimensions. Enable
drilling on shared members when the shared
member is on a parent member for the main
hierarchy.
Show Currency Available for multi-currency applications;
displays currencies
Show Qualified Name Displays the members of the Entity
dimension as Parent.Child.
Select Never, As Needed, or Always.
Selecting this option together with the
Show Currency option displays the entity
member as Parent.Child (ParentCurrency,
Child Currency).
This option is retained when the form is
used in Oracle Smart View for Office.
4. Click Save to save your work and continue, or click Finish to save your work and
close the form.
Notes:
• The Account dimension must be assigned to a row axis.
• Account, Entity, View and Scenario dimensions cannot be assigned to the column
axis.
• The Entity dimension can be assigned to the row, page, or Point of View axis.
• View and Scenario dimensions must be assigned to the page or Point of View
axis.
To set display properties:
1. Open the form, and then click Layout.
15-10
Chapter 15
Creating Simple Forms
Option Description
Make form read-only Use this option to make the form read-only.
Hide form For example, hide forms that are accessed
from menus or task lists.
Display missing values as blank Leave form cells empty where data does not
exist. If this option is not selected, empty
cells display the text "#MISSING".
Enable account annotations This option is only available if the Account
dimension is on the row.
Allow multiple currencies per entity If the application supports multiple
currencies, allow entities to support multiple
currencies, regardless of base currency.
Users can select the currency for displayed
cell values in forms.
Enable Mass Allocate Users must have the Mass Allocate role to
use this option.
Enable Grid Spread Use this option to enable grid spread.
Enable cell-level document (Default) Enable users to add, edit, and view
documents in cells in the form, depending
on access permissions. To prevent users
from using documents in a form, clear this
option.
Message for forms with no data Enter text to display in form rows for queries
without valid rows. Leave blank to display
the default text: There are no valid
rows of data for this form.
3. Click Save to save your work and continue, or click Finish to save your work and
close the form.
15-11
Chapter 15
Creating Simple Forms
Option Description
Include supporting detail Include supporting detail as extra rows in
PDF files. Specify display format:
• Normal Order: Prints supporting detail
in the same order as on the Supporting
Detail page, after the member it is
associated with
• Reverse Order: Prints supporting detail
in reverse order, before the member
associated with it. Supporting detail for
children displays above parents, and
the order of siblings is preserved.
Show comments Display text notes associated with cells
Format data Apply number format settings from the form
to the displayed data
Show attribute members If attribute members are selected in the
form, display them in PDF files
Apply precision Apply form precision settings (desired
number of decimal points) to the displayed
data in PDF files
Show currency codes If the form supports multiple currencies,
display currency codes in the form and in
PDF files. Whether currency codes display
depends on whether currency codes are
present on any member in the form.
If a currency code is present on any
member contained in the form, currency
codes display in the form regardless of the
selection for this check box. If currency
codes are not present on members in the
form, they are not displayed.
Show account annotations If account annotations are enabled for the
form, select to display account annotations
in PDF files
3. Click Save to save your work and continue, or click Finish to save your work and
close the form.
15-12
Chapter 15
Creating Simple Forms
Note:
The menu options that display are context-sensitive, and depend on
whether rules have already been added, and if you previously selected
a menu option. For example, if you right-click a cell that contains a rule
and select Copy Validation Rules, the Paste Validation Rules menu
option is displayed when you right-click another cell.
Option Description
Add/Edit Validation Rules Add or edit existing rules in the condition
builder are of the Data Validation Rule
Builder dialog box.
Copy Validation Rules Copy the selected rules to be pasted to a
new location.
Paste Validation Rules Paste the previously copied rules to a new
location.
Validate only for users with access to If the currently logged-in user does not
this form have access to the form, do not execute
validations associated with the form when
validating the Approval unit.
Validate only for pages with existing When enabled, the system figures out which
blocks page combinations have potential blocks
and runs the validations only for those page
combinations. There are a few exceptions to
this. If a page combination has any Dynamic
Calc, Label only, or Store with one child
member, then that page is always loaded.
Validate only for cells and pages the user When enabled, validations are run as
has access to the currently logged-in user and not as
the administrator, which means the user’s
security will be applied to the form members.
Validate with each possible value for user When enabled, the form will be validated
variables from approval unit dimensions multiple times by replacing the user variable
from the approval dimension with every
possible value for the user variable. If not
enabled, the form will be validated once with
the user variable replaced with all possible
values for the user variable. It is not enabled
by default.
Validate with current approval unit When enabled, the user variable for the
members as values for user variables approval dimension on the form will be
replaced by the approval unit member
before the validations are run. If not
enabled, the user variable will be replaced
with all possible values for the user variable.
It is not enabled by default.
15-13
Chapter 15
Creating Simple Forms
Notes:
• By default, the precision settings that you select here override the precision
set for the currency member. If instead you want the currency member’s
precision setting to apply for the form, select Use Currency member
precision setting.
• Precision settings affect only the display of values, not their stored values,
which are more accurate. For example, if Minimum Precision is set to 2, and if
the system spreads the value 100 from Q1 into the months January, February,
and March, the month cells display 33.33 when they are not selected. When
they are selected, they display their more accurate values (for example,
33.33333333333333).
3. In Context Menus, associate menus with the form by selecting them from
Available Menus and moving them to Selected Menus, using the right and left
arrows.
4. If you select multiple menus, use the Up and Down arrows to set the order in
which they display.
15-14
Chapter 15
Creating Simple Forms
5. Select Enable Dynamic User Variables to allow dynamic user variables in the
form.
6. Click Save.
Tip:
Consider adding a formula row between two other rows to create a blank
row. Blank rows are useful, for example, for visually separating subtotals and
totals within a form.
15-15
Chapter 15
Creating Simple Forms
15-16
Chapter 15
Working with Forms and Form Components
9. Click Save to save your work and continue, or click Finish to save your work and
close the form.
Opening Forms
To open a form for editing:
Previewing Forms
While you are designing forms, you can preview the dimensions that are assigned
to the Point of View, columns, rows, and page axes. Previewing displays member
attributes, alias, and data associated with forms, although new data cannot be
entered.
Previewing completes regular form design validation checks, and checks for proper
evaluation of any data validation rules included in the form. Data validation rules must
be properly completed before the form can be saved. In addition, data validation
rules are saved as part of the form. If you do not save changes to a form, any data
validation rule changes made after the form was last saved are lost.
To preview a form’s design:
15-17
Chapter 15
Working with Substitution Variables
5. Save the form to ensure that updates are saved, including any changes to data
validation rules.
Note:
You can move multiple forms simultaneously if they are in the same
folder.
15-18
Chapter 15
Working with User Variables
15-19
Chapter 15
Working with User Variables
15-20
Chapter 15
Working with Smart Lists
15-21
Chapter 15
Working with Smart Lists
Note:
Smart List names cannot have spaces in them. If you are synchronizing
Smart Lists in a reporting application, ensure that any new members do not
have spaces in the name.
Property Description
Smart List Enter a unique name containing only
alphanumeric and underscore characters
(for example: Position) and no special
characters or spaces. Smart List names can
be referenced in formula expressions.
15-22
Chapter 15
Working with Smart Lists
Property Description
Label Enter the text to display when the Smart List
is selected. Spaces and special characters
are allowed.
Display Order How Smart Lists are sorted in the drop-
down list: by ID, Name, or Label
#MISSING Drop-Down Label Enter a label (for example, "No Justification")
to be displayed as an entry in the Smart List
whose value is #MISSING.
It displays as the first selection in the Smart
List drop-down, allowing #MISSING as a
selection in the form.
When the cell is not in focus, this label
displays only if Drop-Down Setting is
selected in the next option. Otherwise,
#MISSING or a blank cell is displayed,
depending on the Display Missing Values As
Blank selection for the form.
#MISSING labels determine only the display
of cells with #MISSING data; #MISSING
remains the stored value.
#MISSING Form Label Determines how #MISSING values are
represented in cells associated with Smart
Lists. Options:
• Drop-Down Setting: Displays the label
set in #MISSING Drop-Down Label.
• Form Setting: Displays #MISSING
or leaves cells blank, depending on
the Display Missing Values As Blank
selection for the form. This selection
determines what is displayed in the cell
when it is not the focus. When the
cell is in focus, the Smart List item
that is selected from the drop-down is
displayed.
Automatically Generate ID Generate a numeric ID for each Smart List
entry. If you do not select this option, you
can customize Smart List ID values.
5. Click Save.
6. Select Entries.
Use the Entries tab to define selections on Smart Lists.
15-23
Chapter 15
Working with Smart Lists
Option Guideline
Blank When designing forms, select Display
Missing Values as Blank.
When setting Smart List properties, select
Form Setting.
15-24
Chapter 15
Working with Smart Lists
Option Guideline
#MISSING When designing forms, do not select Display
Missing Values as Blank.
When setting Smart List properties, select
Form Setting.
A custom label, such as "No Change" When setting Smart List properties, enter the
custom label in the #MISSING Drop-Down
Label field (for example, No Change). Select
Drop-Down Setting.
15-25
16
Managing Journals
Related Topics
• Creating Journal Groups
• Deleting Journal Groups
• Managing Journal Periods
• Setting Journal Options
• Journal Referential Integrity
16-1
Chapter 16
Managing Journal Periods
Note:
If the group has any journal references in the application, the system
displays an error message that it cannot delete the group.
16-2
Chapter 16
Journal Referential Integrity
16-3
17
Consolidating Data
Related Topics
• Consolidation Process
Consolidation is the process of gathering data from descendant entities and
aggregating the data to parent entities.
• Data Flow
• Consolidation Process Flow
• Intercompany Eliminations
• Consolidation Dimension
• Translation Process
• Translating Data
• About Exchange Rates
• Entering Exchange Rates
• Entering Override Rates
• Specifying Default Translation Settings
• Consolidation and Translation Security Access
• Calculation Status
• Consolidating Data
• Viewing Consolidation Progress
• Running a Consolidation Report
• Consolidation Examples
• Advanced Consolidation Overview
• Consolidation Logic
• Managing Consolidation Methods
• Modifying Consolidation Methods
• Adding Consolidation Methods
• Importing and Exporting Consolidation Methods
• Recomputing Ownership Data
• Managing Ownership
• Changing Manage Ownership Settings
• Importing and Exporting Ownership Data
• Ownership Settings Year to Year
• Ownership Settings in Forms and Configurable Calculation Rules
17-1
Chapter 17
Consolidation Process
Consolidation Process
Consolidation is the process of gathering data from descendant entities and
aggregating the data to parent entities.
Consolidation is the process of gathering data from descendant entities and
aggregating the data to parent entities. After you enter or load data into base-level
entities, calculate and adjust data, you run a consolidation for a selected Scenario,
Year, Period and Entity to aggregate the data throughout the organization.
You launch the Consolidation process from forms or from data grids. You must have
first loaded or entered data in base entities. See Consolidating Data.
Launching consolidation runs the consolidation rules for the specified scenario, period,
and entity. The translation process is run as required to convert data from the child
entity currency to the parent entity currency. If the child and parent entity use the same
currency, the translation process is not run.
After you select the parent entity into which the dependent entities consolidate, the
required processes run automatically.
• The system runs calculation rules for all descendants of the entity.
• If the data for the child entity and the data for the parent entity are in different
currencies, the system translates data based on the exchange rate.
• You can enter adjustments to data through journals.
• The consolidation process begins. You can make further adjustments to
contribution data through journals.
Data Flow
Financial Consolidation and Close provides several dimensions through which data
"flows" from an input point to a consolidated point. These dimensions are the Entity,
Consolidation and Currency dimensions.
Entity Dimension
17-2
Chapter 17
Data Flow
17-3
Chapter 17
Data Flow
Currency is the same currency as Parent Currency, and also to any matching
Reporting Currency. The entered data is not copied to Entity Currency even if Entity
Currency matches the Input Currency to which the data was entered. There are no
translation calculations applied because the data is treated as "translated" data. A
separate Data Source member is required for each Input Currency to which data is to
be entered.
If required, the Entity Input and Translated Currency Input data can be applied to
one or more reporting currencies through the Translation process. If the reporting
currency is the same currency as represented by either the Entity Currency or the
Parent Currency, then the data is copied from the relevant source to the reporting
currency. If the reporting currency is not the same currency as represented by either
the Entity Currency or the Parent Currency, then the data is translated using the same
process as translation from Entity Currency to Parent Currency. Note that Translated
Currency Input data is never translated and only copied to Reporting Currency from
Parent Currency.
Opening Balances are never translated but are carried forward from the translated
Closing Balances of the prior period.
Entity Input and Translated Currency Input aggregates to Entity Total. For a multi-
currency application, this aggregation occurs for Entity Currency, Parent Currency and
any populated reporting currencies.
Entity Total and Parent Input aggregate to Parent Total (if Parent Input is enabled) in
Parent Currency only.
Proportionalization
Data is proportionalized to the Proportion member from Entity Total or from Parent
Total (if Parent Input is enabled). Proportionalization applies the Consolidation %
defined for the child/parent combination to all source data points.
Data can be entered to Parent Input in the currency of the parent. Parent Input
is therefore specific to the entity / parent combination and aggregates only to the
specified parent entity. If an entity is shared and has more than one parent then
there will be more than one Parent Input point available. Parent Input is an optional
Consolidation dimension member and must be enabled in order to be used.
Opening Balances are never proportionalized, but are carried forward from the Closing
Balances of the prior period of the Proportion member. If the Consolidation % changes
from one period to the next, the Opening Balance Ownership Change system rule
generates adjustment entries to adjust the Opening Balance to the required current
period Consolidation %.
Elimination
Entity Total data or Parent Total data (if Parent Input is enabled) can be eliminated
and adjusted to the Elimination member. The Standard Elimination system rule adjusts
intercompany entries based on the account Intercompany and Plug Account settings.
Additional adjustments can be generated from Configurable Consolidation rules.
Opening Balances are always carried forward from Closing Balances of the prior
period of the Elimination member.
Contribution to Parent
Proportion data aggregates with Elimination data to Contribution.
17-4
Chapter 17
Data Flow
Data can be entered to Contribution Input in the currency of the parent. Contribution
Input is therefore specific to the entity / parent combination and aggregates only to
the specified parent entity. If an entity is shared and has more than one parent then
there will be more than one Contribution Input point available. Contribution Input is an
optional Consolidation dimension member and must be enabled in order to be used.
Contribution and Contribution Input aggregate to Contribution Total (if Contribution
Input is enabled) in Parent Currency only.
Contribution or Contribution Total (if Contribution Input is enabled) aggregates to Entity
Consolidation of the parent entity, combining with similar data from the siblings (the
other children of the parent).
Opening Balances are always carried forward from Closing Balances of the prior
period.
Parent Entity Data Entry
At the parent entity, additional data can be introduced in the Entity Input and
Translated Currency Input members (currently through Journal entries only).
Entity Elimination Adjustment entries are generated by the system if the aggregated
Entity Consolidation data requires adjustment. This could occur if the cumulative
consolidation % of a source level 0 entity increases due to the merging of shared
instances of the entity. Equity consolidations could then be required to change to
Proportional or Subsidiary at an intermediate parent entity.
Entity Consolidation, Entity Elimination Adustment, Entity Input and Translated
Currency Input are then aggregated to Entity Total entity currency values and
translated to Parent and Reporting currencies as required. Additional data can be
entered to Parent Input and Contribution Input. The consolidation process then
continues through the Consolidation / Currency dimensions from each child entity to
its parent.
17-5
Chapter 17
Data Flow
There are two settings for the behavior of the top members of the Entity dimension.
Preferred behavior (applied by default): No substitution variable
"ProportionalizeTopEntityMembers" or set this substitution variable to False
Data is not translated to parent currency or consolidated to Contribution / Contribution
Total for the "top" entities in the Entity dimension ("Total Geography" and any siblings).
This is because there is no valid parent entity for which a default currency is defined,
and no valid parent entity to which to contribute (the "Entity" member of the dimension
is deemed to be a dimension label rather than an entity). Data entry to Translated
Currency Input, Parent Input and Contribution Input is also restricted for these top
entity members. However, the entity dimension label ("Entity") can be selected when
invoking a consolidation process. This will allow all hierarchies in the entity dimension
to be consolidated at one time.
Alternative behavior: Create and set substitution variable
"ProportionalizeTopEntityMembers" to True.
Data is translated to parent currency for the "top" entities in the Entity dimension
by applying the system currency. Parent Currency data is also consolidated to
Contribution / Contribution Total but no further. Data entry to Translated Currency
Input, Parent Input and Contribution Input is restricted for these top entity members.
Watch the following video for details about consolidation data flow:
17-6
Chapter 17
Consolidation Process Flow
Local Currency
17-7
Chapter 17
Consolidation Process Flow
Translated
17-8
Chapter 17
Consolidation Process Flow
Note that the Translated tab is not available for single-currency applications.
Opening Balance Carry Forward
At each level of the Entity, Consolidation and Currency dimensions, the Closing
Balance of the prior period is carried forward to the Opening Balance of the current
period for all Flow type accounts.
Note that Opening Balance is never translated. Opening Balance is always carried
forward from the Closing Balance of the prior period for the Applicable Consolidation
Members and at Parent Currency.
The translated currency Opening Balance is retrieved from the translated currency
Closing Balance of the prior reporting period of the same scenario. If the current period
is the first period of the year, then the Opening Balance will be retrieved from the last
period of the prior year.
For all Balance Sheet accounts (account type Asset, Liability or Equity), the Opening
Balance is retrieved for all periods. For Income Statement accounts (account type
Revenue or Expense), the Opening Balance is retrieved for all periods except the first
period of the year.
The Opening Balance is retrieved:
• In the Periodic reporting view, from the Closing Balance of the prior period
• In the Quarter-to-date reporting view, from the Closing Balance of the prior quarter
• In the Half-year-to-date reporting view, from the Closing Balance prior half-year
• In the Year-to-date reporting view, from the Closing Balance of the prior year
Default Translation
Default Translation applies the default translation settings to the translation of periodic
movement members. The default translation settings can be configured from the
Manage Defaults button on the Translation Overrides screen.
Any "Amount Override" and "Rate Override" entries are also applied to the translated
data.
See these topics:
• Translation Process
• Translating Data
17-9
Chapter 17
Consolidation Process Flow
17-10
Chapter 17
Consolidation Process Flow
Consolidated
17-11
Chapter 17
Intercompany Eliminations
Intercompany Eliminations
Standard Eliminations Overview
Companies record the results of transactions with other companies. Those other
companies might be related companies or unrelated (that is, third party) companies.
When reporting consolidated financial results, the impact of any transactions for which
the legal companies within the scope of the consolidation have common control
must be removed /eliminated from the consolidated results. The net results must be
presented as if the group of legal entities were a single economic unit.
Transactions with unrelated companies do not require elimination. Transactions with
related companies might need to be eliminated or partially eliminated depending on
whether the related company is in the scope of the consolidated results and the
accounting requirements applied to the consolidation arithmetic.
The nature of the relationship between the related parties will determine the manner
in which information from the in-scope companies is aggregated and eliminated to
produce the consolidated results. Different accounting standards will require some
different aggregation methods, but most standards follow similar general principles.
When an application is enabled for Intercompany accounts and contains Intercompany
account data, eliminations take place as part of the consolidation process.
17-12
Chapter 17
Intercompany Eliminations
17-13
Chapter 17
Intercompany Eliminations
17-14
Chapter 17
Consolidation Dimension
Consolidation Dimension
The Consolidation dimension provides an additional layer to the financial information,
which enables you to view details on input values, adjustment, and contribution
information. It includes entity data, such as the input value and any related
adjustments to the entity’s data. As a dependent entity’s values roll up into its
parent during consolidation, the system stores consolidation detail including Proportion
and Elimination detail. Proportion detail contains the balances resulting from the
17-15
Chapter 17
Consolidation Dimension
17-16
Chapter 17
Translation Process
Note: * The Entity Consolidation and Entity Elimination Adjustment members are
system calculated members and are only applicable to Parent entities.
Translation Process
Financial Consolidation and Close provides currency translations for a multi-currency
application. The default translation process applies the Periodic translation method to
Flow accounts and the Year-to-Date method to Balance accounts.
See Translating Data.
17-17
Chapter 17
Translating Data
available for Reporting Currency translation. All Reporting Currencies have a suffix of
_Reporting, for example, USD_Reporting.
Translation to Reporting Currencies is required for all periods. If prior periods in the
current year have not yet been translated, they will be translated before the selected
period. If there are prior years that have not been fully translated, you will need to
translate in sequence each year that has not yet been translated and then translate
the current year.
Each entity is translated independently of each other.
• If the default currency of the entity is the same as the Reporting Currency, then the
entity currency is moved to Reporting Currency.
• If the default currency of the entity is not the same as the Reporting Currency, then
if there is a Parent Entity with a default currency that is the same as the Reporting
Currency, the Parent Currency is copied to the Reporting Currency.
• If neither the default currency for the entity nor the parent entity is the Reporting
Currency, then the entity currency is translated to the Reporting Currency.
Due to the cumulative nature of some translation calculations, it is recommended that
any translation to a Reporting Currency that is neither an entity's Entity currency or
Parent currency be executed from the first period of the year.
Note that only entity input and entity consolidation are translated. Proportion,
Elimination and Contribution will not show up in Reporting Currency.
Exchange Rates
The Rate Cube contains all the exchange rate data with respect to any source
currency to any destination currency. If there is no Override rate or amount for a
Historical Rate account, the system uses the global exchange rate for translation.
You can view the exchange rates used for calculations in a pre-defined data form. You
can also use pre-defined forms to enter exchange rates and to enter override rates.
See these sections:
• Entering Exchange Rates
• Entering Override Rates
• Predefined Forms
Translating Data
Currency translation converts data from one currency to another. You can translate
data from the entity’s input currency to any other reporting currency that has been
defined in the application. When you consolidate data, currency translation occurs if
the parent entity has a different default currency than the child entities.
Financial Consolidation and Close provides default currency translations for a multi-
currency application. By default, the translation process uses the Periodic Value (PVA)
method for Flow accounts, and the Value at exchange rate (VAL) method for Balance
accounts. The default method and exchange rate accounts used can be modified. See
Specifying Default Translation Settings.
Translation is performed using calculation scripts and based on stored consolidated
data. When the system performs translation, if data is not consolidated or if data
is impacted, it automatically consolidates the data before translation. The system
17-18
Chapter 17
Translating Data
translates the stored consolidated amount to the Reporting currency by applying the
applicable exchange rates.
Translation to Parent currency is performed as part of the consolidation process. If
you want to translate data into a specific Reporting currency, you select the target
Reporting Currency and perform translation. Only currencies enabled for reporting are
available for Reporting currency translation.
All accounts within the Balance Sheet grouping ("FCCS_Balance Sheet") except for
"Saved Assumption" accounts are translated. The default translation is based on
the default translation settings that you have selected from the Translation Overrides
screen (Periodic Translation at Average Rate is used by default unless modified).
All Movement dimension base (level 0) members are translated at the selected
translation settings except for the Opening Balance and Opening Balance Adjustment
member. Any override account entries for accounts specified as Historical Amount
Override or Historical Rate Override Exchange Rate Type accounts are then applied,
replacing the default translations. If no override entries were made, then the Historical
accounts remain translated at the default settings. Any deployed translation override
rules are then applied, adjusting or replacing the default translation results.
Opening Balance is always carried forward from the Closing Balance of the prior
period for all stored levels of data and is never translated. Opening Balance
Adjustment entries are deemed to be related to the prior period (for example, prior
period adjustments). Opening Balance Adjustment entries are therefore translated at
the prior period Ending Rate. Historical accounts are translated at the prior period
"effective rate" (the ratio of the prior period Closing Balance translated amount
divided by the prior period Closing Balance untranslated amount) on an account-
by-account basis. It is possible that small extraneous amounts might create an
invalid (unreasonable) effective rate that can incorrectly distort subsequent translation
calculations. To avoid this issue, if the ratio of the calculated prior period effective rate
to the prior period Ending Rate (or the reciprocal) exceeds 10, then the Ending Rate
will be used for the translation (for example, if effective rate / ending rate < 0.1 or
effective rate / ending rate > 10, then translate using the ending rate).
Foreign Exchange Variances (FX Opening, FX Movements) are then calculated to
bring the aggregated Closing Balance to the equivalent of the untranslated Closing
Balance translated at Ending Rate. Then for all accounts that are defined with an
Exchange Rate Type of Historical, Historical Rate Override or Historical Amount
Override, the calculated FX is reversed in either the FX-to-CTA or FX-to-CICTA
movement members. The accumulation of these reversals for all accounts within
the Balance Sheet top member (not the "FCCS_Balance Sheet" grouping, but the
"FCCS_Total Balance Sheet" Traditional or Net Assets member) are then posted to the
CTA or CICTA account (within the Balance Sheet, the reversal of the calculated FX
and the posting to CTA / CICTA is a balanced entry).
After the translation process is complete, the translated data is stored. Adjustments
can be made to the stored data using Configurable Calculation rules.
You can view the exchange rates used for calculations in a pre-defined data form. You
can also use pre-defined forms to enter exchange rates and to enter override rates.
See these sections:
• Entering Exchange Rates
• Entering Override Rates
• Predefined Forms
17-19
Chapter 17
About Exchange Rates
To translate data:
1. On the Home page, click Data.
2. From the Forms list, click Data Status.
3. Select the point of view.
4. Select a cell for which to run translation rules.
5. From the Actions drop-down menu, select Business Rules.
6. From the Business Rules dialog, click Translate.
7. When the translation process successfully completes, the system displays a
confirmation message. Click OK.
Note that if a translation is interrupted, it might be necessary to run a Force
Translate to reset the system and complete the required translation.
17-20
Chapter 17
Entering Exchange Rates
Note:
To view Indirect Exchange Rates, on the Home page, click Data, and from
the Forms list, open the Exchange Rates form.
Cross-Rates
Generally, exchange rates are quoted and entered in terms of a common or system
currency. When a translation is to be calculated with that system currency, the direct
or indirect rate is applied. When a translation is to be calculated between two other
currencies (for example, neither currency is the system currency), then the required
cross-rate can be triangulated through the system currency.
Using USD as the system currency:
GBP to USD: 2.00 direct rate
EUR to USD: 0.80 direct rate
USD to EUR: 1.25 indirect rate
GBP to EUR = GBP to USD/ USD to EUR = 2.00 / 1.25 = 1.60
If only direct rates are entered to Financial Consolidation and Close, based on the
system currency, the system will calculate the indirect rates and all of the cross-
rates used in translations. If indirect rates or cross-rates are entered, Financial
Consolidation and Close will not overwrite the entered rates.
It is recommended that only direct rates be entered to Financial Consolidation and
Close in order for the most accurate indirect and cross-rates to be generated. If for
example, an indirect rate is entered and it is not the reciprocal of the direct rate, then
a translation from currency 1 to currency 2 and then back to currency 1 will incorrectly
not yield the original amount. A similar issue can occur if cross-rates are entered.
17-21
Chapter 17
Entering Exchange Rates
Note:
The predefined Rate forms are only provided if the Multi-currency option was
selected during application creation. See Predefined Forms.
To view Indirect Exchange Rates, from the Forms list, open the Exchange
Rates form.
After you save data in forms, the following two rules are automatically executed:
• Form_PostProcess_Rate
• Form_PostProcess_SDMCurrencyRates
These rules automatically compute rates if any cell has been edited on a form
targeting the Rates cube. If you have created your own Exchange Rate entry forms
with the old rules "Compute Rates" and "RefreshSDMCurrencyRates", you should
remove them to avoid duplicate rate computation. If the Compute Rates dialog
appears after saving data, you must manually remove the old rules from the form.
You can also import Exchange Rates. See Example: Data Import File - Exchange
Rates.
To enter direct rates in a data form:
1. On the Home page, click Data.
2. From the Forms list, click Enter Exchange Rates - Single Period, or Enter
Exchange Rates - Multi Period.
3. From the POV, select the Scenario, Year, and Periods.In the rows, select the level
0 descendants in the "From Currency" dimension, excluding the currency defined
as the system currency:ILvl0Descendants(From Currency) excluding USD
4. In the rows, select the level 0 descendants in the "From Currency" dimension,
excluding the currency defined as the system currency:
ILvI0Descendants(From Currency) excluding USD
5. In the columns, select the level 0 descendants of "Entered Exchange Rates" in the
Account dimension:
ILvI0Descendants(Entered Exchange Rates)
6. Enter the direct rates and click Save.
7. From Actions, select Compute Rates.
To view all rates in a form:
1. From the Home page, click Data, and then open the Exchange Rate form to
review the rates.
2. In the rows, select the level 0 descendants in the "From Currency" dimension:
ILvI0Descendants(From Currency)
3. In the columns, select the level 0 descendants of "Input Currencies" in the
Currency dimension:
ILvI0Descendants(Input Currencies)
17-22
Chapter 17
Entering Override Rates
4. In the columns, select the level 0 descendants of "Entered Exchange Rates" in the
Account dimension:
ILvI0Descendants(Exchange Rates)
Note:
The system will automatically compute rates if any cell has been edited on a
form targeting the Rates cube.
After you have entered all the direct rates and the system has executed the rules, all
direct, indirect and cross-rates will be displayed.
The direct rate entry and all rates display can be combined into one form for a single
period if required.
In this example, direct rates for USD, BRL, CAD, CHF and GBP are entered in the first
two columns against a system currency of EUR. All indirect and cross-rates are then
displayed.
Note:
The predefined Rate forms are only provided if the Multi-currency option was
selected during application creation.
17-23
Chapter 17
Specifying Default Translation Settings
When you enter an override amount or rate to an Intercompany entry that has
already been eliminated, the override will also be applied to the elimination entry. The
eliminated amount in Data Source "Intercompany Eliminations" will be adjusted by the
same ratio as the original source entry in one or more of the "Total Input and Adjusted"
members.
You can also import Override Rates. See Example: Data Import File - Overrides.
To enter override rates:
1. On the Home page, click Data.
2. From the Forms list, click Override Rates.
All accounts specified as Historical Rate accounts are listed in the rows.
3. From the POV, select a Scenario, Year, and Entity.
4. For an account, enter the amount or rate for the override, and click Save.
Note:
Any changes to the default translation settings impact existing data in the
application. The calculation status changes from OK to System Change,
and the status for all reporting currency changes to Needs Translation. This
applies to both locked and unlocked entities.
17-24
Chapter 17
Consolidation and Translation Security Access
Note:
Although you can create additional rate accounts for an application, you
can only select Average or Ending for the default translation accounts.
Note:
Entities that are locked are excluded from the consolidation process.
Note:
Administrators have default access to all the rules in the application.
17-25
Chapter 17
Calculation Status
Calculation Status
Oracle Financial Consolidation Close Cloud maintains the calculation status for
each Scenario, Period, Entity and Parent entity combination. The calculation status
indicates whether data needs to be translated or consolidated. The calculation status
can change as a result of several actions:
• Changing the organization structure
• Adding or deleting accounts
• Modifying entity attributes
• Entering data in data grids, or loading data from external sources
• Posting or unposting journals
• Reloading rules
• Changing percent consolidation
• Changing currency rates
• Changing override amount data
Status Description
OK Data is OK - none of the data for the specified
dimensions has changed.
No Data No data exists for the specified dimensions.
Impacted Data has changed since last generated, which
requires a reconsolidation to change its status
to OK. This occurs when a change to a base
entity data impacts a parent entity.
Needs Translation The selected dimension member is not the
entity’s default currency and its translated
values may not be current.
System Change A change has occurred that may affect
the data for the specified dimensions. For
example, a new rules file or metadata file
has been loaded, or the currency rate has
changed.
You can view the calculation status in forms and grids and then take action as
necessary. The following tables list available actions for forms and grids.
17-26
Chapter 17
Calculation Status
17-27
Chapter 17
Consolidating Data
Consolidating Data
You can launch the Consolidation or Translation process from a form, and you can
view the data status in a data grid. Oracle Financial Consolidation and Close Cloud
provides a predefined Data Status grid, which contains entities in the rows, and
periods in the columns. The data in the grid is based on the Scenario/Entity/Period/
Currency information from the form.
Note:
Translation is performed as part of consolidation. For details on the
translation process, see Translating Data.
To consolidate data, you must be a Service Administrator, Power User or User, and
must also have Write access to the Parent entity to be consolidated.
When you select a base entity to consolidate, the system performs the calculation for
the entity only. It does not consolidate to its parent entity.
When you select a parent entity, all descendants of the parent are also consolidated.
If you consolidate data for a period and the data for prior periods has not been
consolidated, the data for the prior period is also consolidated. If you select to
consolidate the December period and any prior periods are impacted, the system
starts consolidation from the first impacted period.
The consolidation process runs for entities that are Impacted. When the process is
complete, the status of each successfully consolidated entity changes to OK.
You can use the Force Consolidate option to force consolidation to run on selected
cells. For example, if the consolidation process did not properly complete due to
an external factor (a database crash, or the user stopped the process), it will leave
entities in a processing status. The system may also display an error message that a
17-28
Chapter 17
Viewing Consolidation Progress
"failed consolidation needs to be reset". In these cases, you use the Force Consolidate
option, which consolidates all entities with data.
You can view the consolidation status in the Jobs console. If you want to run
consolidation but there is already a consolidation process running, you can run Force
Consolidate.
To consolidate data:
1. On the Home page, click Data.
2. From the Forms list, click Data Status.
3. Select the point of view.
4. Select a cell for which to run consolidation.
5. From the Actions drop-down menu, select Business Rules.
6. From the Business Rules dialog, click Consolidate.
7. Optional: To force the consolidation process to run for all selected cells, click
Force Consolidate.
You can also run Force Consolidate from the Rules card. See Consolidation and
Translation Rules.
If running from a form, you can add Force Consolidate to the Business Rules
option of the Form design. See Selecting Business Rules.
8. When the consolidation process successfully completes, the system displays a
confirmation message. Click OK.
9. To check consolidation status, open the Jobs console. See Viewing Consolidation
Progress.
17-29
Chapter 17
Running a Consolidation Report
When you run the report and save it as an Excel report type, you can use a
Substitution Variable to automatically display the values in number format, rather than
cell text. The substitution value is called EnableExcelNumberFormat, and when set to
True, when you save the report as an Excel report type, the values are automatically
displayed in numeric values.
The Consolidation report provides the following information for a selected parent
entity:
• List of accounts (displayed in Columns)
• List of child companies within the selected consolidation group contributing to each
displayed account (displayed in Rows)
• Original reported closing balance (normally general ledger balance) for Assets and
Liabilities and Equity, and current YTD balances for Profit and Loss
• Adjustments to the reported balance during consolidation, including manual
journal entries, Multi-GAAP adjustments and automatic eliminations generated
by Intercompany elimination and consolidation rules. These include Intercompany
eliminations, Acquisitions or Disposal entries (such as Investment Eliminations,
Share Capital Eliminations, Reserves Eliminations), valuation adjustments, NCI,
Equity accounting, and so on.
– Manual journals are displayed with both the journal label and description
– Automatic eliminations are displayed with Life-To-Date amount (Opening
Balance) and YTD amount on a rule-by-rule basis
– Adjustments are displayed in Entity currency of the selected Parent entity
• Net contribution of each immediate child entity for each account in the selected
group
• Any Variance - the total net contribution with consolidated group results
17-30
Chapter 17
Running a Consolidation Report
You can display Journal details instead of a Summary amount when you use a Parent
GAAP member or Parent accounts in the POV. Journal amounts are displayed on their
own accounts on a row named Manual Journals, but if you use a Parent account, the
amount is displayed in the parent account in the row of the journal labels. If you select
a Parent GAAP member, all journals can be displayed label by label.
17-31
Chapter 17
Running a Consolidation Report
If you leave the title blank, the report is generated with the "Consolidation Trail
Worksheet" title.
7. For Column Display, select Account or Movement.
If you select Movement, the report displays all of the movements in level 0 under
FCCS_ClosingBalance in the Columns. However, if the zero line display option
is "No", the zero column will not be displayed in the report. Selecting Movement
displays the movement details on a specific POV, and as a result the column will
display all the movement.
If you select multiple accounts in the POV, each account will be a sub-report. If you
select multiple accounts and then select the XLS output option, the XLS file will
have multiple sheets to display the result of different accounts.
The report displays the following information (if any) in Rows:
• Entity Name
• Original Balance
• Manual Journal
• Intercompany Elimination
• Auto-Elimination
• Subtotal
8. For Hierarchy Display, and Multi-GAAP Display, the report uses the default
values, and you cannot change them.
9. For Zero Line Display, select Yes to display zero data lines, or leave the default
setting of No to suppress rows with only zero data.
10. For Member Display, select an option:
• Member Name
• Alias
• Name and Alias
11. From Report Type, select an option:
• HTML
• PDF
• XLS
12. To run the report immediately, click Run Report and then select to open or save
the report.
13. Optional: To save the report as a Job, which you can schedule to run immediately
or at a later time, click Save as Job, enter a job name and optional description,
and click Submit to save the job.
After you save a report, the report name and description are displayed in the
reports list on the Consolidation Reports Jobs page.
14. To run a report that was saved as a job, use one of these methods:
• From the Consolidation Reports Jobs page, select the report from the list of
reports, select an Output Format, and click Run Report. You can download
the report file to a local path.
17-32
Chapter 17
Consolidation Examples
Consolidation Examples
Related Topics
• Example 1: Reconsolidating Data from a Form
• Example 2: Consolidating Data from the Data Status Grid
• Example 3: Consolidating Data for Multiple Periods
17-33
Chapter 17
Advanced Consolidation Overview
17-34
Chapter 17
Consolidation Logic
Entity Total / Parent Currency aggregated data then provides the source data for
consolidation to the contribution to the Parent entity. All data is proportionalized to the
Proportion Consolidation dimension member. A factor (multiplier) is applied to each
data value. The factor applied is the Consolidation % defined for the specific Entity /
Parent combination. All data at Entity Total / Parent Currency is proportionalized
except for the Opening Balance Movement dimension member. Opening Balance is
always carried forward from the Closing Balance of the prior reporting period for each
level in the Entity / Consolidation / Currency dimensions. Note that the prior period
from which the Closing Balance is drawn is dependent on the reporting view. For the
Periodic View, for example, Opening Balance is drawn from the Closing Balance of the
prior period / month, while for the Quarterly View, Opening Balance is drawn from the
Closing Balance of the prior quarter.
In addition to proportionalization, some Entity Total / Parent Currency data is
eliminated or adjusted as required by consolidation logic. Any data that is required
to create elimination or adjustment entries is multiplied by an appropriate factor and
posted to the Elimination Consolidation dimension member. Multiple elimination and
adjustment entries will usually be created from the Entity Total / Parent Currency
source entries, and will be grouped into balanced sets of entries, constituting a
Consolidation Journal entry.
Proportion and Elimination data then aggregates to the Contribution member.
Additional data can be entered to the Contribution Input member and aggregates
with Contribution to the top level Consolidation dimension member, Contribution Total.
Contribution Total of each Entity/Parent combination then aggregates with Contribution
Total of sibling entities into Entity Consolidation/Entity Total of the parent entity.
Consolidation Logic
Data is proportionalized from the Entity Total / Parent Currency Consolidation
dimension member to Proportion. The factor applied is always the Consolidation %
defined for the Entity/Parent combination.
Data eliminated or adjusted might have the Consolidation % applied, or might use
the Ownership % or Minority Interest (Non controlling interest) %. Other ratios might
also be applied, such as the change in Ownership % or the lower of the entity
Consolidation % and the Intercompany Partner Consolidation %.
The factors applied will be based on the Ownership Management of each Entity/Parent
combination for each Scenario, Year and Period. Ownership Management records the
ownership percentage for which a legal entity (an owning company) directly owns all or
part of another legal entity.
Ownership Management
Ownership management consists of managing global consolidation settings and the
application of those consolidation settings to each entity hierarchy on a scenario-
by-scenario, year-by-year and period-by-period basis. For details, see Managing
Ownership.
17-35
Chapter 17
Managing Consolidation Methods
• Ownership %
• Consolidation %
• Minority (Non controlling) Interest %
A Control setting is also available to help determine the other settings for the
methods.
The consolidation methods are then applied to the consolidating parent entity and
its hierarchical descendants during the execution of consolidation, adjustment and
elimination rules.
Financial Consolidation and Close Cloud provides several system methods:
• Holding
• Subsidiary
• Proportional
• Equity
• Not Consolidated
• Inactive
• Discontinued
Holding method
The Holding method is applied to the legal entity for which its immediate parent
represents the consolidated results of that legal entity. The Holding method always
applies an Ownership % of 100% and a Consolidation % of 100%. Control is Yes.
There can be only one Holding method entity for each parent entity.
Subsidiary method
The Subsidiary method is applied to legal entities owned by the holding company and
for which the holding company exercises control. The Ownership % of a Subsidiary
company generally ranges from 50% to 100%. Control is Yes and the Consolidation
% is therefore 100%. Minority (Non-controlling) Interest equals 100% minus the
Ownership %.
Proportional method
The Proportional method is applied to legal entities owned but not controlled by the
holding company but requiring proportional consolidation. This generally applies to
Joint Ventures. Control is No and the Consolidation % is equal to the Ownership %.
Equity method
The Equity method is applied to legal entities owned by the holding company and
for which the holding company exercises significant influence but not control. The
Ownership % of an Equity company generally ranges from 20% to 50%. Control is
No and the Consolidation % is therefore 0%. Minority (Non-controlling) Interest
also equals 0%.
17-36
Chapter 17
Modifying Consolidation Methods
Inactive method
The Inactive method is reserved.
Discontinued method
The Discontinued method is reserved for future use when system consolidation rules
are created for discontinued operations.
Ownership Range
Each of the methods can be assigned an Ownership % range that is used to populate
the method for an Entity parent/child combination based on the entered Ownership %
for each Scenario, Year and Period. The range across the applicable methods must
be a continuous range from 0% to 100%. Methods not assigned a range will not be
applied to an Entity parent/child combination by the system, but can be selected as
required, overriding the range-based system-assigned entry.
The system methods comprising the 0% to 100% range are:
• Not Consolidated >= 0% to <=20%
• Equity >20% to <=50%
• Subsidiary >50% to <=100%
All other system methods have no range assigned.
17-37
Chapter 17
Adding Consolidation Methods
17-38
Chapter 17
Importing and Exporting Consolidation Methods
7. The Control setting will default to Yes and the Consolidation % will default to
100%. You can modify these settings as required.
If Control is changed to No, then Consolidation % will change to 0% but can
then be amended.
If Control is changed back to Yes, then Consolidation % will change to 100% but
can then be amended.
8. If the new method displays the Ownership % Range, select the operator and
ownership % for the lower and upper ranges. The settings of the lower range
of the method above and the upper range of the method below will change as
required to maintain a continuous range from 0 to 100.
9. If the new method displays the Ownership % Range and a range entry is not
required, click Actions (...) and select Remove Range.
10. If the new method does not display a range slider bar and a range entry is
required, click Actions in the relevant method row and select Add Range. Follow
the steps described in "Adding a Range to a System Method".
11. Click Save to save your changes.
When you click Save, the settings will be validated and you must correct any
errors before the changes are saved and you close the screen.
Note:
It is recommended that you save your changes after completing changes
for a single method rather than making multiple method changes and
then saving.
12. After you make changes to the Consolidation Methods range settings, you must
recompute the POV-specific ownership data. A warning message will be displayed
at the top of the Manage Ownership screen if the data has not been re-computed.
See Recomputing Ownership Data.
17-39
Chapter 17
Importing and Exporting Consolidation Methods
Method Name, Lower Limit Operator, Lower Limit, Upper Limit Operator,
Upper Limit, Control, Percentage Consolidation, RangeOn
17-40
Chapter 17
Recomputing Ownership Data
Note:
When the ownership data is recomputed, if the process takes longer than
60 seconds, then the remainder of the process will be continued in the
background and you can navigate to other screens if required. To view the
progress of the process, open the Jobs console.
You must also recompute ownership data after the Database is refreshed,
regardless of whether changes were made to the entity structure, unless the
DeltaDBRefresh Substitution Variable has been created and set to "True".
If the DeltaDBRefresh Substitution Variable has been set to "True" and
changes are made to the entity structure, then after the required Database
Refresh you must recompute ownership, but recomputation will not be
required for other metadata changes.
Managing Ownership
Ownership management consists of managing global consolidation settings and the
application of those consolidation settings to each entity hierarchy on a scenario-by-
scenario, year-by-year and period-by-period basis.
Ownership settings are applied to each Entity parent/child combination for each
Scenario, Year and Period combination.
To access the Ownership Management screen:
1. On the Home page, click Application and then click Consolidation.
2. Click Manage Ownership.
3. Select the Entity parent member for which to view the hierarchy.
17-41
Chapter 17
Changing Manage Ownership Settings
Parent/Child View
Initially, all members will inherit the following settings:
• Ownership %: 100
• Control: Yes
• Consolidation Method: Subsidiary
• Consolidation %: 100
• Minority Interest %: 0
The only exception will be any shared entities (for example, where an entity exists
more than once in a single hierarchy). The first instance will inherit the settings noted
above while each subsequent instance will have the following settings:
• Ownership %: 0
• Control: No
• Consolidation Method: Not Consolidated
• Consolidation %: 0
• Minority Interest %: 0
17-42
Chapter 17
Changing Manage Ownership Settings
• Consolidation Method
The Consolidation Method entry is assigned by the system based on the entered
Ownership % and the method ranges. If required, you can change the system-
assigned Consolidation Method entry.
To change the Consolidation Method entry, select the required entry from the
drop-down list. The methods available in the drop-down list are dependent on the
Ownership % and Control settings. The Holding method will only be available for
selection with 100% Ownership and Control = Yes. Other methods will be available
for selection based on their Ownership Method Control settings. So if Control =
Yes, only those Methods with a Control setting of Yes will be displayed. To change
the available Methods in the drop-down list, first change the Control selection.
If the Consolidation Method entry has been changed from the system-assigned
entry, the color of the field will change to a yellow background.
To remove an override entry and revert to the system-assigned entry, from
Actions (...), select Clear.
Note that the combination of Control and Consolidation Method selected must
match the method settings. If Control is Yes, the selected Consolidation Method
must be one of the methods for which Control has been defined as Yes.
• Consolidation %
The Consolidation % will be displayed based on the method settings.
You cannot modify this entry.
• Minority Interest %
The Minority Interest % will be displayed based on the method settings.
You cannot modify this entry.
• Subsequent Changes to Ownership %
If you make changes to system-assigned Control and/or Consolidation Method
entries and then you enter a revised Ownership%, any user-selected entries will
be retained.
If the Control and/or Consolidation Method should be updated based on the
new Ownership%, then you must either clear the override entries or select new
override entries.
17-43
Chapter 17
Importing and Exporting Ownership Data
The Control entry is assigned by the system based on the entered Ownership %
and the method ranges. If required, you can change the system-assigned Control
entry. The behavior of this field is the same as in the Parent/Child view.
• Consolidation Method
The Consolidation Method entry is assigned by the system based on the entered
Ownership % and the method ranges. If required, you can change the system-
assigned Consolidation Method entry. The behavior of this field is the same as in
the Parent/Child view.
• Consolidation %
The Consolidation % will be displayed based on the method settings.
You cannot modify this entry.
• Minority Interest %
The Minority Interest % will be displayed based on the method settings.
You cannot modify this entry.
17-44
Chapter 17
Importing and Exporting Ownership Data
Consol,FY18,Feb,[CE-0012-USD].[LE-0014-CAD],[CE-0011-EUR].[CE-0012-
USD],80,,
Consol,FY18,Feb,[CE-0012-USD].[LE-0016-BRL],[CE-0011-EUR].[CE-0012-
USD],50,,PROPORTIONAL
Consol,FY18,Feb,[CE-0012-USD].[LE-0017-GBP],[CE-0011-EUR].[CE-0012-
USD],30,,
Consol,FY18,Feb,[CE-0012-USD].[LE-0018-EUR],[CE-0011-EUR].[CE-0012-
USD],10,,
Consol,FY18,Jan,[CE-0013-GBP].[LE-0014-CAD],[CE-0011-EUR].[CE-0013-
GBP],10,,
Consol,FY18,Jan,[CE-0013-GBP].[LE-0016-BRL],[CE-0011-EUR].[CE-0013-
GBP],10,,
Consol,FY18,Feb,[CE-0012-USD].[LE-0016-BRL],[Entity].[FCCS_Total
Geography],,NO,PROPORTIONAL
Note that Ownership % (POwn) is a required entry for all Parent/Child rows but should
not be entered for Parent / Legal Company rows where the Legal Company is not the
immediate child.
To import ownership data:
1. On the Home page, click Application and then click Consolidation.
2. Click Manage Ownership.
3. Select a Scenario, Year and Period to which to import data.
Note that the Scenario, Year and Period in the import file must match the POV
displayed.
4. From the Actions menu, select Import Ownership Data.
5. Click Browse and select the import file.
6. Click Import.
7. When you enter or import ownership settings, the system validates the
dependencies between the related fields:
• The Method and Control combination must match the global settings.
• If the Method selected is Holding, then the Ownership % must be 100.
17-45
Chapter 17
Ownership Settings Year to Year
Note:
When the ownership data is imported, if the process takes longer than
60 seconds, then the remainder of the process will be continued in the
background and you can navigate to other screens if required. To view the
progress of the process, open the Jobs console.
When ownership data is imported, it will be merged with any existing data. There
might therefore be invalid ultimate ownership entries created. If an entity is present
in more than one branch of a hierarchy, data entered on-screen cannot be saved if
the combined ownership exceeds 100%. When loaded from a file, the ownership data
is not rejected so the combined ownership % of an entity could exceed 100%. If this
occurs, an error message will be displayed at the top of the Manage Ownership screen
in the period in which the discrepancy occurs:
Ownership data for certain Parent/Legal Company combinations are invalid.
Please identify the incorrect ownership % in the Parent/Legal Company view
and then correct it inthe Parent/Child view.
Navigate to the period in which the data is incorrect and select the Parent/Legal
Entity view. Review the Parent/Legal Entity Ownership % entries. Any errors will be
highlighted in red text. Note the entity (entities) with errors, return to the Parent/Child
view and correct the necessary parent/child ownership % to ensure that the combined
ownership does not exceed 100%.
17-46
Chapter 17
Ownership Settings in Forms and Configurable Calculation Rules
Note that this option is only available in the last period of each year.
To copy ownership data to next year:
1. On the Home page, click Application and then click Consolidation.
2. Click Manage Ownership.
3. Select the last period of the current year in the POV.
4. From the Actions menu, select Copy Ownership Data to Next Year.
If ownership settings have not yet been copied to the first period of each subsequent
year, the entity structure will not be displayed in the subsequent years and an
Information message will be displayed:
No ownership data in the current year. Try "Copy ownership data to next
year" action in the prior year last period.
When the ownership data is copied, if the process takes longer than 60 seconds,
then the remainder of the process will be continued in the background and you can
navigate to other screens if required. To view the progress of the process, open the
Jobs console.
17-47
Chapter 17
Ownership Settings in Forms and Configurable Calculation Rules
17-48
Chapter 17
Advanced Consolidation Rules
17-49
Chapter 17
Advanced Consolidation Rules
17-50
Chapter 17
About Configurable Consolidation Rules
For example, an entity might be owned at 40% by one immediate parent and 40% by
another, with the Equity method being applied in both cases. The lower of the entity
and partner consolidation % is applied to the elimination. In this case, no eliminations
occur because the Consolidation % for the Equity method is 0%. When the two shared
entities consolidate into their first common parent however, the combined ownership
is 80% and the Subsidiary method should be applied, with a Consolidation of 100%.
An adjustment is made at the first common parent at which the aggregated results
of the lower level eliminations are incorrect for the current consolidation method. This
adjustment is made in the Entity Elimination Adjustments Consolidation member of the
first common parent.
17-51
Chapter 17
About Configurable Consolidation Rules
Rule-Sets
Several parameters can be applied to the rule-set:
1. Condition
A condition under which the rule-set is executed
The condition can be based on:
• The consolidation method applicable to the entity dimension parent/child
combination being processed
• Some combination of dimension members or dimension member attributes -
the dimensions applicable for a rule-set condition are the "page" dimensions:
Scenario, Year, Period, Entity (S/Y/P/E) and the "sub-cube" dimensions:
Account, Intercompany, Movement, Data Source, Multi-GAAP (if applicable),
plus any user-created custom dimensions
• A data value
The condition defaults to "Always run".
2. Factor
A factor to which to apply to the source data values
Source data is multiplied by the selected factor, the entity or partner
Consolidation %, Ownership %, Minority Interest %, change from period-to-
period of any of these percentages, the lower of Entity or Partner values of any of
these percentages, the prior period value of any of these percentages or a specific
ratio/percentage.
3. Source Data-Set
The source data-set that is to be processed by the consolidation rule-set defaults
to the "page" dimension members of Current Scenario, Current Year, Current
Period, level 0 members of the "FCCS_Entity Total" Consolidation dimension
member and "Parent Currency". The source data-set can be modified to a different
POV within certain limitations. In general, the source data-set cannot be a data-set
that will be impacted by the posting of data-points by the current consolidation
process. See Creating Consolidation Rule-sets for further details.
4. Scope
A source data POV to filter the data-set to which to apply the rule-set on a
dimension by dimension basis. The default source POV includes all level 0
members of the sub-cube dimensions: Account, Intercompany, Movement, Data
Source, Multi-GAAP (if applicable), plus any user-created custom dimensions.
One or more selections of base (level 0) members can be made for sub-cube
dimensions, including lists. The sub-cube dimension selections in the Source POV
filters and limits the execution of the rule from the total data set to only those data-
points that fall within the sub-cube filter definitions. So the Source POV could, for
example, specify one single account to which to apply the rule-set. If a dimension
is not added to the Source POV, then all base members of that dimension are
included in the data-set.
The page dimensions of Scenario, Year, Period and Entity can also be added
to the Scope of the rule-set. Filtering on a page dimension will prevent the rule-
set from running against any dimension members not included in the scope of
the rule-set regardless of whether the member is in-scope for the consolidation
17-52
Chapter 17
About Configurable Consolidation Rules
process. Note that this method of excluding page dimension members from the
scope of the consolidation is more efficient than using the condition field, but will
not cater for selections that are conditional on more than one dimension.
5. Partner Elimination
If the Partner Elimination feature has been enabled for the application, and if one
or more rules within the rule-set is to write a Partner Elimination entry, click on
the Create Partner Elimination button. When selected, three dimensions will be
added to the scope of the rule-set if not already added by the rules-writer.
The Factor entry and Scope are optional at the rule-set level, but if defined, then these
settings will be inherited by each of the rules within the rule-set.
Rules
One or more rules can be created within the rule-set. The Condition, Factor and Scope
created at the rule-set level will be inherited by each rule and cannot be modified.
If the rule-set has been defined as a Partner Elimination rule-set, then individual rules
can then be set to write Partner Elimination data. Not all rules in a Partner Elimination
rule-set must write partner eliminations.
In addition to parameters inherited from the rule-set, additional parameters can be
defined for each rule:
1. A factor to which to apply to the source data values (if not defined at the rule-set
level)
2. A Processing option of "Add" or "Subtract"
3. One or more Target "Redirection" dimension members
One or more target redirection members can be defined on a dimension-by-
dimension basis (one redirection entry per dimension) for sub-cube dimensions.
If no target redirection dimension members are defined, then the source data will
be written to the target Elimination Consolidation dimension member using the
source dimension members. If a redirection member is defined, then the source
data will be written using the defined redirection member.
Note that if the "#Source POV entity#" entry is selected for redirection of the
Intercompany dimension, then the redirection will be applied to the Intercompany
"ICP_<Source POV Entity>" member.
Also note that if the Source POV Entity has not been designated as a valid
intercompany member (and the "ICP_<Source POV Entity>" member does not
exist), then the redirection will be ignored and the data will be written to the Source
POV Intercompany member.
If the rule is a Partner Elimination rule, the redirection for the Entity, Intercompany
and Data Source dimensions will be pre-set and cannot be changed.
4. Target "Redirection" conditions
Multiple target redirection members can be specified using one or more conditions
to determine when each redirection member is to be applied. A "condition block"
can be created in the form of:
If <condition1> Then
<redirection member 1>
ElseIf <condition2>
17-53
Chapter 17
About Configurable Consolidation Rules
Else
End If
Example 2:
Source POV = Base members of Balance Sheet accounts
Else
17-54
Chapter 17
Managing Consolidation Rule-sets and Rules
End If
17-55
Chapter 17
Creating Consolidation Rule-sets
Note:
Best practice: Where possible, exclude dimension members not required
in the source data set using the Rule-set Scope settings instead of using
the Condition . This design technique will provide for better processing
performance. The Condition logic might be required for complex or multi-
dimensional conditions but should be minimized where possible.
17-56
Chapter 17
Creating Consolidation Rule-sets
17-57
Chapter 17
Creating Consolidation Rule-sets
After you create a condition block, to add another condition, click the Add (+) icon. The
conjunction between the conditions is "And" by default, but you can change it to "Or",
"And Not", or "Or Not".
Grouping Conditions
After you add multiple condition blocks, you can group selected conditions. Grouping
conditions determines required combinations of conditions.
To group conditions:
1. Click on the row of the first condition to include in the grouping, then hold down
Ctrl and select the required adjacent conditions.
2. After you select all adjacent conditions for the grouping, click and select
Group from the drop-down list.
For example, if Condition A and Condition B are grouped, and Condition C and
Condition D are grouped:
Then the condition is applied as:
(Condition A and Condition B) or (Condition C and Condition D).
In this case, the rule-set will execute if conditions A and B are met, or if conditions C
and D are met.
Note that only "Equals" and "Does Not Equal" are available for the Years and Period
dimensions. You cannot apply "before" or "after" logic. Use a list or multiple block
conditions to apply this type of logic.
Example 1:
Years | Member Name | Equals | FY16, FY17, FY18
Example 2:
Period | Member Name | Equals | Mar, Jun, Sep, Dec
Example 3:
Years | Member Name | Does Not Equal | FY16, FY17
Or
And
Period | Member Name | Equals | Jul, Aug, Sep, Oct, Nov, Dec
Rule-set Factor
The rule-set factor will by default display None. If this entry is retained, then the factor
should be set in each of the related rules. If this entry is changed, then the factor
selected will apply to all rules in the rule-set.
Select one of the options in the first drop-down box:
• Current
• Change In
17-58
Chapter 17
Creating Consolidation Rule-sets
17-59
Chapter 17
Creating Consolidation Rule-sets
of the application (that is, a period or year before the first period and year defined in
the application), then the rule-set will not execute for that current POV. This will be
noted in the Job Console but will not cause the consolidation to fail.
Entity:
Currently, only the Current Entity is available.
Consolidation:
Entity Total (default)
• Entity Input
• Entity Elimination Adjustment
• Entity Consolidation
• Proportion
• Elimination
• Contribution
Note that the Consolidation dimension members Proportion, Elimination or
Contribution cannot be selected unless a different Scenario is selected, or if a Year
or Period non-zero offset is selected. This restriction is intended to ensure that the
data-set to be used as the source of the rules is not dependent on the results of the
rules.
You can use the results of Opening Balance Carry Forward, Proportionalization,
Standard Eliminations and Opening Balance Ownership Change system rules of the
current entity. To do so, select the "Contribution" Consolidation dimension member
instead of the default "Entity Total". This will then apply the consolidation rules to the
post-proportionalized net data set, including the results of the system rules.
Currency:
• Parent Currency (default)
• Entity Currency
Note that this selection is not available for a Single-Currency application.
Also note that for multi-currency applications, Entity Currency is not available if
Proportion, Elimination or Contribution has been selected for the Consolidation
dimension member.
View:
• FCCS_Periodic (default)
• FCCS_YTD
• FCCS_HYTD
• FCCS_QTD
The source data will reflect the View member selected, but the rule will still write the
calculated results to the Periodic view.
Setting the Scope of the Data-set
Click the Add (+) icon below the Scope bar to add a dimension to the Source POV
filter definition. Select one of the available dimensions. Select the Member Selector
17-60
Chapter 17
Creating Consolidation Rules
icon, , from the right side of the new dimension row or type in the name of the
required dimension. From the Member Selector, select one or more members or lists.
Specifying members in the Source POV will restrict the data-set to which the rule-set
will be applied. The Entity and Intercompany dimensions also provide a Consolidation
String selection for #Legal Company# and the Intercompany dimension provides for
#Any ICP that is a descendant of the current parent#. See Consolidation Strings.
The rule-set Source POV will be inherited by any rule that is created within the rule-
set. You cannot edit the inherited Source POV in the individual rules.
17-61
Chapter 17
Creating Consolidation Rules
value to any data value already posted to the destination. See Rule Processing
Option.
10. Rule Source POV: This is inherited from the rule-set and cannot be modified in
the rule.
11. Optional: To define a redirection of the data, click Redirect Members. See Rule
Redirection.
12. Optional: If Partner Eliminations has been enabled for the rule-set, after selecting
Redirect Members, select Enable Partner Elimination.
13. To save the rule, click Save and Close, or to continue creating rules, click Save
and Continue.
17-62
Chapter 17
Creating Consolidation Rules
Rule Redirection
When the data defined by the Source POV is processed, the data values are multiplied
by the factor and posted to the Elimination Consolidation dimension member. If no
redirection is defined, then the POV of the Destination will be the same as the
Source (other than the Consolidation member). The posting of the data can, however,
be redirected to a different member of one or more of the sub-cube dimensions:
Account, Intercompany, Movement, Data Source, Multi-GAAP (if applicable), or any
user-created Custom dimension.
To define a rule redirection:
1. From the Create Rule screen, click Redirect Members.
The Source POV section of the screen will be split into the inherited Source POV
on the left, and a Redirection column on the right.
2. In the Redirection column, the default redirection member is displayed as "Same
as source". You can add a redirection member by selecting a base member of the
dimension from the member selector.
When posting to the Elimination Consolidation dimension member, the member from
the Source POV will be replaced by the selected redirection member.
The Intercompany dimension also provides a Consolidation String selection for
#Source POV Entity#. If you select this string, then the Intercompany member used
for redirection will be the Intercompany equivalent of the Entity in the Source POV
("ICP_<Source POV Entity>"). See Consolidation Strings.
You can apply different redirect members based on one or more conditions.
To add a condition to a redirection dimension:
1. Click the Add (+) icon at the right side of the column.
2. Create a condition to which to apply to a data point in order to determine the
redirection.
• If the condition is met, then the data is posted to the first redirection member.
• If the condition is not met, then the data will be posted to the second
redirection member.
Select the redirection members from the Member Selector or leave as "Same
as Source", as required.
3. Continue to add conditions and redirection members as required by selecting the
Add (+) icon, or remove existing conditions by selecting the Delete (x) icon.
The conditions for each of the redirection entries are created using the same method
as the rule-set condition. See Creating Consolidation Rule-sets.
17-63
Chapter 17
Creating Consolidation Rules
Partner Eliminations
If the rule is to write data to a partner, first select the Redirect Members button and
then select Enable Partner Elimination. For a Partner Elimination rule, the redirection
entry for the Entity, Intercompany and Data Source dimensions will be pre-set and
cannot be changed.
Entity redirection
#Source POV Intercompany#
Intercompany redirection
#Source POV Entity#
Data Source redirection
Partner Eliminations
When the entity is processed and an eligible data-point is encountered, the Partner
Elimination rule will write a data-point to the Elimination consolidation member of a
sibling of the entity being processed. If the intercompany partner itself is a sibling
of the current entity, the data will be written to the partner but if not, will be written
to any ancestor of the partner that is a sibling of the current entity. The POV of the
data-point written will include the entity of the source data-point as the intercompany
partner and will always be written to the Partner Eliminations Data Source member
("FCCS_Partner Eliminations").
When Partner Elimination data is written to the Elimination member of a sibling,
the calculation status of that sibling is not impacted in the current period, but is
impacted in future periods. When the entity creating the partner elimination entry is
re-consolidated, any data written to any sibling from that entity is first cleared and then
re-posted as required. The posting and clearing of data in the Partner Elimination Data
Source member of the Elimination Consolidation member is in effect "owned" by the
entity that writes that data (identified by the intercompany entry) and not by the entity
in which the data resides.
Note that if the partner of a data-point exists in multiple places in the entity hierarchy
(that is, shared ownership) then one source data-point might generate multiple
partner elimination entries, at a single generation of the source entity or at multiple
generations.
Watch the following video for information on creating consolidation rules:
17-64
Chapter 17
Consolidation Strings
Consolidation Strings
The following sections list the consolidation strings that can be used in consolidation
rule-sets and rules. Consolidation strings provide logical references and can be
selected from the dimension member selector.
To include consolidation strings:
1. Create a rule or rule-set.
See Creating Consolidation Rule-sets and Creating Consolidation Rules.
2. From the bottom of the Member Selector dialog box, select Members.
3. From the drop-down options, select Consolidation Strings, then select a string.
• #Legal Company#
The Legal Company string determines whether the current Entity or Intercompany
member represents a Legal Company. All base entities are Legal Companies.
You can use the Legal Company string for the Entity or Intercompany dimensions
in a rule condition or in the Source POV.
• #Any ICP that is a descendant of the current parent#
This string can be used in the Intercompany dimension Source POV and restricts
the in-scope data-set to those data-points that have an Intercompany dimension
entry that represents a descendant of the parent entity of the Entity currently being
processed.
• #Source POV Entity#
This string can be used in the Intercompany dimension redirection. The
Intercompany member used to write the data will be the Intercompany equivalent
to the Entity in the Source POV ("ICP_<Source POV Entity>").
If the Source POV Entity has not been designated as a valid Intercompany
member (and the "ICP_<Source POV Entity>" member does not exist), then
the redirection will be ignored and the data will be written to the Source POV
Intercompany member. If the Source POV Intercompany member is a parent
member, then the rule and consolidation process will fail.
Viewing Rule-Sets
From the Configurable Consolidation page, you can view rule-sets and rules.
You can also deploy and undeploy rule-sets, and duplicate or delete rule-sets and
rules. See these topics:
• Deploying and Undeploying Rule-Sets
• Duplicating and Deleting Rule-Sets
To access the Configurable Consolidation page:
1. On the Home page, click Application and then click Consolidation.
2. From the Consolidation Process page, select the Consolidated tab, and then
select Configurable Consolidation.
17-65
Chapter 17
Deploying and Undeploying Rule-Sets
To view the Rule-sets by Status, select the appropriate option from the Status drop-
down list:
• All Rules
This option displays all rule-sets. If a rule-set has been deployed and then
changed but not yet redeployed, the Changed status icon is displayed next to
the rule-set name.
You can open and view any of the displayed rule-sets.
System rule-sets: You can view, duplicate, deploy and undeploy.
Non-system rule-sets and rules: You can view, modify, duplicate, deploy and
undeploy.
If you open a Changed rule-set, the changes not yet deployed are displayed and
you can make additional changes.
If you open and modify a deployed and not changed rule-set, a "changed" copy of
the rule-set is created when saved.
• Deployed
This option displays all deployed rule-sets. If a rule-set has been deployed and
then changed but not yet redeployed, the Deployed status icon is displayed next to
the rule-set name and the details of the deployed rule-set are displayed.
You cannot make any changes to deployed rule-sets in this view. To modify a
rule-set that has been deployed, open the rule set in the All Rules view.
You can undeploy rule-sets from this view.
• Undeployed
This option displays all rule-sets that are not deployed. If a rule-set is undeployed
and then changed, the status icon remains unchanged.
You can deploy rule-sets from this view.
• Changed After Deploy
This option displays all rule-sets that have been deployed and then changed but
not yet redeployed. The details of the rule-sets and rules reflect the changes made
since the previous deployment. You can make additional changes in this view.
You can deploy changes to rule-sets and rules from this view. If the changes are
not deployed, then the previously deployed version will remain active.
17-66
Chapter 17
Duplicating and Deleting Rule-Sets
• A rule-set that has been created and deployed is "Deployed" (identified by a green
circle with a check-mark)
• A rule-set that has been created and deployed and then changed is "Changed, yet
to be redeployed" (indicated by a yellow triangle with an exclamation mark)
Any rule-set that has been deployed and then changed, but not yet redeployed,
also exists in its original deployed state. When the changed rule is deployed, then
it replaces the previously deployed version.
Note:
Duplicating Rule-Sets
To duplicate a rule-set, or rule within a rule-set:
1. From the Configurable Consolidation list of rule-sets, select the row and click .
2. To duplicate a rule-set or rule, click Duplicate.
3. To duplicate both a rule-set and the rules within that rule-set, click Duplicate with
Rules.
17-67
Chapter 17
Re-ordering Rule-sets and Rules
Note:
To change the name of a rule-set or rule, the rule-set must be undeployed.
Changes to other fields do not require that the rule-sets be undeployed.
Deleting Rule-Sets
To prevent a referential integrity problem with configurable consolidation rules from
occurring in the application, Financial Consolidation and Close verifies and prevents
the deletion of any metadata member that is referenced in the rule.
When you delete a dimension member from the application, if the member is
referenced in a configurable consolidation rule, the system displays a Failure error
and the member is not deleted.
To delete a rule-set, or rule within a rule-set:
1. From the Configurable Consolidation list of rule-sets, select the row and click .
2. To delete the item, click Delete.
If the rule-set or rule has been deployed and then changed, both the deployed and
changed items will be deleted.
Note:
When you change the sequence of the user-defined rule-sets, it might
have an impact on the results if the source data for one or more of the
rule-sets includes the current period Elimination data, and the source data
of a subsequent rule-set includes the target data of a previously executed
rule-set.
17-68
Chapter 17
Seeded Consolidation Rules
17-69
Chapter 17
Seeded Consolidation Rules
and Owner's Equity (Equity) PP) provide adjustment/elimination entries between the
Investment of a holding company in a subsidiary and the Owner's Equity of that owned
company, whether consolidated by the Subsidiary method (recognizing Minority/Non-
Controlling Interest), the Proportional method or the Equity method.
The Goodwill - Offset asset account is used as the clearing/plug account between
the investment and owner's equity adjustments. If the holding company investment
amount and the owned company pre-acquisition Owner's Equity amount(s) do not
match, the difference will be recorded as Goodwill.
The Owner's Equity (Holding) rule-set prepares the Owner's Equity data of a Holding
company for subsequent elimination if the Holding company becomes a subsidiary at a
higher level in the organization structure.
Net Income (Subsidiary) and Net Income (Equity) rule-sets record the ongoing Net
Income impact for a Subsidiary (Minority interest) and an Equity company (Equity
income).
Pre-conditions for the Seeded Rule-Sets
The seeded rule-sets use the Intercompany dimension to track the legal entity
(currently the base entity) to which elimination entries are related. All base entities
must therefore be designated as Intercompany entities (select the "ICP_Entity_Yes"
attribute in the Entity dimension level 0 members) so that they exist in the
Intercompany dimension in the form "ICP_<entity name>".
The data entered for Investment in Subsidiaries in the Holding Company must include
an Intercompany dimension entry that identifies the owned entity. Data entered to
Owner's Equity accounts do not need an Intercompany entry.
Watch the following video for information on seeded consolidation rules:
Investment Rule-Set
The Investment rule-set consists of two rules/journal detail lines.
This rule-set transfers current period Investments to Goodwill for all Intercompany
partners representing siblings. The Goodwill entry will offset with the elimination of
Owner's Equity from the partner, leaving a net Goodwill value (if any).
Data posted to the Investment in Subsidiaries ("FCCS_Investment in Sub") account
must include an Intercompany partner representing the company in which the
investment is held in order for this rule to execute. The account can be set as an
"Intercompany" account through metadata maintenance but no "plug" account should
be selected. If a "plug" account is entered to the Investment in Subsidiaries account,
then both the Standard Eliminations and Investment rule will execute, doubling the
elimination.
17-70
Chapter 17
Seeded Consolidation Rules
Entry Description
Condition( (Entity Current Method = Holding Or Entity
Current Method = Subsidiary Or Entity Current
Method = Proportional And FCCS_Total Data
Source < > 0 And Intercompany Consolidation
> 0 Or Intercompany Consolidation % Change
< > 0 Or Partner Current Method = Equity)
Factor Current \ Entity Consolidation %
Dimension Source POV
Account "FCCS_Investment in Sub"
Intercompany #Any partner that is a descendant of the
current parent#
Movement Base of "FCCS_ClosingBalance" Excluding
"FCCS_OpeningBalance"
Data Source Base of "FCCS_TotalDataSource"
17-71
Chapter 17
Seeded Consolidation Rules
Investment PP Rule-Set
The Investment PP rule-set consists of two rules/journal detail lines.
This rule-set transfers accumulated prior period (or more specifically current Opening
Balance) Investments to Goodwill for all Intercompany partners representing siblings.
The Goodwill entry will offset with the elimination of Owner's Equity from the partner,
leaving a net Goodwill value (if any).
Data posted to the Investment in Subsidiaries ("FCCS_Investment in Sub") account
must include an Intercompany partner representing the company in which the
investment is held in order for this rule to execute. The account can be set as an
"Intercompany" account through metadata maintenance but no "plug" account should
be selected. If a "plug" account is entered to the Investment in Subsidiaries account,
then both the Standard Eliminations and Investment rule will execute, doubling the
elimination.
Entry Description
Condition (Entity Current Method = Holding Or Entity
Current Method = Subsidiary Or Entity Current
Method = Proportional And FCCS_Total Data
Source < > 0 And Intercompany Consolidation
> 0 And Intercompany Prior Consolidation % =
0)
Factor Current \ Entity Consolidation %
Dimension Source POV
Account "FCCS_Investment in Sub"
Intercompany #Any partner that is a descendant of the
current parent#
Movement "FCCS_OpeningBalance
Data Source Base of "FCCS_TotalDataSource"
17-72
Chapter 17
Seeded Consolidation Rules
17-73
Chapter 17
Seeded Consolidation Rules
Entry Description
Condition Entity Current Method = Subsidiary,
Proportional and Total Data Source < > 0
Factor None
Dimension Source POV
Account Base of "FCCS_Total Equity" Excluding Base
of "FCCS_Retained Earnings Current", Base
of "FCCS_Other Reserves", "FCCS_CTA"
Intercompany Base of "FCCS_Intercompany Top"
Movement Base of "FCCS_ClosingBalance" Excluding
"FCCS_OpeningBalance"
Data Source Base of "FCCS_TotalDataSource"
17-74
Chapter 17
Seeded Consolidation Rules
Entry Description
Condition Entity Current Method = Subsidiary,
Proportional and Total Data Source < > 0 And
Entity Ownership % Change < > 0
17-75
Chapter 17
Seeded Consolidation Rules
Entry Description
Factor None
Dimension Source POV
Account Base of "FCCS_Total Equity"
Intercompany Base of "FCCS_Intercompany Top"
Movement "FCCS_OpeningBalance"
Data Source Base of "FCCS_TotalDataSource"
17-76
Chapter 17
Seeded Consolidation Rules
17-77
Chapter 17
Seeded Consolidation Rules
Entry Description
Condition Entity Current Method =Equity And Total Data
Sources < > 0
Factor Current / Entity Ownership %
Dimension Source POV
Account Base of "FCCS_Total Equity" Excluding Base
of "FCCS_Retained Earnings Current", Base
of "FCCS_Other Reserves", "FCCS_CTA"
Intercompany "FCCS_No Intercompany"
Movement Base of "FCCS_ClosingBalance" Excluding
"FCCS_OpeningBalance"
Data Source Base of "FCCS_TotalDataSource"
17-78
Chapter 17
Seeded Consolidation Rules
17-79
Chapter 17
Seeded Consolidation Rules
therefore be eliminated to the extent that the Ownership % has changed from the prior
period.
This rule-set offsets with Investment in Subs (from Investment rule-set) and the
two rule-sets use the Goodwill Offset account as the clearing account. The other
side of the entry recognizes the Investment in Equity Companies. There is no
"Reverse Proportionalization" entry because the Consolidation % is zero and nothing
is proportionalized from an Equity method company.
This rule does not rely on any Intercompany data entry in order to execute. It will run at
the first consolidation level (that is, the immediate parent).
Entry Description
Condition Entity Current Method = Equity And Total
Data Sources < > 0 And Entity Ownership %
Change < > 0
Factor Current / Entity Ownership %
Dimension Source POV
Account Base of "FCCS_Total Equity"
Intercompany Base of "FCCS_Intercompany Top"
Movement "FCCS_OpeningBalance"
Data Source Base of "FCCS_TotalDataSource"
17-80
Chapter 17
Seeded Consolidation Rules
Table 17-28 (Cont.) Owners Equity PP- Investment in Equity Companies (Rule)
Entry Description
Condition Entity Current Method = Holding And Total
Data Sources < > 0
Factor Current / Entity Ownership %
Dimension Source POV
Entity #Legal Company#
Account Excluding base of "FCCS_Retained Earnings
Current", base of "FCCS_Other Reserves",
"FCCS_CTA"
Intercompany "FCCS_No Intercompany"
Movement Base of "FCCS_ClosingBalance" Excluding
"FCCS_OpeningBalance"
Data Source Base of "FCCS_TotalDataSource"
17-81
Chapter 17
Seeded Consolidation Rules
Entry Description
Condition Entity Current Method = Subsidiary and Total
Data Sources < > 0
Factor Current / Entity Minority Interest %
Dimension Source POV
17-82
Chapter 17
Seeded Consolidation Rules
Entry Description
Account Base of "FCCS_Retained Earnings
Current", base of "FCCS_Other Reserves",
"FCCS_CTA"
Intercompany Base of "FCCS_Intercompany Top"
Movement Base of
"ILvl0Descendants([FCCS_ClosingBalance]"
Excluding "FCCS_OpeningBalance"
Data Source Base of "FCCS_TotalDataSource"
17-83
Chapter 17
Seeded Consolidation Rules
This rule does not rely on any Intercompany data entry in order to execute. It will run at
the first consolidation level (that is, the immediate parent).
Entry Description
Condition Entity Current Method = Equity and Total Data
Sources < > 0
Factor Current / Entity Ownership %
Dimension Source POV
Account Base of "FCCS_Retained Earnings
Current", base of "FCCS_Other Reserves",
"FCCS_CTA"
Intercompany Base of "FCCS_Intercompany Top"
Movement Base of
"ILvl0Descendants([FCCS_ClosingBalance]"
Excluding "FCCS_OpeningBalance"
Data Source Base of "FCCS_TotalDataSource"
Table 17-37 Net Income (Equity) - Investment in Equity Company Income (Rule)
17-84
Chapter 17
Seeded Consolidation Rules
The data displayed in the following examples use positive numbers to represent
debit entries and negative numbers to represent credit entries. This should make
the calculations in the examples easier to understand without having to reference
metadata attributes, and will be valid regardless of the account type and consolidation
operators in the metadata.
The negative entries shown for the Common Stock accounts would actually be loaded
as positive numbers to an application for which Common Stock is an "Equity" type
account. Credit balances for Common Stock, represented in the examples by negative
numbers, would be loaded to an application as positive amounts because credits in an
Equity type account are represented by positive numbers.
17-85
Chapter 17
Seeded Consolidation Rules
17-86
Chapter 17
Seeded Consolidation Rules
17-87
Chapter 17
Seeded Consolidation Rules
17-88
Chapter 17
Seeded Consolidation Rules
17-89
Chapter 17
Seeded Consolidation Rules
17-90
Chapter 17
Seeded Consolidation Rules
17-91
Chapter 17
Seeded Consolidation Rules
17-92
Chapter 17
Seeded Consolidation Rules
17-93
Chapter 17
Seeded Consolidation Rules
17-94
Chapter 17
Seeded Consolidation Rules
17-95
Chapter 17
Seeded Consolidation Rules
17-96
Chapter 17
Seeded Consolidation Rules
17-97
Chapter 17
Seeded Consolidation Rules
17-98
Chapter 17
Seeded Consolidation Rules
17-99
Chapter 17
Seeded Consolidation Rules
17-100
Chapter 17
Seeded Consolidation Rules
17-101
18
Working with Rules
Related Topics
• Consolidation and Translation Rules
Financial Consolidation and Close provides pre-built calculation scripts to handle
consolidation and translation.
• Selecting Business Rules
• Assigning Access to Rules
• Disabling View Calculations
• Updating View Calculations
• Working with Override Translation Rules
• Working with Configurable Calculations
• Equity Pickup Overview
• Working with On-Demand Rules
• Working with Essbase Calc Script
Essbase Calc Script is the language available to you to write your own custom
business logic in Financial Consolidation and Close.
• Supported Essbase Functions
• Financial Consolidation and Close Custom Functions
18-1
Chapter 18
Selecting Business Rules
• FCCSFormStatusProcessor
• RefreshDatabase_PostProcess_Consol
• RefreshDatabase_DelegatePostProcess
• ComputeRates
• RefreshDatabase_PostProcess_Rates
• ClearEmptyBlock
You can filter the list of rules by Cube and Rule Type.
To view the list of rules:
1. On the Home page, click Rules.
2. To filter the list of rules, click the Filter icon.
3. From the Cube drop-down list, select a Cube: Consol or Rates, or use the default
of All.
4. From the Rule Type drop-down list, select a type, or use the default of All:
• Scripts
• Rules
• Rulesets
• Templates
5. Click Apply to apply the filter.
18-2
Chapter 18
Assigning Access to Rules
4. Click .
5. Perform a task:
• To add access, click Add , and then select from the list of available users
and groups.
For Type of Access:
– Select Launch to allow the selected users and groups to launch the
selected rules.
– Select No Launch to prevent the selected users and groups from
launching the selected rules.
• To edit access, click , and then select the applicable Type of Access.
• To remove access, select the users or groups for which to remove access, and
then click .
18-3
Chapter 18
Updating View Calculations
18-4
Chapter 18
Working with Override Translation Rules
Note:
Starting with the 21.04 update, the sequence in which Financial
Consolidation and Close executes translation steps has changed.
Translation Override rules are now executed before Amount / Rate override
entries. The new default translation sequence may reduce the need to
amend a translation rule when applying an override amount or rate that
occurs within the scope of the translation rule.False.
If you want to retain the older translation sequence, you can create a
Substitution Variable named skipTransRulesIfOverrideRatesExist and set
the value to False.
Starting with the 21.04 update, the sequence in which Financial Consolidation and
Close executes translation steps has changed. Translation Override rules are now
executed before Amount / Rate entries. If you want to retain the older translation
sequence, you can create a Substitution Variable named
18-5
Chapter 18
Working with Override Translation Rules
18-6
Chapter 18
Working with Override Translation Rules
When you create a translation rule, you can specify redirection to a different
destination member. The Source POV can include any members, including parent
or system members. The Parent member can only be selected as part of a function
list and must have redirection to a base member. You cannot select a single Parent
member.
The Redirection POV must be a base member and not a system-calculated member,
such as Opening Balance or FX Opening. If you do not specify a redirection member,
the system will process the translation and write to the same dimension members as
the source.
Reporting Currency
The translation rule applies to the selected entity when translating to all of its parents
with the same currency. For example, if Entity1 has two parents P1 and P2, and both
P1 and P2 have the same currency, the translation rule applies to both P1.Entity1, and
P2.Entity1. The translation rule also applies to all reporting currencies.
18-7
Chapter 18
Working with Override Translation Rules
Replace Option
If you have multiple transaction rules with the same referenced POV and select the
Replace option, the system uses the last translation rule.
For example, the first translation rule contains Acct1 that translates using PERIODIC
and MyRate. A second translation rule contains the same Acct1, but translates using
YTD and MyRate. The third translation rule contains the same Acct1 using PERIODIC
and NewRate. Since the third translation rule is the last one with Acct1 reference, the
system uses the third rule for translation.
Add Option
The Add option is used for accumulating translation override rules.
If you have multiple transaction rules with the same referenced POV and select the
Add option, the rule accumulates to the override translation amount.
For example, the first translation rule contains Acct1 that translates using PERIODIC
and MyRate. A second translation rule contains the same Acct1 but translates
using YTD and MyRate. The third translation rule contains the same Acct1 and
uses PERIODIC and NewRate. If all these rules have the Add option, the system
accumulates all the translation override results. The override translation will always
replace the default translation value.
Subtract Option
If you have multiple transaction rules with the same referenced POV and select the
Subtract option, the rule subtracts from the previous override translation amount.
For example, the first translation rule contains Acct1 that translates using PERIODIC
and MyRate. A second translation rule contains the same Acct1 but translates using
YTD and MyRate. If these rules have the Subtract option, the system will subtract from
the previous translated override result. The override translation will always replace the
default translation.
18-8
Chapter 18
Working with Override Translation Rules
The Deployed view displays all the rules that are currently deployed to the system.
This view is read-only. You cannot remove or modify any rules from this view.
5. To add a new translation rule, click the Add (+) icon.
6. Enter a name for the translation rule and a description.
7. From Translation Method, select Periodic or Year to Date.
8. From Rate Information, select a Rate account or a specific amount:
• FX Rates - Average
• FX Rates - Ending
• Specific Rate, then enter a rate.
By default, the current Scenario, Year and Period are used to determine the rate
account value.
Optional: Click Advanced to specify different values for these dimensions.
9. Click Scope, and then select the Source members for the rule.
You must select at least one dimension to create the rule. You can select
additional dimensions using the Add (+) icon, or remove dimensions using the
Remove (X) icon. The members specified in the source are written to the same
member as the target unless you select Redirect Members.
You cannot create an override translation rule with parent or calculated members.
The View dimension is not available for override translation rules.
10. Optional: To enable redirection to a target, click Redirect Members, then click
the Add + icon to display the member selector and select members for the Target
Redirection.
Scenario, Year, Period, Entity and Data Source dimensions are not available for
redirection.
From the Actions menu on the right side, you can click Add Exclusion to exclude
specific members, or Delete or Clear members.
For each dimension that you add to source, you can select the Redirect Members
option. If you want to later remove redirection, click Remove Redirection to clear
the redirection information.
11. From Processing Option, select an option:
• Replace
• Add
• Subtract
12. Click Save and Close or Save and Continue.
18-9
Chapter 18
Working with Override Translation Rules
Note:
When a translation rule is deployed, the calculation status changes from OK
to System Change. This applies to both locked and unlocked entities.
Internally, when a rule is first created, it will not be part of the consolidation process.
However, once a rule is deployed in the application, it will be included in the
consolidation process.
1. On the Home page, click Application and then click Consolidation.
2. From the Consolidation Process page, select the Translated tab.
3. From the list of rules, select Translation Overrides.
By default, the Manage Translation Override Rules page lists all the translation
rules available in the application.
4. Click Deploy to open the Deploy Rules window.
The Deploy Translation Rules window is displayed, and all the rules that were
previously deployed are automatically selected.
5. Select the rules you want to deploy, and unselect rules that you no longer want
deployed.
If you uncheck an already selected rule and deploy the rules, the unchecked rule
will be un-deployed from the system.
6. From the Deploy Rules window, click Deploy to deploy the rules.
Note:
You must be a Service Administrator to create, edit, or delete user-defined
Rate accounts.
Power Users and other Users are not able to access Translation Rules and
cannot view or modify any user-defined Rate accounts.
See these topics:
• Editing User-Defined Rate Accounts
• Deleting User-Defined Rate Accounts
18-10
Chapter 18
Working with Override Translation Rules
• Local Rate
Guidelines for Global Rate Accounts
You can create a maximum of three new Global Rate accounts (for a total of five
Global Rate accounts).
After you create a new Global Rate account, or perform any account maintenance
on one, you must perform a Refresh Database. When you refresh the database, the
system updates the "Entered Exchange Rates" and the "Exchange Rates" account
hierarchies.
The new user-defined Global Rate account is inserted as a child member of "Entered
Exchange Rates". It is a level 0 member of that hierarchy, and a sibling to the two
existing system Rate accounts - Average Rate and Ending Rate. It has the same
properties as the system Rate accounts.
When you create new Global Rate accounts, these seeded system Rate forms
automatically include the newly defined accounts:
• Enter Exchange Rates – Multi Period
• Enter Exchange Rates – Single Period
• Exchange Rates
Rate data entered to Global Rate accounts is applied to all entities.
The system automatically computes rates if any cell has been edited on a form
targeting the Rates cube. It computes the rates for all Global Rate accounts, including
the new user-defined Global accounts. All of the computed Global Rate data is stored
in the Rates cube and can be viewed in the seeded Data Forms.
Guidelines for Local Rate Accounts
After you create a new Local Rate account, or perform any account maintenance
on one, you must perform a Refresh Database. When you refresh the database, the
system updates the "Entered Exchange Rates"and the "Exchange Rates" account
hierarchies.
The new user-defined Local Rate account is inserted as a child member of Exchange
Rates -> Local rates. It is a level 0 member of that hierarchy.
When you create new Local Rate accounts, the Local Exchange Rates seeded Rate
form automatically includes the newly defined accounts.
The seeded Local Exchange Rates data form allows you to enter rate data related to
the different currencies being translated. Only Direct rate is supported for Local Rate
accounts. No indirect rates or cross rates are computed.
You can enter Local Rate data for a base or a Parent entity. You can specify different
Local Rates when translating to different Reporting Currencies.
Note:
The "Global Assumptions" entity is not valid for Local Rate data.
All of the computed Local Rate data is stored in the Consol cube.
18-11
Chapter 18
Working with Override Translation Rules
Note:
The Alias information is used in the Default Alias table.
Note:
You must be a Service Administrator to create, edit, or delete user-defined
Rate accounts.
18-12
Chapter 18
Working with Configurable Calculations
Note:
You must be a Service Administrator to create, edit, or delete user-defined
Rate accounts.
18-13
Chapter 18
Working with Configurable Calculations
• To create, modify, and delete rules, you must be the Service Administrator.
• To view rules, you must be a Service Administrator or Power User.
See these topics:
• Creating Configurable Calculations
• Configurable Calculation Rules
• System Calculations
Note:
To create calculations, you must be a Service Administrator.
You can edit an existing calculation rule at any time if you have the Service
Administrator role. You cannot remove any of the seeded calculation rules. If the rule is
no longer needed, you can delete the content from the rule.
You can only create calculations at the pre-defined insertion points.
You cannot modify the calculations that are performed by the system. However, you
can override some system calculations. See System Calculations.
To create configurable calculations:
1. On the Home page, click Application, and then click Consolidation.
2. From the Consolidation Process page, select the tab for which to create
calculations: Local Currency, Translated (if multi-currency application), or
Consolidated.
The Consolidation Process page displays a list of applicable system and user-
defined calculations in the order in which they are executed.
3. When you select a rule, the rule Properties are displayed in the right panel. To
view the description of a rule, on the right panel, click the Information tab .
4. On the Consolidation Process page, click on an insertion point in the list of rules
18-14
Chapter 18
Working with Configurable Calculations
to create missing blocks for the configurable calculation. Changing this value will
mark the Calculation Status as System Change. To continue, click OK.
Note:
This option applies to non-Extended Dimension applications only.
Enabling the Auto Create Blocks option may affect calculation
performance. For details on this option, see Enabling Auto Create Blocks
for Configurable Calculations.
6. The system opens Calculation Manager in a separate tab in the browser. Expand
the "Planning" folder and navigate to the "FCCS Consol Rules" folder rules. These
are the rules that you are allowed to edit.
7. Drill down to the rule that corresponds to the insertion point.
For example, the Calculation Manager rule: FCCS_10_After Opening Balance
Carry Forward_LocalCurrency
corresponds to the After Opening Balance Carry Forward insertion point.
For a list of rules and corresponding insertion points, see Configurable Calculation
Rules.
18-15
Chapter 18
Working with Configurable Calculations
or Impacted remains the same. You must run the consolidation process to see the
impact of the new calculations.
Note:
If you are using Bottom-Up processing (@CALCMODE(BOTTOMUP) in your
custom calculation, do not enable Auto Create Blocks for that custom
calculation. Bottom-Up processing (@CALCMODE(BOTTOMUP) and Auto
Create Blocks are mutually exclusive features.
The system creates a data block for each unique combination of Sparse standard
dimension members. The data block represents all the Dense dimension members for
its combination of Sparse dimension members.
Assume you have four dimensions in your application:
The application has six Sparse and two Dense members. Assume all Sparse members
are of the Stored type.
All members of a Dense dimension constitute a block. So a block for this application
will look like this:
Data for ‘Sales’
This type of block will exist for each combination of stored Sparse members in your
application:
18-16
Chapter 18
Working with Configurable Calculations
Note:
Enabling the Auto Create Blocks option may affect calculation performance.
18-17
Chapter 18
Working with Configurable Calculations
Multi-Currency Applications
If you have a multi-currency application, the Consolidation Process page displays
three tabs: Local Currency, Translated, and Consolidated.
The tabs depict the consolidation flow that Financial Consolidation and Close follows.
It first performs calculations for base-level members in their local currency, then
performs the translation to parent currency, and finally performs the consolidation.
Single Currency Applications
If you have a single currency application, the Consolidation Process page displays two
tabs: Local Currency and Consolidated.
Calculation Rows
Each of the tabs on the Consolidation Process page displays multiple rows that depict
in order, the flow of calculations that are performed. Each row is marked by one of
these icons:
• — Insertion point for user-defined rule. Represents the point in the process
where you can insert your calculations from Calculation Manager.
When you select any of the rules in the list, the system displays a Properties panel on
the right with information such as the rule name, the consolidation members for which
the rule would be processed, and any override specifications, if applicable.
When you click on a row where you can insert a user-defined calculation, Calculation
Manager opens in a separate tab in the browser.
Example:
1. From the Local Currency tab, click on either After Opening Balance Carry
Forward or Final Calculations.
The system opens Calculation Manager.
2. Expand the "Planning" folder on the left side until you see the FCCS Consol
seeded rules in Calculation Manager, for example:
• FCCS_10_After Opening Balance Carry Forward_LocalCurrency
• FCCS_20_Final Calculations_LocalCurrency
3. The Calculation Manager rules correspond to the Configurable Calculation rows.
For example:
• The Calculation Manager rule: FCCS_10_After Opening Balance Carry
Forward_LocalCurrency
corresponds to the: After Opening Balance Carry Forward row, where you
can add your own calculations. These are calculations to be performed after
the Opening Balance Carry Forward calculations, but before balancing the
Balance Sheet.
• The Calculation Manager rule: FCCS_20_Final Calculations_LocalCurrency
18-18
Chapter 18
Working with Configurable Calculations
corresponds to the Final Calculations row, where you can add your own
additional calculations to be performed after the Balance Sheet is balanced.
The following table lists the Financial Consolidation and Close rows for each tab and
the corresponding Calculation Manager rules.
Summary of Configurable Calculation Rules
18-19
Chapter 18
Working with Configurable Calculations
18-20
Chapter 18
Working with Configurable Calculations
System Calculations
If you are a Service Administrator, you can override or disable some system
calculations.
See these topics:
• System Calculation Option for Custom Dimension Top Member
• Opening Balance Carry Forward
• Opening Balance Override Rules
• Balance the Balance Sheet Calculation
• Ratio Calculation
You can also create your own calculation rules to be inserted into the default
consolidation calculation process. See Creating Configurable Calculations.
To override or disable system calculations:
1. On the Home page, click Application, and then click Consolidation.
2. Select the Consolidation Process tab if it is not already selected.
3. Select the tab for which to configure calculations: Local Currency, Translated (if
multi-currency application), or Consolidated.
The Consolidation Process page displays a list of applicable system and user-
defined calculations in the order in which they are executed.
4. When you select a rule, the Properties of the rule are displayed in the right panel.
To view the description of a rule, on the right panel, click the Information tab .
5. Optional: To disable the Balance system calculation for a scenario:
a. From the Local Currency tab, select the "Balance the Balance Sheet" rule.
b. From the right panel, under Disable by Scenario, select a Scenario member
using the Member Selector.
c. Click Save to save the rule.
6. Optional: To enable a disabled system calculation:
a. Select the disabled calculation.
b. Remove the override entry.
c. Click Save to save the rule.
18-21
Chapter 18
Working with Configurable Calculations
Note:
If your application is an Extended Dimension application, you may want to
turn this feature off for better consolidation performance.
The option applies to the following System Calculations for all applicable currency
members such as Entity Currency, Parent Currency and Reporting Currency:
• Opening Balance
– Includes both Opening Balance for movement and Retained Earnings Prior
calculation
– Opening Balance Ownership Change
• Foreign Exchange (FX) Calculations (for multi-currency applications)
– FX Opening
– FX Movement
– FX to Cumulative Translation Adjustment (CTA)
• Balance Calculation
During the Translation process, the translation from Entity Currency to Parent
Currency, and from Parent Currency to Reporting Currency, will continue to calculate
at the Custom detail level. For any Translation Override rules and Configurable
Consolidation rules, the system will process them according to the rule definition.
You can change the option at any time for an existing application. By default, the
option is disabled for all Custom dimensions. When the option is changed, the
system will change the Calculation Status to SC (System Changed), and you can
reconsolidate if needed. Any new system calculations will be performed based on the
currently selected option.
The Task Audit log contains the history of changes to the System Calculation option.
It includes the user who performed the setting change, the date and time it was
performed, and the information that was changed - the original setting and the newly
updated setting.
To set the System Calculation option:
1. On the Home page, click Application, and then click Consolidation.
2. Select the Consolidation Process tab.
3. Select the tab for which to configure calculations: Local Currency, Translated (if
multi-currency application), or Consolidated.
4. Click the Options menu at the top of the page.
5. From System Calculation Options, select the dimensions for which Top Member
processing will be applied, then click Save.
18-22
Chapter 18
Working with Configurable Calculations
18-23
Chapter 18
Working with Configurable Calculations
Note:
The general requirements of the Closing Balance carry forward to Opening
Balance are not applied to any of the accounts within the Retained Earnings
(Total) hierarchy including the Income Statement, Retained Earnings Current,
Retained Earnings Prior, Dividends Declared or any additional accounts
added within the Retained Earnings (Total) hierarchy. The carry forward of
Total Retained Earnings at the end of a year to the Opening Balance of the
following year is always applied to the following year first period Retained
Earnings – Prior account only.
18-24
Chapter 18
Working with Configurable Calculations
Watch the following tutorial for more details on how to specify a different scenario from
which to source the Closing Balance.
18-25
Chapter 18
Working with Configurable Calculations
18-26
Chapter 18
Working with Configurable Calculations
• Modify the entry by including only the Scenarios for which you want the
calculation disabled, for example, Consol,Forecast,ActBudDiff.
Note that there are two lines in the Member Selector.
• The first line is the list of Scenarios that should be disabled. Add the Scenario
that you want to disable on this line.
• The second line is an Exclusion line, which means that any Scenario listed in
the second line is effectively enabled (not disabled).
5. Click Save to save the rule.
6. Re-run the consolidation process.
Applicable Consolidation Members
The system will only process this calculation with local currency data for the Entity
Input Consolidation member.
Ratio Calculation
Most ratios, including Liquidity Ratios, Asset Management Ratios, Profitability Ratios,
and Leverage Ratios, are dynamically calculated as needed. The two performance
Ratios - Days Sales in Inventory, and Days Sales in Receivables, are calculated as
part of the consolidation process.
These performance ratios are calculated as follows.
Days Sales in Inventory = (average inventory/annual cost of sales) * 365
Average inventory equals the inventory balance of the last 13 periods summed and
then divided by 13.
Annual Cost of Sales equals the sum of Cost of Sales for the current period, plus the
preceding 12 periods.
Days Sales in Receivables = 365/ (annual sales/average receivables)
Average receivables equals the receivables balance of the last 13 periods summed
and then divided by 13.
Annual sales equal the sum of sales for the current period, plus the preceding 12
periods.
Applicable Consolidation Members
• Entity Input
• Entity Consolidation
• Elimination Adjustment (member for Ownership Management)
To improve consolidation performance, you can disable the Ratio calculations of
"FCCS_Days Sales in Receivables" and "FCCS_Days Sales in Inventory" for selected
scenarios if you do not use these calculations. This option is only available when the
Asset Management feature is enabled.
To disable the ratio calculations:
1. On the Home page, click Application, then click Consolidation.
2. Select the Consolidation Process tab if it is not already selected.
18-27
Chapter 18
Working with Configurable Calculations
18-28
Chapter 18
Working with Configurable Calculations
status to "System Change" (SC). You must reconsolidate data based on the changes
made to the rule that has been deployed.
Note that the calculations that you define in Calculation Manager cannot be executed
standalone. When the rule is deployed, Financial Consolidation and Close will
insert the script statements of the seeded rule into the appropriate places of the
consolidation logic.
You do not launch rules from within Calculation Manager. In addition, you cannot
include Scenario/Year/Period/Entity as the OUTER FIX statement in your seeded rule
because the selection of Scenario/Year/Period/Entity is determined by the user who
invokes the consolidation from Financial Consolidation and Close. See Working with
Essbase Calc Script.
Data Blocks
The following figure shows a Data Block from a sample application.
• Stored members of dense dimensions constitute a Data Block. Block size for the
sample application above is 2 (Sales and Cash) x 8 bytes = 16 bytes.
• Unique combinations of sparse dimensions members constitute INDEXes and
point to Data Blocks. In the sample application above, there are total of 2 (Actual,
Budget) x 2 (FY17, FY18) x 2 (Jan, Feb)= 8 indexes.
18-29
Chapter 18
Working with Configurable Calculations
Note: To view the database properties, from Calculation Manager, select Action, and
then Database Properties.
18-30
Chapter 18
Working with Configurable Calculations
Separate data blocks are created for each combination of stored Sparse dimensions.
The members in a Dense dimension equal one block.
When you create configurable calculations, you may need to create additional blocks
to store the calculated results and resolve issues with missing data.
You can enable the Auto-Create Blocks option to have the system automatically create
missing blocks. See Enabling Auto Create Blocks for Configurable Calculations.
If you use Bottom-Up processing in your configurable calculations, you should
manually create data blocks or ensure that data blocks already exist.
You can manually create data blocks using one of these methods:
• Assigning data during the data load process. For example, write a "Zero" to a
single Dense member intersection, and then write "#missing" to clear the "Zero"
after block creation.
• Using the Essbase DATACOPY command, in which all blocks from the source are
copied to the destination, including the missing cells. However, this method can
potentially create unnecessary blocks and slow the consolidation process.
18-31
Chapter 18
Working with Configurable Calculations
Data exists in Actual, FY16, P12, ML_HFM. The data is being pulled from Oracle
Hyperion Financial Management, and has not been loaded in Actual, FY16, P1,
ML_HFM. The data must be retrieved from the prior year's P12 period, and a reversal
entry should be reflected at Actual, FY17, P1, ML_HFM_Calc.
The calculation script is as follows:
No journals have been posted ("FCCS_Journal Input" in P13. The code is expected to
take the following path, with "ML_HFM_Calc" as the sparse member anchor:
@SHIFT("P12"->"ML_HFM", -1, @CHILDREN("Years"));
However, this returns #MISSING.
Workaround 1:
18-32
Chapter 18
Working with Configurable Calculations
Workaround 2:
18-33
Chapter 18
Working with Configurable Calculations
18-34
Chapter 18
Working with Configurable Calculations
Period = "ILv10Descendants(YearTotal)"
*The schedule for this scavenge activity must maintain at least a gap of 3-4 hours with
the Daily Maintenance Cycle.
18-35
Chapter 18
Working with Configurable Calculations
The following figure shows the correspnding Configurable Calculation rules from the
Consolidation Process Local Currency tab.
18-36
Chapter 18
Working with Configurable Calculations
18-37
Chapter 18
Working with Configurable Calculations
18-38
Chapter 18
Working with Configurable Calculations
• Block calculation mode is fast, but you need to carefully consider data
dependencies within the block to ensure that the resulting data is accurate.
• CELL mode: In this calculation mode, Essbase calculates each cell sequentially,
following the calculation order, which is based on the outline.
• Cell calculation mode is slower for obvious reasons. However, it ensures accurate
results where data dependencies are concerned.
• When Essbase compiles a formula, it prints a message in the application log file
explaining the mode of execution for the formula similar to the following message:
Formula on member Profit % will be executed in CELL and TOPDOWN mode.
Essbase uses Block mode while calculating a formula, unless it uses functions such
as:
• @ANCEST
• @CURRMBR
• @ISMBR on a dense member
• @MDANCESTVAL
• @MDPARENTVAL
• @MDSHIFT
• @NEXT
• @PARENT
• @PARENTVAL
• @PRIOR
• @SANCESTVAL
• @SPARENTVAL
• @SHIFT
• @XWRITE
To manually induce Block mode, use @CALCMODE(BLOCK). Ensure there are no
data dependencies within your dense block.
Example of Block Mode
Perform the following calculation, based on month:
• January - Sales Synergies is the sum of the children of Returns and Allowances
• Februrary - Sales Synergies is the sum of children of Returns and Allowances -
multiply by 20%
• Remaining months - Sales Synergies is the sum of the children of Returns and
Allowances - multiply by 10%
Block Mode
18-39
Chapter 18
Working with Configurable Calculations
February - Sales Synergies is the sum of the children of Returns and Allowances -
multiply by 20%
Remaining months - Sales Synergies is the sum of the children of Returns and
Allowances plus the prior period's Sales Synergies. Multiply the entire result by
10%.
CELL Mode
Block Mode
18-40
Chapter 18
Working with Configurable Calculations
18-41
Chapter 18
Working with Configurable Calculations
18-42
Chapter 18
Working with Configurable Calculations
18-43
Chapter 18
Working with Configurable Calculations
18-44
Chapter 18
Working with Configurable Calculations
18-45
Chapter 18
Working with Configurable Calculations
18-46
Chapter 18
Working with Configurable Calculations
Note that in this example, you have a FIX on "FCCS_Intercompany Eliminations", but
override it with "Data Input" in the member block, and the system will not return an
error during validation.
18-47
Chapter 18
Working with Configurable Calculations
18-48
Chapter 18
Working with Configurable Calculations
18-49
Chapter 18
Working with Configurable Calculations
If you are using an Extended Dimensionality environment, to make sure using the
Custom Top Member does not slow down performance, you can create an empty block
at "NoCustomX" at the beginning of the consolidation based on the Entity Input and
Entity Currency data, and use that block to perform all the calculations. For example,
if you have 1000 Custom members in the Product Custom dimension, you can create
one block @"No Product", FIX on "No Product", and use Bottom-Up processing.
The system then does not need to loop through all 1000 members of the Product
dimension, and you can use "Total Product" for the total value to improve overall
performance.
The following example shows a sample Calc Script:
18-50
Chapter 18
Working with Configurable Calculations
Calculation Dependency
You should avoid dependencies between entities when calculations are done in
Insertion Points and On-Demand Rules. If you try to reference Entity A's value in the
calculation, and if Entity A has not yet been calculated, Entity A would have no value.
For example, if you try to reclassify data from "Entity A" > "ICP_B" > "Entity Currency"
(source) to "Entity B" > "ICP_A" > "Entity Currency" (destination), data in Entity A
(source) may not be available, since it may not have been calculated, if both entities
Entity A and Entity B are being calculated in parallel.
Therefore, in such cases, the reclassification should be attempted by first calculating
Entity A and then dependent Entity B.
18-51
Chapter 18
Working with Configurable Calculations
18-52
Chapter 18
Working with Configurable Calculations
1. CALC DIM, CALC ALL, AGG, and any other assignment-free expressions that
calculate a sub-tree. A best practice is to limit use of CALC DIM and AGG to
dimensions where no stored members are dependent on dynamic members.
2. Do not use CREATENONMISSINGBLOCK or CREATEBLOCKONEQ in
calculation scripts.
3. Avoid using these functions inside insertion points:
• @ALLOCATE
• @CREATEBLOCK
• @IRREX
• @MDALLOCATE
• @MDSHIFT
• @MOVSUMX
• @PTD
• @SANCESTVAL
• @STDEV
• @STDEVP
• @STDEVRANGE
• @SYD
• @TREND
18-53
Chapter 18
Working with Configurable Calculations
1. Top members are Dynamic Calc, and cannot be used in FIX expressions, so use
them on the right hand side of calculation and redirect result to "No <member>".
2. A single dense dimension member that stores the result of calculation, is to be
placed in FIX.
18-54
Chapter 18
Working with Configurable Calculations
The calculation does not perform well due to the following reasons:
1. The right-hand side calculations are basically queries to Essbase, because most
parent members of the respective dimensions are Dynamic Calc.
2. In the above case, two simultaneous queries are being launched, and only when
results are fetched, will the actual calculation initiate., which leads to a slow
formula cache.
3. The above script executes for every entity, during a consolidation, irrespective of
entity level.
Revised Calculation
The following example shows a revised calculation.
Script Improvements
• Each query calculation is segregated as a separate FIX, and destination dense
member is moved to FIX
• Script executes only on level zero entity, during a consolidation
18-55
Chapter 18
Working with Configurable Calculations
18-56
Chapter 18
Equity Pickup Overview
18-57
Chapter 18
Equity Pickup Overview
This accounting method when applied to reporting by a legal company will be referred
to as Equity Pickup (EPU) to distinguish it from the equity consolidation method.
Equity Pickup is applied to the investments made and recorded by a legal company
in their legal company records. The equity consolidation method is used when a legal
company aggregates data from the companies in which it has a direct or indirect
ownership and reports the consolidated results. The principle behind Equity Pickup
accounting and the equity consolidation method is essentially the same but is applied
under different circumstances (legal company results vs. consolidated results).
To record the results of Equity Pickup, the holding company’s share of the change
in Owner’s Equity for the period (generally profit or loss of the owned company, less
the holding company’s share of any dividends declared), is recorded in the holding
company’s accounting records as income and as a corresponding increase in the
value of the investment in the associated company. Any share of earnings of indirectly
held companies is recorded by virtue of the owned company’s reported income having
already recorded their equity earnings of all companies that they own.
In complex multi-level ownership structures, a specific sequence of Equity Pickup
calculations is required in order to achieve the correct results. For example, if
company A owns shares in Company B and Company B in turn owns shares in
company C, then the Equity Pickup for company B must be calculated before the
Equity Pickup for company A is calculated, to ensure that the earnings and investment
adjustment made in company B is subsequently reflected accurately in company A.
Prerequisites
The Equity Pickup feature of Financial Consolidation and Close is based on the
following configuration settings and requirements:
• The Entity dimension hierarchy accurately represents the direct ownership
relationships between holding companies and companies for which EPU will be
applied.
• The entities in the Entity dimension can be identified as legal companies.
• There is only one Holding method company under each parent entity and the
entity currency of the Holding company and the parent entity is the same currency.
• If the EPU reported for each Holding company is to be identified by each legal
company in which the holding company has either a direct or indirect ownership
interest then:
All legal companies in the Entity dimension must be flagged as intercompany in
the Entity dimension and exist as level 0 entities in the Intercompany dimension
• If the EPU reported for each Holding company is to be identified by each legal
company in which the holding company has only a direct ownership interest,
with indirect ownership being grouped within "interim" directly owned holding
companies, then:
All legal companies and all parent entities in the Entity dimension must be
specified as Intercompany in the Entity dimension and exist as level 0 entities
in the Intercompany dimension.
See these topics:
• Enabling Equity Pickup
• Equity Pickup Processing
Watch the following video for information on equity pickup:
18-58
Chapter 18
Equity Pickup Overview
Equity Pickup
• From the Enablement screen after application creation. See Enabling Application
Features.
18-59
Chapter 18
Equity Pickup Overview
Note:
You can only enable Equity Pickup if the Ownership Management feature is
enabled.
18-60
Chapter 18
Equity Pickup Overview
Data Source:
The Calculation Setting for the rule will be "Yes"( Active) when EPU is first
enabled.
If the Equity Pickup Calculation Setting is changed to "No" (Inactive), then the
application will revert to non-EPU behavior.
For the Equity Pickup system rule, you can select an alternative Movement
member other than the default member. By default, the system rule uses the
FCCS_Mvmts NetIncome member. An administrator can change the default
entries to single level 0 members under FCCS_Mvmts Subtotal from the
Movements dimension. From Equity Pickup Movement Members, click the Edit
icon to open the Member Selector and select members from the Movements
dimension, and then click OK.
• Add four seeded Configurable Consolidation rule-sets (three in a Deployed state,
one un-deployed)
18-61
Chapter 18
Equity Pickup Overview
18-62
Chapter 18
Equity Pickup Overview
This rule-set gathers source data from the owned company for Total Equity excluding
Equity Company Income.
For each client-created custom dimension, combines all level 0 data into a single "No
<custom>" member for subsequent reporting.
This rule-set can be copied and the copy modified and deployed if required (for further
details on copying and modifying rule-sets, see Managing Consolidation Rule-sets
and Rules). For example, if data is to be reported separately for all level 0 members
of an application-specific custom dimension, then that dimension should be removed
from the Scope of the copied rule-set. The EPU data will then be processed for each
member of that dimension instead of being grouped into a single member. Be aware
that this might have a performance impact on the application.
EPU – Consolidate EPU Source Data
18-63
Chapter 18
Equity Pickup Overview
This rule-set consolidates the source data initially gathered by the first rule-set at the
Ownership % and identifies the source directly or indirectly owned legal company from
which the data was derived
The source legal company is identified by the Intercompany member used when
consolidating the data.
Note that all legal companies must therefore be identified is ICP_Entity_Yes in the
Entity dimension such that a matching base member is created in the Intercompany
dimension.
EPU – Consolidate EPU Source Data Indirect Grouping
18-64
Chapter 18
Equity Pickup Overview
This rule-set consolidates the source data initially gathered by the first rule-set at the
Ownership % and identifies the source directly owned legal company from which the
data was derived.
The source legal company is identified by the Intercompany member used when
consolidating the data.
Note that all legal companies and all parent entities must therefore be identified is
IC_Entity_Yes in the Entity dimension such that a matching base member is created in
the Intercompany dimension.
Either the EPU – Consolidate EPU Source Data rule-set or the EPU – Consolidate
EPU Source Data Indirect Grouping rule-set should be deployed, but not both.
EPU – Reverse Holding Company Data
18-65
Chapter 18
Equity Pickup Overview
This rule-set reverses the Equity Pickup results posted to the holding company when
consolidating to its parent.
The parent member represents the consolidated results of the holding company.
The investment in subsidiaries is recorded by different methods and calculations in
consolidated statements than those used in the legal (holding) company results.
The Reverse Holding Company Data rule-set will be applied to any movements to
which the system rule has written data.
Three of the four seeded consolidation rule-sets provided will be deployed when
Equity Pickup is initially enabled. If the Equity Pickup Calculation Setting is changed
from "Yes" to "No", the deployed EPU rule-sets should be un-deployed by the system
administrator. If the Calculation Setting is changed from "No" to "Yes", then the
required rule-sets (seeded or copied / modified) must be deployed by the system
administrator.
18-66
Chapter 18
Equity Pickup Overview
generation of holding company entities and then the next highest generation of parent
entities... and so on..
The following diagrams show the difference in processing in a very simple hierarchy
(where legal company A owns legal companies B and D, and legal company B owns
legal company C). Equity Pickup processes by generation from the bottom up. The
standard sequencing processes by level from the bottom up:
18-67
Chapter 18
Equity Pickup Overview
However, note that if no data is entered to A, selecting A for consolidation will not
process a consolidation because A itself is not impacted. In this case, to update all
entities, A Consolidated would need to be selected for consolidation as described in
Example 1.
Example Equity Pickup calculation flow and required results
In order to ensure that when an Equity Pickup calculation is executed, the sibling
source entity data has already been updated, entities need to be calculated in the
required sequence as determined by the ownership chain.
Following is an example ownership chain:
18-68
Chapter 18
Equity Pickup Overview
18-69
Chapter 18
Working with On-Demand Rules
18-70
Chapter 18
Working with On-Demand Rules
Replacement Variables
When you add a new rule, Calculation Manager automatically creates six system
Replacement Variables for the rule as Run-Time Prompts for the Scenario, Year,
Period, Entity, Consolidation, and Currency dimensions. Users use the run-time
prompts to select members for these dimensions when they launch the rule. You can
change the run-time prompt texts for these variables, but you cannot remove them.
Users can override the default member at run-time.
You can define additional Replacement Variables if needed for your rule.
When you launch an on-demand rule from the Rules card for the first time, if a default
member was not specified for a run-time prompt, the prompt is blank. On subsequent
launches of the rule, the prompt displays the last member used.
When you launch on-demand rules from a form, the Run-Time Prompts by default
display the members from the Point of View of the currently selected cell. However,
if you would like the system to always use a specific member for the dimension, you
can select the option to override with a specified value for the variable. If you specify a
value in Use as Override Value, it will also be used in the Rules card.
If you select the Is Hidden option for the replacement variable, the system will
not prompt the user for the value at run time, but will use the value specified in
the Replacement Variable definition for that variable. This option is the same when
invoking from a Data Form or from the Rules card.
18-71
Chapter 18
Working with On-Demand Rules
You can view all six system replacement variables as part of the rule in the Variable
tab of the rule.
You must a enter a Value in the Validation column for the variable so that rule can be
validated before deployment.
When you validate the rule, you must provide members for any of the Run-Time
Prompt dimensions for which you did not provide a default in the Value column.
Note:
For the Consolidation dimension, if you want to use FCCS_Amount Override
or FCCS_Rate Override, you must first set the following substitution variable
for the Consol cube to enable it:
ODR_ENABLE_RATE_AMOUNT_OVERRIDE = TRUE
The following dimensions are not available for Run-Time Prompts, but are also
supported for on-demand rules:
• View - you can only select Periodic view. The Periodic View member must be
specified in either the FIX statement or as a Target.
• Account and Movement - see Working with Essbase Calc Script. If you do not
specify members for any of these dimensions, the system processes the rule
for all members. You should exclude any system-restricted members in the FIX
statement.
• Data Source - see Working with Essbase Calc Script.
18-72
Chapter 18
Working with On-Demand Rules
Note:
The FCCS_Intercompany Eliminations member is not valid for on-
demand rules.
• Multi-GAAP, Intercompany and Custom - If you do not specify members for these
dimensions, the system will process rules for all members in the dimension.
18-73
Chapter 18
Working with On-Demand Rules
Note:
You add on-demand rules to the Consol cube. You cannot add them to
the Rates cube. The Consol cube is seeded with six placeholder rules for
Configurable Calculations. You cannot delete or rename these rules.
18-74
Chapter 18
Working with On-Demand Rules
Note:
For the Consolidation dimension, if you want to use FCCS_Amount
Override or FCCS_Rate Override, you must first set the following
substitution variable for the Consol cube to enable it:
ODR_ENABLE_RATE_AMOUNT_OVERRIDE = TRUE.
See Creating and Assigning Values to Substitution Variables.
• For the Entity dimension, if you use shared entities, you must explicitly define
both the primary and shared entities in the Run-Time Prompt, in order for the
shared entities to be impacted.
• For the Entity dimension, to run the On-Demand rule on all Level 0
descendants, you must select the Level 0 descendants function from the
Member Selector. For example, to run the rule on all Level 0 descendants
of "FCCS_Total Geography", select the Level 0 descendants function
with"FCCS_Total Geography" as its parameter. Example: IDescendants
("FCCS_Total Geography".
• Note that the FIX statements in on-demand rules cannot include any run-time
prompt dimensions. You also cannot use run-time prompt dimensions in the
left side or Target side of formulas, although you can use these dimensions on
the right side or Source side.
10. To validate the rule, from the Actions menu, select Validate and Save.
You must specify members for any of the Run-Time Prompt dimensions for which
you did not previously specify a default value.
If validation fails, from the Home page, click Application, and then click Jobs to
view the job details.
11. From the confirmation prompt, click OK.
12. To view the rule, navigate to the Rules folder and right-click Refresh.
The new rule is displayed in the Rules list. On-demand rules are listed in
alphabetical order after the seeded configurable calculation rules.
It does not become active until it is deployed.
13. To deploy the rule, from the Actions menu, select Deploy.
You cannot undeploy a rule after it has been deployed. If the rule is no longer
needed, you can delete it.
14. From the confirmation prompt, click OK.
15. To verify that the rule was deployed, on the Home page, click Rules and click
Refresh.
The deployed rule will be displayed in the list of rules after the system rules.
18-75
Chapter 18
Working with On-Demand Rules
When users are viewing or entering data in the form, they can execute the assigned
on-demand rule from within the form so that they can see the calculated results in the
form after execution.
To launch rules from a form, users must be assigned both access to the form and
launch permissions for the rule. See Assigning Access to Rules.
To create Custom Menus for the calculation to be included as part of the form
Action menu, see "Defining Action Menu Items" in Administering Planning Using the
Simplified Interface .
To include on-demand rules as part of the Business Rules menu, you use the
Business Rules tab of the Form designer.
You can decide how you want the on-demand rule to be processed for the form based
on the properties assigned for the business rule. For example, you can define an
on-demand rule for the form with these actions:
• Run before loading the form
• Run after the form is loaded with data
• Run before saving the form data
• Use the members invoked from form
• Hide Run-Time Prompts
To add on-demand rules to a data form:
13. Under Create and Manage, click Forms to open the form editor.
14. Select the Other Options tab to assign the menu to a form.
18-76
Chapter 18
Working with On-Demand Rules
To add on-demand rules to the list of business rules available from the Business
Rules dialog box:
18-77
Chapter 18
Working with On-Demand Rules
Note:
Locked data may be impacted after running on-demand rules. Be cautious
when executing these for desired results.
Note:
For the Entity dimension, you can specify multiple entities or a member
list, but for all other dimensions, you specify only one member.
18-78
Chapter 18
Working with On-Demand Rules
The system will display only the Business Rules you have assigned to the form for
user to select. After selection, the system will display the Run-Time Prompt values
based on your POV selection.
If the user selects a block of cells by selecting an entire row or column when they
launch the rule, the system uses the cell from upper-top-left corner as the selection
cell for the Run-Time Prompts.
You can launch on-demand rules either from the Action Menu drop-down list using a
Custom Menu, or from the Business Rules option.
After you run on-demand rules, all entities included in the calculation process have a
calculation status of Impacted, regardless of the original status. The system will not
run on-demand rules for entities that are locked. All applicable parent and ancestor
members are Impacted, and all future periods that have data are also Impacted.
To launch an on-demand rule in a form:
1. On the Home page, click Data, and then open the form.
2. From the Action menu, select Business Rules, and select the rule.
3. From the Launch Confirmation message, click OK.
4. In the Run-Time Prompt dialog box, click Launch, then specify values or use the
default values for the prompts, and click OK.
18-79
Chapter 18
Working with On-Demand Rules
After an on-demand rule is executed, the status for all entities in the rule changes to
Impacted.
When entities are Impacted, the system follows these rules for applicable parent
members and ancestors as well as future periods.
Locked Entities
If an entity is Locked, the system does not execute the rule on the locked entity. If the
rule Run-Time Prompt contains multiple entities and only some are Locked, the system
skips those entities but continues to run the rule for the other valid entities.
Entities with View or None Access
If a user has View or None access to the entity, the system will not run the rule for
these entities and they will not be impacted.
Entities with Errors
If an entity in a rule does not pass validation, the system will not run the rule for the
entity and it will not be impacted. Rules are run only for valid entities.
Reference of Source Entities
When a rule references a source entity for data, the system ignores the status of the
source entity and processes the data at the time of retrieval.
Note:
You cannot edit the rule while you are debugging it.
18-80
Chapter 18
Working with On-Demand Rules
• Insert and remove break points where you want to stop the execution of the
script to examine the values of the intersections of members in the statement.
When the execution stops at a break point, the values of the intersection of all
members in the statement are displayed.
To add a break point, right-click to the right of the break point, and then select
Add Break Point. You can add a break point only in lines of the script that
show the break point grayed out. To remove a break point, right-click it, and
then select Remove Break Point.
• Add a condition to a break point to stop the execution of the statement only if
the condition is met. Only members used in the statement with the breakpoint
can be used in the condition.
To add a condition to a break point, right-click to the right of the break point,
and then select Add Condition. In the Add Condition dialog box, click ,
and then enter the condition in the Condition Builder.
These functions are available for conditional testing:
– @isCURRMBR
– @BEFORE
– @AFTER
Sample conditions to invoke debugging of specific breakpoint:
– @isCURRMBR("Feb") – when the current period is "Feb"
– @BEFORE("Cash") > 1000 – when the before value of "Cash" is greater
than 1000
– @AFTER("Cash") < 2000 – when the after value of "Cash" is less than
2000
To edit a condition, right-click it, and then select Edit Condition.
You can have one or more conditional statements.
You can also group the conditional statements.
Note that if a condition is not met, the Debug process will skip the breakpoint,
but still execute the statement.
• Debug statements with break points.
To debug a statement with a break point, right-click the statement, and then
select Start Debug. The statement you are debugging is highlighted. The
members of the statement, the break points, and the values of the intersection
of the members before and after execution are displayed in the following tabs:
– Members—Shows the current intersection of members at the debug
breakpoint. To see the next intersection of members, click Resume
Debugging.
– Breakpoints—Shows the expressions from the script that contain
breakpoints. The Values at the Break Point tab displays the expression
members with the values as they were before and after the debug was
run.
18-81
Chapter 18
Working with On-Demand Rules
Tip:
18-82
Chapter 18
Working with Essbase Calc Script
in a data form, when you open the data form, you will no longer see the menu option
because no rule has been associated with the menu.
To delete on-demand rules:
Note:
If the rule has been deployed, the system warns you that the some of the
selected objects have been deployed. Select the option to include the
deployed object as part of the deletion.
6. From the confirmation message that the rule was deleted, click OK.
7. To confirm that the rule was deleted from the list, right-click on the Rules folder,
and click Refresh.
Common Syntax
• Semicolon
– Required at end of each statement
– Example: Sales = Sales * 1.50;
– Not needed after FIX and ENDFIX
• Double Quotes
– Member names with spaces / special characters / start with number
– Best practice is to always use double quotes around a member name
– Example: "Cash Ratio" = "Cash"/"Current Liabilities";
• Cross-dimensional Operator
– Use > to specify intersection of more than one dimension
– Example: "Sales" > "Changes In Net Income" > "Product1"
Comments
18-83
Chapter 18
Working with Essbase Calc Script
FIX/ENDFIX
FIX/ENDFIX is one of the basic building blocks of any calc script. To do any
calculation, you must define a FIX/ENDFIX section and then place the actual business
calculations within it.
Example: Assume "Products" is your custom dimension and you want to calculate
number of Televisions sold. You could use the following syntax:
FIX("Televisions")
ENDFIX
Note:
You must put a semi-colon at the end of each calculation statement, but not
for FIX or ENDFIX.
The FIX/ENDFIX section limits members from various dimensions that participate
in calculations within it. In this example, only "Televisions" are participating in the
calculations.
You can define nested FIXes also, such as the following:
18-84
Chapter 18
Working with Essbase Calc Script
The system will fail deployment and an error message will be logged in the Jobs
console with the appropriate information.
However, this does not mean that you cannot use these dimensions in the script.
Generally, a calculation will have something like the syntax below:
Note that in FIX and "Left hand side", you cannot use any member from the Scenario,
Year, Period, Entity and View dimensions. But there is no such restriction on the "Right
hand side" of the equation.
The following syntax would be allowed:
For the remaining eight dimensions, if you do not FIX on a particular dimension, the
system will assume all the members from that dimension. For example, suppose you
have the following statement:
In this example, all remaining dimensions have a FIX except Account. In this case,
Essbase will consider all members from the Account dimension for the calculations
within FIX/ENDFIX.
18-85
Chapter 18
Working with Essbase Calc Script
18-86
Chapter 18
Working with Essbase Calc Script
18-87
Chapter 18
Working with Essbase Calc Script
These sparse combinations work as indexes for Essbase to search the data blocks
that match indexes and pull them for calculations. Therefore, not all blocks are pulled
for the system to perform.
When FIX is used on a Dense dimension, dense members will be present in each
data block in Essbase. Therefore, this would have a performance impact if not used
correctly. Note than when FIX is on the Dense dimension, Essbase will pull all data
blocks without limit to the number of blocks and will only limit to a portion within
each block. Therefore, it may require multiple passes to the database to return the
information.
For example, you could reference "Sales" and "PostSales" from the Account
dimension with the following statements:
When the system processes the first fix on "Sales", Essbase pulls all data blocks of the
Account dimension but only works on the one "Sales" account.
Later in the FIX statement on "PostSales", Essbase again pulls all data blocks of the
Account dimension but only works on the one "PostSales" account. In this case, two
passes are made to the database for these two accounts.
To avoid a performance issue, you can avoid using FIX on the Account dimension, but
use IF...THEN for a Dense dimension.
In this example where you are not using the FIX statement, you only need to make
one pass to the Essbase database.
The recommendation is to use FIX on Sparse dimensions, and use IF..THEN for
Dense dimensions to help calculation performance.
Member Block
Member blocks are also known as calculation blocks. Sometimes you will see the term
"anchor" used for Member blocks. The syntax of a member block is as follows:
18-88
Chapter 18
Supported Essbase Functions
In this example, "My Total Opening Balance" is known as a calculation block member
or anchor. Whenever possible, this member should be a member from a Dense
dimension.
In the above calculation, we will only limit to the member "My FX Opening" and the
calculations are performed on the member specified in the FIX statement.
Note that when using IF statements, you will need a member block. You cannot write
IF statements outside of Member blocks.
18-89
Chapter 18
Supported Essbase Functions
18-90
Chapter 18
Supported Essbase Functions
18-91
Chapter 18
Supported Essbase Functions
18-92
Chapter 18
Supported Essbase Functions
18-93
Chapter 18
Supported Essbase Functions
18-94
Chapter 18
Supported Essbase Functions
18-95
Chapter 18
Financial Consolidation and Close Custom Functions
Note:
@ISACCTYPE: This function only applies to Expense accounts. Any of these
values may be used: First, Last, Average, Expense, and Twopass.
CALC DIM: You should only use CALC DIM on non-aggregated dimensions
(for example, Movement, Intercompany, Multi-GAAP and Custom(s). It is
required only if you need to reference an aggregated intersection in the
middle of your custom calculation.
18-96
Chapter 18
Financial Consolidation and Close Custom Functions
18-97
Chapter 18
Financial Consolidation and Close Custom Functions
18-98
Chapter 18
Financial Consolidation and Close Custom Functions
18-99
Chapter 18
Financial Consolidation and Close Custom Functions
Select "Actual / FY16 / Mar / EUR E1" to run the OnDemand Rule.
It will explicity impact"Actual / FY16 / Mar / EUR E3 and USD E4" and ancestors of
EUR E3 and USD E4 in Actual/FY16/Mar.
The corresponding Parent "USD D2" will also be impacted for March.
18-100
Chapter 18
Financial Consolidation and Close Custom Functions
The following example shows additional use cases for the @FCCSImpactStatus
function and its results.
18-101
Chapter 18
Financial Consolidation and Close Custom Functions
Suppose you are using this Entity Hierarchy, consolidating Actual / FY19 / Nov / P02,
and using the @FCCSImpactStatus function:
Use case 1: @FCCSImpactStatus("Actual", "FY19", "Nov", "E03")
As Entity E03 is a descendant of P02 (and Scenario, Year and Period are same),
impacting will not be done.
Use case 2: @FCCSImpactStatus("Actual", "FY19","Nov", "E04")
Entity E04 is not a descendant of P02. Impacting will be done.
Use case 3: @FCCSImpactStatus("Actual", "FY19","Dec", "E03")
Even though Entity E03 is a descendant of P02, Dec. is a period after November, so it
will be impacted.
Use case 4: @FCCSImpactStatus("Actual", "FY19", "Oct", "E03")
No impacting will be done. We are consolidating Actual / FY19 / Nov / P02, which
means P02 and all its descendants including E03 will become OK in Actual / FY19 /
Nov.
Use case 5: @FCCSImpactStatus("Actual", "FY19", "Oct", "E04")
Impacting will be done. Entity E04 is not a descendant of P02.
18-102
19
Managing Approval Unit Hierarchies
Related Topics
• Creating Approval Unit Hierarchies
• Editing Approval Unit Hierarchies
• Viewing Approval Unit Hierarchy Usage
• Synchronizing Approval Unit Hierarchies
• Deleting and Renaming Approval Unit Hierarchies
• Exporting Approval Unit Hierarchies
• Importing Approval Unit Hierarchies
19-1
Chapter 19
Creating Approval Unit Hierarchies
19-2
Chapter 19
Creating Approval Unit Hierarchies
• Click Next or select Primary and Subhierarchy Selection to select the approval
unit members (see Selecting Approval Unit Hierarchy Members.
• Click Save and then OK to save changes and close the approval unit hierarchy.
19-3
Chapter 19
Creating Approval Unit Hierarchies
19-4
Chapter 19
Creating Approval Unit Hierarchies
Note:
If the reviewers are individual users, select the reviewers in the order
that you want them to review the approval unit. The first reviewer in the
list is the first user to work on the approval unit. When the first reviewer
promotes the approval unit, the second reviewer selected becomes the
approval unit owner, and so on through the list of reviewers that you
create.
4. Under Promotional Path, click to display the approval unit promotional path
for the entity, verify that it is correct, and then correct any errors.
For an entity to be approved and locked, the entity must have gone through the
promotional path and reached the last owner or reviewer in the path. Only the last
owner/reviewer on the promotional path can approve or lock the entity.
5. Optional: Under Notify These Users, click Search to select the users to notify
whenever an approval action is performed for the approval unit.
In order to receive notifications, the user to be notified must set up email ID
and enable approval notifications in User Preferences. See "Setting Up Email for
Notifications" in Working with Oracle Financial Consolidation and Close Cloud.
6. Optional: Repeat these steps for other approval units to assign owners and
reviewers.
7. Click Save to save your work and continue, or click OK to save your work and
close the approval unit hierarchy.
Note:
You assign only one Approval Unit Hierarchy to a specific Scenario/Year/
Period. You cannot assign multiple Approval Unit Hierarchies to the same
Scenario/Year/Period.
19-5
Chapter 19
Editing Approval Unit Hierarchies
c. From the Years column drop-down, select the year to associate with the
approval unit hierarchy.
d. From the Period column drop-down, select the periods to associate with the
approval unit hierarchy.
You can select multiple periods at once, for example, Actual, FY19, January,
February, March, and so on.
e. Click OK.
A new assignment row is displayed.
Tip:
19-6
Chapter 19
Synchronizing Approval Unit Hierarchies
Note:
When you add dimension members, they are added as approval units
only if they meet the criteria in the inclusion rules for the approval unit
hierarchy. For example, if the added entity is a fourth-generation entity, and
the inclusion rules specify generations one through three as approval units,
the entity is not added as an approval unit. If the entity is a third-generation
member, however, it is added as an approval unit the next time the approval
unit hierarchy is edited and saved, or synchronized.
1. Click the Navigator icon , and then under Workflow, click Approval Unit.
2. In the Synchronized column, approval unit hierarchies are labeled as follows:
• Synchronized—Changes are synchronized with the approval unit hierarchy
• Not Synchronized—Changes are not synchronized with the approval unit
hierarchy
• Locked By user—A user is editing or synchronizing the approval unit
hierarchy
19-7
Chapter 19
Deleting and Renaming Approval Unit Hierarchies
Note:
If a user begins editing or synchronizing an approval unit hierarchy after
you display the approval unit hierarchy list, the approval unit hierarchy
list does not display "Locked" for the approval unit hierarchy. If you try
to synchronize this approval unit hierarchy, the synchronization does not
occur, and an error message states that it is being edited.
Note:
You cannot synchronize changes to an approval unit hierarchy that
another user is editing or synchronizing.
4. To view the status of the synchronization process, navigate to the Jobs console.
The Jobs list includes the status of each approval unit hierarchy being processed
and details of any errors.
19-8
Chapter 19
Importing Approval Unit Hierarchies
information. After you create this file, you can copy its contents to an existing approval
unit hierarchy (see Importing Approval Unit Hierarchies).
To export approval unit hierarchies:
1. Click the Navigator icon , and then under Workflow, click Import and Export.
2. Select Export Approval Unit Hierarchy.
3. In Existing Approval Unit Hierarchy Name, select an approval unit hierarchy to
export.
4. Click OK.
5. When the Save dialog box is displayed, save the export file to a location of your
choice.
6. Click Export or Done. Export performs the action, and Done closes the dialog
box.
Note:
An approval unit hierarchy load deletes an existing member and its children
from the hierarchy if the member isn't specified in the input file.
1. Click the Navigator icon , and then under Workflow, click Import and Export.
2. Select Import Approval Unit Hierarchy.
3. In Existing Approval Unit Hierarchy Name, select the approval unit hierarchy
receiving the exported information.
19-9
Chapter 19
Importing Approval Unit Hierarchies
Note:
The imported approval unit hierarchy includes the defined owner,
reviewers, and rules for determining the promotional path.
If your Approval Unit Hierarchy is already started and you import an
Approval Unit Hierarchy which may contain changes to assigned entities,
errors will result. Before you import an Approval Unit Hierarchy file,
ensure that the Approval Unit Hierarchy is not started by performing
Exclude, which resets the hierarchy to Not Started status.
4. For Approval Unit Hierarchy with Ownership, click Browse to select the
exported approval unit hierarchy file to import.
5. Click OK.
6. Click Import or Done. Import performs the action, and Done closes the dialog
box.
If the message Import successful is displayed, the approval unit hierarchy
information in the exported file was successfully copied to the approval unit
hierarchy that you selected in Existing Approval Unit Hierarchy Name.
If the message Import not successful. Some items have not been imported is
displayed, click Details to view the log file. Correct the errors and retry importing
the approval unit hierarchy.
19-10
20
Managing the Approval Process
Related Topics
• Approval Process Overview
• Enabling Approvals
• Starting the Approval Process
• Approval Unit Promotional Path
• Creating Approval Unit Annotation Reports
• Creating Approval Status Reports
• Data Validation Rules
• Locking and Unlocking Entities
• Troubleshooting Approval Process Issues
Enabling Approvals
Before you can use the Approvals process, you must enable approvals for the
Scenario dimension in the metadata file. When the Enabled for Approvals option
is enabled, the Scenario is available for selection in the Approval Unit Assignment
screen.
20-1
Chapter 20
Starting the Approval Process
To enable approvals:
1. On the Home page, click Application, and then click Overview.
2. Click Dimensions, and then select the Scenario dimension.
3. Click Edit Member Properties.
4. Select Enabled for Approvals.
5. Click Save.
20-2
Chapter 20
Approval Unit Promotional Path
In the graphical pie chart, you will see "no data displayed" if the Approval Unit
Hierarchy has not yet started.
5. From the View drop-down on the top right, select Tree View.
6. Select an approval unit and click Start to begin the approval process.
7. From the confirmation message that the approval unit has been started, click OK.
The Approved Status changes to Under Review.
For a list of all Approval Unit levels and available actions, see "Reviewing and
Approving Data" in Working with Financial Consolidation and Close .
8. Optional: If you want to re-start the approval process for a specific entity, you
can select Exclude to remove an approval unit from the process, and reset the
approval status to "Not Started".
Caution:
After you exclude an approval unit, all associated annotations and
history are discarded. Data values are retained.
20-3
Chapter 20
Creating Approval Unit Annotation Reports
20-4
Chapter 20
Data Validation Rules
• Current Location
• Total Value
• Last Status Change Date
Sample Approval Status Report
20-5
Chapter 20
Locking and Unlocking Entities
validation messages, enforce limits on submitted approval unit data, and designate
a specific reviewer or owner to review data that meets some condition.
For example:
• Conditionalizing the approval unit promotional path
• Preventing the promotion of approval units that include invalid data
You define validation rules within a data form, and can specify options for validating
approval units. See Including Data Validation Rules in Forms.
In the approval process, validation is run only for these actions:
• Promote
• Approve
• Lock
• Unlock
• Exclude (Administrator action; checks to ensure that the current period is not
locked)
Validation is not run when these actions are performed:
• Sign Off
• Reject
• Reopen
• Originate
• Take Ownership
• Start (administrator action)
20-6
Chapter 20
Locking and Unlocking Entities
You can modify the owner information for the default approval unit hierarchy
"FCCS_Total Geography" as long as the owner is a valid Service Administrator or
a Power User with Write access to the entities within the approval unit hierarchy.
It is not necessary to define any reviewer for "FCCS_Total Geography" as reviewer
is optional. All descendants of "FCCS_Total Geography" will inherit the same owner
information as its parent unless you choose to have a different owner or reviewer for
an individual entity within the approval unit hierarchy.
If you create any hierarchy outside of "FCCS_Total Geography", you must define a
valid owner for that hierarchy.
Locking Entities
You can lock data only if these conditions are met:
• The entity’s calculation status must be OK, No Data, or System Change. You
cannot lock an entity with Impacted calculation status.
• The prior period data must be locked. For example, you can only lock an entity in
the February period if it is locked in January.
To lock entities:
1. On the Home page, click Approvals.
2. Select the Total Geography approval unit.
By default, the Total Geography approval unit has a status of Not Synchronized,
and must be synchronized.
3. Click the Synchronize icon to synchronize the approval unit.
Note:
You must repeat this step each time after you add or remove an entity
and perform a database refresh.
4. To start the approval unit, click the Navigator con, and then select Manage
Approvals.
If you do not start an approval unit, the entities in that approval unit will remain in
"Not Started" status.
5. Select the Scenario, Year and Period that you want to start and click Go.
6. From the View list on the right, select Tree View.
7. Expand "Total Geography" until you see FCCS_Total Geography.
FCCS_Total Geography is in "Not Started" state.
8. Click Start to start "FCCS_Total Geography ".
The system then moves it and all its descendants to "Unlocked" state.
9. On the Home page, click Approvals.
10. Click an unlocked approval unit.
11. On the Change Status page, click Change Status to change the status to Locked.
20-7
Chapter 20
Locking and Unlocking Entities
If an error occurs during the locking or unlocking process, the Approvals page displays
a Failed status next to the approval unit. Click the link to view a detailed validation
report and resolve the error.
Unlocking Entities
You can only unlock data for a period if the next period is unlocked. For example, you
can only unlock an entity in February if the entity is unlocked in March.
You can select the Unlock or Unlock Single option:
• Unlock - If you select the Unlock action on a parent entity, the system unlocks the
parent entity and all its descendants.
• Unlock Single- If you select the Unlock Single action on a parent entity, the
system unlocks only the parent entity, but not its descendants.
When you unlock an entity and select the owner for the entity, it can be any owner
in the previous promotional path, including the current owner. If you select the
Automatic option for the owner, the new owner will be the current owner of the entity.
To unlock entities:
1. From the Approvals page, click a locked approval unit.
2. On the Change Status page, from the Actions drop-down, select an option:
• Unlock - unlock the parent entity and all its descendants
• Unlock Single - unlock the parent entity only.
3. Click Done.
If an error occurs during the locking or unlocking process, the Approvals page displays
a Failed status next to the approval unit. Click the link to view a detailed validation
report and resolve the error.
1. Click the Navigator icon , and then under Workflow, click Approval Unit.
20-8
Chapter 20
Troubleshooting Approval Process Issues
20-9
Chapter 20
Troubleshooting Approval Process Issues
20-10
21
Setting Up Task Manager
Related Topics
• Task Manager Terms
• Task Manager Overview
• Sample Task Flows
• Managing Task Manager System Settings
• Managing Task Manager Attributes
Integrations
A definition of a service provided by an application.
Task Types
Identify and categorize commonly performed tasks; for example, Data Entry, or G/L
Extract. The Task Type enables you to set default information, such as settings that
need to be input by the user, and questions or instructions that are shared by all tasks
of that type. Task Types are often based on Integration Types.
Execution Types
End-users, System-Automated Task, Event Monitoring Task
Templates
Business processes that are repeatable. Administrators can create templates for
different types of business processes, such as monthly or quarterly.
Schedules
Defines the chronologically ordered set of tasks that must be executed for a specific
business process, and is the alignment of a template's generic business process
days, to calendar dates.
Dashboard
This view presents a portal-style interface with views into schedules and task lists,
and high-level summaries into which you can drill down for greater detail.
Alerts
Notifications from users on issues that they encounter during the process, such as
hardware or software issues. Users create alerts identifying a problem and assign
them to be resolved.
21-1
Chapter 21
Task Manager Overview
21-2
Chapter 21
Sample Task Flows
9. Alternatively, users can log on to review and access assigned tasks in different
types of views.
10. When users complete tasks, the tasks are sent to approvers and can be viewed by
other users.
11. Users can create alerts for issues, such as hardware or software issues, that they
encounter. Alerts are forwarded to Assignees and Approvers for resolution.
Watch this overview video to learn more.
Overview Video
Scenario 3: Approver
A user assigned as an Approver reviews a current task to determine whether it can be
approved.
• The assigned Approver receives an email notification of an outstanding task.
• From the email, the Approver selects the link for the task.
• The Task Actions page is launched outlining the process.
• The Approver reviews the document that the user submitted when completing the
task to ensure completeness.
• The Approver enters additional comments and approves the submission.
• If another level of approval is required, the task is forwarded to the next approver.
If the task was the last requiring approval, then the task completes, and the
system runs the next task if it is ready.
21-3
Chapter 21
Managing Task Manager System Settings
• The Approver can reject a task instead of approving it, and the task is reassigned
to the Assignee.
Scenario 4: User
A user logs on to the application and reviews and completes an assigned task.
• The user logs on and reviews their tasks.
• The user clicks the link for an assigned task.
• The task page is launched with instructions for the task, and a reference
document.
• The user reviews the instructions and the reference document, processes the
updates, enters a comment about the task, and submits it for approval.
• The system automatically updates the task status and sends a notification to the
assigned approver.
Scenario 5: User
A user responds to an email notification of a task to load data, clicks a link in the email,
and then completes the task.
• The user receives an email notification of an outstanding task.
• From the email, the user selects the link for the page where the required process
is documented.
• The user reviews the instructions for the task and opens the task.
• The user loads data into the system.
• The user enters a comment about the task and submits it for approval.
…$YearName$%22%22Period%20Name%22&val6=%22$PeriodName$
%22&col17=%22Logical%20Schedules%22.%22Year%20Name%22&val7=%22$Y
earName$
21-4
Chapter 21
Managing Task Manager System Settings
%22&col8=%22Logical%20Schedules%22.%22Deployment%20Name%22&val8=%22$
ScheduleName $%22
where
$YearName$ = 2012
$PeriodName$ = Jan12
$ScheduleName$ = DemoSchedule
…
%222012%22%22Period%20Name%22&val6=%22Jan2012%22&col7=%22Logical%20Sched
ules%22.%22Year%20Name%22&val7=%222012%22&col8=%22Logical%20Schedules%22
.%22Schedule%20Name%22&val8=%22DemoSchedule%22
21-5
Chapter 21
Managing Task Manager System Settings
1. On the Home page, click Application, and then click Task Manager.
2. Click the System Settings tab on the left, and then select Global Integration
Tokens.
3. Click New.
4. Enter:
• Name: A unique token name
• Type: Static or Task Attribute
• Token Value:
– If Task Attribute is selected as the Parameter Type, select the value that
is passed when the URL is rendered.
– If Static Attribute is selected as the Parameter Type, enter the value that
is passed when the URL is rendered.
5. Click Save.
Deleting a Token
To delete a token:
1. On the Home page, click Application, and then click Task Manager.
2. Click the System Settings tab on the left, and then select Global Integration
Tokens.
3. Select a token, then click Actions, and click Delete.
A warning message is displayed: "Deleting a Global Integration Token will
invalidate the URLs that are referencing it. Are you sure you want to continue?"
4. Click Yes to delete.
21-6
Chapter 21
Managing Task Manager System Settings
3. Click Import .
• Click Browse to navigate to the CSV import file.
Sample Organizational import format:
Note:
The following section shows the import format. This example
requires a pre-existing parent organizational unit named "Americas",
a holiday rule named "US", and a Viewer named "fm_user5".
"OrganizationalUnitID","Name","ParentOrganization","Description","T
imeZone","H
olidayRule","Calendar","Workdays","Viewer1","Commentator1"
21-7
Chapter 21
Managing Task Manager System Settings
21-8
Chapter 21
Managing Task Manager System Settings
• Year
The Year attribute behaves as a filter option. You do not need toselect a value
for this attribute. If you do, the table is filtered to display the dates associated
with the selected year.
6. To name a holiday, in the Holiday section, click Import ( ) to import the list of
holidays or click Add and enter the date and name of the holiday.
21-9
Chapter 21
Managing Task Manager System Settings
21-10
Chapter 21
Managing Task Manager System Settings
21-11
Chapter 21
Managing Task Manager System Settings
Note:
The setting affects only running and closed tasks.
Note:
By default, email notifications are not enabled.
Administrators can also assign the number of days before a due date to send reminder
notifications.
Due Date reminder notifications are emailed to Assignees and Approvers in these
conditions:
21-12
Chapter 21
Managing Task Manager System Settings
21-13
Chapter 21
Managing Task Manager System Settings
Reopening Tasks
In Task Manager, there might be times when users need to reopen a task.
Administrators can specify whether to allow open or closed tasks to be reopened.
To allow reopening of tasks:
1. On the Home page, click Application, and then click Task Manager.
2. Click the System Settings tab on the left.
3. Select Reopen.
4. Set the conditions to allow reopening of a task that is Open with an Assignee or
Approver:
• Not Allowed - this is the default option and assignees or approvers cannot
change the workflow of an open task after it has been submitted or approved.
• Allowed for all approvers - allows approvers who have approved a task to
return the workflow to themselves.
• Allowed for all assignees and approvers -- allows an assignee who has
submitted a task or an approver who has approved a task to return the
workflow to themselves.
5. Set the conditions to allow reopening closed tasks:
• Not Allowed - this is the default option and users will not be able to reopen a
closed task.
• Allowed for final approver- allows only the final approver to reopen and
return the workflow to themselves.
• Allowed for all approvers- allows an approver to reopen and return the
workflow to themselves.
21-14
Chapter 21
Managing Task Manager Attributes
• Allowed for all assignees and approvers - allows assignees and approvers
of a task to reopen and return the workflow to themselves.
Note:
The maximum number of Task Manager attributes that you can create or
import is 10,000.
21-15
Chapter 21
Managing Task Manager Attributes
• Name
• Type:
– Date
– Date/Time
– Integer
– List
If you select List, enter a list of valid responses to the question.
– Multi-Line Text
If you select Multi-Line Text, enter the Number of Lines, from 3 to 50
lines. Multi-Line Text determines how many lines of text are visible, without
scrolling, on the Actions dialog boxes. The maximum length should be
less than 4,000 characters.
Select Include Attachments if you want to include an Attachments
section on the Actions dialog box.
– Number
If you select Number, click the Format tab and select number formatting
options:
* For Decimal Places, enter a value for the number of decimal places
to display.
* For Display As Percentage, check the box if you want a percentage
to display.
* Select the Thousands Separator option if you want numbers to
display a thousands separator (for example, 1,000.00)
* From the Currency Symbol list, select a currency symbol, for
example, Dollars ($).
* From the Negative Number list, select how to display negative
numbers, for example, (123).
* From the Scale list, select a scale value for numbers, for example,
1000.
– Text
– True/False
– User
– Yes/No
– Calculation - Select to add logical and mathematical functions for
attributes.
See Defining Calculation Attributes.
21-16
Chapter 21
Managing Task Manager Attributes
Schedules: You can add any Calculation and the calculation is evaluated, regardless
of whether or not it was explicitly assigned to the task.
Templates: You cannot add a custom attribute that has the Calculation option selected
as a column or a filterable attribute.
When administrators add attributes to the Attributes sections in the Actions dialogs,
they are viewable by workflow users. Administrators can restrict access to certain roles
by setting the access to Do Not Display. For example, for calculated attribute XYZ,
an administrator could set the access to Viewer: Do Not Display so that the XYZ
attribute is not displayed for users with only the Viewer role.
Any user role can add calculated attributes as columns in views and portlets. They can
also be added as filterable attributes in the Filter Panel.
To define a calculation attribute:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Attributes tab on the left.
3. Click New, and on the Properties tab, enter:
4. Enter a Name for the attribute.
5. Select a Type from the drop-down list.
6. Select the Calculation option.
7. On the Calculation tab, select a Calculation Type.
You can select from the following calculation types. The available types are
determined by the Attribute Type (Text, Integer, and so on).
• Assign Value to List—Assign custom values to a List type attribute
• Assign List To Value—Assign custom list values to the values of a different
attribute. Only available for List type attributes.
• Conditional—A conditional calculation (If – Then – Else)
• Scripted—A free-form scripted calculation. Only available for attributes of type
Integer, Multi-line Text, Number, or Text.
The following table lists the Calculation types available for each Attribute type.
Attribute Type Assign Value to List Conditional Scripted Assign List to Value
Date
Date/Time
Integer X X X
List X X
Multi-Line Text X X X
Number X X X
Text X X X
True/False X
User
Yes/No X
Calculation Definition
21-17
Chapter 21
Managing Task Manager Attributes
The Scripted Calculation type enables you to enter a free-form calculation equation.
You can use the Add Attribute and Add Function.
• Add Attribute—Select an attribute and insert the attribute into the Calculation
Definition box at the location of the cursor. If the cursor is in the middle of a word
or attribute, the word/attribute will be replaced in the definition. The script format
adds brackets {} around the name of the new attribute.
The only available attributes are Schedule attributes.
• Add Function—Select a function and add the function to the Calculation
Definition. The Function is added with placeholders for each parameter.
For example: Insert the DATE_DIFF function in the calculation definition:
DATE_DIFF(<Date1>, <Date2>, <Type>)
21-18
Chapter 21
Managing Task Manager Attributes
• If Then Else: Allows you to insert a conditional calculation into the scripted
calculation. IF_THEN_ELSE calculations can also be nested to support ELSE IF
type calculations.
IF_THEN_ELSE(<Condition>, <Value1>, <Value2>)
Example: IF_THEN_ELSE( ( {Priority} = 'Low'),
1,IF_THEN_ELSE( ( {Priority} = 'Medium'), 2,
IF_THEN_ELSE( ( {Priority} = 'High'), 3, 0)))
Example: IF_THEN_ELSE( ( {Priority} = 'Low'), 'Good'
IF_THEN_ELSE( ( {Priority} = 'Medium'), 'Better'. 'Best') )
• Instring: Returns the index of the substring within the value.
INSTRING(<Value1>, <Value to Search>)
Example: INSTRING({Name}, 'a')
• Length: Takes a text value as a parameter and returns an integer which is the
number of characters in the text. If the value is empty/null, the calculation will
return 0.
Length ({<attribute>})
Example: LENGTH("Value") would return 5, and LENGTH({Name}) would return the
number of characters in the name of the object.
Use the calculation with SUBSTRING to extract the last four characters of a text
value.
SUBSTRING( {MyString}, LENGTH ({MyString}) - 4
• Lowercase: Returns the value in lower case
LOWERCASE(<Value>)
Example: LOWERCASE ({Task Code})
• Maximum: Returns the maximum value from a list of attributes. There can be any
number of parameters.
MAX <Value1>, <Value2>, <ValueN>)
Example: MAX( {Scripted Substring Loc a}, {Scripted Substring Loc s},
{Scripted Substring Loc t} )
• Minimum: Returns the minimum value from a list of attributes. There can be any
number of parameters.
MIN (<Value1>, <Value2>, <ValueN>)
Example: MIN( {Scripted Substring Loc a}, {Scripted Substring Loc s},
{Scripted Substring Loc t} )
• Month: Returns the month value of a date as an integer number (1-12)
MONTH (<DATE>)
• Power: Raises one number to the exponential power of another.
POWER(x,y) where x=BASE NUMBER,and y=EXPONENT and x and y can be attributes
or calculations, as long as they are numeric.
Example: POWER(3,4)=81
21-19
Chapter 21
Managing Task Manager Attributes
Note:
Fractional values will reduce the number to its root. For example,
POWER(27, 1/3) = 3 the cube root.
Negative values will perform an inverse of the exponential calculation.
For example, POWER(2, -2) = 1 / (2^2) = 1 / 4 = .25.
Calculation Validation
The following validation checks are performed when you save the Calculation:
• The syntax of the Calculation is correct.
• The Attributes and Functions specified in the Calculation exist.
• Parameters to Functions are correct.
• No Circular Loops exist.
Blue
Yellow
Red
Green
21-20
Chapter 21
Managing Task Manager Attributes
5. Click Import .
6. Browse to a TXT import file.
7. Click Import. Import List Values displays the values: Total List Values,
Completed, Errored, List Values Created, and List Values Updated.
If Completed Successfully, click OK.
If Completed with Errors, the errors are listed. To export the error list, click
Export to Excel .
Editing Attributes
You can edit the name of a custom Task Manager attribute. If the attribute type is a
List, you can also add, rename, or delete list values.
To edit Task Manager attributes:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Attributes tab on the left.
3. Select an attribute and click Edit.
4. Edit the attribute name.
Note:
If the attribute is a List type, you can add, rename, or delete list values.
After a custom attribute is saved, you can't change its type.
5. Click OK.
All related templates, schedules, task types, or tasks are updated.
Duplicating Attributes
You can duplicate attributes.
To duplicate attributes:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Attributes tab on the left.
3. Select an attribute to duplicate, and click Duplicate.
4. Click Close.
Deleting Attributes
You can delete attributes that you no longer need. When you delete an attribute, the
system removes all references to the attribute.
21-21
Chapter 21
Managing Task Manager Attributes
To delete attributes:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Attributes tab on the left.
3. Select the attributes to delete, and click Delete.
4. At the confirmation prompt, click Yes.
Viewing Attributes
In Attributes, you can specify which columns to display for the list of attributes, or show
all. You can also reorder columns, sort columns by ascending or descending order,
and change the column widths.
To display columns:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Attributes tab on the left.
3. Do one or more of the following tasks:
• To display all columns, select View, then Columns, and then select Show All.
• To display specific columns, select View, then Columns, and select or deselect
the column names.
• To reorder columns, select View, and then Reorder Columns, select columns
and use the Up or Down arrows or drag them to change the order.
• To sort columns, hover over a column header until the Sort icons are
displayed, and then click Sort Ascending or Sort Descending.
• To change column widths, hover over the column header dividers until the
arrows display, and drag the columns to the desired width.
21-22
Chapter 21
Managing Task Manager Attributes
Note:
icon.
21-23
22
Managing Teams for Task Manager
Teams are defined and provisioned with Owners, Assignees, Approvers, and Viewers
roles. Then, rather than assigning named users these roles on a task, the role is
assigned to the Team. Administrators and Power Users can add, edit, and delete
teams.
See these topics:
Adding Teams and Members for Task Manager
Editing Teams and Members for Task Manager
Deleting Teams and Removing Members
Managing Backup Assignments
Requesting a Reassignment in Task Manager
22-1
Chapter 22
Editing Teams and Members for Task Manager
6. On the Team dialog box, select Primary User to have the tasks default to a
Claimed status with that user.
Note:
Other team members can then claim the task.
7. Click OK.
Note:
icon.
22-2
Chapter 22
Deleting Teams and Removing Members
Note:
Administrators cannot back up owner assignments on templates, schedules,
and tasks.
22-3
Chapter 22
Requesting a Reassignment in Task Manager
4. If you know the reassigned user, enable To User, and then enter or
search for the name.
Note:
If you do not know the new user, then submit a request without
specifying the name of the user.
22-4
23
Managing Task Types
Related Topics
• Task Types
• Creating Task Types
• Viewing Task Type History
• Editing Task Types
• Viewing Task Types
• Searching for Task Types
• Importing Task Types
• Exporting Task Types
• Deleting Task Types
Task Types
Task Types are saved definitions of commonly performed tasks. They identify and
categorize tasks commonly performed during a business process, for example, Data
Entry or General Ledger Extract. Task Types enable you to set default information,
such as settings that must be input by the user, and questions or instructions that are
shared by all tasks of that type. For example, if you have a set of required questions
to be answered by users responsible for data loads, you can create a Data Load Task
Type with the required questions. When you create data load tasks, you can select the
Data Load Task Type and the questions are automatically included in the tasks.
Two predefined Task Types are installed by default:
• Basic Task: Basic Task Type that does not contain instructions, questions, or
attributes.
• Parent Task: Enables you to create parent tasks to define task hierarchies.
To create and manage Task Types, you must be assigned the Service Administrator or
Power User security role. Power Users can create their own Task Types, but can only
view those of others.
23-1
Chapter 23
Creating Task Types
3. Click New.
4. See also:
• Setting Task Type Properties
• Setting Task Type Parameters
• Specifying Task Type Instructions
• Specifying Task Type Questions
• Working With Task Type Rules
• Viewing Task Type History
23-2
Chapter 23
Creating Task Types
Note:
The Parameters tab is available only if you have selected an Integration that
has parameters that must be defined. Parameter values can be set at the
Task Type level or at the task level.
Some tasks contain parameters that need to be changed each time that they are
applied to a schedule. For example, date-driven parameters for Data Entry tasks may
need to be set to the current month each time they are added to a schedule. When
you set Task Type parameters, you can specify which parameters can be overridden
during the scheduling process.
To set Task Type parameters:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Task Types tab, and then click New.
3. Enter Task Type Name and Task Type ID.
4. Select the Parameters tab.
5. Enter parameter values as required.
6. Optional: To enable the parameter to be overridden at scheduling time, select
Override at scheduling.
7. See also:
• Setting Task Type Properties
• Specifying Task Type Instructions
• Specifying Task Type Questions
• Working With Task Type Rules
• Viewing Task Type History
23-3
Chapter 23
Creating Task Types
• Local File
Enter a name, click Browse to select and attach the file, and click OK.
• URL
Enter a URL name, then enter the URL, for example: Oracle, http://
www.oracle.com, and click OK.
Note:
You can add one or more attachments by using drag and drop
functionality available from the Add Attachments dialog box. You can
rename the attachment in the Name field, if desired. If you drag and drop
multiple attachments, you can upload them at one time.
You must access the Add Attachments dialog box to properly drag and
drop attachments.
3. See also:
• Setting Task Type Properties
• Setting Task Type Parameters
• Specifying Task Type Questions
• Working With Task Type Rules
• Viewing Task Type History
Tip:
To delete a reference, select the reference, and click Delete.
Note:
The Questions tab is not available for a Task Type that uses an automated
Integration.
To specify questions:
1. Create a new Task Type.
2. Select the Questions tab.
3. Click New.
4. From the New Question dialog box, for Question, enter the text for the question.
5. From the Type list, select a question type:
23-4
Chapter 23
Creating Task Types
• Date
• Date and Time
• Integer
• List
Enter a list of valid responses to the question.
• Multi-Line Text
The maximum length should be less than 4,000 characters.
Enter the Number of Lines, from 3 to 50 lines. Multi-Line text determines how
many lines of text are visible, without scrolling, on the Actions dialog boxes.
Include Attachments- select if you want the custom attribute to include an
attachments section.
6. Assign a Role. The purpose of assigning a role is to determine which role can
answer the question:
• Assignee
• Approver
• Owner
• Viewer
When re-ordering questions, you can only re-order within a role.
7. If the question is required, select Required.
The Required checkbox is disabled for Questions assigned to Owner or Viewer
roles.
8. Click OK to save the question.
9. Optional: To change the order of questions, select a question, then click Move to
Top, Move Up, Move Down, or Move to Bottom.
10. Optional: To edit a question, select the question and click Edit. To remove a
question, select the question and click Delete.
11. Click Save and Close to save the Task Type.
23-5
Chapter 23
Creating Task Types
For example, you may have a List attribute named Sales Region with the values of
North, South, East, and West. The current Task Type applies only to the West Sales
Region, so you can add the Sales Region attribute and set it to "West".
To apply an attribute:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Task Types tab on the left, and then click New.
3. Enter the Task Type Name and the Task Type ID.
4. Select the Attributes tab.
Enables administrators to assign attributes and provide values for the attributes.
To add an attribute, click Add. Enter:
• Attribute
Select an attribute from the list of defined attributes.
• Type
This field is not editable - it is populated by the Attribute.
• Value
Select a value associated with the type of attribute; for example, a numeric
value for Formatted Number attribute, a List for List attribute, multiple lines of
displayed text without scrolling for Multi-Line Text, a name of a person, User,
or Yes or No for the Yes/No attribute.
• Access
All roles have view access unless otherwise specified in the Access box.
To add an access, for each of the roles:
a. Click Add.
b. Select a role: Owner, Assignee, Approver, with separate roles for each
Approver level currently in use in the application, or Viewer.
c. Select one of the Role access types.
– Do Not Display—Does not see this attribute on the Task Actions
dialog box, or in any of the dashboards, list views, or reports.
– Allow Edits—Has the ability to add, change, and remove values for
the attribute, but subject to the editability rules.
– Required—Requires a value for the attribute. The Required option
is available for Assignees and Approvers. Until a value is provided,
Assignees are prevented from submitting, and Approvers are
prevented from approving.
d. Click OK.
5. Click OK.
6. See also:
• Setting Task Type Properties
• Setting Task Type Parameters
• Specifying Task Type Instructions
23-6
Chapter 23
Creating Task Types
23-7
Chapter 23
Viewing Task Type History
• Rule—Select a rule.
• Description—Optional. Explain why you configured the rule and how should
be used.
• Message (On some rules)
– Message to Approver—Define an optional message to approver in a
prevent task approval rule.
– Message to Assignee—Define an optional message to assignee in a
prevent task submission rule.
• Approver Level—Select the rule for all levels or select the Approver levels.
Note:
The Approver Level must be set on the Auto Approve Task rule, and
the Prevent Task Approval rule.
• Select Create Filter and populate the conditions section or select Use Saved
Filter, and then select a filter. The filter selected and configured for the rule
determines the conditions that trigger the rule to apply.
• Conditions—Select one:
– Use Saved Filter—The Conditions section displays a read-only version of
the conditions associated with the saved filter.
– Create Filter—The Condition section is enabled.
Conjunction, Source, Attribute, Operand, and Value behave as they do for
the existing advanced filter feature.
• Filter Task—Specify on which task the conditions should be selected: Current
Task, Any Predecessor, Specific Task (Provide the Task ID).
6. See also:
• Setting Task Type Properties
• Setting Task Type Parameters
• Specifying Task Type Instructions
• Specifying Task Type Questions
• Viewing Task Type History
23-8
Chapter 23
Editing Task Types
23-9
Chapter 23
Searching for Task Types
Note:
icon.
Note:
Task Type rules cannot be imported. Use Migration to import Task Type
rules.
To import Task Types, you must have the Service Administrator or Power User security
role.
To import Task Types:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Task Types tab on the left.
3. Click Actions, and then Import.
23-10
Chapter 23
Exporting Task Types
Note:
You can select the Keep Attachments checkbox to retain
attachments to task types that are being replaced.
• Update—Updates partial information for Task Types. This option is not a full
replacement of the Task Type details. Only details for the Task Type properties
specified in the file are updated.
• Delete—Deletes task types based on a list of task IDs provided in a file. The
required information to perform a delete is a file with a column of task IDs.
6. Select a Date Format.
Select a format from the drop-down list of allowed date formats. Date formats are
not translated. By default, the date format is set to the locale date format of the
exported file location.
7. Select a File Delimiter for the import file: Comma or Tab. or choose Other to
specify any single character as the delimiter.
8. Click Import.
Note:
Task Type rules can't be exported. Use Migration to export Task Type rules.
23-11
Chapter 23
Deleting Task Types
Note:
You cannot delete a Task Type if tasks belong to it.
23-12
24
Managing Task Templates
A task template defines a repeatable set of tasks required for a business process. It is
used as a basis for creating schedules. You can create templates for different types of
processes.
Template tasks are not assigned to specific days on a calendar, but are defined using
generic days, for example, day-3, day-2, day-1, day 0, based on the process activities.
You apply the task flow defined in the template to calendar dates when you create
schedules.
If you are a Service Administrator or Power User, you can view, create, edit, and
delete templates.
Note:
The maximum number of task templates that you can create or import is
10,000.
24-1
Chapter 24
Creating Task Templates
6. For Owner, use the default owner or click Select Owner . Administrators,
or Power Users configured with the Administrator or Power User roles are the
only roles that will display when you click Search to select a user to assign as an
Owner. Any member of the Shared Services group can perform the role, but the
same person cannot perform more than one role.
7. Enter the necessary information in the template sections:
• Specifying Template Instructions
• Assigning Viewers to Templates
• Applying Template Attributes
• Specifying Day Labels
• Embedding Templates
• Working With Template Rules
24-2
Chapter 24
Creating Task Templates
24-3
Chapter 24
Creating Task Templates
• Embedding Templates
• Working With Template Rules
Note:
Only users who have the task Viewer role can respond to questions.
Tip:
To remove users, select them and click Remove or Remove All.
24-4
Chapter 24
Creating Task Templates
24-5
Chapter 24
Creating Task Templates
Embedding Templates
You can reuse tasks from one task template in another by embedding one template
into another template. When you schedule tasks for a template, tasks for embedded
templates are also scheduled.
For example, you may have two processes that are essentially the same, with some
additional tasks for one of the processes. You can specify that one template embeds
the second template so if you change one template, you do not need to update the
other one. When you generate a schedule, it will include the tasks from the other
template.
Note:
Only one level of embedding is possible. For example, if Template A is
embedded in Template B, then Template B cannot be embedded in another
template.
Embedded template are task templates that are not designed to be deployed directly,
but rather to be used by other templates that are directly deployed. The Manage
Templates screen includes these columns to identify embedded templates:
• Embedded: a list of templates that are embedded in the current template. Blank if
none.
• Embedded In: a list of templates that the current template is embedded in. Blank if
none.
The columns are not displayed by default, but are available from the View menu.
To embed templates:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Templates tab on the left.
3. From the New or Edit Template dialog, select the Embedded Templates tab.
4. To identify previously embedded templates, from the top menu, select View, then
Columns, and select Embedded In or Embedded Templates.
5. From the Available Templates list, select a template to embed.
6. Click Move to move the template to the Embedded Templates list.
24-6
Chapter 24
Creating Task Templates
Tip:
To remove a template or templates, select the template from the
Embedded Templates list and click Remove or Remove All to move
it to the Available Templates list.
7. Click OK.
8. Enter the necessary information in the template sections:
• Setting Template Properties
• Specifying Template Instructions
• Assigning Viewers to Templates
• Applying Template Attributes
• Specifying Day Labels
• Working With Template Rules
Notes:
1. Auto Submit Task runs when the Task status changes from Pending to Open
with Assignee. Auto Submit Task rule honors predecessor relationship. It will
only run when Finish-To-Finish predecessors have completed without error and
Finish Error-To-Finish predecessors have completed. When a Finish-To-Finish
predecessor is Closed by either user or rules, it should check for its Running
successors and trigger Auto Submit Task rules if necessary.
24-7
Chapter 24
Creating Task Templates
2. Auto Submit Task rule is not triggered when the task has missing parameters.
24-8
Chapter 24
Opening Templates
Opening Templates
You can open and work with templates from the Templates dialog box.
To open a template:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Templates tab on the left.
3. From Templates, select a template.
4. Use one of these methods:
• Select Actions, and then Edit.
• Click the template.
• Right-click and select Edit.
Note:
The maximum number of tasks that you can add to a Task Manager template
is 500,000.
24-9
Chapter 24
Editing Templates
If you have a large list of templates, enter a full or partial name in the Search box
to search for templates from a list in the selection dialog.
4. Add tasks as required.
5. Click OK.
Editing Templates
You can edit Task Manager templates to change the properties, such as the name of a
template and the number of days before and after Day Zero. If you reduce the number
of days before or after the Day Zero, tasks associated with those days are removed.
Editing a template has no effect on schedules previously generated from that template.
You can edit, copy, and delete tasks in a template.
You must be working in the source template to edit tasks from embedded templates.
To edit a Task Manager template:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Templates tab on the left.
3. Select a template and click Edit.
4. Edit the template properties.
5. Click OK.
Note:
Before you import tasks into a template, you must specify task IDs that are
unique in the template to ensure that no two tasks have the same ID.
To import tasks, you must have security rights to edit the template.
These options are available for importing tasks into a template:
• Replace
Replaces the definition of a task with the definition in the import file. This option
replaces the task detail with the detail that is in the file that you are importing. It
does not affect other tasks in the template that are not specified in the import file.
• Update
Updates partial information for tasks. For example, in the import file, you might
have made changes to task instructions, reassigned Owners, Assignees, and
24-10
Chapter 24
Importing Tasks into Templates
Approvers, or removed some attributes and added new attributes. You might also
have made the same change to a large number of tasks, for example, adding a
new attribute to 100 of 400 tasks. The update option is not a full replacement
of the task details. Only details for the task properties specified in the file are
updated. For example, if the import file has only a column for a task instructions,
the task name, Assignee, attributes, and other properties are not affected.
• Delete
Deletes tasks and associated information based on a list of task IDs provided in a
file. The required information to perform a delete is a file with a column of task IDs.
To import tasks into a template:
1. On the Home page, click Application, and then click Task Manager,
2. Click the Templates tab on the left.
3. Select a template into which to import tasks.
4. Click Import Tasks.
5. Enter the name of the file to import, or click Browse to find the file.
6. Select an import option:
• Replace— Replaces the definition of a task with the definition in the import
files. It does not affect other tasks that are not specified in the import file.
Note:
You can select the Keep Attachments checkbox to retain
attachments to tasks that are being replaced.
• Update— Updates partial information for tasks. For example, in the import
file, you might have made changes to task instructions, reassigned Owners,
Assignees, and Approvers, or removed some attributes and added new
attributes. You might also have made the same change to a large number
of tasks, for example, adding a new attribute to 100 of 400 tasks. The update
option is not a full replacement of the task details. Only details for the task
properties specified in the file are updated. For example, if the import file has
only a column for a task instructions, the task name, Assignee, attributes, and
other properties are not affected.
Note:
The system displays a warning that tasks in the template that match
a task ID in the import file will be modified. If you do not want to
overwrite the task, click Cancel to cancel the import process.
24-11
Chapter 24
Task Import File Format
Select a format from the drop-down list of allowed date formats. Date formats are
not translated. By default, the date format is set to the locale date format of the
exported file location.
8. Select a File Delimiter for the import file: Comma or Tab. or choose Other to
specify any single character as the delimiter.
9. Click Import.
• If the import is successful, the Import Success dialog box is displayed, indicating
the template name, the name of the file containing the tasks, and the total number
of tasks imported. Click OK.
• If errors are found, the import process is not run, and the Import Errors dialog box
displays errors. View the errors, then click OK to return to Manage Templates.
Error Resolution
Duplicate Task ID Check for duplicate Task IDs. Task IDs must
be unique within the template or schedule. See
Creating Tasks.
Task Name is too long The Task Name can contain a maximum of 80
characters. See Setting Task Properties.
Organizational Value - "Invalid Value" The Organizational Value cannot be blank,
contain bullet points or multiple lines.
24-12
Chapter 24
Task Import File Format
when you set up the application. For groups of column headings, if you have a certain
number of one of the group, you must have the same number for other members. For
example, if you have QText5, there must be a corresponding QType5.
Note:
When you need to create multiple lines of text in the import file (for example,
in Instructions), use this syntax to indicate a new line: '\n'. Do not use hard
returns to separate lines of text.
24-13
Chapter 24
Task Import File Format
24-14
Chapter 24
Exporting Tasks to Microsoft Excel
• Two questions
• Two attributes
• Two instructional references
• Three predecessor tasks
• Three approver levels
24-15
Chapter 24
Creating Schedules from Templates
a. From the Select User dialog box, enter the first or last name for the user, and
click Search.
b. Select the user from the results, then click OK.
6. Click Replace with and enter search criteria for the user to whom you want to
reassign tasks.
7. Select roles for the user that must be reassigned:
• Owner
• Assignee
• Approver
• Viewer
8. Click Reassign.
When the process ends, the system displays a "Reassign Users - Success"
message that indicates that the user reassignment is complete, and displays the
template name and total number of user reassignments made.
24-16
Chapter 24
Creating Schedules from Templates
Tip:
When you create a schedule from a template, you can globally update the
task parameters for a Task Type if the parameters have the override option
enabled. See Setting Task Type Parameters.
Tip:
You can create one global template and have that template
create the proper schedules for each regional entity, taking into
consideration the holiday calendars, time zones, and work day
configurations of the entity.
* Organizational Unit
Select one:
* Use Task Value—Select a value from the Organizational Unit
* Set Value To—The selected organizational unit is applied to all
tasks in the Schedule (even if the task in the template contained a
24-17
Chapter 24
Manually Validating Templates
different Organizational Unit value). Since all tasks have the same
Organizational Unit, the Organizational Unit in the Date Mapping
panel on the Schedule from Template dialog box displays as Read
Only.
* Work Days—If you do not assign an organizational unit to a task, and
you do not use the Override Work Days feature, than the application
uses the following default: Monday – Friday are working days, and
Saturday and Sunday are non-working days.
– Date Map—For each template day whose date assignment you want to
modify, in the Date column, enter the new date.
5. Optional: Select the Predecessor Task Links tab, select the schedule that
contains the predecessor task and in the Assigned Task list, select the
predecessor task.
6. Optional: Select the Override Parameters tab, review the parameters, and for
each parameter that you want to modify, in the New Value column, enter a new
value.
Note:
This Override Parameters tab displays only tasks that use a Task Type in
which at least one parameter has the Override option enabled.
24-18
Chapter 24
Viewing Task Manager Templates
24-19
Chapter 24
Deleting Templates
4. Optional: From the filter bar, click on a category to display additional search
operators such as Equals, Does Not Equal, Contains, Does Not Contain,
Starts With, and Ends With.
You can filter templates using these categories: Name, Owner, Organizational
Unit, Days After Day 0, Days Before Day 0, Embedded In, Embedded Only,
Embedded Templates, Description, Created By, Created On, Last Updated
By, or Last Updated On.
Note:
icon.
Deleting Templates
You can delete Task Manager templates that you no longer need. To delete a template,
you must have security rights to the template.
Deleting a template removes it from the list of available templates and removes
tasks associated with it. It does not directly affect a running schedule, however some
reporting and dashboard metrics may use the template to link various schedule runs
together, which are not possible if the template is deleted.
To delete a Task Manager template:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Templates tab on the left.
3. Select the template, and click Delete.
4. At the confirmation prompt, click Yes.
24-20
25
Managing Tasks
Tasks are the core units of action in a business process, such as data entry or data
consolidation.
Each task has different parameters depending on the Task Type. If you have Service
Administrator or Power User security rights, you can create, edit, or delete tasks.
See Creating Tasks.
Creating Tasks
You can add tasks to templates or schedules. If you create a task in a template, you
assign the start and end date as days before or after Day Zero. If you create a task in
a schedule, you select calendar dates for the start and end dates.
You can group tasks under parent tasks to provide a simpler view of the business
process. After viewing upper-level parent tasks, you can then drill into the underlying
tasks. Child tasks of parent tasks may have different owners than the parent task.
You can create a task using any of these methods:
• Drag and drop the Task Type onto a template or schedule in a view.
• Right-click on a task and select New.
Then enter the task information:
• Setting Task Properties
• Setting Task Parameters
• Specifying Task Instructions
• Selecting the Workflow
• Adding Task Questions
• Setting Task Access
• Setting Task Predecessors
• Applying Task Attributes
• Working With Task Rules
• Viewing Task History
Watch this video to learn more about creating tasks.
Creating Tasks
25-1
Chapter 25
Creating Tasks
Note:
You can use carriage returns and URLs in Descriptions, Questions,
and Instructions.
• Organizational Unit
Represents a hierarchical entity-type structure that you can use to model
your organization. Define a separate organizational unit for each entity for
which separate reporting is required, or for entities that require different
configurations for any of the following: time zones, holidays, work days,
or viewer or commentator assignments. Organizational Units are defined in
system settings.
• Task Type (required)
Click Browse and select a Task Type.
• Priority
Select a priority for the task:
– High
25-2
Chapter 25
Creating Tasks
– Medium
– Low
• Owner
Use the default owner or click Select Owner to select a user or Shared
Services group.
• Select Active to include this task in schedules generated from the template.
Note:
This option is not available for tasks created in schedules.
25-3
Chapter 25
Creating Tasks
Note:
If the parameters are not defined when the task is ready to start, an
email is sent to the task owner. The task waits to start until the values
are provided.
5. See also:
• Setting Task Properties
• Specifying Task Instructions
• Selecting the Workflow
• Adding Task Questions
• Setting Task Access
• Setting Task Predecessors
• Applying Task Attributes
• Working With Task Rules
• Viewing Task History
25-4
Chapter 25
Creating Tasks
Note:
To add a reference file or URL to multiple tasks at one time:
a. Navigate to the Tasks page.
b. You can multi-select (either highlight more than one row or select
more than one using the SHIFT key), and then click Actions, then
Add Reference, then File or URL.
Note:
You can also add one or more attachments by using drag and drop
functionality available from the Add Attachments dialog box. You can
rename the attachment in the Name field, if desired. If you drag and drop
multiple attachments, you can upload them at one time.
You must access the Add Attachments dialog box to properly drag and
drop attachments.
3. See also:
• Setting Task Properties
• Setting Task Parameters
• Selecting the Workflow
• Adding Task Questions
• Setting Task Access
• Setting Task Predecessors
• Applying Task Attributes
• Working With Task Rules
• Viewing Task History
25-5
Chapter 25
Creating Tasks
the workflow, the Actual column shows who performed work on the task,
regardless of the user status.
Note:
The additional user information only appears if the task is reassigned
after it was completed by the initial user.
Note:
For a Process-Automated task, click Run As, search for and select a
user under which tasks of this type are run, and click OK.
If the selected Run As user is the user creating the task,
authorization is not required.
• Backup—If you assigned a user for the primary Assignee, you can assign a
backup user authorized as an Assignee:
a. Click Backup .
b. Enter the First Name and Last Name or click Search to select a backup
user.
c. Click OK.
• Starts
Select a start date, then select the time of day, in increments of 15 minutes, for
the task to start.
• Ends
Select an end date, then select the time of day, in increments of 15 minutes,
for the task to end.
• Optional: For Minimum Duration, enter the minimum duration of a task in the
form of Days, Hours, and Minutes. An At Risk criteria is based on the condition
if the Start date was missed and (the End_date minus the Current_date is less
than the minimum task duration or the End_Date minus the Start_Date is less
than the minimum duration). The At Risk tasks display in the Needs Attention
Graph in the Status Chart of the Dashboard.
• Optional: For an End-User task, select Allow Early Start to allow the
Assignee to open the task before the scheduled start time.
Enter this information for the Approver:
• Level Name
25-6
Chapter 25
Creating Tasks
• Backup
• End Date
5. See also:
• Setting Task Properties
• Setting Task Parameters
• Adding Task Questions
• Setting Task Access
• Setting Task Predecessors
• Applying Task Attributes
• Working With Task Rules
• Viewing Task History
Note:
The Questions tab is not displayed for automated tasks or parent tasks.
When you create a task, you may want the Assignee to answer questions about their
actions before they indicate a task is complete. For example, you may ask if a certain
process was followed when completing that task.
You can specify questions on the task. You can specify various types of questions,
such as Text, Number, or True/False, and indicate whether they are required. If
a question is required, the user must respond or they cannot submit the task for
approval. You can also order the questions by using the Move Up and Move Down
buttons.
For schedule tasks, users can respond to the questions from the Task Actions page.
If you are creating or updating a task in a template, an additional column displays,
showing whether the row is locked or unlocked to indicate whether the user can
remove or update the questions. Rows that are locked cannot be edited or deleted
because they are inherited from the Task Type.
In templates, the Task Type questions are displayed, but are not editable.
Note:
Only users who have the task Viewer role can respond to questions.
To add a question:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Templates tab on the left and then click Tasks.
25-7
Chapter 25
Creating Tasks
25-8
Chapter 25
Creating Tasks
Tip:
For additional details about the user, such as groups and roles, click
Details.
3. Optional: To change the order of approvers, select users, then click Move to Top,
Move Up, Move Down, or Move to Bottom.
Tip:
To remove a user from the Approvers or Viewers list, select the user,
then click Remove.
4. See also:
• Setting Task Properties
• Setting Task Parameters
• Specifying Task Instructions
• Selecting the Workflow
• Adding Task Questions
• Setting Task Predecessors
25-9
Chapter 25
Creating Tasks
Condition Description
Finish to Start Default. The task starts as soon as the
predecessor task completes or finishes with
warning.
Finish Error to Start The task starts as soon as the predecessor
task completes, even it is in error.
Finish Error to Finish The task completes as soon as the
predecessor task completes, even it is in error.
Finish to Finish The task cannot be marked as Complete
until the predecessor task is marked as
complete. This is primarily used for user tasks.
For example, a user can start a document
summary, but cannot mark it complete until the
consolidated data is final.
25-10
Chapter 25
Creating Tasks
25-11
Chapter 25
Creating Tasks
3. See also:
• Setting Task Properties
• Setting Task Parameters
• Specifying Task Instructions
• Selecting the Workflow
• Adding Task Questions
• Setting Task Access
• Setting Task Predecessors
• Working With Task Rules
• Viewing Task History
25-12
Chapter 25
Creating Tasks
2. Create a task.
3. Select the Rules tab to open a New Rule.
• Order—The order of precedence.
• Rule—Name of the Rule
• Conditions—The choice of what conditions must exist before running the rule
4. Under Rule, select the type of rule you want to use:
• Auto Approve Task
• Auto Submit Task
• Prevent Task Submission
• Prevent Task Approval
• Prevent Task Rejection
• Send Email on Update
• Select Create Filter and populate the conditions section or select Use Saved
Filter, and then select a filter. The filter selected and configured for the rule
determines the conditions that trigger the rule to apply.
5. Optional: Under Description, explain why you configured the rule and how it
should be used.
6. For Approver Level, select the rule for all levels or select the Approver levels.
7. Select the Filter to determine the conditions that trigger the rule to apply:
• Use Saved Filter—The Condition section displays a read-only version of the
conditions associated with the saved filter.
• Create Filter—The Create Condition section is enabled. Select the
conditions that apply for the advanced filter: Conjunction, Source, Attribute,
Operand, and Value
8. Under Filter Task, select the task to which the conditions should be applied:
Current Task, Any Predecessor, Specific Task (Provide the Task ID).
9. See also:
• Setting Task Properties
• Setting Task Parameters
• Specifying Task Instructions
• Selecting the Workflow
• Adding Task Questions
• Setting Task Access
• Setting Task Predecessors
• Applying Task Attributes
• Viewing Task History
25-13
Chapter 25
Viewing Task History
25-14
Chapter 25
Importing and Exporting Tasks
• Actual Duration
7. Click Instructions to display any instructions.
8. Click Alerts to display current alerts.
9. Click Workflow to view assignees for the tesk.
10. Click Attributes to view any attributes for the task.
11. Click Questions to view any questions that have been posted for the task.
12. Click Comments to view any comments that have been posted for the task.
13. Click Related Tasks to view any related tasks. You can view Predecessors or
Successor tasks.
14. Click Parameters to view dashboard, cluster, application, and so on.
15. Click History to capture an audit trail of changes to the task. You can view the
activity for the task, including All Activity, Last 7 Days, and Today.
16. Click Actions, then select one of the following actions:
• Submit Task
• Abort Task - The purpose of aborting a task (instead of performing a forced
close) is to prevent successors from continuing and to keep the process
moving.
• Force Close Task
• Refresh
17. Click Close.
25-15
Chapter 25
Editing Tasks
of tasks, for example, adding a new attribute to 100 of 400 tasks. The update
option is not a full replacement of the task details. Only details for the task
properties specified in the file are updated. For example, if the import file has
only a column for a task instructions, the task name, assignee, attributes, and
other properties are not affected.
• Delete—Deletes tasks and associated information based on a list of task IDs
provided in a file. The required information to perform a delete is a file with a
column of task IDs.
5. Select a Date Format.
Select a format from the drop-down list of allowed date formats. Date formats are
not translated. By default, the date format is set to the locale date format of the
exported file location.
6. Select a File Delimiter for the import file: Comma or Tab. or choose Other to
specify any single character as the delimiter.
7. Click Import.
Exporting Tasks
To export tasks:
1. On the Home page, click Tasks, and then click Schedule Tasks.
2. Select a task, click Actions, and then select Export.
3. Select Export options:
• Select All Tasks or Selected Tasks
• For Format: Select Formatted data (visible columns only) or Unformatted
data for future import
Note:
If you are an Administrator or Power User, you can select the format. If
you have User security rights, by default the Format option is Formatted
data (visible columns only), and it cannot be changed.
4. Click Export.
5. Select Open with Microsoft Office Excel (default), or Save File.
6. Click Close.
Editing Tasks
You can edit tasks depending on their status and your security rights. For example,
you can edit a task description, attributes, or end date.
For an Open task in a Task List, you cannot edit the start date, because the task
has started. You can only change the duration or the end date. You also cannot
edit instructions, questions, Assignee, or approver, and you cannot add, delete, or
edit predecessors. You can reassign the Assignee or approver from the Task Actions
workflow.
25-16
Chapter 25
Adding Attachments
To edit a task:
1. On the Home page, click Tasks, and highlight the task that you want to edit. The
Edit icon is enabled.
2. Click the Edit icon.
3. To edit task attributes:
Select the Attributes tab.
To add an attribute, click the Add icon to display the Add Attribute Assignment
dialog box., and make the following selections:
• Attribute
Select an attribute from the list of defined attributes.
• Type
This noneditable field is populated by the Attribute.
• Value
Select a value associated with the type of attribute; for example: a numeric
value for Formatted Number attribute, a List for List attribute, multiple lines of
displayed text without scrolling for Multi-Line Text, a name of a person, User,
or Yes or No for the Yes/No attribute.
• Access
Select the access to the attribute.
4. Click OK.
Adding Attachments
If you have an attachment you want to include with your task, such as a Word file,
Excel spreadsheet or other document, you can use one of the following methods to
attach the document to the task. You can attach multiple items at the same time. When
you click OK, the system uploads all the documents that you attached.
To add an attachment to a task:
1. From the Home page, click Tasks, and then click Schedule Tasks.
2. Select a task.
3. Select the Comments tab.
4. Click the Attachment icon to open the Add Attachment dialog box.
5. Select one of the following options to attach the document:
• Browse to the location of the document.
• Drag and drop the document directly from your local directory.
6. Optional: Rename the document.
7. Click OK.
25-17
Chapter 25
Sorting Tasks
Sorting Tasks
From the Task List, you can sort tasks by ascending or descending order. You can sort
by Schedule Name, Status, Owner, Start or End Date, or Duration.
To sort tasks:
1. On the Home page, click Tasks, and then click Schedule Tasks.
2. Hover over a column header until the Sort icons display, and then click Sort
Ascending or Sort Descending.
Moving Tasks
You can use views to move tasks. For example, you can move tasks in the Gantt view.
To move a task:
1. On the Home page, click Tasks, and then click Schedule Tasks.
2. Select a task.
3. Right-click on the task and drag it to a new location, or cut, copy, and paste the
task.
4. Navigate to the target destination for the task and click OK.
25-18
Chapter 25
Reopening Tasks
Note:
Cut, Copy, and Paste features are not available for parent tasks. The Cut
function is not available for scheduled (open or closed) tasks.
Reopening Tasks
You can reopen tasks and choose to reestablish the predecessor and successor
relationships.
To reopen a task:
1. On the Home page, click Tasks and then click Schedule Tasks.
2. Select a closed task and double-click it.
3. On the Properties tab, under Actions , select Reopen Task. The Task is now
editable.
4. Add or delete predecessors and then click Save and Close.
Designate relationships:
• Designate predecessor tasks. Choose one:
– If there are predecessors, then you can choose this option: Re-establish
predecessor relationships - Tasks will open in original order.
– Ignore predecessor relationships - All tasks will re-open immediately.
• Designate successor tasks:
a. Select Re-Open Successor Tasks. The successor list is displayed.
b. Select the successor tasks.
5. Click OK to close. The task details dialog box closes and the task reopens based
on your selections. Click OK, otherwise, click Cancel.
25-19
Chapter 25
Submitting Tasks
Submitting Tasks
To submit tasks:
1. On the Home page, click Tasks, and then click Schedule Tasks.
2. Select the tasks that you need to submit.
To multiselect, press Ctrl for random selection or press Shift while you click the
first and last row in a range.
3. Select Submit Task. A warning is displayed that this will complete the task. Click
Yes to proceed.
4. Review any errors, and click OK
25-20
Chapter 25
Aborting Tasks
Aborting Tasks
The purpose of aborting a task (instead of performing a forced close) is to prevent
successors from continuing and to keep the process moving:
• When a Finish-to-Start or Finish-Error-to-Start predecessor is aborted, its
successors remain as Pending. To keep the process moving, you must edit the
successors to remove the aborted predecessor and to start the successors.
• When a Finish-to-Finish or Finish-Error-to-Finish predecessor is aborted, to keep
the process moving, the task owner/schedule owner/administrator must force a
close of the successor.
Deleting Tasks
You can delete tasks that you no longer need. To delete a task, you must have Service
Administrator or Power User security rights.
In schedules, you can delete only tasks that have a status of Pending. You cannot
delete tasks that have a status of Open or Closed. If you delete a parent task, you can
choose to delete just the parent, or the parent and its children.
You can delete the schedule tasks using the actions menu on the task . (Delete will not
appear in the menu when the task is open or completed.)
To delete a task:
1. On the Home page, click Tasks, and select a task.
2. From Actions, and then select Delete.
3. At the confirmation prompt, click Yes.
25-21
26
Managing Schedules
A schedule defines a chronologically ordered set of tasks that must be executed for a
specific business process, and is the application of a template into the calendar. For
example, you can apply the Quarterly template as Q1FY19 for the first Quarter, then
apply the template again as Q2FY19 for the second quarter.
The maximum number of schedules that you can create, import, or deploy is 100,000.
Schedules have a status of Pending, Open, Closed, or Locked. You can change the
status of a schedule from Pending to Open, or from Open to Closed or Locked.
Note:
After a schedule is set to Open, it cannot be reset to Pending.
After a schedule is set to Locked, its status cannot be changed.
Creating Schedules
To manually create a schedule:
1. On the Home page, click Application.
2. Click Task Manager.
3. Click the Schedules tab on the left.
4. Click New.
5. Enter schedule information on the schedule tabs:
• Setting Schedule Properties
• Adding Instructions to Schedules
• Assigning Schedule Viewers
• Applying Schedule Attributes
• Adding Day Labels
26-1
Chapter 26
Manually Creating Schedules
Note:
The schedule status is initially set to Pending and is display only.
• Source Template
2. To save and close, click OK or click the another tab; all entries are saved.
3. Enter schedule information on the schedule tabs:
• Adding Instructions to Schedules
• Assigning Schedule Viewers
• Applying Schedule Attributes
• Adding Day Labels
• Working With Schedule Rules
• Viewing Schedule History
26-2
Chapter 26
Manually Creating Schedules
26-3
Chapter 26
Manually Creating Schedules
Note:
Only users who have the task Viewer role can respond to questions.
Tip:
To remove users, select users, then click Remove or Remove All.
9. To save and close, click OK or click the Attributes tab; all entries are saved.
10. Enter schedule information on the schedule tabs:
26-4
Chapter 26
Manually Creating Schedules
2. Click Add.
3. From the Attribute list, select an attribute.
4. For Value, depending on the attribute, select a value for the attribute from a
drop-down list, or enter a value.
5. To save and close, click OK or click the Day Labels tab; all entries are saved.
6. Enter schedule information on the Schedule tabs:
• Setting Schedule Properties
• Adding Instructions to Schedules
• Assigning Schedule Viewers
• Adding Day Labels
• Working With Schedule Rules
• Viewing Schedule History
26-5
Chapter 26
Manually Creating Schedules
Auto Submit Task - Automatically submits a task if specified conditions are met.
When conditions are satisfied, the Assignee role is marked complete, and workflow
progresses to the first Approval level, or closes if no Approval levels exist.
26-6
Chapter 26
Setting Required Task Parameters
Opening Schedules
You open schedules to add, edit, or work on tasks.
To open a schedule:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Schedules tab on the left.
3. Use one of these methods:
• Select Actions, and then Open.
• Click the Open icon.
• Right-click and select Open.
Editing Schedules
You can edit schedules to change the properties, such as the name or the schedule
or the start and end dates. You cannot change the start date to a date later than the
first task in the schedule, or the end date to a date earlier than the last task in the
schedule. You can make changes to an Open or Pending schedule to modify pending
tasks. You cannot add, change, or delete tasks in a Closed or Locked schedule. To
edit a schedule, you must be the schedule owner or an Administrator.
To edit a schedule:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Schedules tab on the left.
3. Select a schedule and click Edit.
4. Edit the schedule.
5. Click OK.
26-7
Chapter 26
Importing Tasks into Schedules
Note:
The maximum number of tasks that you can add to a Task Manager
schedule is 500,000.
Note:
Before you import a file to a schedule using the Update option for a closed
task, remove the Owner, Assignee, Approver, and Start Date and Time fields
from the import file, or an error occurs.
If you import information on an End-User task that has started running, it is reset to
Open with Assignee status, and the answers to questions are cleared.
To import tasks into a schedule:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Schedules tab on the left.
3. Click Import Tasks.
4. Enter the name of the file to import, or click Browse to find the file.
5. Select an import option:
• Replace— Replaces the definition of a task with the definition in the import
file. This option replaces the task detail with the detail that is in the file that
you are importing. It does not affect other tasks in the schedule that are not
specified in the import file.
26-8
Chapter 26
Importing Tasks into Schedules
Note:
You can select the Keep Attachments checkbox to retain
attachments to tasks that are being replaced.
• Update— Updates partial information for tasks. For example, in the import
file, you might have made changes to task instructions, reassigned Owners,
Assignees, and Approvers, or removed some attributes and added new
attributes. You might also have made the same change to a large number
of tasks, for example, adding a new attribute to 100 of 400 tasks. The update
option is not a full replacement of the task details. Only details for the task
properties specified in the file are updated. For example, if the import file has
only a column for a task instructions, the task name, Assignee, attributes, and
other properties are not affected.
Note:
The system displays a warning that tasks in the schedule that match
a task ID in the import file will be modified. If you do not want to
overwrite the task, click Cancel.
Error Resolution
Duplicate Task ID Check for duplicate Task IDs. Task IDs must
be unique within the template or schedule.
See Creating Tasks.
Task Name is too long The Task Name can contain a maximum of
80 characters. See Setting Task Properties.
26-9
Chapter 26
Updating Tasks in Schedules
Error Resolution
Organizational value - "Invalid Value" The Organizational value cannot be blank,
contain bullet points or multiple lines.
26-10
Chapter 26
Reassigning Users in Schedules
26-11
Chapter 26
Setting Schedule Status
• If you add a Process-Automated task with an alternate runtime user known as the
Run As user to a schedule, from a template or by manually adding the task
• When you set a schedule to Open status, the system automatically issues a
request for authorization if it has not been completed.
If the parameters of a task are modified by a user other than the Assignee (or task
owner if the owner is also the Assignee), the authorization is reset to Unauthorized
and must be obtained by entering a password. For Process-Automated tasks, if a user
other than the specified or default Run As user modifies the parameters, the task is
reset to Unauthorized.
Authorization ensures that the user performing the Process Automated task has
security privileges for the application and data for which the task runs. An
administrator who knows the credentials of the runtime user can perform the
authorization or issue a request to the user to obtain authorization.
When the Process Automated task is scheduled to run, if authorization is not provided,
the task is not run, and its status changes to Needs Attention. If an owner or Assignee
edits the task, the task details indicate that authorization is required. In this case, only
the Run As user can authorize the task.
A user who receives a request for authorization can access the authorization on the
Worklist from a link in the email or by logging on to the application.
To authorize a task:
1. On the Home page, click Application, and then click Task Manager
2. Select Manage, then Schedules.
3. Select a schedule.
4. Select Actions, and then Authorize Tasks, or select the Authorize Tasks icon.
The system displays a Users selection list and a table of unauthorized tasks for
the selected schedule. The user selection list is populated with users that have
pending Process-Automated tasks assigned to them that require authorization.
5. From the user selection list, select a user.
The system displays a list of unauthorized tasks for that user. Your user name
displays first on the list in bold by default. If you have no unauthorized tasks, the
list is blank.
6. Select a task that needs authorization.
7. To view task details, click a task name and review the task parameters.
Tip: To contact the task owner by email, click the Owner name next to the task
and view the user details.
26-12
Chapter 26
Setting Schedule Status
Pending
The schedule is not yet active. This is the default status of the schedule when it is
created. For a schedule in Pending status, you cannot close or lock the schedule.
Open
The schedule is open for work to be performed. Tasks in the schedule can be run.
Closed
The schedule is no longer active but follow-up work may be required. Tasks in the
schedule continue to proceed based on their definitions, but you cannot add tasks
to the schedule. Schedule owners or administrators can reopen a Closed schedule,
which changes its status to Open.
Locked
The schedule is locked and cannot be modified. You can reopen a locked schedule, if
required.
When you create a schedule, it has a status of Pending by default so that you can
make final adjustments to it, and add, edit, or delete tasks.
To run a schedule, you change the status from Pending to Open. When the schedule
is opened, tasks begin to execute according to their definition. Status for tasks that
have met their starting condition are set to Open, and task notifications are sent to
their Assignees.
Note:
If a schedule task start time is reached and authorization has not been
provided for a system-automated task, the task remains in the Pending
status and requires authorization.
When work on the schedule has reached a stage when follow-up work is all that
is required, you set the status to Closed. You cannot add new tasks to a Closed
schedule, however users can continue to work on tasks that are not complete. You can
reopen a Closed schedule, which changes its status to Open.
When all tasks are completed, you set the status to Locked. You cannot edit a Locked
schedule, but you can set the status back to Open, if required.
To set schedule status:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Schedules tab on the left.
3. Select one or more schedules for which to set status.
4. Select Actions, and then Set Status, or select the Set Status dropdown.
5. Click one of these status options, depending on the current status:
• Open
• Closed
• Locked
26-13
Chapter 26
Viewing Schedule History
Validating Schedules
You can validate schedules with a status of Pending or Open. Validating a schedule
checks for problems with start and end dates, predecessor relationships, parent-
child relationships, and missing task parameters for product integrations. You cannot
change a schedule status from Pending to Open until all validation errors are resolved.
To validate schedules, you must be the schedule owner or Service Administrator.
The validation results show the schedule names, status, and error messages. You can
sort the results by Schedule Name or Status.
To validate schedules:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Schedules tab on the left.
3. Select one or more schedules to validate.
4. Select Actions, and then Validate, or select the Validate icon.
If no errors exist, the validation results show a "Schedule is valid " message. If
errors exist, it shows the error details.
Locking Schedules
You can lock a schedule to prevent users from making further changes.
To lock a schedule:
1. On the Home page, click Application, and then click Task Manager.
26-14
Chapter 26
Viewing Schedules
Viewing Schedules
In Schedules, you can specify which columns to display for the list of schedules, or
show all. You can also reorder columns, sort columns by ascending or descending
order, or change the column widths.
To display columns:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Schedules tab on the left.
3. Do one or more of the following tasks:
• To display all columns, select View, then Columns, and then select Show All.
• To display specific columns, select View, then Columns, and select or deselect
the column names.
• To reorder columns, select View, and then Reorder Columns, select columns
and use the Up or Down arrows or drag them to change the order.
• To sort columns, hover over a column header until the Sort icons are
displayed, and then click Sort Ascending or Sort Descending.
• To change column widths, hover over the column header dividers until the
arrows display, and drag the columns to the desired width.
26-15
Chapter 26
Deleting Schedules
Note:
icon.
Deleting Schedules
You can delete a schedule that you no longer need. To delete a schedule, you must be
the schedule owner or Service Administrator. Deleting a schedule removes it and all
references to it from the system.
To delete a schedule:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Schedules tab on the left.
3. From Schedules, select the schedule that you want to delete.
4. Click Delete.
The system displays a warning that if you delete a schedule, it will also
permanently delete all tasks within the schedule, and the only way to recover
is from a backup.
5. To delete the schedule, click Yes.
26-16
27
Managing Task Manager Integrations
You can enable Task Manager tasks to include integrations with external applications.
An Integration requires an execution URL for user tasks and an optional set of
parameters. The execution URL launches the external program, and the parameters
pass information required for the task to the external program. For example,
the Approve Journals Integration contains parameters such as the Point of View
dimension values for the journal.
To manage Task Manager Integrations, you must have the Service Administrator role.
When you create an Integration, you select one of these task types:
End User
Users must perform and validate the task. For example, the task may be a generic
task such as submitting data, or it may require product integration to facilitate or
validate its completion.
Process Automation
These integrations are automatically executed in external applications when their Start
date and time are reached, and their predecessor tasks are completed, for example,
an overnight feed from a General Ledger. These tasks are often executed after
working hours. They require limited user interaction and do not have Assignees.
Event Monitoring
These are based on events that occur in external applications, for example Approve
Journals.
Task Manager provides these pre-built Integrations:
• Cloud Integrations: End User and Process Automation integrations for EPM Cloud
Connections. See Task Manager Integrations with EPM Cloud Services.
• Cloud Integrations: Oracle Fusion integrations. See Task Manager Integrations
with Cloud and On-Premises Applications.
• On-Premises End User and Event Monitoring Integrations. See Task Manager
Integrations with Cloud and On-Premises Applications.
• On-Premises Oracle E-Business Suite General Ledger, Accounts Payable, and
Accounts Receivable Integrations. See Task Manager Integrations with Cloud and
On-Premises Applications.
If you require any other Integrations for Cloud or On Premises, you can create Custom
Integrations. See Creating Custom Task Manager Integrations.
Creating Integrations
When you create Integrations, you select End-User as the Execution type. Users can
then create task types based on the defined Integrations, or validate the Integrations.
27-1
Chapter 27
Creating Integrations
To create an Integration:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Integrations tab on the left.
3. Click New.
Add information to the following sections:
• Setting Integration Properties
• Setting Integration Parameters
Note:
You can maintain the list of applications from the Manage Connections
icon in the Manage Connections dialog box.
6. For Execution Type, select End User Task and select options:
• End User Endpoint: To enter parameters for an End-User task, the End User
Endpoint should contain those parameters in these formats:
$ Parameter Type Code $, for example $COLORS$. The system replaces the
parameter tokens in the End User Endpoint with the information you specified
for the task parameters.
• Optional: Show in-line: Select whether to display the URL in line within the
Task Actions dialog.
• Optional: SSO Parameter: Specify the name of the SSO parameter for your
application to include when executing the End-User task URL to the external
application. If you do not specify an SSO parameter, the system uses the End
User URL.
27-2
Chapter 27
Editing Integrations
Editing Integrations
You can't edit the pre-built Integrations provided by default by the system. You can
only edit custom-built integrations that you created.
27-3
Chapter 27
Validating Integrations
For an End-User type, you can edit the endpoint, change the point of view, or change
the list of values.
To edit an Integration:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Integrations tab on the left.
3. Select an Integration, and click Edit.
4. Edit the Integration.
5. Click Save and Close.
Validating Integrations
You can test and validate Task Manager Integration definitions from the Integrations
module before you create and execute tasks. You can provide parameter values for
the parameter definition, and then test those parameters. For End-User tasks, the
system displays the end result URL web page.
The Validation results can contain any or all sections:
• Security Settings—Security settings for this Integration; includes the Request
and Response Security Policy and Keystore Alias specified in the application, and
the End-User URL and SSO Parameter of the Integration. These settings are set
in the application of the Integration.
• Application Tokens—Lists the application-level tokens that exist for the
Integration. If there are no application-level tokens, this section is not displayed.
• Registry Settings—Displays the values from the installation registry, for example:
– Web Application settings, displayed only if the Web App setting is defined in
the application
– Web Service application settings, displayed only if the web service application
setting is defined in the application
• Parameters—This section is identical to the Parameters section for tasks and
task details, and enables you to provide values for Integration parameters. Task
Information parameters are also displayed and editable, and parameter errors are
displayed.
• Results—Displays the current End-User Endpoint URL with the tokens that you
specified. Click Refresh to update the URL.
To validate an Integration:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Integrations tab on the left.
3. Select an Integration.
4. Click Validate.
End-User Integration Type: The system displays the security settings,
Application Tokens if applicable, parameters, and results. Click Validate to open
the URL in a browser window.
27-4
Chapter 27
Deleting Integrations
Tip:
If you need to cancel the process, you can click Cancel Validation when
the validation is in the Invoking or Waiting for Response stage.
Deleting Integrations
You can delete Integrations that you no longer need. However, you can't delete pre-
built Integrations provided by default and you can't delete an Integration while it is
associated with a Task Type.
To delete an Integration:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Integrations tab on the left.
3. Select an Integration to delete.
4. Click Delete.
5. At the confirmation prompt, click Yes.
Managing Connections
Integrations are assigned connections for the external products to which they link.
From the Manage Connections module, you can maintain a list of connections
associated with the Integrations. You can search on and sort the list by connection.
• Adding Connections
• Editing Connections
• Deleting Connections
Adding Connections
You can add connections to associate with an Integration Type. You can also specify
the security policy to use for an Integration Type.
In addition, you can specify application-level tokens and values for all Integration
Types in an application. When you specify an application-level token in an end-user
URL or web service WSDL, the system replaces the token with the value defined
for that token in the application. For example, you can specify tokens with values for
server and port, and the system automatically applies those values to the Integration
Types in the application.
To add a connection:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Integrations tab on the left.
3. Click Manage Connections.
4. Click New.
27-5
Chapter 27
Managing Connections
Tip:
To remove a token, click Delete.
Editing Connections
You can edit the name of a connection, the security information, and application-level
tokens.
Note:
You cannot add or modify application tokens for seeded applications. You
can only edit the token values.
You also use the Edit Connections dialog to enable pre-built Integrations. After you
enable the Integration and fill in the parameters, you can then create tasks using Task
Types for the enabled Integrations.
To edit a connection:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Integrations tab on the left.
3. Click Manage Connections.
4. Select a connection, and click Edit.
5. To enable a pre-built Integration, select the connection, select Enabled, and fill in
the parameters.
You can enable or disable a connection at any time.
6. Edit the settings or tokens as needed, and click OK.
Deleting Connections
You can delete connections that you no longer need for Integrations. You cannot
delete a connection while it is associated with an Integration Type. You must modify
the properties for each Integration Type that references the connection before you can
delete the connection.
Note:
You cannot delete seeded Integration connections.
27-6
Chapter 27
Viewing Integrations
To delete a connection:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Integrations tab on the left.
3. Click Manage Connections.
4. Select a connection, and click Delete.
Viewing Integrations
You can view the properties and parameters of imported Integrations. You can specify
which columns to display, or show all. You can also reorder columns, sort columns by
ascending or descending order, or change the column widths.
To display columns:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Integrations tab on the left.
3. Select View, then Columns, and then select an option:
• To display all columns, select Show All.
• To display specific columns, select or deselect the column names.
To reorder columns:
1. Click Integrations.
2. Select View, and then Reorder Columns.
3. Select columns and use the Up and Down arrows to change the order.
To sort columns:
1. Click Integrations.
2. Hover over a column header until the Sort icons display, then click Sort
Ascending or Sort Descending.
To change column widths:
1. Hover over the column header dividers until the arrows display.
2. Drag the columns to the desired width.
27-7
Chapter 27
Creating Custom Task Manager Integrations
27-8
Chapter 27
Creating Custom Task Manager Integrations
Make sure you have the prerequisites and follow these steps to set up an integration
between Task Manager and an external application.
For an overview of the custom integrations flow, see Creating Custom Task Manager
Integrations.
Prerequisites
To integrate Task Manager with an external application, you need:
• A subscription to Oracle Integration Cloud Service, to integrate with on-premises
and non-EPM Cloud services.
Note:
You need one Integration Cloud instance per Oracle EPM cloud
instance.
Note:
If the on-premises application services are deployed in an environment
set up in a demilitarized zone (DMZ) configuration so that these services
are publicly accessible through the Internet, you do not need to install
Integration Cloud Agent.
27-9
Chapter 27
Creating Custom Task Manager Integrations
27-10
Chapter 27
Creating Custom Task Manager Integrations
3. Click Manage Connections, and then from Actions, select Integration Cloud
Connection.
4. Specify the Integration Cloud connection URL and credentials and click Validate.
After validation is successful, click Save. This saves the server and credentials of
the connection.
15. From the list of Triggers, select the Oracle Enterprise Performance
Management Adapter and drag it to the diagram as the Start trigger.
16. From the list of Triggers, drag and drop the external application connection that
triggers the event.
17. From Operation Selection, select the operation for the external application.
18. Navigate to Mapping, and complete the mapping between the Source parameter
and Target parameter.
19. From the list of Invokes, drag and drop the service connection and select Update
Task Status Operation.
20. Edit and complete mapping the parameters.
21. Navigate to Tracking, and specify the Business Identifier for Tracking, for
example taskID, integrationCode, and parameters.
22. From the list of Integrations, select and activate the integration.
27-11
Chapter 27
Creating Custom Task Manager Integrations
3. In Task Manager, select Schedules, and create a new Schedule in Pending state.
See Manually Creating Schedules.
4. Create the process automation task and add it to the schedule. See Creating
Tasks.
5. From Schedules, select and open the schedule.
Prerequisites
To integrate Task Manager with an external application, you need:
• A subscription to Oracle Integration Cloud Service, to integrate with on-premises
and non-EPM Cloud services.
Note:
You need one Integration Cloud instance per Oracle EPM cloud
instance.
Note:
If the on-premises application services are deployed in an environment
set up in a demilitarized zone (DMZ) configuration so that these services
are publicly accessible through the Internet, you do not need to install
Integration Cloud Agent.
27-12
Chapter 27
Creating Custom Task Manager Integrations
27-13
Chapter 27
Creating Custom Task Manager Integrations
27-14
28
Managing Alert Types for Task Manager
and Supplemental Data Manager
Note:
The Alert Types feature is only available to administrators.
28-1
Chapter 28
Creating Alert Types
An object may have multiple alerts with different restrictions. If this is the case, the
following rules will apply in order of precedent:
1. If any open alert associated with the object has a Prevent Workflow restriction,
Prevent Workflow will stop the object's (for example, a Task) workflow until the
alert is closed.
28-2
Chapter 28
Creating Alert Types
2. If any open alert associated with the object has a Prevent Close restriction, then
the object cannot be closed until the alert(s) is closed.
In addition, an alert may be associated with multiple objects. If it has more than one
Prevent Close restriction to different objects, the alert will only be closed when the last
object is closed.
To set alert type properties:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Alert Types tab on the left.
3. Click New to open New Alert Type, which will default to the Properties tab.
4. For Name, enter an alert type name.
5. Enter an Alert Type ID.
An Alert Type ID is required, and must be unique.
6. Optional: For Description, enter an alert type description.
7. Optional: From the Associated With drop-down list, select an object, such as a
task, with which to associate the alert.
8. Optional: For Restrictions, enter any restrictions for the alert. For example, if you
select Prevent Close for an alert on a task, the user can't complete the close task
until the alert is complete.
If you select All Types for Associated With, no restrictions are available.
9. Click Enabled to enable the alert type.
Only alert types that are Enabled are displayed in the list of available Alert Types
and available for selection when creating new alerts.
10. Click an Alert Type tab and continue entering information.
When you are done entering the Alert Type information, click Save and Close.
• Specifying Alert Type Instructions
• Selecting the Alert Type Workflow
• Assigning Alert Type Viewers
• Adding Questions for Alert Types
• Applying Alert Type Attributes
28-3
Chapter 28
Creating Alert Types
28-4
Chapter 28
Creating Alert Types
You can add one or more levels of default Approver users, groups, or teams for
the alert when one is created of this type. These are not required. If you do not
specify Approvers, the user who creates the alert has the option to add them.
7. Click an Alert Type tab and continue entering information.
When you are done entering the Alert Type information, click Save and Close.
• Assigning Alert Type Viewers
• Adding Questions for Alert Types
• Applying Alert Type Attributes
28-5
Chapter 28
Creating Alert Types
Administrator, Assignee, Approver, Owner, or Viewer roles. This allows key details to
be gathered from the user experiencing the issue.
You can specify various types of questions, such as Text, Number, or True/False, and
indicate whether they are required. If a question is required, the user must respond or
they cannot submit the task for approval. You can also order the questions by using
the Move Up and Move Down buttons.
To add a question:
1. On the Home page, click Application, and then click Task Manager.
2. Click the Alert Types tab on the left.
3. From the New or Edit dialog, select the Questions tab.
4. Click Add.
5. For Question, enter text for the question, with a maximum of 4000 characters.
6. From the Type list, select a question type:
• Date
• Date and Time
• Integer
• List
Enter a list of valid responses to the question.
• Multi-Line Text
The maximum length should be less than 4,000 characters.
Select Multi-Line Text, and then enter the Number of Lines, from 3 to 50
lines. Multi-Line Text determines how many lines of text are visible without
scrolling, on the Actions dialog boxes.
• Number
If you select Number, select number formatting options:
– For Decimal Places, enter a value for the number of decimal places to
display.
– Select the Thousands Separator option if you want numbers to display a
thousands separator (for example, 1,000.00)
– From the Currency Symbol list, select a currency symbol, for example,
Dollars ($).
– From the Negative Number list, select how to display negative numbers,
for example, (123).
– From the Scale list, select a scale value for numbers, for example, 1000.
• Text
• True or False
• User
• Yes or No
7. Assign a Role (Owner, Assignee, Approver, Viewer) of the user who should
answer the question..
28-6
Chapter 28
Creating Alert Types
When you are done entering the Alert Type information, click Save and Close.
• Applying Alert Type Attributes
• Viewing Alert Type History
28-7
Chapter 28
Viewing Alert Type History
28-8
Chapter 28
Editing Alert Types
Note:
icon.
28-9
Chapter 28
Deleting Alert Types
28-10
29
Using Task Manager and Supplemental
Data Manager Reports
Related Topics
• Generating Custom Reports for Task Manager and Supplemental Data Manager
• Creating a Task Manager Query
• Creating a Supplemental Data Query
• Creating a Template
• Setting Up a Report Group
• Creating a Report
• Searching and Filtering Queries, Report Groups, or Reports
• Generating the Report
• Using Task Manager Report Binders
• Generating Report Binders
• Viewing Report Binders
Note:
Task Manager provides sample reports to assist you in getting started. You
can use them as templates and can duplicate them as needed, then make
modifications or extend access to users. To duplicate a report, select the
report, then select Duplicate from the ellipsis button . You can then edit
the newly created report.
You can also create custom reports. Building custom reports involves four steps and
can only be performed by a Service Administrator:
• Create a Task Manager or Supplemental Data Query from the New button of the
Queries tab. See Creating a Task Manager Query or Creating a Supplemental
Data Query.
• Create a template. See Creating a Template.
• Set up a report group.
29-1
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
29-2
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
7. From Select Columns, select the columns to display in the query, and then click
Next.
29-3
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
8. From Select Filters, click Create Condition or Create Condition Group and
select the conditions to create the filters to create the query.
9. Select OK.
10. Optional: If you want to use the report in the future, click Generate Sample XML.
12. To test the query for errors, click Validate from the New Query dialog. The query
displays in the Queries tab.
29-4
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
Note:
You can easily delete a query, or duplicate a query using the Action
menu.
Modifying A Query
A system administrator can edit a Task Manager query or Supplemental Data query.
1. From the Home Page, select Applications, then Reports.
2. In Reports, select Queries if is not already selected, and then Edit from next
to the query you are editing.
Note:
If it is locked, ask the System Administrator to unlock.
3. Select an option:
• Task Manager Query
• Supplemental Data Query
4. In Edit Query, edit the information as needed.
5. After you are done with your changes, click Save and Close.
29-5
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
Select the records to be included in the report. You can apply a security filter,
so users see only the data that they are authorized to see based on their
roles and the reports to which they are assigned. To apply a Security Filter
to a report query, add the following syntax to the end of the query WHERE
CLAUSE statement.
$FCC_SECURITY_CLAUSE$
Note:
Because many predefined queries included with Task Manager have
the Security Filter applied, you can use them as examples when
building your own.
For example, the following Report Query specifies scheduled tasks to display
Task Code, Name, Assignee and Schedule for all High Priority tasks in the
selected schedule.
SELECT TaskEO.TASK_CODEAS "$TASK_CODE$" ,
TaskEO.TASK_NAMEAS "$NAME$" ,
((SELECT CASE WHEN FIRST_NAME IS NULL AND LAST_NAME IS
NULL THEN USER_LOGIN ELSE FIRST_NAME||' '||LAST_NAME END FROM
FCM_USERS WHERE USER_ID = (coalesce(AssigneeEO.ACTIVE_USER_ID,
AssigneeEO.USER_ID))))AS "$ASSIGNEE$" ,
DeploymentEO.DEPLOYMENT_NAMEAS "$SCHEDULE$"
FROM FCC_TASKS TaskEO
LEFT OUTER JOIN FCC_ACCESS AssigneeEO ON (TaskEO.TASK_ID =
AssigneeEO.SOURCE_ID AND AssigneeEO.ACCESS_TYPE = 'AS')
LEFT OUTER JOIN FCC_DEPLOYMENTS DeploymentEO ON (TaskEO.SOURCE_ID =
DeploymentEO.DEPLOYMENT_ID)
WHERE (TaskEO.SOURCE_TYPE = 'DEPLOYMENT')
AND ((((TaskEO.PRIORITY=3 )
AND (TaskEO.SOURCE_ID=~SCHEDULE~ ))))
6. Click Generate Query to build the query from the New Query dialog. The dialog
assists you in creating a query against the database by allowing you to select any
existing attribute in the product to be queried and/or filtered against. The system
then generates the SQL to match the specified attributes and filters, at which time
you can modify and enhance it.
a. On the Select Type screen, select the following:
• From Query, select Workflow.
• Optional: Select the Apply Security checkbox to automatically apply
the user security filter to the generated query. This applies the Security
token to the query, to be filled in with the correct SQL when the report is
generated.
b. Click Next.
29-6
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
7. From Select Columns, select the columns to display in query, and then click
Next.
8. From Select Filters, click Create Condition or Create Condition Group and
select the conditions to create the filters to create the query.
29-7
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
9. Select OK.
10. Optional: If you want to use the report in the future, click Generate Sample XML.
12. To test the query for errors, click Validate from the New Query dialog. The query
displays in the Queries tab.
Note:
You can easily delete a query, or duplicate a query using the Action
menu.
Modifying A Query
A system administrator can edit a Supplemental Data Query.
1. From the Home Page, select Applications, then Non-Consolidation Reports.
2. From the Queries tab, select Edit from next to the query you are editing.
Note:
If it is locked, ask the System Administrator to unlock.
3. Select an option:
• Task Manager Query
• Supplemental Data Query
4. In Edit Query, edit the information as needed.
29-8
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
5. After you are done with your changes, click Save and Close.
Creating a Template
Creating report templates is the second step in generating custom reports. Report
templates are created in Microsoft Word with Oracle BI Publisher Desktop for 32/64
bit Office on Windows installed. Template creation also requires that you already
generated the Sample XML during query creation.
To create a report template:
1. Open Microsoft Word with a new document.
2. Select the BI Publisher tab, then the Sample XML folder above Load Data
3. Locate theSampleQuery.xml that was generated when you created the query and
click Open.
A message displays, " Data Loaded Successfully ". Click OK.
4. Select Insert, and then Table Wizard.
5. Select Table and click Next.
6. Select the default data set and click Next.
7. Select the desired fields to show in the report and click Next.
8. Select the Group By, then select the fields to group by, and then click Next.
9. Select the Sort By, then select the fields to sort by, and then click Finish.
10. Save the template as an *.rft file; for example: SampleQuery.rtf.
Note:
Nested Report Groups are not supported.
After a report group has been created, you can modify it if necessary. You can
duplicate a report group but its name must be unique. You can also delete a report
group, however, deleting a report group deletes all reports associated with that group.
To create report groups:
1. From the Home Page, click Application, and then select Non-Consolidation
Reports.
2. From the Report Groups tab, click New.
3. In the New Report Group, enter:
• Name
Enter a group name for the group of reports.
29-9
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
• Description
• Display to User
Select Display to User if you want this report group displayed to the user.
The Display to User option enables report writers to have a group of reports
hidden while they are working on them.
4. On the Reports tab, reorder or edit reports that have been added to the report
group using the Move icons
.
5. Click Save and Close.
Creating a Report
Creating report definitions is the fourth step in generating reports. Users can create
reports from the queries and assign them to groups.
To create report definitions:
1. From the Home Page, click Application, and then select Non-Consolidation
Reports.
2. Select Reports, then New, and then Task Manager Report.
29-10
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
Click Browse and then browse to a report template. You can upload
any supported Oracle Business Intelligence Publisher template format. See
Creating a Template.
• Report Group
Select the Group Name for the report from the drop-down menu.
• Display to User
Select if you want the report displayed to a user.
• Output Format
Select a report output format BI Publisher from one of the following:
– XLSX - not supported for graphs.
– HTML - not supported for graphs and charts.
– PDF
– CSV - does not use a template and is better at faster data retrieval.
– CSV (Formatted) - is best suited for a simple data table with formatted
data and does not support images, graphics, or styling in the template.
Note:
The CSV (Formatted) format takes additional time to generate
the report to honor template formatting when compared to the
CSV format. Therefore, you can select CSV to generate the
data quickly or CSV (Formatted) to generate formatted template
based data.
4. To complete the report definition, you must set the parameters and access:
a. For Parameters, select the Parameters tab.
Parameters from the query are identified and added to the list. Update the
following:
• Display Name
• Parameter Type - The available options are:
– Task Manager/ Supplemental Data Attribute
– Text
– Date
– Date/Time
– Number
– Query
– Integer
– True/False
– Yes/No
– User
29-11
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
Note:
The report must be granted access to at least one application
module for the report to display in the corresponding Reports tab.
Note:
icon.
29-12
Chapter 29
Generating Custom Reports for Task Manager and Supplemental Data Manager
Note:
For reports that contain more than 10,000 records, it is
recommended to use the CSV format.
• CSV (Formatted) - is best suited for a simple data table with formatted data
and does not support images, graphics, or styling in the template.
Note:
The CSV (Formatted) format takes additional time to generate the
report to honor template formatting when compared to the CSV
format. Therefore, you can select CSV to generate the data quickly
or CSV (Formatted) to generate formatted template based data.
5. Click Generate.
6. Enter the Name, Schedule, and Period from the drop down menus.
7. Click Generate.
When done, the system displays a "Completed Successfully" status message.
8. Select Open with or Save File to save the ZIP file.
29-13
Chapter 29
Using Task Manager Report Binders
The report generation process uses a backend job framework that runs report jobs
in the background. If the report has an error, for example, if the size is greater than
the recommended size, you see a message stating the error in the Generate Report
dialog before the report is generated. For reports with very large number of records, it
is recommended to use filtering to break the report down to fewer records.
29-14
Chapter 29
Using Task Manager Report Binders
Note:
Including attachments in the report greatly increases the size of the
report and may impact the performance.
6. Click Generate.
7. From File Download, select Save.
The Save As dialog box is displayed, and the ZIP file name is displayed at the
bottom.
8. Select a directory for the ZIP file, click Save, then Close.
29-15
30
Managing Supplemental Data
Related Topics
• Supplemental Data Process Overview
• Managing Supplemental Data System Settings
• Working with the Supplemental Data Analysis Dashboard
• Managing Dimension Attributes in Supplemental Data Manager
• Working with Collection Intervals
• Working with Supplemental Data Collections
• Creating Supplemental Data Manager Form Templates
• Editing Form Templates
• Duplicating Form Templates
• Deleting Form Templates
• Deploying a Form Template to a Data Collection Period
• Un-Deploying a Form Template to a Data Collection Period
• Re-opening Supplemental Data Forms
• Validating Supplemental Data Total Against an Account Balance
• Working with Supplemental Data in Smart View
• Using Currency Translation
30-1
Chapter 30
Managing Supplemental Data System Settings
Supplemental Data.
30-2
Chapter 30
Managing Supplemental Data System Settings
Note:
By default, email notifications are not enabled.
You can also add an email as the From Address. Customize the from address, or
perhaps include a product acronym to alert the user where the notification is coming
from.
To set email notifications:
1. On the Home page, click Application, and then click Supplemental Data.
2. Click the System Settings tab on the left.
3. Select Email Notifications.
4. For Email Notifications, select Turn On to initiate the notification, or Turn Off to
deactivate the notification.
5. Enter the email From Address. You can edit the email address to supply a
specific address, or to include a product acronym to alert the user where the
notification is coming from, for example, SDM.
6. Click Save.
30-3
Chapter 30
Working with the Supplemental Data Analysis Dashboard
• Text Color
• Background Color
6. Click Save.
30-4
Chapter 30
Managing Dimension Attributes in Supplemental Data Manager
30-5
Chapter 30
Managing Dimension Attributes in Supplemental Data Manager
Note:
If you want to use the dimension for collection intervals, the attribute
should be a key attribute and the dimension should have only one
key attribute.
• Data Type
Select one:
– Date
– Date and Time
– Integer
– List
Select a method:
* Click Add, and then enter values for the attribute.
* To import list items from a CSV file, click Import , then browse to the
CSV file.
* To export list items from a CSV file, click Export, then follow the
prompts.
– Number
If you select Number, select formatting options (The defaults are set in the
Preferences section of the System Settings).
* For Decimal Places, enter a value for the number of decimal places
to be displayed.
* Select Display as Percentage to display a percent sign.
* Select Thousands Separator to display a thousands separator (for
example, 1,000.00). The system displays the thousands separator
symbol for the user locale.
30-6
Chapter 30
Managing Dimension Attributes in Supplemental Data Manager
Note:
The system allows multiple attributes as key for a dimension.
30-7
Chapter 30
Working with Collection Intervals
Note:
You can't delete an attribute if it is referenced in a collection.
30-8
Chapter 30
Working with Collection Intervals
Note:
After defining a data collection period, you cannot make changes to the
selected collection interval in the Collection Interval tab.
30-9
Chapter 30
Working with Supplemental Data Collections
Creating Collections
When you work with Supplemental Data, you create a collection to define the data
for the collection process. You can also create sub-collections, which allow finer
detail data collection. You can ensure data collection security by specifying whether
to prevent sharing of data across data forms.
Watch the following video about creating collections for Supplemental Data:
30-10
Chapter 30
Working with Supplemental Data Collections
Creating Sub-Collections
Sub-Collections allow you to obtain detailed data collections. You create a sub-
collection for an existing collection, which then becomes the parent collection.
The sub-collection is linked to the parent collection and displays under the parent
collection. You can create a maximum of five sub-collections for a parent collection.
To create sub-collections:
1. On the Home page, click Application, and then click Supplemental Data.
2. Click the Collections tab on the left.
3. Click + (plus sign).
4. On the Properties tab, enter the sub-collection information:
• Name—Enter a unique name.
• Description
• Sub Collection—Click the checkbox.
• Collection Interval—This is not editable after you click the Sub-Collection
checkbox.
• Collection—Select the parent collection for which you want to create a sub-
collection. On selecting the parent collection, the Collection Interval auto-
populates the collection interval associated with the parent collection.
• Share data records among Templates/Forms—This is not editable after you
select the parent collection in Collection.
• On the Attributes tab, add attributes for the sub-collection.
Note:
The attributes in the parent collection are linked to the sub-collection
by default. When you create an attribute for the sub-collection, the
new attribute links to the parent collection and the associated collection
interval.
30-11
Chapter 30
Working with Supplemental Data Collections
Note:
Supplemental Data Manager does not support the Calculated
attribute as a Key Identifier attribute.
If you select the Calculated attribute as a Key Identifier, you may
encounter unexpected behavior and errors in collections.
• Assign Workflow
Displays the workflow defined in the collection interval. It is not editable.
• Name
• Dimension Name
• Attribute Type (displayed if there are existing attributes)
• Data Type—Date, Date and Time, Integer, List, Number, Text, True or False,
Yes or No
• Total—Enables you to specify the totaling method for the attribute:
– Sum: Additive total
– Average: The average of the rows with data. Rows without data are not
counted in the denominator
– Count: The count of the rows with data
– None: No total is calculated
5. Click Actions, then New, and then select:
• Add Attribute: Go to step 5.
• Add Attribute from Dimension:
a. Select a Dimension.
b. Select attributes from the Available Attributes list and Move them to the
Selected Attribute list.
The system includes the key attribute of the dimension as a Selected
Attribute. You cannot clear the key attribute.
c. Click OK and then Save or Save and Close.
6. If you selected Add Attribute, on Create New Attribute, enter the Properties tab
information:
• Name
30-12
Chapter 30
Working with Supplemental Data Collections
• Description
• Specify the Attribute Type:
Changing the Attribute Type overrides previously specified Validations or
Calculations. You cannot change this setting after the attribute is created.
– Input: Input is the default, and the Validations tab is enabled.
For periods that have been opened and form instances created, the
modified validation rule does not apply. Changes made apply only to new
form instances.
– Calculated: If type is Calculated, then the Calculated tab is enabled.
• Data Type
Select one:
– Date
– Date and Time
– Integer
– List
Click Add and enter values for the attribute. List is local to the collection
and can't be shared among other collections.
– Number
If you select Number, select formatting options to override the defaults set
in the Preferences section of System Settings.
Note:
You can only enter numeric values for this attribute.
30-13
Chapter 30
Working with Supplemental Data Collections
If Use Value is populated, the system applies the value entered by the
designer for any record created by the user.
You can change the default value during data entry.
7. Click OK to save the attribute.
You must save the attribute before including it in a calculation.
8. To continue adding an attribute:
• If you selected Input for the Attribute Type, then select the Validations tab.
To add a conditional expression:
You can create a special validation rule for the value entered by the user.
a. Click Add.
b. Select an Operand and enter Value1 and Value2.
c. If you need a second condition, select from the following lists:
– Conjunction; for example, And, Or
– Operand; for example, Equals, Between, Does not Equal, Greater
than, Is blank, Is not blank, Less than, Not between
– Value1 and Value2
d. Click OK.
• If you selected Calculated for the Attribute Type, then select the Calculations
tab.
The following section is an example of how to add a calculation attribute.
a. Create a collection with these attributes:
Int1 Input and Data Type: Integer. Click OK, and from Edit Collection,
select Int1 as a Key Identifier.
TextInput: Input and Data Type: Text.
b. To use the attribute in TextCalc, save the data.
c. Create an attribute TextCalc: Calculated and Data Type: Text.
d. On the Calculations tab, enter the following fields:
i. Calculation Type: Select Scripted.
ii. Add Function: Select TextLocation, and then click Add.
iii. INSTRING(<Value>, <Value To Search>) is added to Calculation
Definition.
iv. Click <Value> and either enter a value (enclosed in single quotation
marks and case sensitive), or, in Add Attribute, select an attribute,
TextInput, and then click Add.
<Value> changes to {TextInput}.
v. Replace <Value to Search> with 'tion'
Ensure that you replace <xxx> with single quotation marks: 'xxx'.
Example INSTRING({TextInput}, 'tion')
9. To add a calculation expression, select a data type and calculation type as
described in the following table, and then click OK.
30-14
Chapter 30
Working with Supplemental Data Collections
Note:
Changes to attributes apply only to subsequent data collection periods.
Scripted Functions
• Absolute Value: Returns the absolute value of a specified number. If a
number is less than zero, the positive value of the number is returned. If
the specified number is equal to or greater than zero, the specified number is
returned.
ABS(<Number>)
• Add Month: Returns a date offset a specified number of months from the
starting date. The date will always fall in the specified month offset. If the
starting date has a day value beyond what is in the offset month, the last day
of the offset month will be used. For example, EDate (31-Jan-2017, 1) returns
(28-Feb-2017). For Months, enter the number of months before or after the
start date. A positive value for months yields a future date. A negative value
yields a past date.
30-15
Chapter 30
Working with Supplemental Data Collections
• Length: Takes a text value as a parameter and returns an integer which is the
number of characters in the text. If the value is empty/null, the calculation will
return 0.
Length ({<attribute>})
Example: LENGTH('Value') would return 5, and LENGTH({Name}) would return
the number of characters in the name of the object.
Use the calculation with SUBSTRING to extract the last four characters of a
text value.
SUBSTRING( {MyString}, LENGTH ({MyString}) - 4
• Lowercase: Returns the value in lower case.
LOWERCASE(<Value>)
30-16
Chapter 30
Working with Supplemental Data Collections
Note:
Fractional values will reduce the number to its root. For example,
POWER(27, 1/3) = 3 the cube root.
Negative values will perform an inverse of the exponential
calculation. For example, POWER(2, -2) = 1 / (2^2) = 1 / 4
= .25.
30-17
Chapter 30
Working with Supplemental Data Collections
Blue
Yellow
Red
Green
2. On the Home page, click Application, and then click Supplemental Data.
3. Click the Collections tab on the left.
4. Create or select an attribute of type List, and then click Edit from the
Associated Form Templates area. The Edit Form dialog is displayed.
5. Click Import from the Users area.
6. Browse to select the import file.
7. Select an Import Type - Update to update only the members in the source file, or
Replace to replace the users with members from the source file.
8. Select a File Delimiter for the import file from the drop-down list: Comma or Tab.
9. Click Import.
Import List Values displays the values: Total List Values, Completed, Errored, List
Values Created, and List Values Updated.
30-18
Chapter 30
Working with Supplemental Data Collections
Editing Collections
You can edit the description and the attributes of a collection.
To edit collections:
1. On the Home page, click Application, and then click Supplemental Data.
2. Click the Collections tab on the left.
3. Select a collection, then click Actions, and then Edit.
30-19
Chapter 30
Creating Supplemental Data Manager Form Templates
Copying Collections
You can copy a collection by using the Supplemental Data Analysis dashboard. From
the dashboard, you can export the data from one POV and import it into another POV.
To copy a collection:
1. On the Home page, click Data.
2. From the left, click Supplementeal Data Analysis.
3. From the Collections drop-down, select a collection that you want to copy.
4. From the POV on the Supplemental Data Analysis page, select POV members for
the data that you want to copy.
5. From Actions, select Export to Excel to export data from the collection.
6. From the POV on the Supplemental Data Analysis page, select POV members for
the data that you want to paste.
7. From Actions, select Import to import data into the collection.
Deleting Collections
To delete collections:
1. On the Home page, click Application, and then click Supplemental Data.
2. Click the Collections tab on the left.
3. Select a collection, select Actions, and then Delete.
• If data exists, you cannot delete the collection.
• If no data exists, but form instances are created, you cannot delete the
collection.
4. From the confirmation prompt, click Yes.
30-20
Chapter 30
Creating Supplemental Data Manager Form Templates
Tip:
To delete a reference, select the reference, and then click Delete.
30-21
Chapter 30
Creating Supplemental Data Manager Form Templates
30-22
Chapter 30
Creating Supplemental Data Manager Form Templates
30-23
Chapter 30
Creating Supplemental Data Manager Form Templates
Note:
View Only column for each dimension attribute must be deselected
to validate against account balances.
• View Only
The column is for view only. If multiple forms are created for the same
Collection, then only one form can contain the column for input, including key
columns.
8. Total Row
How the total row should be displayed:
• Top: Total row is displayed at the top of the table
• Bottom: Total row is displayed at the bottom of the table
• None: Total row is not displayed
9. Optional: To add new attributes to a Form Template Section, click the Add (+)
icon, select Add Attribute and specify the attribute information.
The procedure for adding attributes in Form Template Sections is the same as
adding attributes in a Collection. See Adding Collection Attributes.
10. Click OK to save the data.
30-24
Chapter 30
Creating Supplemental Data Manager Form Templates
6. Total Row:
Indicates how the total row should be displayed:
• Top: Total row is displayed at the top of the table
• Bottom: Total row is displayed at the bottom of the table
• None: Total row is not displayed
7. Enter information on other Section tabs as needed.
8. To save your updates and go back to the Form Template Sections tab, click OK.
Note:
As a best practice, clear the browser cache and re-login before creating or
editing mapping.
30-25
Chapter 30
Creating Supplemental Data Manager Form Templates
30-26
Chapter 30
Creating Supplemental Data Manager Form Templates
30-27
Chapter 30
Creating Supplemental Data Manager Form Templates
30-28
Chapter 30
Editing Form Templates
Note:
You must define a Workflow before you assign Viewer access.
To add access:
1. On the Home page, click Application, and then click Supplemental Data.
2. Click the Form Templates tab on the left.
3. Click New Form or Edit Form, and click the Access tab.
4. Click New, or select a user and click Edit.
5. In Viewers Access, select a user, group, or team.
6. From Workflow, select members of theWorkflow Dimension.
The system lists all the combination of the members of the Workflow Dimensions.
7. Select a View Option:
• Always—You can view the data at any time even if the data entry is not
complete or has not been submitted for approval.
• After Submission—You can view the data as soon as the data is submitted,
even before it has been approved.
• After Approval—You can't view the data until after all levels of approvals are
granted.
8. Optional: To load Viewer Access for multiple users from a CSV file:
a. From the menu bar, click Import.
b. Browse to select the file.
c. For Import Type, select Replace All or Update.
d. For File Delimiter, select Comma, Tab, or select Other, then enter a
delimiter.
e. Click Import.
30-29
Chapter 30
Duplicating Form Templates
1. On the Home page, click Application, and then click Supplemental Data.
2. Click the Form Templates tab on the left.
3. Select a form template, then from the menu bar, select Edit.
30-30
Chapter 30
Deploying a Form Template to a Data Collection Period
11. After deployment is completed, a confirmation dialog box indicates the following
information:
• Total Form Templates from Collections: Total number of form templates
from the Deploy Information dialog.
• Form Template and Period frequency or Interval do not match: Number of
Form Templates that do not match the collection interval frequency. Click View
Details to display the form template missing the frequency.
• Form Templates with Errors: Total number of form templates with errors. If
there are errors, no copying is done.
• Collections with Errors: Collections that contain errors. Click View Details
for error details.
• Deployed Form Templates: Templates that have already been deployed.
• Total Forms to deploy: Total number of forms specified on each of the form
templates.
• Successfully Deployed: Total number of forms deployed.
• Unsuccessfully Deployed: Total number of forms unsuccessfully deployed.
30-31
Chapter 30
Un-Deploying a Form Template to a Data Collection Period
30-32
Chapter 30
Re-opening Supplemental Data Forms
30-33
Chapter 30
Validating Supplemental Data Total Against an Account Balance
Note:
You can only select leaf-level members, not parent members.
Make sure View Only is deselected.
If you try to add data and submit the form, the system checks and will only permit the
submission if the total of the attribute equals the account balance. For example, if you
add data for Stationery:
If you add a Travel Expense of $100, you will see that the attribute value now matches
the account balance, and the form is submitted.
30-34
Chapter 30
Working with Supplemental Data in Smart View
Security Considerations
• Service Administrators can view all Collections regardless of which legal entities
are specified in the data collection.
• Power Users and Users can see all Collections for which they are eligible as part
of the workflow and according to their access roles for the legal entities.
• Users will see only the forms for which they are authorized. Depending on the
security role, the available options such as Save Data, Approve, or Reject change
to match the associated role.
30-35
Chapter 30
Using Currency Translation
Note:
Only collections that contain data display for each data collection period.
5. When you are finished, select the appropriate action for the form:
• Save Data
• Submit Data
• Approve
• Reject
• Post Data
30-36
Chapter 30
Using Currency Translation
are generated in the currency of the parent company. The currency translation feature
gives you the capability to translate currency attributes from local to parent currency
within Supplemental Data Management.
Currency translation uses the following process:
• The system stores the base currency (or default currency) of entity members in
Supplemental Data Manager.
• If you are using a multi-currency application, the system also stores Currency Rate
Types, and currency rates, using the Exchange Rates member of the Account
dimension in the Rates cube. The Rate Types and Currency Rates are read-only
in Supplemental Data Manager.
Note:
If you do not make a selection and you have chosen the currency property
of an attribute as Entity currency, translation will not work when forms are
deployed to this particular entity, since it has no currency to inherit.
30-37
Chapter 30
Using Currency Translation
4. From the Attributes tab, select the attribute (for example, Amount which is the
input value for the meal expenses from various teams around the globe), and click
Actions, then Edit.
5. In Currency, selecting Entity Currency means that this attribute (Amount) will
inherit the currency of the Entity that the form is deployed to, which is "USD"
(dollars) in this example.
6. The calculated attribute, Amount in HQ Currency, was set up with Currency in
USD (dollars).
7. In Calculations, the Translate function has been set up to translate the values in
"Amount" to USD currency using the "Average" exchange rate type.
30-38
Chapter 30
Using Currency Translation
8. Once the setup is complete, you can see the translation work in a deployed
form. In this example, a form template has been deployed to four different entities
having four different currencies.
For Monthly Meal Expenses for India, after you enter the Amount, the translated
currency value displays after you Save it. Note that the translation is calculated to
the HQ currency.
9. You can also view this in Supplemental Data Analysis. Note the currency symbol
in the "Amount" column and the translated values in the "Amount in HQ Currency"
column.
30-39
Chapter 30
Using Currency Translation
30-40
31
Managing Supplemental Data Manager
Teams
Teams are defined and provisioned with Owner, Assignee, and Approver roles. Then,
rather than assigning named users these roles on a task, the role is assigned to the
Team. Administrators and Power Users can add, edit, and delete teams.
Note:
Other team members can then claim the task.
8. Click OK.
31-1
Chapter 31
Importing and Exporting Teams and Members for Supplemental Data Manager
31-2
Chapter 31
Importing and Exporting Teams and Members for Supplemental Data Manager
Caution:
Any entries that are not included in the import file will be deleted.
31-3
Chapter 31
Exporting Supplemental Data Manager Users
31-4
Chapter 31
Deleting Teams and Removing Members for Supplemental Data Manager
3. To delete teams, select a team, click Delete, and from the confirmation
prompt, click Yes.
4. To remove members, double click a team name, and on the Edit Team dialog box,
select a member and then click Remove from the Actions drop-down.
5. Click OK.
31-5
A
Task Manager Integrations with EPM Cloud
Services
If you are using Task Manager and have subscriptions to other EPM Cloud services,
you can create connections between services and enable integrations using Task
Manager functionality.
Pre-built integrations enable you to perform Task Manager tasks that access other
EPM Cloud functionality.
Pre-built integrations are provided within Task Manager for these EPM Cloud services:
• Account Reconciliation
• Planning
• Planning Modules
• Financial Consolidation and Close
• Tax Reporting
• Profitability and Cost Management
To learn more about how to set up integrations, see Setting Up an Integration.
To learn more about which pre-built integrations are available, see Pre-Built EPM
Cloud Integrations.
To learn more about which end user integrations are available, see End User
Integrations for EPM Cloud.
Setting Up an Integration
Make sure you have the prerequisites and follow these steps to set up an integration
between Task Manager and other EPM Cloud services.
Prerequisites
To create integrations between EPM Cloud services, you need to:
• Obtain a subscription to the EPM Cloud service you want to integrate with.
• Set up connections between Task Manager and other EPM Cloud subscriptions.
A-1
Appendix A
Uploading and Downloading Files Within EPM Services
A message displays the progress of the synchronization, and the system creates
the Integration Type and Task Type.
See Managing Task Manager Integrations for details on using Integration Types.
A-2
Appendix A
Pre-Built EPM Cloud Integrations
4. Select a connection.
5. From the list of pre-built integrations, select to upload or download a file. For
example, select Copy File from FCCS to copy the file from the current FCCS
machine to a remote machine.
6. For File Name, browse to and select the file that you want to copy.
7. In Save File As, enter a file name (which can be different than the original file
name).
8. Optional: For External Directory Name, select the name of a directory.
9. Click Save and Close.
A-3
Appendix A
Pre-Built EPM Cloud Integrations
A-4
Appendix A
Pre-Built EPM Cloud Integrations
A-5
Appendix A
Pre-Built EPM Cloud Integrations
Pre-Built Integrations for Financial Consolidation and Close and Tax Reporting
A-6
Appendix A
Pre-Built EPM Cloud Integrations
A-7
Appendix A
Pre-Built EPM Cloud Integrations
A-8
Appendix A
Pre-Built EPM Cloud Integrations
A-9
Appendix A
Pre-Built EPM Cloud Integrations
A-10
Appendix A
Pre-Built EPM Cloud Integrations
A-11
Appendix A
Pre-Built EPM Cloud Integrations
A-12
Appendix A
Pre-Built EPM Cloud Integrations
A-13
Appendix A
Pre-Built EPM Cloud Integrations
A-14
Appendix A
Pre-Built EPM Cloud Integrations
A-15
Appendix A
Pre-Built EPM Cloud Integrations
A-16
Appendix A
Pre-Built EPM Cloud Integrations
A-17
Appendix A
End User Integrations for EPM Cloud
A-18
Appendix A
End User Integrations for EPM Cloud
• Import Journal
• Invalid Intersections Report
• Generate Intercompany Matching Report
• Generate Journal Report
• Manage Approvals
• Manage Dimensions
• Manage Forms
• Manage Journals
• Manage Ownership
• Manage Periods
• Manage Valid Intersections
• Refresh Application
• View Dashboard (Dashboard)
Required parameter is Dashboard (EPM Artifact Type) displayed in the drop down
list in the Task Details dialog.
• View Financial Reports
A-19
Appendix A
End User Integrations for EPM Cloud
A-20
B
Task Manager Integrations with Cloud and
On-Premises Applications
This appendix describes how to set up theseTask Manager Integrations:
• Oracle Fusion Cloud Integrations
• On-Premises Integrations
• On-Premises Oracle E-Business Suite Event Monitoring Integrations
Oracle Integration Cloud Service is used to connect securely and exchange messages
between applications and services in the Cloud and on-premises. EPM Cloud uses
Integration Cloud as an integration platform forTask Manager to connect to non-EPM
Cloud services.
The following diagram shows the system and user flow that applies to Financial
Consolidation and Close and Tax Reporting:
B-1
Appendix B
End User Integrations for Oracle Fusion Cloud
B-2
Appendix B
End User Integrations for Oracle Fusion Cloud
B-3
Appendix B
End User Integrations for Oracle Fusion Cloud
B-4
Appendix B
Event Monitoring Integration Tasks for Oracle Fusion General Ledger
Note:
For custom process automation or event monitoring integration to Fusion
cloud, see Creating Custom Task Manager Integrations.
Prerequisites
To integrate Task Manager with the business events, you need:
• Fusion Version R13 (update 19B) (11.13.19.04.0)
• Oracle Integration Cloud Standard Edition (19.2.1.0.0)
B-5
Appendix B
Event Monitoring Integration Tasks for Oracle Fusion General Ledger
B-6
Appendix B
Event Monitoring Integration Tasks for Oracle Fusion General Ledger
If any event is not enabled, see Update the Enabled Indicator for a Business Event.
Follow these steps to set up an integration between Task Manager and Oracle Fusion:
1. On the Home page, click Application, then Task Manager.
2. Click the Integrations tab on the left, Manage Connection, then Integration
Cloud Connection.
3. On the Integration Cloud Connection dialog, add the required information:
a. For URL, enter the Oracle Integration Cloud URL.
b. For Service Administrator and Password, enter the Service Administrator
credentials.
c. Click Validate.
d. After successful validation, click Save and close the dialog.
Note:
The first time you enable the connection to Integration Cloud, all Integration
Cloud deployments will fail during activation. The Administrator must activate
the integrations in Integration Cloud. Before activating the integrations, the
Administrator must set up the integration in Integration Cloud.
B-7
Appendix B
Event Monitoring Integration Tasks for Oracle Fusion General Ledger
3. Edit the connections by providing the environment and credential information. For
details on prerequisites for creating a connection, see Prerequisites for Creating a
Connection.
• EPM Fusion Connection is the connection to the Fusion Cloud. See Using
the Oracle ERP Cloud Adapter for more details.
• EPM Connection is the connection to the EPM Cloud Service in Task
Manager. See Using the Oracle Enterprise Performance Management Cloud
Adapter with Oracle Integration for more details.
After configuring, testing, and saving the connections, you see a green check mark
next to the connections.
B-8
Appendix B
Event Monitoring Integration Tasks for Oracle Fusion General Ledger
4. In Task Manager, click Template, select the ERP Event Template and create a
schedule. See Creating Schedules from Templates.
5. In Task Manager, click Schedules, select the schedule, and change the status to
Open.
You can monitor the schedule task in the Schedule Tasks screen.
4. Wait for a few minutes for the task to be completed. Then navigate to the
Schedule Tasks screen in Tasks to verify the task is closed.
Note:
If you open a period that has never been opened, the Period Open Event
is triggered. If you open a period that has been closed before, the Period
Reopen Event is triggered.
B-9
Appendix B
End User Integrations for On-Premises Applications
3. Click Requiring My Approval and select the journal batch, then click Approve.
4. Wait for a few minutes for the task to be completed. Then navigate to the
Schedule Tasks screen in Tasks to verify the task is closed.
Note:
You can trigger the Journal Batch Approved event only if it is the last
approval in the multi level approval process.
Note:
The journal batch name and accounting period should match the
parameters of the task in the Task Manager schedule.
5. Wait for a few minutes for the task to be completed. Then navigate to the
Schedule Tasks screen in Tasks to verify the task is closed.
B-10
Appendix B
End User Integrations for On-Premises Applications
• Extract Journals
• IC Matching Template Report
• Intercompany Match By Account Report
• Intercompany Match By Transaction ID Report
• Intercompany Reports
• Intercompany Transaction Report
• Journal Reports
• Ownership Management
• Post Journals
• Process Control
• Process ICT
• Task List
• Web Data Entry Forms
B-11
Appendix B
End User Integrations for On-Premises Applications
B-12
Appendix B
End User Integrations for On-Premises Applications
B-13
Appendix B
End User Integrations for On-Premises Applications
B-14
Appendix B
End User Integrations for On-Premises Applications
B-15
Appendix B
End User Integrations for On-Premises Applications
B-16
Appendix B
End User Integrations for On-Premises Applications
B-17
Appendix B
End User Integrations for On-Premises Applications
B-18
Appendix B
Setting Up an Integration
Setting Up an Integration
Make sure you have the prerequisites and follow these steps to set up an integration
between Task Manager and an external application.
Prerequisites
To integrate Task Manager with an on-premises application such as E-Business Suite,
you need:
• A subscription to Oracle Integration Cloud Service.
Note:
You need one Integration Cloud instance per FCCS or TRCS instance.
• The on-premises application such as Oracle E-Business Suite (EBS) set up.
1. Subscribe to Oracle Integration Cloud / Oracle Autonomous Integration Cloud. See
Integration Cloud Service Documentation for detailed information.
2. Review and complete the pre-requisites in "Use Oracle E-Business Suite Business
Events to Trigger Integration Endpoint in Oracle Integration Cloud" for EBS
adapter in Oracle Integration Cloud: https://docs.oracle.com/cloud/latest/related-
docs/ICEBS/toc.htm
3. In Financial Consolidation and Close or Tax Reporting, from the Home page,
select Application, and then click Task Manager.
4. Click the Integrations tab on the left.
5. Click Manage Connections.
6. From Manage Connections, under Actions, select Integration Cloud
Connection.
7. Specify the Integration Cloud connection URL and credentials and click Validate.
After validation is successful, click Save. This saves the server and credential of
the FCCS or TRCS connection.
B-19
Appendix B
Setting Up an Integration
Note:
Task Manager uses Integration Cloud for all the integrations to external
applications that are non-EPM Cloud. The external applications can be
another Cloud service or an on-premises application such as E-Business
Suite. These can be Process Automation or Event Monitoring integration
types.
8. Do one of the following depending on whether the EBS connections for General
Ledger and Account Payable connections are already enabled:
• If the EBS connections for General Ledger and Account Payable is already
enabled, click Deploy and then Generate to deploy the corresponding
Integration Cloud integrations to Integration Cloud
• If the EBS connections for General Ledger and Account Payable connections
were not enabled:
a. In Task Manager within Financial Consolidation and Close orTax
Reporting , go to Manage Integrations, then from Action menu, select
Manage Connections.
b. Select and edit Oracle E-Business Suite - General Ledger. Select the
Enabled check box and click OK. Then click Deploy and then Generate.
c. Repeat steps for Oracle E-Business Suite - Account Payable.
The system creates the Integration Task Type and also deploys Integration
Cloud integrations to Integration Cloud service.
B-20
Appendix B
Setting Up an Integration
Note:
If you are doing this for first time and the connections in Integration
Cloud are not completed, all the Integration Cloud deployments will fail
during activation. This is expected. To fix this:
a. Log in to Integration Cloud.
b. Navigate to Connections. You will see two connections named
FCCS and EBS. Optionally use Search.
Edit FCCS connection:
• Click Configure Connectivity and enter FCCS url as <FCCS
url>/HyperionPlanning/rest/cmapi/v1
• Click Configure Security and enter the Service Administrator
credential of your FCCS service. Then click Test and then Save.
Note:
The Service administrator user ID should be in the format
specified in the following link: https://docs.oracle.com/en/
cloud/saas/enterprise-performance-management-common/
prest/authentication.html
9. Verify that the Integration - EBS linking is done properly. You can do this by
logging in to Oracle E-Business Suite as administrator and verify the Integration
Cloud REST service is added as subscriber for Business event. Here's an
example:
B-21
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
Check that the Integration Cloud service was added. For example:
B-22
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
Table B-3 General Ledger Close Process Period Integration Types Parameters
B-23
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
Note:
When you click Save, the cursor needs to be inside the Batch field.
Note:
When you save, the cursor needs to be inside the Batch field.
8. Click OK for the " Please enter one or more Journals " message.
9. Click Journals.
10. Enter a unique name in Journal field.
11. Provide Line entries starting with Line 1. Provide debit and credit values for the
accounts.
12. After you finish entering the line values, move the cursor into the Journal field.
14. Click Yes for " Do you want to save the changes you made? " message.
Note:
By clicking Yes, you will be able to add multiple Journal entries into the
Batch.
After you finish the journal entries for the last Journal, move the cursor into the
Journal field.
15. Select File and then click Save to save the last journal entry.
16. Focus on the Batch (Vision Operation (USA) and select Batch field.
B-24
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
19. In Field, enter JE_BATCH_ID and click inside Value to get the unique Journal
batch ID. For example,
• Block: BATCH
• Field: JE_BATCH_ID
• Value: 4776732
Copy this value to Notepad. This batch ID will be used as the value for the Batch
ID parameter of the Event Monitoring task.
Next Steps in Task Manager
1. Create a new Schedule in Pending state.
2. Create a task for event monitoring task to monitor Journal Approve Event
(oracle.apps.gl.Journals.journal.approve).
3. On the Parameters tab, provide a value for Batch ID as the journal batch ID from
EBS.
4. Save the task and set the schedule to Open state.
Next Steps in EBS
1. On Batch (Vision Operation (USA), the Approve button is now enabled for the
specified batch.
2. Click Approve to raise the journal approval event.
Next Steps in Task Manager
1. Wait for the task to be set to Open state. It takes a few minutes to capture the EBS
event.
2. After 2-3 minutes, click Refresh in Task Manager.
Refer to this document for further information on Journal Batch Approval
related information: http://download.oracle.com/docs/cd/A60725_05/html/comnls/us/gl/
journa09.htm#t_ja_submit
B-25
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
Note:
When you click Save, the cursor needs to be inside the Batch field.
Note:
When you save, the cursor needs to be inside the Batch field.
8. Click OK for the " Please enter one or more Journals " message.
9. Click Journals.
10. Enter a unique name in the Journal field.
11. Provide Line entries starting with Line 1. Provide debit and credit values for the
accounts.
12. After you finish entering the line values, move the cursor into the Journal field.
14. Click Yes for " Do you want to save the changes you made? " message.
Note:
By clicking Yes, you will be able to add multiple Journal entries into the
Batch.
After you finish the journal entries for the last Journal, move the cursor into the
Journal field.
15. Select File and then click Save to save the last journal entry.
16. Focus on the Batch (Vision Operation (USA) and select the Batch field.
19. In Field, enter JE_BATCH_ID and click inside Value to get the unique Journal
batch ID. For example,
• Block: BATCH
• Field: JE_BATCH_ID
• Value: 4776732
Copy this value to Notepad. This batch ID will be used as the value for the Batch
ID parameter of the Event Monitoring task.
Next Steps in Task Manager
1. Create a new Schedule in Pending state.
B-26
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
2. Create a task for event monitoring task to monitor Journal Approve Event
(oracle.apps.gl.Journals.journal.post).
3. On the Parameters tab, provide a value for Batch ID as the journal batch ID from
EBS.
4. Save task and set the schedule to Open state.
Next Steps in EBS
1. On the Batch (Vision Operation (USA), the Approve button is now enabled for the
specified batch.
2. Click Post to raise the journal approval event.
3. Examine the status of EBS request by selecting the View, then Requests, then
Specific Requests.
4. Specify the Request ID that was noted earlier.
Next Steps in Task Manager
1. Wait for the task to be set to Open state. It takes a few minutes to capture the EBS
event.
2. After 2-3 minutes, click Refresh in Task Manager.
Refer to this document for further information on Journal Batch Post
related information: http://download.oracle.com/docs/cd/A60725_05/html/comnls/us/gl/
conten07.htm#w_conts_post
EBS Steps
1. Log on to EBS.
2. Select General Ledger, and then the Vision Operations (USA) role from the left
tree.
3. Select Open/Close, and then Enter and wait for Oracle Applications to start.
The Find Periods dialog displays.
4. Click Find. The Open and Close Period dialog displays.
5. From the list of displayed periods, choose which one you want to close.
6. Select the Status column for that period.
7. Click Status Options. The status list box opens.
8. Select the Closed status and click OK. Then note the period in Notepad.
9. To save the status, select File and then click Save.
10. Select the Status column for that period.
13. In Field, enter LEDGER_ID and click inside Valueto get the unique Ledger ID. For
example,
• Block: PREVIOUS
B-27
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
• Field: LEDGER_ID
• Value: 1
Copy this value to Notepad. This Ledger ID will be used as the value for the
LEDGER_ID parameter of the Event Monitoring task.
Next Steps in Task Manager
1. Create a new Schedule in Pending state.
2. Create a task for event monitoring task to monitor Journal Close Event
(oracle.apps.gl.CloseProcess.period.close).
3. On the Parameters tab, provide a value for Ledger ID and Period Name from
EBS. For example: Period Name: Dec-10 and Ledger ID: 1
4. Save the task and set the schedule to Open state.
Next Steps in EBS
1. Close the Open and Close Period dialog.
2. Click OK in the Submit Request Node message box.
3. Examine the status of EBS request by selecting View, then Requests, and then
Specific Requests.
Next Steps in Task Manager
1. Wait for the task to be set to Open state. It takes a few minutes to capture the EBS
event.
2. After 2-3 minutes, click Refresh in Task Manager.
Refer to this document for more information on General Ledger Periods:
http://docs.oracle.com/cd/A60725_05/html/comnls/us/gl/openper.htm
EBS Steps
1. Log on to EBS.
2. Select General Ledger, and then the Vision Operations (USA) role from the left
tree.
3. Select Open/Close, and then Enter and wait for Oracle Applications to start.
The Find Periods dialog displays.
4. Click Find. The Open and Close Period dialog displays.
5. From the list of displayed periods, choose which one you want to open.
6. Copy the period you want to open in Notepad.
7. Select the Status column for that period.
8. Click Help and select Diagnostics, and then Examine.
9. Enter Oracle password:APPS.
10. In Field, enter LEDGER_ID and click inside Value to get the unique Ledger ID.
For example,
B-28
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
• Block: PREVIOUS
• Field: LEDGER_ID
• Value: 1
Copy this value to Notepad. This Ledger ID will be used as the value for
theLEDGER_ID parameter of the Event Monitoring task.
Next Steps in Task Manager
1. Create a new Schedule in Pending state.
2. Create a task for an event monitoring task to monitor Journal Period Open Event
(oracle.apps.gl.CloseProcess.period.open).
3. On the Parameters tab, provide a value for Ledger ID and Period Name from
EBS. For example: Period Name: Dec-10 and Ledger ID: 1
4. Save the task and set the schedule to Open state.
Next Steps in EBS
1. Click Open Period.
2. Select the period to open and click OK to raise the event.
3. Examine the status of EBS request by selecting View, then Requests, and then
Specific Requests.
Next Steps in Task Manager
1. Wait for the task to be set to open state. It takes a few minutes to capture the EBS
event.
2. After 2-3 minutes, click Refresh in Task Manager.
Refer to this document for more information on General Ledger Periods:
http://docs.oracle.com/cd/A60725_05/html/comnls/us/gl/openper.htm
EBS Steps
1. Log on to EBS.
2. Select General Ledger, and then theVision Operations (USA) role from the left
tree.
3. Select Open/Close, and then Enter and wait for Oracle Applications to start.
The Find Periods dialog displays.
4. Click Find. The Open and Close Period dialog displays.
5. From the list of displayed periods, choose which one you want to reopen.
6. Copy the period you want to reopen in Notepad.
7. Select the Status column for that period.
8. Click Help and select Diagnostics, and then Examine.
9. Enter Oracle password:APPS.
B-29
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
10. In Field, enter LEDGER_ID and click inside Value to get the unique Ledger ID.
For example,
• Block: PREVIOUS
• Field: LEDGER_ID
• Value: 1
Copy this value to Notepad. This Ledger ID will be used as the value for the
LEDGER_ID parameter of the Event Monitoring task.
Next Steps in Task Manager
1. Create a new Schedule in Pending state.
2. Create a task for an event monitoring task to monitor Journal Period Reopen
Event (oracle.apps.gl.CloseProcess.period.reopen).
3. On the Parameters tab, provide a value for Ledger ID and Period Name from
EBS. For example: Period Name: Dec-10 and Ledger ID: 1
4. Save task and set the schedule to Open state.
Next Steps in EBS
1. Click Open Period.
2. Select the closed period to open and click OK to raise the event.
3. Examine the status of EBS request by selecting View, then Requests, and then
Specific Requests.
Next Steps in Task Manager
1. Wait for the task to be set to Open state. It takes a few minutes to capture the EBS
event.
2. After 2-3 minutes, click Refresh in Task Manager.
Refer to this document for more information on General Ledger Periods:
http://docs.oracle.com/cd/A60725_05/html/comnls/us/gl/openper.htm
EBS Steps
1. Log on to EBS.
2. Expand Payables, and then the Vision Operations (USA) role from the left tree.
3. Expand Accounting, and select Control Payables Periods. This launches the
Control Payables Periods form.
4. Specify the Ledger and Operation Unit. Do not close the Find Payables Periods
dialog. Instead, perform the following steps to identify the Ledger ID value.
5. Click Help and select Diagnostics, and then Examine.
6. If requested for credentials, specify the APPS schema credentials. The Examine
Fields and Variable Values form displays.
7. In Block, enter PERIOD_QF. In Field, enter SET OF BOOKS, and click inside
Value, to get the unique Ledger ID numeric value. For example,
B-30
Appendix B
On-Premises Oracle E-Business Suite (EBS) Integration
• Block: PERIOD_QF
• Field: SET OF BOOKS
• Value: 1
Copy this value to Notepad. This Ledger ID will be used as the value for the
LEDGER_ID parameter of the Event Monitoring task.
Next Steps in Task Manager
1. Create a new Schedule in Pending state.
2. Create a task for an event monitoring task to monitor Payables Period Open/
Close Event (oracle.apps.ap.CloseProcess.period).
3. On the Parameters tab, provide a value for Ledger ID, Period Name and Action
from EBS. For example, Ledger ID: 1, Period Name: Dec-10 and Action: Closed
4. Save the task and set the schedule to Open state.
Next Steps in EBS
1. Find the period in EBS Control Payables Periods.
2. Click on Period Status column for that period.
3. In Control Statuses form, select the appropriate status.
4. Select File, and then Save to raise the event.
Next Steps in Task Manager
1. Wait for the task to be set to Open state. It takes a few minutes to capture the EBS
event.
2. After 2-3 minutes, click Refresh in Task Manager.
Note:
The EBS implementation raises the events only for Closed and Open
statuses. Permanently Closed status will not raise any event.
B-31
C
Financial Consolidation and Close Best
Practices
Best practices describe effective ways to use a feature. The following table provides
links to the best practices mentioned in this guide.
C-1