Cloud Oracle Engagement · Oracle Engagement Cloud Creating and Administering Analytics Preface ii...

Oracle EngagementCloud

Creating and AdministeringAnalytics

19D

Oracle Engagement CloudCreating and Administering Analytics

19DPart Number F22444-04Copyright © 2011, 2019, Oracle and/or its aliates. All rights reserved.

Author: Penny Anderson, Brian Oden, Kristin Penaskovic, Judy Wood, Dan Hilldale

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected byintellectual property laws. Except as expressly permied 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 nd any errors, please reportthem 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, thenthe following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware,and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal AcquisitionRegulation and agency-specic supplemental regulations. As such, use, duplication, disclosure, modication, and adaptation of the programs,including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to licenseterms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for usein any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware indangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safeuse. Oracle Corporation and its aliates 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 aliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks orregistered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarksof 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. OracleCorporation and its aliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, andservices unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its aliates will not be responsiblefor 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 applicableagreement between you and Oracle.

The business names used in this documentation are ctitious, and are not intended to identify any real companies currently or previously in existence.


Contents

Preface i

1 About This Guide 1Audience and Scope ..................................................................................................................................................................... 1

Related Guides for Analytics ....................................................................................................................................................... 1

Analytics Terminology ................................................................................................................................................................. 2

2 Prebuilt Analytics 5Analytics for User Roles .............................................................................................................................................................. 5

Complete Listing of Prebuilt Analytics ..................................................................................................................................... 6

Incentive Compensation Analytics ............................................................................................................................................ 7

3 Analytics Access, Currency, and Display 11Analytics Work Areas .................................................................................................................................................................. 11

Business Intelligence Catalog ................................................................................................................................................... 13

Analytics Security and Permissions ........................................................................................................................................ 14

Get More Access with the BI Administrator Role ................................................................................................................. 15

Optimize Analytics Display ........................................................................................................................................................ 17

Currency Seings for Analytics ............................................................................................................................................... 29

4 Subject Areas 35How Subject Areas Work ........................................................................................................................................................... 35

Subject Areas And Business Questions ................................................................................................................................. 35

Subject Area Context And Analytic Results .......................................................................................................................... 35

Multiple Subject Areas in a Single Analytic .......................................................................................................................... 37

Listing of Prebuilt Subject Areas ............................................................................................................................................. 43


5 Create and Edit Analytics 45Data Structure for Analytics ..................................................................................................................................................... 45

Analysis and Report Limits ...................................................................................................................................................... 46

Engagement Repository and Session Variables for Business Intelligence ..................................................................... 55

Deep Linking ................................................................................................................................................................................ 57

Edit Prebuilt Analytics ................................................................................................................................................................ 59

Report on System User Activity .............................................................................................................................................. 60

Create and Edit Analyses Using a Wizard ............................................................................................................................. 64

Manage Analytics with Advanced Features .......................................................................................................................... 65

Create a Simple Activity Analysis ........................................................................................................................................... 66

Create an Opportunity Analysis .............................................................................................................................................. 67

Create and Filter an Historical Trending Analysis ............................................................................................................... 69

Create and Edit Dashboards .................................................................................................................................................... 70

Best Practices for Working with Analytics ............................................................................................................................. 71

FAQs for Analytics and Dashboards ....................................................................................................................................... 71

6 Analytics on Interfaces 73Analytic Interfaces ...................................................................................................................................................................... 73

Sandboxes .................................................................................................................................................................................... 73

Analytics on Sales Pages ........................................................................................................................................................... 77

Analytics on Object Pages ........................................................................................................................................................ 80

Expose the Refresh, Export, and Print Links on Tabs ........................................................................................................ 84

Direct Linking .............................................................................................................................................................................. 86

Paths and Links to Analytics .................................................................................................................................................... 91

ADF Contextual Event Action .................................................................................................................................................. 92

USER_PARTY_ID Session Variable .......................................................................................................................................... 94

Embed Analyses and Dashboards .......................................................................................................................................... 95


7 Custom Subject Areas 97About Custom Subject Areas ................................................................................................................................................... 97

Custom Subject Area Objects .................................................................................................................................................. 98

Custom Subject Area Fields ................................................................................................................................................... 100

Measures ...................................................................................................................................................................................... 101

Custom Subject Areas Dates .................................................................................................................................................. 102

Secure Custom Subject Areas ................................................................................................................................................ 104

Create Custom Subject Areas ................................................................................................................................................ 105

Publication Statuses of Custom Subject Areas .................................................................................................................. 108

How to Report on Custom Fields .......................................................................................................................................... 109

Hierarchies in Analytics ............................................................................................................................................................ 110

Custom Subject Areas: Frequently Asked Questions ......................................................................................................... 111

8 Schedule and Share Analytics 113Create Brieng Books ............................................................................................................................................................... 113

Schedule Analytics and Brieng Books ................................................................................................................................. 113

Schedule Snapshots of Your Sales Historical Pipeline ...................................................................................................... 114

9 Analytics Folders 119Where to Save Analytics and Reports ................................................................................................................................... 119

Manage Predened Catalog Permission .............................................................................................................................. 120

How to Create Folders .............................................................................................................................................................. 127

Set Folder Permissions and Aributes ................................................................................................................................. 128

Set Folder Permissions ............................................................................................................................................................ 128

Archive and Move Analytics ................................................................................................................................................... 129

What happens to modied analytics and reports when an update is applied? ........................................................... 130


Preface

i

PrefaceThis preface introduces information sources that can help you use the application.

Using Oracle Applications

HelpUse help icons to access help in the application. If you don't see any help icons on your page, click your user imageor name in the global header and select Show Help Icons. Not all pages have help icons. You can also access the OracleHelp Center to nd guides and videos.

Watch: This video tutorial shows you how to nd and use help.

You can also read about it instead.

Additional Resources

• Community: Use Oracle Cloud Customer Connect to get information from experts at Oracle, the partnercommunity, and other users.

• Training: Take courses on Oracle Cloud from Oracle University.

ConventionsThe following table explains the text conventions used in this guide.

Convention Meaning

boldface Boldface type indicates user interface elements, navigation paths, or values you enter or select.

monospace Monospace type indicates le, folder, and directory names, code examples, commands, and URLs.

> Greater than symbol separates elements in a navigation path.

https://docs.oracle.com/en/cloud/saas/applications-help/

https://docs.oracle.com/en/cloud/saas/applications-help/

https://apex.oracle.com/pls/apex/f?p=44785:265:0::::P265_CONTENT_ID:27341

https://apex.oracle.com/pls/apex/f?p=44785:265:0::::P265_CONTENT_ID:27341

http://www.oracle.com/pls/topic/lookup?ctx=cloud&id=OACPR158049

https://appsconnect.custhelp.com/

http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?page_id=906


Preface

ii

Documentation AccessibilityFor information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website.

Videos included in this guide are provided as a media alternative for text-based help topics also available in this guide.

Contacting Oracle

Access to Oracle SupportOracle customers that have purchased support have access to electronic support through My Oracle Support. Forinformation, visit My Oracle Support or visit Accessible Oracle Support if you are hearing impaired.

Comments and SuggestionsPlease give us feedback about Oracle Applications Help and guides! You can send an e-mail to:[email protected].

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs

mailto:[email protected]


Chapter 1About This Guide

1

1 About This Guide

Audience and ScopeThis guide gets you o to a good start covering many primary tasks that sales administrators will do to set up analyticsfor their organization. The tasks covered here are:

• Edit analytics that come with the application.

• Edit subject areas that come with the application.

• Build new analytics.

• Build new subject areas.

• Enable the sales pages.

• Add analytics to the sales pages.

• Add analytics to the side and sub tabs of the edit and object landing pages.

"Oracle Sales Cloud" has been incorporated within "Oracle Engagement Cloud." Existing Oracle Sales Cloud users willretain access to Oracle Sales Cloud features under their preexisting licensing agreements. Any new users created withinyour current Oracle Sales Cloud license count will also retain the same access to Oracle Sales Cloud. Users may obtainaccess to additional Oracle Engagement Cloud features by renewing their subscriptions under the Oracle EngagementCloud SKU.

Related Guides for AnalyticsFor additional learning resources, refer to the Oracle Help Center, application online help, and Oracle University.

This table shows a list of guides that contain information related to the areas covered in this guide.

Title Description

Geing Started with Your SalesImplementation

This guide provides you with the concepts and procedures you need to implement a salesautomation solution in a test environment. You learn how to quickly implement a simplesolution for a business selling to other businesses

Implementing Sales

This guide provides conceptual information and procedures used to implement salesapplication components and features. It's intended for sales application administrators, and insome cases, application implementors, as they implement, congure, and use administrativecomponents of the sales applications.

User's Guide for Business IntelligenceEnterprise Edition

This guide provides detailed instruction on working with the broader set of BI analytic tools,which is helpful you are working with BI analyses in your Engagement application.

Security Reference for Sales andService

You can review the information in this guide to decide how to assign roles and privileges tospecic users depending upon who you want to see what information in your analytics.



2

Title Description

Related Topics• Get Started with Your Sales Implementation• Implementing Sales• User's Guide for Business Intelligence Enterprise Edition• Security Reference for Sales and Service

Analytics TerminologyThese are some of the words that might be unfamiliar to you as you read through this guide.

Term Description

Analytic/ Analytics

The broader term used for information pulled from business databases displayed in a waythat's meaningful to you. Analytics can include analyses, reports, and dashboards of any form.

Analysis/ Analyses

The specic term for one or more analytics that are shown visually on your desktop or mobiledevices.

Analytic Work Area

Analytic work areas are pages in the application that show analytics. You can congure somework areas to be specic to one or many user roles. You can also congure work areas to showdetailed information on a specic record.

Column

The term column in the context of creating analytics is used to describe the objects that holdthe data that populates an analysis. The columns are aributes of the subject area dimensionsand you drag the columns to the palee as you build your analytics.

Fact Folders/Facts

The Fact folders contain lters to count or measure the information in analytics. Factsare pieces of information that are calculated using standard operators such as addition,subtraction, and so on.

Infolet

An infolet is a small container or "widget" on the sales pages that hold an analytic. You cancongure the infolet shape and size.

Key Performance Indicator (KPI)

Key Performance Indicators are values that analytics provide to help organizations get asnapshot of information in a particular context.

Navigator

Navigator is represented by an icon with four parallel white lines on the Home page. When youclick the Navigator icon you go to a page that shows all the options for users to manage andmonitor their sales activities. Administrators see options for managing the application.

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=FASMC

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=OASAL

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=BIEUG

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=OASLM



3

Term Description

Oracle Business Intelligence Answers(BI)

BI is a major work area for administrators. You view, edit, and create analytics and subjectareas in BI.

Report

A report is a type of analytic used primarily for published presentation. Types of reports mightbe nancial documents, human resource spreadsheets, and so on. The wizard for building areport walks you through a series of options for formaing the layout of the report.

Sandbox

A sandbox is a testing stage you use to add and view changes to the interface without actuallyimplementing your changes to a live site.

Home Page

The landing page for the application, also called the springboard.

Sales Icon

The Sales Icon links to a page that contains icons with links to all of the major work areas forsales users.

Subject Area

Subject areas are the building blocks of your analytics. You begin building your analytics bychoosing an appropriate subject area. Technically, subject areas are a grouping of databaseinputs called data objects that relate to each other in a particular context.

White Dot Page Controls

The white dot page controls on the Home Page are navigation tools that link to the SalesPages. Both of these pages are enabled by administrators for users to access.



4


Chapter 2Prebuilt Analytics

5

2 Prebuilt Analytics

Analytics for User RolesPrebuilt analytics let you get analytics out to your users right away. You can set up these analytics so that your sales orservice user roles see their own data when they log in. There are dozens of analytics for specic user roles, as well asanalytics relevant to all roles in your organization.

Here are some analytics for sales roles:

• Sales Representatives - performance, opportunities, pipeline, leads, and quota analytics

• Sales Managers - team analytics including activities, leads, performance, opportunities, quota, andperformance

• Channel Account Managers - MDF Requests, deal registration, partner status, opportunities, pipeline, partnerperformance, and quota analytics

• Sales Executive - team leads and executive analytics including, actual vs. quota, forecast vs. quota, top openopportunities, sales stage by age, forecasting, performance, and service request

• Channel Sales Manager - MDF requests, open pipeline, stalled opportunities, partner business plan objectives,partner hierarchy analytics.

• Partner Sales Representative - stalled opportunities and top open opportunities analytics



6

Here are some analytics examples for specic user roles. These are for Sales Representatives to see their opportunitiesand pipeline.

Here are some analytics for service roles:

• Customer Service Representative - personal performance, pending tasks, compliance, queues, action plans,work order analytics.

• Customer Service Manager - agent performance, compliance, interactions, queues, channels, action plans, workorders, email, social post analytics.

• Human Resource Help Desk Agent - personal performance, pending tasks, compliance, queue analytics.

• Human Resource Help Desk Manager - agent performance, compliance interaction, queues, email analytics.



7

Complete Listing of Prebuilt AnalyticsYour Engagement applications come with a variety of dierent prebuilt analytics for your sales users. Use the prebuiltanalytics right out of the box,, or make a copy and modify them however you like.

Related Topics

• Sales analytics listing in downloadable format.

• Service analytics listing in downloadable format.

Incentive Compensation Analytics

Incentive Compensation AnalyticsHere are the standard business intelligence reports for Incentive Compensation and where you can nd them.

IC Report Description Incentive Compensation Dashboard

Assigned Disputes by Type

View the number of disputes with a giventype.

Analyst

Aainment Comparison

Assess participants' performance againstaainment goals and earnings targets.

Participant Manager

Aainment Details

Audit transaction processing and researchaainment disputes.

Analyst

Aainment Versus Goal Report

Assess participant aainment againstperformance goals.

Participant

Balances

View a participant's payment balancessummarized by period.

Commission Statement

Commission Statement Participant DetailsReport

View the participant context for acommission statement, including: theparticipant name, worker number, andbusiness unit.


Commission Statement AainmentSummary Report

Assess participant aainment towardgoals.


Commission Statement PaymentSummary Report

View a participant's payment balancessummarized by period.


http://www.oracle.com/webfolder/technetwork/docs/reports/r13/Sales-Reports-R13.xls

http://www-content.oracle.com/webfolder/technetwork/docs/reports/r13/Service-Reports-R13.xlsx



8


Compensation Cost of Sales by Month

Assess incentive plan eectiveness bymonth.

Plan Eectiveness

Compensation Cost of Sales by Plan

Assess incentive plan eectiveness byviewing compensation in proportionto performance. This informationhelps to determine the return for eachcompensation dollar invested, rather thanthe absolute cost of compensation.

Plan Eectiveness

Compensation Cost of Sales by Quarter

Assess incentive plan eectiveness byquarter.

Plan Eectiveness

Compensation Plan Assignment

View the compensation plans assigned toa participant.

Analyst

Compensation Plan Summary Report

View plan details, including plan name,eective start and end dates, and earningsand target incentive amounts.


Credit Details

View credit details, including transactionand credit amounts as well as splitpercentage.

Participant Participant Manager

Credits

View credited transactions for a selectedperiod, including credit category,transaction amount, credit split, and creditamount.

Participant Participant Manager

Dispute Status and History

Access a participant's dispute history.

Analyst

Earning Comparison

Assess participants' earnings againsttarget incentives.

Participant Manager

Earnings Summary

Assess a participant's earnings towardtarget incentive.

Analyst

Earnings Versus Target Incentive Report

Assess participant earnings against targetincentives.

Participant

Earnings, Year to Date, Target Incentive

Compare a participant's year-to-dateearnings with target incentives for a singleplan component or all components.

Participant



9


Event Based Payment Details Report

View payment details where transactionswere calculated per event.


Interval Based Payment Details Report

View payment details where transactionswere calculated per interval.


Investment Matrix by Product

Assess the revenue to compensation ratiofor dierent products and services tounderstand if sales behavior is alignedwith strategy for dierent products andservices.

Plan Eectiveness

Manual Adjustments

View a summary of manual paymentadjustments by period.


Participant Detail

View a history of key participant detailsincluding business unit, cost center, andcurrency.

Analyst

Pay Group Assignment

View the pay groups assigned to aparticipant.

Analyst

Payment Balance and History

Review a participant's payment balancessummarized by period.

Analyst

Payment Plan Assignment

View the payment plans assigned to aparticipant.

Analyst

Payments

View a breakdown of payments for oneor more periods by plan component,adjustments, and recovery amounts.

Analyst

Performance Distribution

View the number of participants within agiven aainment range, by period.

Participant Manager

Plan Components

View a summary of payments by plancomponent.


Sales Investment Matrix by Plan

Assess the revenue to compensation ratiofor dierent plans and determine if salesbehavior aligns with strategy for dierentplans.

Plan Eectiveness

Sales Investment Matrix by Product

Assess the revenue to compensationratio for dierent products and servicesto understand if sales behavior aligns

Plan Eectiveness



10


with strategy for dierent products andservices.

Year-to-Date Earnings and PaymentSummary

View by period your payments year todate and a breakout of earnings anddraws,

Plan Eectiveness

You can see the report dashboards in these work areas, depending on your role.

Dashboard Role Location

Analyst

Incentive Compensation Manager Incentive Compensation Analyst

Participant Snapshot work area in theAnalytics pane Search for a participant before you cansee the report.


Participant

In the Business Intelligence catalog youcan open from the Reports and Analyticspane You can add the dashboard to the SalesCompensation work area

Participant

Participant

Sales Compensation work area in theReports and Analytics pane

Participant Manager Participant

Incentive Compensation Manager

Sales Compensation work area in theReports and Analytics pane

Plan Eectiveness

Incentive Compensation Manager

Participant Snapshot work area in theReports and Analytics pane Search for a participant before you cansee the report. In the Business Intelligence catalog youcan open from the Reports and Analyticspane

Related Topics

• Incentive Compensation Subject Areas

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=017A6C256E033EC0E053B69BF40AD53A


Chapter 3Analytics Access, Currency, and Display

11

3 Analytics Access, Currency, and Display

Analytics Work AreasAs an administrator, your job is to create, edit, and maintain analytics for your organization. The work areas are thepages that you use to create and edit all things analytics. You also add analytics for your users on these pages.

Work Area Name Description

Oracle Business Intelligence (BI)

You view, edit, and create analytics in BI. You also can view, edit, and create subject areas here.

Home Page

This page is the main landing spot for you and your users and is the springboard to get to allyour analytics pages.

Sales Infolet Page

This page comes prebuilt with infolets specic your user roles. You can do just about anythingto change the way this page looks and which analytics show. To get to this page click the whitenavigation dot on the home page.

Sales Pages

You enable these pages for your users. These ve blank pages are available for you to addanalytics related to any Engagement Cloud area. The white navigation dots on the home pagetake you to these pages.

Object Pages

On these pages sales users work with opportunities, accounts, contacts, activities and so on.Administrators enable the tabs on these pages and add analyses to the tabs on the side orboom of the page.

Analytics Page

This page is where sales users search for analytics they have permissions to view and makethem favorites. Sales users also see analytics that administrators have congured to showspecic to their role. It is your users own analytics page to do what they want with.



12

This is an example of an Infolet page.

This is the Analytics page. It's a page where users add and view analytics.



13

This is the Opportunities work area. Users can click the analytic icon and view analytics specic to a record.Administrators add analytics to this object page.

Related Topics

• Using Oracle Business Intelligence

Business Intelligence CatalogThere are two major work areas for analytics administration. The main Engagement interface is where your usersview the analytics administrators set up in user work areas and on the infolet pages. The second area is the businessintelligence catalog. Reports, analyses, dashboards, and other business intelligence (BI) objects are stored andadministered in the business intelligence catalog. BI is where you build and edit analytics for your user work areas. Youcan toggle back and forth between the two areas.

Navigate to the Catalog1. Click Tools > Reports and Analytics in the Navigator.2. In the Reports and Analytics work area, click the Browse Catalog buon.

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=BIEUG



14

Objects in the CatalogThe catalog stores the BI objects in a folder structure of individual les, organized by product family.

BI objects and reports are organized in the following folder hierarchy:

• Shared Folders (parent)

• Product family (example: Financials)

• Product (example: Payables)

• Report groups (example: Invoices)

• Dashboard reports

• Data Models

• Report Components

• BI Publisher reports

• Prompts

The following table describes the common BI objects that you nd in the catalog:

Catalog Object Description Location

Analysis

Analyses are used for infolets, the Salespages, and on object pages such asOpportunities.

Analytics library

Dashboard

Dashboards organize analytical contentand catalog objects, and present them in ameaningful way.

Reporting group folder

Dashboard Prompt

Dashboard prompts allow users to lterdashboard content using provided values.

Prompts folder

Filter

Filters are used in dashboards andanalyses.

Prompts folder

Report

Reports are operational reports inprintable format created in BusinessIntelligence Publisher.

Analytics library

Data Model

Data models are used by reports createdin Business Intelligence Publisher.

Data Models folder

Sub-template

Sub-templates are used by reports createdin Business Intelligence Publisher.

Reporting group folder



15

Analytics Security and PermissionsSome analytics might contain information specic to job roles that you don't want everyone to see. An example mightbe analytics with salary information. Access to objects in subject areas, which in turn are used to build analytics arecontrolled by permissions. Permissions are authorizations that determine who can see what. Permissions are a part ofthe security model, and how permissions are initially assigned is based on how users, roles, and groups were initially setup on your application.

The setup administrator has likely assigned you the role of Sales Administrator, or the Sales Administrator mighthave created a sub-role specically for administering analytics. As the person responsible for administering analytics,your permissions enable you to access and edit all of the analytics and analytic work areas. You have access to the BIcatalogs, dashboards, and tools to create, edit, and add analytics to your team work areas. For more information, seeSecurity Reference for Sales and Service.

Related Topics

• Security Reference for Sales and Service

Get More Access with the BI Administrator RoleIf you're a Sales Administrator you have lots of permissions already. But you likely want to perform high-level tasks inBI as well. To get these extra permissions you need the BI Administrator role. BI Administrators have access to theseadditional things:

• Catalog groups

• Privileges

• Sessions

• Publisher scheduling and delivery

Assign the BI Administrator Role

1. Sign in as a Security Manager. For example, IT_SECURITY_MANAGER.2. Click Tools > Security Console.3. Select the Roles.4. Click Create Role.5. Fill in the required information.

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=OASLM



16

This is the Create Role page for entering basic information.

6. Click Next until you come to the Role Hierarchy page.7. Click the Plus icon to bring up the Add Role Membership page.8. Search All for BI Administrator Role.

This is the Add Role Membership page for creating roles.

9. From the search result select BI Administrator Role and click Add Role Membership.10. Click Next until you get to the Users page.11. Add the users that you want to have the BI Administrator role. You can assign the BI administrator role to users

later too.12. Click Next.13. Click Save and Close.



17

Assign Additional UsersAfter the BI Administrator role is created you can assign additional users to the same role.

1. Sign in as a Security Manager. For example, IT_SECURITY_MANAGER.2. Click Tools > Security Console3. Select the Users tab.4. Search for the user to be assigned the BI Administrator role.5. Select the user and choose Edit.6. Click Add Role.7. Search for the BI Administrator role you created in the steps for Assigning the BI Administrator Role.8. Click Done.9. Click Save and Close.

Optimize Analytics Display

Why Use Responsive Sizing?Responsive sizing ensures that analytics are displayed on your laptop, mobile, or tablet browser in the best possibleway. By default you can congure analytics to t any format, but that doesn't make them responsive to your browserresolution.

When you enable responsive sizing, you ensure the analytic size adjusts to the screen size on your device. This ensuresthat you view an analytic in as much screen space as possible without distorting the image. Not only does the windowadjust to maximize the screen display on the device, but it enables a scroll in the cases where the analytic rows extendbeyond the screen size.

This is an analytic before responsive sizing is set up.

This is an analytic fully sized to t the screen with responsive sizing.



18

This is a tabular report before responsive sizing is set up.

This is a tabular report after responsive sizing is set up. Note how the report now uses all the available screen space.



19

This shows how with responsive sizing set up, the graph size changes in size to respond to the browser size.

Things to Keep in MindYou can't opt into responsive sizing globally. And Prebuilt analytics can't be set for responsive sizing unless you make acopy. There are a few steps to opt in for each analytic you want enabled.

If you have multiple BI objects on a page, responsive sizing doesn't work. But you can embed a dashboard, or layoutquadrant, which can then express multiple analytic objects with responsive sizing. For table views, if it has a largenumber of columns it will scroll.



20

You need to set every analytic that you want to be responsive. In some cases you congure the page the analytic is on.This summarizes the pages and steps for seing responsive sizing.

Page Name Setup Requirements

Object Landing or Object Edit Pagetabs

• In BI, set analytic dimensions, and if the analytic is in a dashboard set the dashboarddimensions as well.

• Working in a sandbox, edit the container parameter and display options.

BI Dashboards


• In BI, set column and container properties so that dashboard container is larger than theanalytic container.

Sales and Service Pages


• Working in a sandbox , edit the container parameter and display options.

These ares the pages that are available for responsive sizing.

Views that can be resized Views that can be partially resized Views that can't be resized

Columns / Sections

• DVT graphs• Map• Tree map view• Table, pivot table• Trellis• Title• View selector

Ticker - horizontal only

• Gauge• Some graph prompts• Performance tile• Funnel• Filter• All others

Responsive Sizing In Analytics and DashboardsTo create or edit a table with responsive sizing you provide the view and container dimensions. The dimensions can't beblank. You set dimensions to optimize viewing and to ensure the container is larger than the view canvas when it sizesdynamically to t the device screen size.

These are the component levels to set for analytics sizing:

• Level 1 -View container (Set in BI)

• Level 2 - View (Set in BI)

For dashboards, four levels of layout sizing are needed:

• Level 1 - Dashboard container (Set in dashboard)

• Level 2 - Dashboard section (Set in dashboard)



21

• Level 3 - View container (Set in BI)

• Level 4 - View (Set in BI)

These are the sizing specications for analytic components.

These are the browser and related container sizes.

Browser (variable sizes) Content container (xed sized)

1094 x 939

933 x 737

1302 x 939

1192 x 737

1468 x 939

1350 x 737

1790 x 939

1509 x 737

Set View Dimensions1. In the results view of your analytic, click View Properties.



22

This shows the View Properties selection for an analytic.

2. Choose the General tab.3. Set the height, and width of the analytic canvas. You must dene the size of the analytic to t the size you have

available in the container that holds the analytic. It doesn't maer which device you use to view the analytic,as long as you have set the size of the analytic in your window in BI to maximize the space available in thecontainer. Seing the height and width ensures that the view of this analytic is responsive on all devices. Thedefault is set to not dene a size. You need to dene a size for responsive sizing to be set.

This shows the General tab for graph properties, and the canvas width and height options.

Set Analytic View Container Dimensions

1. In the results view of your analytic click Format Container.



23

2. Adjust the sizing to make sure the container is larger than the canvas. Since we previously set canvas size to830 and 265, we set the container to a larger size at 835 and 270. Note that if you also add title containers, thesize needs to match the size set for the analytic container.

This shows the Width and Height options for the Format Container dialog.

Set the Dashboard Container DimensionsIf your analytic is in a dashboard you set the dashboard for responsive sizing. For BI dashboards that hold analytics youset each container component on a dashboard to be responsive.

Set the properties for width and height for the container components to be larger than the properties set for youranalytic. In this case, since we previously set our analytic container to 830 and 265, we set our dashboard container to asize larger than the dimensions set for the analytic container.

To set the dashboard container dimensions:

• Select the container. Click Column Properties.



24

This shows the Column Properties option for a dashboard container.

• Select the column. Click Format Section.

This shows the Format Section option for a container in a dashboard.

This shows the Height and Width options for Column Properties of a dashboard.



25

Compound View and View EditorsCompound views are also available for seing up responsive sizing.

This shows the edit container option.

This shows options for seing the text properties in the elds. Set title cell properties using the A icon to the right of theeld.



26

In the Cell property dialog set the vertical alignment to Center to set the title to oat vertically in the resized container.This seing is recommended.

For tables, set the following:

• Select "Fixed headers with scrolling content" to add sizing values.

• Set Vertical Alignment = "Center" in the Table's view container if you want the table to oat vertically in themiddle of the resized container.

This gure shows a table, with the option to edit the table view container properties.

For pivot tables select "Fixed headers with scrolling content" to add sizing values.

This shows a pivot table with the option to edit the pivot table view container properties.



27

Responsive Sizing on Interface PagesAnalytics and analytic interface components all must have the sizing set for responsive sizing to work.

Set the Analytics Tabs on Interface PagesOnce your analytic is set with the proper sizing, the next step is to add the analytic to your interface and set the layoutspecications.

1. Add the analytic to the object tab.2. Open a sandbox.3. Under Seing and Actions choose Edit Pages.4. In the Edit Pages dialog, select internal.5. Click OK.6. Navigate to the page to set up.7. Click Change Layout.8. Navigate to the analytic and click Add.9. Click Edit.

This shows the edit option for a dashboard container.

10. Under the Parameters tab, change the sizing to "content" and remove any height and width values so that theeld is empty.



28

This shows the Height and Width options as well as the Sizing option.

11. Click the Display Options tab.12. Click the Advanced tab.13. Under Stretch Content, set the value to "false".

Best Practices For SizingTraditional BI Content typically doesn't have all these sizes specied. The following are some recommendations forgeing the best sizing results.

• Use original content as a guide and size from the inside out., Start adding sizes for views rst. Follow thisby adding sizes to view containers. Save the report then make adjustments to Dashboard Sections, and thenDashboard Columns. When tweaking dashboard containers, set their size to the specic size then tweak tominimize scroll bars.An inspector tool like Firebug can make this process much easier by allowing temporary edits in place. Youcan then go back and add the values in the dialog. Add 20 pixels to dashboard container heights as this getsdeducted by the dashboard code (presumably to reserve space for the collapsible icon).When you're done tweaking, set the dashboard, columns, and sections to the minimum size seing. This seingremoves the overow behavior and prevents scroll bars from appearing on BI content.

• Measure pixels in original content to obtain starting size values. Use a pixel measuring tool (like Measureor others) to measure pixels on the screen to nd starting sizes for views. Similarly, measure pixels on thescreen to help gure how many pixels to add or deduct for components that can't be resized within views. Forexample, the View Selector widget needs approximately 40 pixel height.

• Build in padding sizes. BI styles typically have some padding built in to their CSS. The BI resizing code worksbest when taking this into account. Moving from sections to columns, try adding 3 pixels per border. Forexample, if you have two sections in a single dashboard column, they contribute four borders. So make thecolumn value 12 pixels larger than the sum of the sections. When working up from views to view containers,try adding the same 3 pixels per border. Note that the 3 pixel padding recommendation is suitable for the Altastyle. Custom styles may need more or less padding to be built into the math. You can validate the dashboard



29

behavior using the specic size seing. In general, more padding is safer but could contribute marginally to lesspredictable behavior.

• Make sure the math works out. BI builds up the sizing map based on nested layout objects. Resizing falls apartif any parent container size is sized smaller than the content that it contains. For example, if a graph size is 300x 200 and its view container is 350 x 250, then section and column containers must be larger than 350 x 250. Ifthe section were set to 300 x 200, for instance, resizing wouldn't work.

This shows a dashboard with an analysis that has a compound layout with titles and two views to choose from.Colors added to highlight the layout components.

Currency Seings for Analytics

Set Currency Preferences for AnalyticsEngagement applications let you to decide how currency is shown in the application, as well as preferences for howanalytics show currency and calculate exchange rates. Currency can be set in dierent regional currency types,depending on where you do business and what currency types you want to see.

There are three ways you set up currency:

• User Currency - Set by the business user in Regional seings. This seing applies to the entire applicationinterface for that user only. The currency options available are set by your application administrator.

• Analytics Currency - Set by the business user in BI in My Account seings in the Reports area. The seingapplies to that user only and only relevant for report production.

• Corporate Currency - Set by the application administrator. This seing applies to all users in that company.



30

Set General User CurrencyUser currency seings determine the currency used as the default for what you see in your application. User currencyapplies to your entire interface for your signed-in session.

1. Navigate to Tools, Set Preferences.2. Select General Preferences > Regional.3. Select the preferred currency to be used. Available currencies include those set up for your company by your

application administrator.

Set Analytics CurrencyThe analytics currency seings determine the currency type that is displayed in all your analytics. It also determines howand when your currency conversion rates are calculated.

1. Navigate to Business Intelligence.2. Click Analytics in the navigator menu.3. Click Browse Catalog.4. Click your user name and select My Account.5. Go to the Preference.6. Select your choice in Currency.

This shows the currency display options for users:

Currency Display Type Description

Entered CurrencyCurrency used on a transaction.

<Application> CurrencyCurrency set up in each respective Cloud application as the common Corporate currency usedcompany-wide.

User Preferred Currency usingSimple Currency Management

Conversion to User Preferred Currency is performed at the time your run the report, and iscalculated from the Corporate currency based on the last time the record was updated andsaved or closed.

User Preferred Currency usingAdvanced Currency Management

Conversion to User Preferred Currency happens on the date your run the report, and uses thecurrency indicated on the record.

Set a Global Currency Conversion ProleSet a global currency conversion method for all your users by creating a currency prole. Only administrators can createcurrency proles.

1. In Setup and Maintenance, go to Manage Prole Options.2. Enter the following values:

◦ Prole Option Code : BI_DEFAULT_CURRENCY_CONVERSION_METHOD



31

◦ Prole Display Name : BI Default Currency Conversion Method

◦ Application

◦ Module

◦ Start Date : Provide previous day's date to proceed to next step to dene values.

3. Click Save and Close.4. In the Manage Prole Options dialog box, you see your new prole. Check the Enabled box for Site.5. Click Save and Close.

Related Topics

• Update Existing Setup Data

Dene Currency Prole ValuesAfter you create your currency prole, the last step is to dene the prole value. This step denes which currencymanagement option is assigned to that prole.

1. In the Setup and Maintenance work area, useManage Administrator Prole Values.2. In Prole Option Code search for your prole: BI_DEFAULT_CURRENCY_CONVERSION_METHOD.3. In Manage Administrator Prole Values, Click Add (+ icon).4. Select Site as the Prole level.5. Enter "User Preferred Currency 2" in Prole Value.6. Click Save and Close.

How User Preferred Currency Exchange WorksThe simple and advanced user-preferred currency choices determine how and when your currency exchange rates arecalculated for your reports. For both simple and advanced currency management, when you save or close a report, theapplication sets the exchange rate at that time. The option you choose impacts how quickly your reports are generatedat run time. Each case includes trade-os, as detailed in the examples.

User Preferred Currency using Simple Currency ManagementThe advantage of this option is performance - the application doesn't have to look up the rate for each transactionbecause when you close or save a record, the application converts it to your corporate currency at that day's rate. Whenyou run the opportunity report, the application multiplies that value by your preferred currency exchange rate for thedate you run the report. This eliminates the need for the application to cycle through each record, and calculate thecorresponding exchange rate to your preferred exchange rate at the time that record was closed or last saved. It simplytakes the value on record for the original transaction exchange to corporate currency, and multiplies it by your preferredcurrency exchange rate at the time your run the report.

As an example of user preferred currency using simple currency management, a user updates and saves or closes anopportunity record with associated revenue of one million Indian Rupees on January 31st with an exchange rate of0.01403 Rupees to one US Dollar. The user then runs an opportunity report in US Dollars on March 31st. In the report,the US Dollar Corporate Currency is set at the January 31st rate it was saved at, in this case reporting as $14,030, or onemillion multiplied by 0.01403. Finally, an opportunity report on March 31st in Euros uses the March 31st conversion ratefor US Dollars to Euros of 0.75017 to convert the recorded US Dollar amount into Euros, in this example one millionmultiplied by 0.1403, which is the January 31st Rupee to US Dollar exchange rate, multiplied by 0.75013, which is theMarch 31st rate for Euros. This requires less processing, because the January 31st Rupee to US Dollar exchange rate,

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=OAFSM1684802



32

while not exact on March 31st, is used as the basis for the calculation of the March 31st opportunity revenue conversionto Euros at the later exchange rate.

The following gure describes an example of user preferred currency using simple currency management.

User Preferred Currency using Advanced Currency ManagementThis option provides a more precise exchange rate, since it goes through each record to determine the rate on the datethe record was updated or closed. The downside of this option is performance. Your reports will take longer to run. Theapplication has to cycle through each record and match currency exchange rates to the date the record was closed orupdated and saved.

As an example of user preferred currency using advanced currency management, a user updates and saves or closesan opportunity record with associated revenue of one million Indian Rupees on January 31st, when an exchange rateof 0.01050 Rupees to one Euro applies. The user then runs an opportunity report on March 31st. In the report, the UserPreferred Currency of Euros is applied, using the March 31st Rupee to Euro rate of 0.01052, requiring calculation duringreport processing to resolve the opportunity to 10,520 Euros. Finally, an opportunity report on March 31st in Euros againuses the March 31st conversion rate for Euros.



33

The following gure describes an example of user preferred currency using advanced currency management.

Why do I see amounts of zero in analyses?The currency exchange rates might not be set up correctly. For example, you choose EUR as your preferred currency ingeneral preferences, and your corporate currency is USD. Amounts in analyses are displayed in EUR after conversionfrom USD, based on the current exchange rate. But if the exchange rate between EUR and USD isn't set up, or if theconversion fails for any reason, then the amounts show as zero.



34


Chapter 4Subject Areas

35

4 Subject Areas

How Subject Areas WorkA subject area is a grouping of information pieces pulled from your transactional database that relate to each otherin a particular context. Examples of context are pipeline, revenue, partners, performance, and so on. These contextscorrelate to key aspects of your business transactions, and are designed to provide answers to questions about how wellthings are going. Prebuilt subject areas come right out of the box to answer key business questions.

Any information your organization tracks can be grouped into a subject area, then used to build analytics. All you haveto do is drag columns from your subject area to your analytics editor and you have an analytic. You can edit prebuiltanalytics the same way, by adding or removing columns from your subject area. When you edit prebuilt analytics, don'tforget to make a copy and give it your own name.

Subject Areas And Business QuestionsSubject areas are designed around business questions. All analytics are built from subject areas. So whether you'recreating your own analytics, or modifying the analytics that come with your Engagement applications, you rst want togure out what questions you want answered.

Here are some examples of subject areas and the business questions they can answer.

Subject Area Name Example Business Questions

Sales - CRM Pipeline

• Are my sales representatives moving their opportunities fast enough.• How is each member on my team performing on deal size, account coverage, and win

rate?• Is my team converting leads to opportunities fast enough?• What are the most likely reasons that we lose against our key competitors?• What are the top 10 open opportunities?

Sales - CRM Forecasting

• What are my forecasts and closed revenues for this quarter?• Are revenues closed in time for their forecast gures?• Does the forecast versus pipeline show a healthy picture?• What were my forecast revenues for the same period last year?

Sales - CRM Sales Activity

• Is there any work load balancing issues on my team?• I want to rebalance my team workloads. Based on upcoming activity levels what are my

resource levels?• Are there accounts that are being heavily pursued?• How can I identify neglected but strategic accounts?



36

Subject Area Context And Analytic ResultsIf your analytic doesn't look right, or columns of information aren't showing up, it could be an issue with context. Thecontext denes what column details the analysis displays. Adding an employee column doesn't mean all employeesshow up in the analysis. It depends on the context you're using to create the analysis. If you build an analysis, and itdoesn't show what you're expecting, be sure that you're adding your columns and facts in context.

The subject area dimension folders contain the columns and the facts folders dene the relationship of the columns. Ifyou add the Employee column to your analysis, and then add the Fact, Number of Activities to the same analysis, thenonly the employees that have one or more activities show on this analysis in this context. There might be hundreds ofemployees that have some sort of relationship with A.C. Networks, but no associated activities, so they don't show up onyour activity analysis.

The following is an example that might help explain this further.

In this exercise you will build an activity analysis, and add an additional subject area, then explore some dierentscenarios.

1. Build an activity analysis as directed in "Create an Activity Analysis".2. With your activity analysis in edit mode, add the standard subject area Sales - CRM Quota Management.3. Both subject areas appear under Subject Areas. Expand Sales - CRM Sales Activity. Expand Customer. Expand

Sales Account Extension. Drag Level 1 Account Name onto the palee.4. Still in Sales Activity, expand Employee. Drag First Name and Last Name onto the palee.5. Expand Facts, then Activity Facts. Drag # of Activities onto the palee. This fact is key to this analysis because

the relationship of Employee to this subject area is dependent on the employee having one or more activitiesfor one or more accounts. If your employee has never entered activities for any given account, they don't tshow up on this report, even if they have another type of relationship with an account. Since the context of thissubject area has to do with sales activities, only employees with activities are included.

6. Now select the "Results" tab. You see four employees in the resulting analysis. Each of these employees hasone or more activities.

7. Now select the "Criteria" tab. Under Subject Areas expand Sales - CRM Quota Management. Expand Facts.Expand Pipeline Facts and drag Opportunity Revenue to the palee.

8. Go to the "Results" tab. Notice that now there are more employees. This result is because you have addedemployees that also have relationships to Quota Management. In this case, employees are added that havegenerated revenue.

9. Go back to "Criteria". Remove # of Activities. The results show only the three employees that have revenue.Helena has both revenue and activities so she shows up in both scenarios.



37

Finally, note that if you remove both # of Activities and Opportunity Revenue and look at the results, you again haveonly the four employees that have a relationship with only the Sales Activity dimension.

Multiple Subject Areas in a Single AnalyticSubject areas can be tricky to master, but once you get familiar with them you can easily mix and match subject areacomponents for your analytics. The reason you would want to do this is just for exibility. You might want to look atyour business from dierent perspectives. Maybe you want to look at leads against pipeline against activity. Are yoursales people doing a good job following up on leads?

You can create analytics that combine aributes and metrics from custom and standard subject areas that share acommon dimension. Or, if that isn't enough, you can create analytics that combine data from a custom subject area likeopportunity, with any related subject area such as Sales CRM Pipeline. You can create combined analytics with an arrayof standard objects, including accounts, contacts, households, opportunities, partners, sales accounts, territories, andresources.



38

To start with, let's learn how to add a subject area to your analytic editing palee. Whether you're creating a newanalysis, or using an existing analysis to add objects from your custom subject area, the steps for adding multiplecustom or standard subject areas to your palee are the same.

To add subject areas to editing palees:

1. Create your analysis using a single subject area.2. In the Subject Area section, click the Add/Remove icon.

This shows the Add or Remove subject areas icon.

3. Select or remove one or more standard or custom subject areas from this analysis by selecting or deselectingsubject area. If you have created custom subject areas, they also appear in this list under the name youassigned to them.

Cross Subject Area QueriesEach subject area contains a collection of aributes and measures relating to the one-dimensional STAR model andgrouped into individual folders. The term STAR refers to the semantic model where a single fact is joined to multipledimensions. You can create an analysis that combines data from more than one subject area. This type of analysis isreferred to as a cross-subject area query. Cross-subject area queries are classied into three broad categories:

• Combining queries from multiple subject areas.

◦ Using common (conformed) dimensions.

◦ Using local and common (conrmed) dimensions.

• Using a "set" operation (Union or Union All for example) to combine more than one result set from dierentsubject areas.

• Combining Logical SQL using the Advanced tab.



39

A Common dimension is a dimension that exists in all subject areas that are being joined in an analysis. For example.the Customer dimension is the common dimension for the Sales - CRM Pipeline and Marketing - CRM Leads subjectareas.

A Local dimension is a dimension that exists only in one subject area. For example, Opportunity and Revenue are localdimensions for the "Sales - CRM Pipeline" subject area.

The following are some general guidelines to follow when working with multiple subject areas:

• If all the metrics and aributes needed for the analysis are available in a single subject area and fact metrics,use that subject area only and don't create a cross subject area query. Such an analysis performs beer and iseasier to maintain.

• When joining two subject areas in an analysis, make sure at least one aribute from a common dimension isused in the analysis.

• When using common dimensions always choose aributes from the common dimension from a single subjectarea. For instance if you're using the Customer dimension to build a query between subject area 1 and subjectarea 2, then select all customer dimension aributes from either subject area 1 or from subject area 2. (Notsome customer aributes from subject area 1 and some from subject area 2.) In some scenarios, the commondimension may have more aributes in one subject area than the other. In such a situation, you can only usethe subset of common aributes for a cross-subject area query.

• Always include a measure from each subject area that's being used in your analysis. You don't have to displaymeasures or use them, but you should include them. You can hide a measure if not needed in the analysis.

• When using common and local dimensions use SET VARIABLE ENABLE_DIMENSIONALITY=1; in the AdvancedSQL tab.

Queries from Multiple Subject AreasThe simplest and fastest way to generate an analysis is to use a single subject area. If the dimension aributes and factmetrics that you're interested in are all available from a single subject area, then you should use that subject area tobuild the analysis. Such an analysis results in beer performance and is much easier to maintain.

If your analysis requirements can't be met by any single subject area because you need metrics from more than onesubject area, you can build a cross-subject area query using common dimensions. There's a clear advantage to buildinga cross-subject area query using only common dimensions, which is recommended.

Keep in mind that if you use three subject areas for an analysis, your common dimensions must exist in all three subjectareas. Joining on common dimensions gives you the benet of including any metric from any of the subject areas in asingle analysis.

While you can create an analysis joining any subject area to which you have access, only a cross-subject area querythat uses common dimensions returns data that's at the same dimension grain. This happens so that the data is cleanlymerged and the result is an analysis that returns exactly the data you want to see.

Knowing how cross-subject area queries are executed in BI helps you understand the importance of using commondimensions when building such an analysis. When a cross-subject area analysis is generated, separate queries areexecuted for each subject area in the analysis and the results are merged to generate the nal analysis. The datathat's returned from the dierent subject areas is merged using the common dimensions. When you use commondimensions, the result set returned by each subject area query is at the same dimensional grain, so it can be cleanlymerged and rendered in the analysis.



40

Common DimensionsHere are some examples of combining common dimensions. In this case, we combine the number of Opportunities,number of Opportunity Revenue Lines, number of Leads, and number of Interactions by Customer. The commondimension in all three subject areas used for this analysis is Customer and dierent fact metrics are pulled from eachsubject area.

The following subject areas are used for this example analysis:

• Subject area 1: "Marketing - CRM Leads"

• Subject area 2: "Sales - CRM Pipeline"

• Subject area 3: "Sales - CRM Sales Activity"

Customer is the common dimension used for this example analysis:

• "Marketing - CRM Leads"."Customer" -- Customer

• "Sales - CRM Pipeline"."Customer" -- Customer

• "Sales - CRM Sales Activity"."Customer" -- Customer

The following are the metric measures for this example analysis:

• Marketing - CRM Leads"."Lead Facts" -- "# of Leads"

• Sales - CRM Pipeline"."Pipeline Detail Facts" -- "# of Opportunity Revenue Lines"

• Sales - CRM Pipeline"."Pipeline Facts" -- "# of Opportunities"

• "Sales - CRM Sales Activity"."Interaction Facts" -- "# of Interactions"

Local and Common DimensionsThis example pulls Opportunity Line Revenue by Product and number of Interactions by Customer. Customer is acommon dimension in both subject areas used for this query. Product is a local dimension to the Sales - CRM Pipelinesubject area and Interaction is a local dimension to Sales - CRM Sales Activity. Dierent fact metrics are pulled fromeach subject area. Note that use of local dimension may impact the grain of the analysis. In such cases the metrics mayget repeated for each of these rows.

The following are the subject areas used for this example analysis:

• Subject area 1: "Sales - CRM Pipeline"

• Subject area 2: "Sales - CRM Sales Activity"

Sales is the common dimension for this example analysis:

• "Sales - CRM Sales Activity"."Customer" - Customer

The following are the local dimensions used for this example analysis:

• "Sales - CRM Pipeline"."Product" - Product

• "Sales - CRM Sales Activity"."Interaction" -- Interaction

The following are the metrics (measures) used for this analysis:

• "Sales - CRM Sales Activity"."Interaction Facts" -- # of Interactions

• "Sales - CRM Pipeline"."Pipeline Detail Facts" -- Opportunity Line Revenue



41

The following is the logical SQL used for this analysis;

SET VARIABLE ENABLE_DIMENSIONALITY=1; SELECT 0 s_0, "Sales - CRM Pipeline"."Customer"."Customer Name" s_1, 0 s_0, "Sales - CRM Pipeline"."Customer"."Customer Name" s_1, "Sales - CRM Sales Activity"."Interaction"."Interaction Type Name" s_3, "Sales - CRM Pipeline"."Pipeline Detail Facts"."Opportunity Line Revenue" s_4, "Sales - CRM Sales Activity"."Interaction Facts"."# of Interactions" s_5 FROM "Sales - RM Pipeline" ORDER BY 1, 6 DESC NULLS FIRST, 2 ASC NULLS LAST, 3 ASC NULLS LAST, 4 ASC NULLS LAST FETCH FIRST 65001 ROWS ONLY

Set Operations to Combine Result Sets from a Subject AreaThis example creates a compound analysis query that's a union of two result subsets from same subject area,combining results from:

• #Leads by Campaign from the Marketing - CRM Campaign Performance subject area (result 1)

• #Interactions by Interaction Type from the Marketing - CRM Interactions Real Time subject area (result 2)

SELECT saw_0, saw_1 FROM ((SELECT 'Campaign ~ ' || "Marketing Source"."Campaign Name" saw_0, "Response Facts"."# Responses" saw_1 FROM "Marketing - CRM Campaign Performance")UNION(SELECT 'Interaction ~ ' || "Interaction"."Interaction Type Code" saw_0, "Interactions Facts"."# of Interactions" saw_1 FROM "Marketing - CRM Interactions Real Time")) t1 ORDER BY saw

Logical SQL Using the Advanced TabIf your requirement can't be met by either of the two methods already discussed, then there's another advancedtechnique you can try. This technique lets you join multiple logical SQL statements based on common IDs or keys,which can be wrien against the same or dierent subject areas, just as used in normal SQL. Both Outer and Equijoinare supported. The following example demonstrates this technique.

Currently Oracle Transactional BI doesn't support Lead as a dimension for Revenue. However, this example illustrateshow you can combine pipeline and lead data in an analysis by combining the logical SQL found on the Advanced tab.

Step 1: Write a BI Answers query using the "Sales - CRM Opportunities and Products Real Time" subject area to showthe Revenue line amount and Opportunity. Once the correct results are achieved, go to the Advanced tab and grab thelogical SQL associated with this query.

Logical SQL for Query 1:

SELECT"Sales - CRM Opportunities and Products Real Time"."Contact"."Full Name" s_1, "Sales - CRM Opportunities and Products Real Time"."Opportunity"."Opportunity ID" OPTY_ID, "Sales - CRM Opportunities and Products Real Time"."Pipeline Detail Facts"."Opportunity LineRevenue" s_12 FROM "Sales - CRM Opportunities and Products Real Time"

Step 2: Write a second BI Answers query using the "Marketing - CRM Leads and Opportunities Real Time" subject areato show Leads associated with the Opportunity. Once the correct results are achieved, go to the Advanced tab and grabthe logical SQL associated with this query.

Logical SQL for Query 2:

SELECT"Marketing - CRM Leads and Opportunities Real Time"."Lead"."Lead Id" s_1,"Marketing - CRM Leads and Opportunities Real Time"."Lead"."Lead Name" s_2,"Marketing - CRM Leads and Opportunities Real Time"."Opportunity"."Opportunity ID" s_3,"Marketing - CRM Leads and Opportunities Real Time"."Opportunity"."Opportunity Name" s_4 FROM "Marketing - CRM Leads and Opportunities Real Time"



42

Step 3: Go to the Advanced tab in BI Answers and copy/paste the following logical SQL which is an OBIEE - Equijoin ofthe two previous SQL statements based on Opportunity ID. Use any text editor to combine the logical SQL statementscopied from Steps 1 and 2.

SELECTLead_Opty.s_1, Lead_Opty.s_2, Lead_Opty.s_3, Lead_Opty.s_4, Opty_Prod.s_1, Opty_Prod.s_2 FROM(SELECT"Marketing - CRM Leads and Opportunities Real Time"."Lead"."Lead Id" s_1, "Marketing - CRM Leads and Opportunities Real Time"."Lead"."Lead Name" s_2, "Marketing - CRM Leads and Opportunities Real Time"."Opportunity"."Opportunity ID" s_3, "Marketing - CRM Leads and Opportunities Real Time"."Opportunity"."Opportunity Name" s_4FROM "Marketing - CRM Leads and Opportunities Real Time") Lead_Opty, (SELECT"Sales - CRM Opportunities and Products Real Time"."Contact"."Full Name" s_1,"Sales - CRM Opportunities and Products Real Time"."Opportunity"."Opportunity ID" OPTY_ID,"Sales - CRM Opportunities and Products Real Time"."Pipeline Detail Facts"."Opportunity LineRevenue" s_2 FROM "Sales - CRM Opportunities and Products Real Time" ) Opty_Prod WHERE Lead_Opty.s_3 = Opty_Prod.OPTY_ID

Note: If you create a new analysis using this SQL, any hierarchical columns, member selection, groups orformaing is stripped out.

Custom and Standard Subject Areas JoinsAnalyses can be build using combinations of standard, as well as both custom and standard subject areas. The addsubject area option appears once you have created an analysis from a single subject area. You can delete subject areasusing these same steps. When you create your analysis, you select a single subject area during the creation steps. Oncethe analysis is created, you add additional standard or custom subject areas.

For example, if a custom object is used to record past sales value, a join analysis can be created to show the pipelinetogether with the sales history using a join between the standard subject area CRM Customer Overview, and a customsubject area that includes past sales from the custom object. Only certain objects can be used when you're combiningyour own custom subject area with a standard subject area.

The following objects support joining custom with standard subject areas:

• Customer

◦ Organization (Account)

◦ Sales Account

◦ Household (Group)

• Resource

◦ Resource

◦ Partner Resource

◦ Employee

◦ Sales Resource

• Contact (Person)



43

• Opportunity

• Partner

• Territory

Listing of Prebuilt Subject AreasThere are a variety of standard subject areas that you can use right out of the box to build your analytics. This listincludes subject areas for other applications as well. See the Related Topics for a link to the subject area listing.

Related Topics

• List of Standard Subject Areas

www.oracle.com/pls/topic/lookup?ctx=cloud&id=FAOEC



44


Chapter 5Create and Edit Analytics

45

5 Create and Edit Analytics

Data Structure for AnalyticsOracle Business Intelligence repository contains the metadata that denes which columns (or piece of data) areavailable for you to include in analyses, and where data for each column originates. The repository is organized intosubject areas, which contain folders with the columns.

Note: You can also use the Oracle BI repository as a data source for reports.

ColumnsThis table describes the three types of columns.

Column Type Description Example Icon for Column Type

Fact

Provides a measure ofsomething, meaning that thevalues are numbers.

Total

Yellow ruler

Aribute

Represents a piece ofinformation about a businessobject, with values that aredates, IDs, or text.

Start Date

Gray paper

Hierarchy

Holds data values that areorganized in a hierarchicalmanner.

Time, with sublevels:

• Year• Quarter• Month

Column: Hierarchy of bluesquares

Sublevel: Blue or white square

Subject AreasWhen you create an analysis, you rst select a subject area, which contains columns related to a specic business objector area. You then open folders within the subject area to nd the columns to include in your analysis.

FoldersEach subject area has one fact folder and a number of dimension folders. Folders can have subfolders.

• Fact folders:

◦ Contain fact columns.

◦ Are usually at the boom of the list of folders and are usually named after the subject area.



46

• Dimension folders:

◦ Contain aribute and hierarchical columns.

◦ Are joined to the fact folder within a subject area.

For example, if your analysis has the Currency aribute from a dimension folder, you see currencies inthe results. If you also add the Total fact, then your analysis includes only records with both a currencyand a total amount. The more columns you add, the smaller the query set for your analysis.

◦ Can be common folders or common dimensions that appear in more than one subject area.

Note: If your analysis has columns from multiple subject areas, then you:• Include columns only from dimension folders that are common to all of those subject

areas. At least one such column is mandatory.• Must include one column from the fact folder in each of those subject areas.

Analysis and Report LimitsLimits on analysis and reports prevent long-running queries.

Examples include:

• Analytics row limits

• Query time limits

• Report Memory Guard limits

Note that when you are reporting on HTML content, for example, Message Body of an SR Message is a report column,you can observe that HTML tags are displayed in the report, in addition to the desired content. In order to display thecontent correctly without the tags, set the Column Properties > Data Format to Treat Text as HTML for the column.Select Save as the system-wide default for that particular column (not the default for this data type). Once you do this,any time a report is created that contains this column, it will automatically display HTML content correctly

This table describes the limits that constrain queries.

Application Context Limit Description Limit Seing

Answers

Analysis

Query Time Limit -Minutes

Time (in minutes)allowed for a queryto return from thedatabase.

10

Answers

Analysis

Rows Retrieved By SQLQuery

Maximum rowsretrieved by a logicalSQL query.

75,000

Answers

Analysis

Rows Exported - CSV/Tab/XML - All Data -Export On Demand

Maximum data rowsexported from theanalysis into CSV, TabDelimited and XML

65,000



47


formats. This limit isenforced when the userexports directly fromthe analysis.

Answers

Analysis

Rows Exported - CSV/Tab/XML - All Data -Export Through Agent

Maximum data rowsexported from theanalysis into CSV,Tab Delimited andXML formats. Thislimit is enforced whenyou export using ascheduled agent.

25,000

Answers

Table

Maximum Rows UsedTo Populate Table

Maximum rows thatcan returned from ananalysis query whenpopulating the table.Anything higher thanthis results in failure torender the table.

75,000

Answers

Table

Rows Exported - Excel/PDF - Per View - ExportOn Demand

Maximum rowsexported from a viewto formats like PDF,Excel and Powerpoint.This limit is enforcedwhen the user exportsdirectly from theanalysis.

25,000

Answers

Table

Rows Exported - Excel/PDF - Per View - ExportThrough Agent

Maximum rowsexported from a viewto formats like PDF,Excel and Powerpoint.This limit is enforcedwhen you export usinga scheduled agent.

25,000

Answers

Table

Cells

Maximum number ofdata cells in a tableview.

1,000,000

Answers

Table

Sections

Maximum number ofsections available forthe view.

25

Answers

Table

Default Rows Per PageIn View

Default rows displayedper page in the view.This can be increasedin the view properties.

25



48


Answers

Table

Maximum Rows PerPage In View

Maximum rows thatcan be displayed perpage in the view.

500

Answers

Table

Prompt Values

Maximum number ofvalues allowed in TablePrompt. Exceedingthis value results in'Exceeded conguredmaximum number'error.

1,000

Answers

Pivot Table

Maximum Rows UsedTo Populate PivotTable

Maximum numberof rows that can bereturned from ananalysis query whenpopulating the pivottable. Anything higherthan this results infailure to render thepivot table.

40,000

Answers

Pivot Table



25,000

Answers

Pivot Table



25,000

Answers

Pivot Table

Cells

Maximum populatedcells of data in the view.

1,000,000

Answers

Pivot Table

Sections

Maximum sectionsavailable for the view.

25

Answers

Pivot Table



25



49


Answers

Pivot Table



500

Answers

Pivot Table

Prompt Values

Maximum numberof values that can bereturned in a Pivotprompt. Exceedingthis value results in'Exceeded conguredmaximum number'error.

1,000

Answers

Pivot Table

Columns In Export

Maximum exportablecolumns.

300

Answers

Chart

Sections


25

Answers

Chart

Slider Values

Maximum amount ofvalues available on theslider.

150

Answers

Chart

Rows Displayed

Maximum amount ofdata points available onthe chart.

2,000

Answers

Chart

Prompt Values

Maximum number ofvalues listed in the viewprompt. Exceedingthis value results in'Exceeded conguredmaximum number'error.

1,000

Answers

Simple Trellis

Maximum Rows UsedTo Populate SimpleTrellis

Maximum rows thatcan returned from ananalysis query whenpopulating the simpletrellis. Anything higherthan this results infailure to render thesimple trellis.

40,000

Answers

Simple Trellis

Cells


1,000

Answers

Simple Trellis

Sections


10



50


Answers

Simple Trellis



10

Answers

Simple Trellis



100

Answers

Simple Trellis

Column In Export


75

Answers

Simple Trellis

Prompt Values


1,000

Answers

Simple Trellis



6,500

Answers

Simple Trellis



100

Answers

Advanced Trellis

Maximum Rows UsedTo Populate AdvancedTrellis

Maximum rows thatcan returned froman analysis querywhen populatingthe advanced trellis.Anything higher thanthis results in failure torender the advancedtrellis.

40,000

Answers

Advanced Trellis

Cells


5,000

Answers

Advanced Trellis

Sections


25



51


Answers

Advanced Trellis



10

Answers

Advanced Trellis



100

Answers

Advanced Trellis

Columns In Export


150

Answers

Advanced Trellis

Prompt Values


1,000

Answers

Advanced Trellis



10,000

Answers

Advanced Trellis



100

Answers

Treemap

Prompt Values


1,000

Answers

Treemap

Cells

Maximum populatedcells/tiles of data in theview.

5,000



52


Answers

Treemap

Sections


50

Answers

Narrative

Rows

Maximum recordsavailable in the view.

40,000

Answers

Ticker

Rows

Maximum recordsavailable in the view.

40,000

Answers

Dashboard


For tables, pivot tablesand trellis views, if theview is set to "Fixedheaders with scrollingcontent", rows visibleon the dashboard areexported, and no more.For example, if a tableis showing ve rowsbefore scrolling, verows are exported,even if the table hasmore rows. If the view is set to"Fixed headers withscrolling content", anexport of the numberof rows specied inthe view's "Rows PerPage" parameter isaempted. This seingdoesn't override otherrow or cell limits,so seing this to avery high row limitonly guarantees thestandard view's exportlimits are honoredwhen exporting from adashboard. The "RowsPer Page" seing canbe higher than theactual limit of rows thatcan be viewed per pagein Answers. Even if thehigher row limit doesn'tapply at runtime, itapplies at export. Forexample, if the tablelimit is 500 rows perpage, but you set it to25,000, an aempt ismade to export 25,000rows.



53


Answers

Dashboard


The same rules applyas for Export onDemand, but theexports are subject tolimits enforced whenexporting data throughagents.

BI Publisher

Memory Guard

Maximum report datasize for online reports

Maximum data sizeallowed for onlinereport viewing. Whena report data sizeexceeds the value,the report receives an'XML Output generatedexceeds specied lesize limit' error.

300MB

BI Publisher

Memory Guard

Maximum reportdata size for oine(scheduled) reports

Maximum data sizeallowed for scheduledreports. When a reportdata size exceedsthe value, the reportreceives an XMLOutput generatedexceeds specied lesize limit error.

500MB

BI Publisher

Memory Guard

Free memory threshold

Minimum value forfree JVM space. Ifthe report data sizeexceeds the threshold,then the report ispaused to wait forfree memory tobecome available. Thereport waits for thetime specied in theproperty MaximumWait Time for FreeMemory to ComeBack Above ThresholdValue. If the freememory does notrise back above theminimum in the waitperiod specied,the report request isrejected.

500MB

BI Publisher

Memory Guard

Maximum report datasize under the freememory threshold

Maximum single reportdata size allowed whenfree JVM memory isunder the speciedthreshold value setin Free memorythreshold. For example,

Free memorythreshold/10



54


assuming the defaultseing of 500MB, if thedata generated for asingle report exceedsone-tenth of the valueset for Free memorythreshold, or 50MB,then processing isterminated.

BI Publisher

Memory Guard

Maximum Wait Timefor Free Memory toCome Back Above theThreshold

Maximum time inseconds that a requestto run a report waits forfree JVM memory toexceed the thresholdvalue. If the freememory becomesavailable within thetime specied, therequest proceedsimmediately. If freememory is still belowthe threshold valueafter the time specied,the request is rejected.For online requests,the larger this propertyvalue, the longer thebrowser will wait for arequest to run.

30

BI Publisher

Memory Guard

Process timeoutfor online reportformaing

For online reports,the maximum timein seconds that aformaing processis allowed to run.If an online reportformaing processexceeds the limit, thereport errors.

600

BI Publisher

Data Model

Maximum datasize limit for datageneration

Maximum XML datasize that can begenerated from theexecution of a datamodel. This seingapplies to both onlineand scheduled reportrequests. When the sizeof the le generatedexceeds the value,execution of the datamodel is terminatedand an exception isgenerated.

500MB



55


BI Publisher

Data Model

Maximum sample datasize limit

Maximum le size ofa sample data le thatcan be uploaded to thedata model editor.

1MB

BI Publisher

Data Model

DB fetch size

20

BI Publisher

Data Model

SQL Query Timeout (inseconds)

600

Engagement Repository and Session Variables forBusiness IntelligenceThe tables below show repository and session variables available for use in your analyses.

These variables are available for all oerings.

Variable Name Type Usage Oering

CURRENT_DAY

Session Variable

Returns the value of CurrentDate.

All

CURRENT_MONTH

Repository Variable

Returns the value of CurrentMonth in the YYYY/ MMformat

All

CURRENT_WEEK

Repository Variable

Returns the value of thecurrent week in YYYYWeeknnn format.

All

CURRENT_ QUARTER

Repository Variable

Returns the value of CurrentQuarter in YYYY Q n format.

All

CURRENT_YEAR

Repository Variable

Returns the value of CurrentYear in the YYYY format.

All

NEXT_MONTH

Repository Variable

Returns the value of NextMonth in the YYYY / MMformat.

All



56


NEXT_WEEK

Repository Variable

Returns the value of NextWeek in the YYYY Week nnformat.

All

NEXT_QUARTER

Repository Variable

Returns the value of NextCalendar Quarter in the YYYYQ nn format.

All

NEXT_YEAR

Repository Variable

Returns the value of Next Yearin the YYYY format.

All

PREVIOUS_MONTH

Repository Variable

Returns the value of PreviousMonth in the YYYY/ MMformat

All

PREVIOUS_WEEK

Repository Variable

Returns the value of PreviousWeek in the YYYY Week nnformat.

All

PREVIOUS_ QUARTER

Repository Variable

Returns the value of PreviousQuarter in the YYYY Q nnformat.

All

These variables are available for Engagement.


USER_ MAX_ TERR_HIER_LEVEL

Session Variable

Returns the maximum xedhierarchy level from TerritoryHierarchy for the logged-inuser. This variable can be usedto dynamically retrieve themaximum territory level thatthe logged-in user owns.

Customer Experience

USER_ ORG_ HIER_LEVEL

Session Variable

Holds the hierarchy levelwithin the organizationselected by the user in areport.

Customer Experience

USER_PARTY_ID

Session Variable

Stores the PARTY_ID fromUserPVO.

Customer Experience

CURRENT_ ENTERPRISE_PERIOD

Repository Variable

Returns the value of theCurrent Fiscal Period.

Customer Experience



57


CURRENT_ ENTERPRISE_PERIOD_ END_DATE

Session Variable

Returns the End date ofCurrent Enterprise Period.

Customer Experience

CURRENT_ ENTERPRISE_QUARTER

Repository Variable

Returns the value of CurrentEnterprise Quarter in theYYYY Q n format.

Customer Experience

CURRENT_ ENTERPRISE_QUARTER_ END_DATE

Session Variable

Returns the End date ofCurrent Enterprise Quarter.

Customer Experience

CURRENT_ ENTERPRISE_YEAR

Repository Variable

Returns the value of CurrentEnterprise Week in the YYYYWeeknn format.

Customer Experience

NEXT_ ENTERPRISE_ PERIOD

Repository Variable

Returns the value of NextEnterprise Period.

Customer Experience

NEXT_ ENTERPRISE_QUARTER

Repository Variable

Returns the value of NextEnterprise Quarter in theYYYY Q n.

Customer Experience

NEXT_ ENTERPRISE_ YEAR

Repository Variable

Returns the value of NextEnterprise Year in the FYYYYYformat.

Customer Experience

PREVIOUS_ ENTERPRISE_PERIOD

Repository Variable

Returns the value of PreviousEnterprise Period.

Customer Experience

PREVIOUS_ ENTERPRISE_QUARTER

Repository Variable

Returns the value of PreviousEnterprise Quarter in theYYYY Q n format.

Customer Experience

PREVIOUS_ ENTERPRISE_YEAR

Repository Variable

Returns the value of PreviousEnterprise Year in the FYYYYYformat.

Customer Experience

SVC_ SR_ ASSIGN_ INIT_DT

Session Variable

Returns a date when thePOD was upgraded to latestversion.

Customer Experience

Deep Linking



58

Register Business Intelligence to Support Deep LinkingDeep linking lets you to navigate from an analysis on the interface pages to specic aributes and objects in your workareas so that you can work with them directly. What does that mean? It means that if you are looking at an analysison leads, for example, you can click a record on the analytic and go edit the lead record on the edit object page. Tosupport deep links, use the Setup and Maintenance work area to register the Business Intelligence Server as a third-party application.

Register Business Intelligence Server as a Third-Party ApplicationTo register the BI Server:

1. Use the Manage Third Party Applications task.2. Click Create.3. Enter AnalyticsApp as the application name.4. Enter the full URL for the BI Server (for example: http://host:port/analytics/saw.dll).5. Enter Analytics Server as the Partner Name.6. Click Save and Close.

Related Topics

• Register a Third-Party Application

Create Deep LinksCreate deep links in your analytics that let you navigate from an analytic to specic aributes and objects in yourtransactional pages to work with them directly.

1. In the Reports and Analytics work area, click Browse Catalog.2. Create or edit an analysis. Use a subject area that includes the aribute you want to link to in the transactional

pages, and ensure that you include the object ID.3. On the Criteria tab, click the Options icon for the aribute column on which you need a deep link and select

Column Properties.4. Open the Interaction tab in the Column Properties dialog box.5. In the Primary Interaction list in the Value section, select Action Links to display the Action Links table.6. Select the Do not display in a pop-up if only one action link is available at runtime option.7. Click Add Action Link.8. In the New Action Link dialog box, enter the link text for the navigation.9. Click the Create New Action icon and select Navigate to a Web Page.

10. In the Create New Action dialog box, enter the URL to navigate to, which references parameters you denein the prompt. For shared analyses://<hostname>/fscmUI/faces/deeplink?objType=@{1}&objKey=<objectID>=@{2}&action=@{3}&returnApp=AnalyticsApp&returnAppParams=PortalGo%26path=</shared/Custom/<folder>/@{6}

For personal analyses stored in My Folders: //<hostname>/fscmUI/faces/deeplink?objType=@{1}&objKey=<objectID>=@{2}&action=@{3}&returnApp=AnalyticsApp&returnAppParams=PortalGo%26pather=/users/@{5}/@{6}

11. Click Dene Parameters to add corresponding parameters for the URL.12. In the Dene Parameters section, click Add Parameter to add the following mandatory parameters:




59

Name Prompt Type of Value Value Fixed Hidden Notes

1

Object Type

Value

<Object Type>

Selected

Selected

Used forshared andpersonalanalyses.

2

<PromptName>

Column Value

Column Namein "<table.name>"."<column.name>"format

Selected

Selected


3

Action

Value

edit

Selected

Selected


4

returnApp

Value

AnalyticsApp

Selected

Selected


5

Logged in User

SessionVariable

USER

Selected

Selected

Sessionvariableparameterused forpersonalanalysispermissions.

6

Report Name

Value

Analysis Name

Selected

Selected

Used forshared andpersonalanalyses. Thename of theanalysis toreturn to afterworking in thetransactionalpage.

13. Click Options to set how the page opens.14. In the Action Options dialog box, select Open in New Window to open the page in a new window.15. Save your work.16. If you have provided the Return Application name, a Return icon is available in the transactional page to return

to the analysis.



60

Edit Prebuilt AnalyticsOut of the box you have plenty of analytics to start o with. But you will probably want to modify many of them andmake them your own.

1. Make a copy of the analytic you want to edit.2. Name the copy.3. Find the new analytic and click Edit.4. Select a dimension and the contents appear in the pane.5. From the tabs select Criteria.6. Drag and drop columns from the Subject Area pane to the editing palee.

Right-click the gear icon and get options for editing that column such as ltering and deleting that column from theanalysis.

Report on System User ActivityInterested in user activity on your application? With a few setup steps you can get critical information on how users areworking in your application. We call it user adoption. User adoption gives you analytic data to evaluate user activity interms of logging in and out of the application, as well as what they are doing when they are logged in.

Here are some of the business benets of user adoption analytics:

• See the relationship between being signed into the application an interaction with objects.

• Leverage usage paerns and behaviors from successful users as best practice guidelines for other users.

• Gain insight on usage and trends for potential future investment opportunities.

• Identify improvements that can increase adoption and usage.

These are the main steps for seing it up:

• Enable system tracking in Setup and Maintenance

• Get the role of FBI_USER_SYSTEM_USAGE_TRANSACTION_ANALYSIS_DUTY

New Subject Areas for User AdoptionThere are three new subject areas to use when you build tracking analytics. You can build analytics with any or all ofthese subject areas, depending on what data you want to see. For example, you can compare user log in against userinteraction with objects, or you can track user adoption and object activity across teams within the organization.

• User System Usage: This subject area provides the key user adoption metric at the application user level.

• Sales - CRM Resource: This subject area provides the mapping between the user and the specic resourceobject.

• Sales - CRM Object Activity: This subject area supports reporting on object activity metrics such as number ofrecords created and number of records updated.



61

About Resource and Usage Subject AreasResource and Usage subject areas make it possible for you to analyze many dierent aspects of user adoption such as:

• Adoption and usage from dierent channels over a period of time.

• User Log in by channels, such as web, mobile, mail.

Here are some of the details on usage tracking values:

• The primary metric used in user adoption subject areas is # of Active Days. This metric provides informationabout an activity such as how long a signed in user has stayed on the device.

• The # of Active Days value is not a sign-in count.

• The day value is based on the server time zone.

• The retention period for information is set at 12 months.

• Sessions can be tracked for usage channels for web and mobile.

• Tracking dierentiates between user activities made directly by the user, or through a proxy user.

• Two additional Metrics are used in these subject areas, they are # of Active Users/Resource and # of Users/Resource.

About the Object Activity Subject AreaThe primary metrics used for object activity subject area is Insert Action Count and Update Action Count. Thesemetrics provide information on the number of records added, and the number of records updated.

Here is the information you can analyze using the object activity subject area:

• Track the type of object that was updated.

• Name of the employee who did the update.

• Manager of the employee that did the update.

• Number of records that were added.

• Number of records that were updated.

• Date the record update was made.

• Month the update report is produced.

Remember These Usage Reporting MustsSeing up the time parameters for user adoption reporting can be tricky. For best results follow these guidelines:

• To be sure the analytics you created in R12 work after you upgrade to 18A+, you should apply the # of ActiveDays > 0 lter.

• Add a lter for a specic year. The User System Usage subject area shows usage for all Time Periods andUsers/Resources. This reporting method tracks when the user is actively using the application and the monthswhere there were no activities/system usage. For this reason you should dene specic time lters. Withouttime lters, the report shows results for the complete 100 years Time dimension.

• Avoid reporting by date. Instead use Month or Quarter.

• Filter by group of users, instead of individual users.

• Apply a lter on the # of Active Days fact > than 0 to ensure the analytic shows positive reporting values.



62

Enable User Adoption TrackingUser adoption should be set up on your application before you do anything else.

1. Go to Setup and Maintenance.2. Search for Manage Administrator Prole Values.3. Search for prole option code FND_TRACK_USER_ACTIVITY and ensure that it is enabled.

This gure shows the prole value as "ENABLED" for FND_TRACK_USER_ACTIVITY prole.

ENABLED

Get the User System Usage Duty RoleThe User System Usage subject area holds all the activity information for users of the application. This subject area issecured and can be accessed by users who have the role FBI_USER_SYSTEM_USAGE_TRANSACTION_ANALYSIS_DUTYor by users who have the BI Administrator role.

1. Sign in as a Security Manager. For example, IT_SECURITY_MANAGER.2. Click Tools > Security Console.3. Select the Roles tab, if the tab is not already selected by default.4. Click Create Role.5. Fill in the required information.6. Click Next until you come to the Role Hierarchy page.7. Click the role name and then click Add Role Membership.8. Search for the BI Duty Role by name or code: FBI_USER_SYSTEM_USAGE_TRANSACTION_ANALYSIS_DUTY .



63

This is the Add Role Membership page with the new duty role content.

FBI_USER_SYSTEM_USAGE_TRANSACTION_ANALYSIS_DUTY

User System Usage Transaction Analysis Duty

9. From the search result select BI Administrator Role and click Add Role Membership.10. Click Next until you get to the Users page.11. Click Add User and search for the users to assign this role. Click Add user to Role.12. Click Next.13. Click Next to go to the Summary and Impact Report. Click Save and Close.

Add Additional Users for System UsageOnce the new role is created, you can add more users to a role if need be.

1. Sign in as a Security Manager. For example, IT_SECURITY_MANAGER.2. Click Tools > Security Console3. Select the Users tab.4. Search for the user to be assigned the role.5. Select the user and choose Edit.6. Click Add Role.7. Search for role you want to assign, in this case the BI System Usage SA Custom Role.8. Select the Role and click Add Role Membership.



64

This shows the search roles, and the Add Role Membership.

BI System Usage SA Custom

BI_SYSTEM_USAGE_SA_CUSTOM

Add Role Membership

9. Click Done.10. Click Save and Close.

Create and Edit Analyses Using a WizardUse the wizards to quickly create and edit your analytics.. Even though the wizard doesn't give you all available features,you can still use it to make typical changes, for example adding views or lters. For other tasks, such as creatingdashboards or deleting analyses, use the advanced business intelligence features.

Create an Analysis1. Open the Reports and Analytics work area, or the Reports and Analytics panel tab if available in other work

areas.2. Click Create and select Analysis.3. Select the subject area that has the columns you want for your analysis.4. Optionally, add more subject areas or remove any that you no longer need.5. Select the columns to include, set options for each column, and click Next.6. Optionally, enter a title to display for the analysis.7. Select the type of table or graph to include, specify the layout of the views, and click Next.

Note: At any point after this step, you can click Finish to go to the last step, to save youranalysis.

8. Optionally, set more options for the table or graph, and click Next.



65

9. Optionally, add sorts or lters based on any of the columns you included, and click Next.10. If you have a table, optionally dene conditional formaing for select columns, for example to display amounts

over a certain threshold in red. Click Next.11. Enter the name of your analysis and select a folder to save it in.12. Click Submit.

Edit an Analysis1. Open the Reports and Analytics work area, or the Reports and Analytics panel tab if available in other work

areas where you can nd the analysis.2. Select your analysis and edit it. In the Reports and Analytics work area, click More for the analysis and select

Edit. In the Reports and Analytics panel tab, click the analysis, then click Edit.3. Perform steps 4 through 10 from the preceding Creating an Analysis task, as needed.4. To update an existing analysis, select the same name in the same folder. To save this analysis as a new copy,

either name it with a new name or save it in a new folder.5. Click Submit.

Related Topics• Reports and Analytics Work Area and Panel Tab• Where to Save Analytics and Reports• How Data Is Structured for Analytics

Manage Analytics with Advanced FeaturesEven though you can use a wizard to create or edit analyses, you might have to use advanced features for complicatedanalyses or specic requirements. For example, you can create view selectors so that users can toggle between viewswithin an analysis, or dene criteria for lters using SQL statements.

You can also perform other actions on analyses, for example delete them or copy and paste them within the businessintelligence catalog.

How to Create and Edit Analytics1. Open the Reports and Analytics work area, or the Reports and Analytics panel tab if available in other work

areas.2. Click the Browse Catalog buon.3. Click the New buon, select Analysis in Analysis and Interactive Reporting, and select a subject area.

Or, select your analysis in the Folders pane and click Edit.4. Use the tabs as described in this table.

Tab Task

Criteria

Select and dene the columns to include. Add lters.

Results Add views and set options for results.

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=9A62A917307E0F67E040D30A68812E70

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=F7412AFA96122633E043B69BF40A6296



66

Tab Task

Prompts

Dene prompts to lter all views in the analysis.

Advanced

View or update the XML code and logical SQL statement that the analysis generates. Set options related to query performance.

5. Save your analysis.

More Actions on Analytics1. Open the Reports and Analytics work area, or the Reports and Analytics panel tab if available in other work

areas where you can nd the analysis.2. Select your analysis and click Action and select More.3. Click More for your analysis and select the wanted action, for example Delete or Copy.

Related Topics• Reports and Analytics Work Area and Panel Tab• How Data Is Structured for Analytics• Where to Save Analytics and Reports

Create a Simple Activity AnalysisAn activity analysis can help you make sure your resources are being used to your greatest advantage.

Analytics to Answer Business QuestionsTo build custom analytics you start by dening your objectives. What problem do you want to solve? What opportunitiesmight you be missing? What insights have potential to drive your sales forward? Here are a few examples:

• Is there any workload balancing issues in my team?

• Which team members are available to focus on a new product?

• What are my urgent overdue tasks, and what's my workload for this week?

• How is my team performing?

• Which accounts are my sales representative focusing on and does this align with business priorities?

• Which accounts can I focus on more to meet our business objectives?

Create Your Own Activity AnalysisYou Sales Manager wants to see how much their team is interacting with potential opportunities. How many times hasa potential customer been contacted? And how have they been contacted? Let's try creating an activity analysis to helpour Sales Manager gure things out.

1. In BI, Click New analysis.


http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=F7412AFA96122633E043B69BF40A6296



67

2. Select CRM - CRM Activity Real Time.

◦ From the dimension Customer, add Account Name.

◦ From the dimension Employee, add Last Name.

◦ From the Facts folder, add # of Activities.

3. You can lter Customer to see a specic account, select the properties on Account Name.4. You select the lter to show only A.C. Networks, for example, and click OK.5. Click Results. The Results tab shows your analysis at this point. Move back and forth from Criteria to Results at

any time to see your analysis.6. Name and save your analysis.

Now you can check out everything that has been going on with with A.C. Networks. Is it time to reach out to them againand tell them about some new stu you're oering?

Create an Opportunity AnalysisYou can keep an eye on your revenue pipeline using Opportunity analytics. Opportunities can be looked at overdierent time periods, or the current time period. You can examine each stage of an opportunity and the associatedrevenue for that stage.

How to Create an Opportunity Analysis

The simple analysis you build in this example shows Total Revenue, Open Pipeline, and Won Revenue for salesrepresentatives for the current quarter. Keep in mind you can add any columns you want from the CRM Pipeline subjectarea. You can even add columns from other subject areas. But for this exercise, let's keep it simple.



68

This is an opportunity analysis. Let's create one now.

To Create an Opportunity analysis:

1. Navigate to BI.2. Select the New drop-down list.3. Select Analysis.4. Go to the editing palee and on the Subject Area panel expand the Sales - CRM Pipeline subject area.

This subject area Sales - CRM Pipeline includes the following columns and facts to use for this example.

Columns and Facts Denition

Sales Stage

Contains data on the stage the opportunity on in the pipeline.

Amount

Contains the amount of the opportunity revenue at a stage in the pipeline.

Open Pipeline

Contains the amount of the revenue not closed in the pipeline.

Won Revenue

Contains the amount of revenue closed in this quarter.

Total Revenue

Contains the amount of all opportunity revenue in the pipeline for this quarter.

Enterprise Quarter Contains real time opportunity custom data



69

Columns and Facts Denition

Pipeline Facts: Number ofOpportunities

Contains real time revenue data

5. In the Subject Areas Panel, in the Sales - CRM Opportunities subject area, expand Historical Sales Stage. Addthe columns: Sales Stage, Sales Stage Name, and Sales Stage Row ID.

6. Expand Pipeline Detail Facts: Add Amount, Open Pipeline, , Won Revenue, % of Total Amount.7. Expand Pipeline Facts:# of Opportunities.8. Expand Employee. Add Employee Row ID.9. Expand Time. Add Enterprise Quarter.

10. Expand Employee. Add Employee Login. On the editing palee, on Employee Login, hover over the gear imageand from the drop-down list menu and select Filter. Under Add More Options select Session Variable. In theSession Variable add: USER_PARTY_ID. Select OK. From the drop-down list again, select Delete. You only addedthe column to add the variable. Adding this variable tells the application to show data for the signed in userspecic to her opportunities only.

11. That's it. Now let's see what it looks like. Select the Results tab and there it is. Don't forget to name and saveyour analytics.

Create and Filter an Historical Trending AnalysisLooking at a broad view of your pipeline helps you get a sense of what things might look like in the future. How doesthe revenue in your pipeline look this quarter, compared to previous quarters? Maybe there are potential problemsdown the road you need get a jump on now. Let's build a historical trending analysis and see how things are shaping up.

How to Create an Historical Trending AnalysisHistorical Trending analytics use the subject area Sales - CRM Opportunity Sales Stage Snapshot. This subject area isspecically designed for reporting on opportunities and revenues against their daily, weekly or monthly (depending onthe enterprise calendar period setup), quarterly and yearly trends or to compare opportunity and revenue data againstspecic points in time.

To Create an Historical Trending Analysis:

1. Navigate to BI.2. Choose New.3. Select Analysis.4. Select the Sales - CRM Historical Pipeline subject area. You may need to scroll down.5. In the regional area, expand Opportunity.6. Double-click Opportunity Name to add it to the Selected Columns section. You may need to scroll down to

locate Opportunity Name.7. Add Owner First Name.



70

8. Add Owner Last Name.9. Expand Customer and add Customer Name.

10. Collapse Customer and expand Industry.11. Add Industry Name and collapse Industry.12. Expand Product and add Product Name.13. Collapse Product and expand Revenue.14. Add Revenue ID and collapse Revenue.15. Expand Pipeline Snapshot Date.

Notice that you can choose a pipeline date, period (week or month), quarter, or year.16. Add Pipeline Snapshot Date and collapse Pipeline Snapshot Date.17. Expand Historical Pipeline Detail Facts.

Notice that you can add facts on revenue lines, open or closed opportunities, or both.18. Add Opportunity Line Revenue.19. Verify your columns.

After you create a historical trending report, you should create lters for your report. The next section showsyou how.

Filtering Historical AnalyticsYou can lter your analytics to show open or closed opportunites, and more.

1. Click Create a lter for the current Subject Area, in the local area, under Filters.2. In the drop-down list, click More Columns.3. In the dialog box, expand Opportunity.4. Select Opportunity Status Category.5. Click OK.6. Verify that Operator = is equal to / is in.7. Select Value = OPEN.8. Click OK to close the New Filter dialog box.

After creating your lters for your historical trending report, name and save your analysis.

Create and Edit DashboardsDashboards give you a palee to add one or more objects for display. You can create and edit dashboards and denetheir content and layout. In addition to objects in the business intelligence (BI) catalog, such as analyses, reports, andprompts, you can add text, sections, and more to a dashboard.

Create a Dashboard1. Open the Reports and Analytics work area, or the Reports and Analytics panel tab if available in other work

areas.2. Click Browse Catalog.3. Click New and select Dashboard under Analysis and Interactive Reporting.4. Enter the dashboard's name and description, and select a folder to save in.



71

5. With the Add content now option selected, click OK.6. Optionally, add more pages, or tabs, within the dashboard.7. Drag and drop items from the Dashboard Objects or Catalog pane to add content to a page.8. Click Save.

Note: The rst dashboard page is saved with the page 1 name by default. To rename this page:1. Click the Catalog link.2. In the Folders pane, select your dashboard.3. For page 1, click More and select Rename.4. Enter the new name and click OK.

Edit a Dashboard1. Open the Reports and Analytics work area, or the Reports and Analytics panel tab if available in other work

areas where you can nd the dashboard.2. Select your dashboard in the pane and click More.3. Click Edit.4. Perform steps 5 and 6 from the preceding Creating Dashboards task, and make other changes as needed, for

example:

◦ Remove content from the dashboard.

◦ Drag and drop within a page to move content around.

◦ Change the layout of a page.

Related Topics• Where to Save Analytics and Reports• Reports and Analytics Work Area and Panel Tab

Best Practices for Working with AnalyticsFor best results when creating and editing analytics, Oracle recommends you refer to the "BI Reports and Dashboard- Best Practices" document located on the Oracle Support site at: hps://support.oracle.com/epmos/faces/DocumentDisplay?id=2331484.1. You can also click the link in Related Topics to download the PDF document directly.

Related Topics• BI Reports and Dashboards - Best Practices Document

FAQs for Analytics and Dashboards

What are subject areas, dimensions, aributes, facts, and metrics?Information for your analytics is grouped into related functional areas called subject areas, which contain fact anddimension folders with columns and metrics used for analytics.


https://support.oracle.com/epmos/main/downloadattachmentprocessor?parent=DOCUMENT&sourceId=2331484.1&attachid=2331484.1:A1&clickstream=yes



72

Dimension folders include the grouping of dimensional aributes for the subject area. Columns (such as date of birthor name) which are grouped for a dimension are known as aributes. Fact folders contain formulas for geing numericvalues, such as counts and percentages.

What's the relationship between dimensions and fact in a subjectarea?A subject area is based around a single fact. The dimensions are all related to each other through the fact only. The factis automatically included in any query that is created, even if none of the measures in the fact appear in the analysis.

What's a common dimension?A common dimension is shared across multiple subject areas. For example, Time, Department, and Location arecommon dimensions. When constructing a cross-subject area analysis, only common dimensions can be used.

How can I determine which dimensions are shared across twosubject areas?If the dimensions exist in both subject areas, they are common dimensions, and are often among the rst folders in asubject area. You can join any subject areas you have access to in Answers, but analyses are subject to the normalizeddata structure. Unless the underlying tables are joined by design, joining subject areas in Answers results in errors.

What's a dashboard?A dashboard is a container page to display analyses, reports, and other objects. Administrators can create shareddashboards for groups of users with common responsibilities or job functions. Personalized views can be created basedon a user's permissions.


Chapter 6Analytics on Interfaces

73

6 Analytics on Interfaces

Analytic InterfacesThese are all the areas on the Engagement interface where your users can view analytics. Some of these pages comeprebuilt and can be personalized by your users, and some you need to set up.

Type Description Visibility

Sales Pages

Includes ve blank pages thatadministrators congure and add prebuiltor custom analytics for any EngagementCloud area.

Not visible until administrators enable theSales Pages in Set System Options.

Sales Infolet Page

Comes prebuilt with role-based analyticsand infolets. One page for each role.

Not visible until administrators enable theSales Infolets in Set System Options.

Object Pages Analytics can be added to the following

object page work areas:

For Sales:

• Leads• Opportunities• Forecasts• Accounts• Households• Contacts• Activities

For Service:• Service Requests• Work Orders• Queues

Analytics can be added to the objectlanding page or object edit page, suchas the Opportunities page, or the EditOpportunities page.

Analytics Page

This page is where users can add analysesthemselves by searching for the analysisand making it a favorite.

Administrators make custom analyticsavailable for users on the Analyticspage by adding session variables on theanalysis. These variables can show dataspecic to the user that is signed in andviewing her Analytics page.

Sandboxes



74

Overview of SandboxesYou use sandboxes to make application changes and test them without impacting other users in the environment.Wherever possible, make changes to the application in a sandbox rather than making direct changes in the mainlineenvironment. Sandboxes set apart untested conguration changes from the mainline environment. So you can test yourchanges in the sandbox and then publish it. After publishing, your changes become available in the mainline metadataor other sandboxes after they're refreshed. So everyone can then see your changes in the environment. Mainlinemetadata is the primary branch of metadata a sandbox is published to.

Why You Need SandboxesToday's business landscape is quite dynamic. Companies are expected to respond quickly to address both customerand market needs. So multiple teams need to make application changes at the same time while sharing the same datamodel and conguration starting point. But you may get conicts between teams working that way. To avoid suchconicts, sandboxes come in handy.

Unied SandboxesYou can either use the Unied Sandboxes UI, which is the default feature you get, or opt out of it using the Oeringswork area to get the Classic Sandboxes feature.

With Unied Sandboxes, you can refresh your sandboxes to bring in the latest changes from the mainline metadatato your sandboxes, and do many other new and versatile sandbox activities. You get a consistent sandbox experienceacross all conguration tools and a more robust user interface with this feature.

With Unied Sandboxes, you can do these additional sandbox activities:

• Select the conguration tools to enable for your sandboxes while creating them.

• Enable all conguration tools in the same way using the Sandboxes UI. So you get a consistent sandboxexperience across tools.

• Restrict access to various sandbox activities for users. For example, you can specify these access rights for yoursandboxes:

◦ Full access

◦ Edit and preview access

◦ View only access

• View just your application changes without having other context layers hide your content.

• Test your changes in a preview mode that shows you exactly how your application changes would appear in apublished sandbox.

• Refresh and merge sandboxes with latest changes in mainline metadata from other published sandboxes. Aftermerging all changes, you can publish your sandbox.

• After opting in to the Unied Sandboxes feature, if you register your target environment in your sourceenvironment, you can do these additional migration tasks using the Migration UI:

◦ Migrate your changes from the test environment to the target environment without manuallydownloading and uploading the conguration set le.

◦ Move only new changes from the source environment to the target environment.



75

Sandbox UsageYou typically use sandboxes for either of these purposes:

• Test-Only: You can make application changes using test-only sandboxes, which you don't want to publish tothe mainline code.

• Publish: Once satised with the application changes made in the test-only sandbox, you can replicate thesechanges in a sandbox that you want to publish. And then publish your changes to the mainline code. Thissandbox type is also known as the integration sandbox, because teams working in parallel use this sandbox asthe nal staging point before publication to the mainline code.

Note: Before each patch or upgrade, publish or delete your sandboxes. If you haven't yet completed yourwork, restart with a new sandbox.

Related Topics

• Create and Activate Classic Sandboxes

• Migrate Congurations Using Unied Migration

Enable or Disable the Unied Sandboxes FeatureYou get to use Unied Sandboxes by default. But if you want to use Classic Sandboxes instead of the default sandboxes,opt out of the Unied Sandboxes feature.

Before you start, consider these points:

• Make sure you totally understand what it means to opt in to or opt out of the feature and what impact thatwould have.

◦ When you use Application Composer in your Unied Sandbox, an object can only be edited in any onesandbox in the environment at a time.

◦ You can't deploy your exelds to a sandbox after you opt in to Unied Sandboxes. You must deploythem directly to the mainline environment.

• You must publish or delete any sandboxes that are open right now. Use the Manage Sandboxes dialog boxto do these tasks. You can open this dialog box by clicking your user image or name in the global header andselecting Manage Sandboxes under Administration. Once you opt in to Unied Sandboxes, you can no longersee the published Classic Sandboxes.

In the Oerings work area, enable or disable the Unied Sandboxes feature:

• Oering: Any with the Application Extensions functional area

• Functional Area: Application Extensions

• Feature: Unied Sandboxes

• Opt In Task: Click Continue if you're sure about enabling or disabling this feature.

Related Topics

• Congure Oerings

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=E98E66180D77C086E040D30A68817ED3

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=8B3145B5B38948CCE053A398F70AA08D




76

Create and Activate Unied SandboxesTo make changes to the application, you must rst store the changes in an active sandbox. You can either create asandbox or select an existing one, and make it active. You must activate the conguration tools you want to use in yoursandbox. If you plan to use Page Composer in your sandbox and need to edit pages at any layer, not just Site, create aseparate sandbox just for using this tool.

Note: You can create up to 20 sandboxes. But, you can increase this limit using the Maximum Number ofSandboxes prole option. In the Setup and Maintenance work area, use the Manage Applications CoreAdministrator Prole Values task in the Application Extensions functional area.

Create and Activate SandboxesFollow these steps to create and activate sandboxes for most conguration tools. For exelds, use the ManageDescriptive Flexelds task or the Manage Extensible Flexelds task instead.

1. Click Navigator > Conguration > Sandboxes.2. On the Sandboxes page, click Create Sandbox.3. Enter a name and description for your sandbox.4. In the All Tools section, select the tools you want to activate for this sandbox. The context layers for all selected

tools are set as Site by default. So the changes you make using these tools aect all users.5. If you select Page Composer, you can click the Edit Sandbox Context icon and change the context layer

from Site to another layer, for example External. You can nd the Edit Sandbox Context icon in the SupportContext column.

Note: If you want to use other tools along with Page Composer in your sandbox, don't changethe context layer for Page Composer, even though you can. That's because all tools except PageComposer support only a single context layer, Site. If you change the context layer for PageComposer from Site to any other layer, you can't activate those tools in the same sandbox.

6. Click Create to just create the sandbox, or Create and Enter to enter or activate the sandbox after creating it.

Here are a few things to know about activating tools in your sandbox.

• If you try to use a conguration tool in a sandbox without activating the tool in it, you get a message promptingyou to activate the tool. You can add more tools to your sandbox later also.

• To create and manage saved searches and make UI adjustments (for example, change a table's column width)just for yourself, you must leave your sandbox before making these changes. But if you want to make thesechanges for others too, then make the changes with Page Composer open, in which case you also must be in asandbox.

Activate Existing SandboxesYou can activate only one sandbox at a time.

1. Click Navigator > Conguration > Sandboxes.2. From the list of sandboxes, if available, nd the one you want to activate, and click the Enter Sandbox icon for

that sandbox. Your sandbox is activated, and you can see its name on the sandbox bar above the global header.You can use the options available on the sandbox bar to quickly do some activities, such as view sandboxdetails, publish the sandbox, or leave the sandbox.

Related Topics• Why can't I create more sandboxes

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=8AAE9E0ED1B00557E053A398F70AE041



77

• Set Prole Option Values

• Why doesn't the page I am editing with Page Composer work with the sandbox context

• Considerations for Managing Flexelds

Publish Unied SandboxesAfter you're done making changes to the application, publish the sandbox to make your changes available to allusers. You must have the Administer Sandbox (FND_ADMINISTER_SANDBOX_PRIV) privilege to publish sandboxes.Remember, you can't make further changes in the sandbox once you publish it.

Before you start, do these tasks:

• Test or validate your changes in the sandbox in preview mode before actually publishing it. If you madechanges using Page Composer, don't forget to close it before testing. To preview your changes, click theSandbox Mode drop-down buon on the sandbox bar above the global header, and select Preview as ifPublished (Context: All).

Note: You can see the sandbox bar only when you're in an active sandbox.

• Resolve all conicts agged in the merge log of your sandbox.

To publish a sandbox:

1. Click Navigator > Conguration > Sandboxes.2. On the Sandboxes page, click the name of the sandbox you want to publish.3. Click Publish.

Note: The Publish buon might be disabled for your sandbox because of variousreasons. For example, you haven't yet made any changes in your sandbox, orthe Control Publish Sandbox Action in Production Environment prole option(FND_ALLOW_PUBLISH_SANDBOX) is set to No.

4. Click Continue to Publish. The sandbox is published to the mainline metadata.5. Click Done.

Related Topics• How to Resolve Conicts in Unied Sandboxes

• Why is the Publish buon on my Sandbox Detail page disabled

Analytics on Sales Pages

Analytic PrerequisitesYou need to complete some infolet display setup steps to ensure that your data shows correctly on the infolet pages.The procedures to perform these setup tasks are detailed in "Geing Started with Your Sales Implementation". TheRelated Links in this topic will take you to the pertinent sections with detailed instructions.

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=FACIA1792242

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=7C308DE1C0692E30E053A398F70AC0F3

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=96E89901A4059BF4E040D30A68811939

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=7C308DE1C06A2E30E053A398F70AC0F3

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=8AAF48937EA41229E053A398F70A45B8



78

Set up Infolet DisplayThe following are the tasks that must be done to enable infolet display:

• Create your company information.

• Create your resource hierarchy.

• Create your accounting calendar and schedule BI processes.

• Create your sales catalog and schedule BI processes.

Related Topics• Enter Company Information• Resource Hierarchy Setup• Accounting Calendar Setup Overview• Create Sales Catalog

Set Up the Sales PagesAdministrators enable the sales pages on the Set System Options page. You can enable as many pages as you want, upto a total of ve. Once you have enabled the pages, you add analytics by navigating to the Sales Page from the whitepage navigation dots on the home page.

Enable the Sales Pages

1. From Navigator select Structure.2. Select Set System Options.3. On the Set System Options page, select the box next to the pages you want visible.4. Click Save and Close.

Add Content to the Sales Pages

1. Next to your name on the page is an arrow. Click the arrow and select Edit Pages.2. Select Job Role and select the role to which your change should apply. Any analytics you add in this context

apply only to the role you dene here.3. Click OK.4. Click Change Layout.5. Select a layout.6. Click Add Content and Open, and navigate to BI and highlight an analytic to add. Select OK.

Set Up Sales Infolet PagesThe Sales and Sales Infolet pages are where your sales team sees key analytics relevant to their job role. Prebuiltanalytics are displayed inside portals on the pages called infolets. The infolets come with a set of default analytics forroles in your organization. You can manage which analytics you want your users to see. You can add prebuilt, or yourown analytics to the infolets. You can also change the way the infolets appear on the page, by changing the infolet size,the shape, and so on.

Note that if you're in accessibility mode, only non-graphical report views such as Table, Pivot table, and Tile aresupported in Infolets. Charts or graphical views such as Pie and Bar aren't supported in accessibility mode.

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=FASMC2451993






79

Sales Infolet CachingAs you make changes to your infolets, remember that infolets are cached by default. Currently the default seing is tobe cached one hour before the existing infolet content is invalidated and refreshed with new content. This means thatany new updates to your analytics aren't visible in your infolets for an hour, when the cache is refreshed.

You can manually override this action by opening your analytic in BI, then going to the Advanced tab, and checkingthe Bypass Oracle BI Presentation Services Cache. Once this check box in enabled your infolet analysis is visibleimmediately.

This image shows the control to bypass the presentation services cache, and make infolet changes immediatelyavailable.

Enable the Sales Infolet PagesOut of the box the sales infolet pages should be enabled for the standard roles by default. But If you add custom roles,you must enable the sales infolet page for each new role.

1. Click Navigator, then click Structure.2. In Structure, select Set System Options.3. In Set System Options, select Social Panel and Sales Infolets.

Edit Infolet Tiles and ViewsYou can change the way the infolet containers appear on the page.

1. Click the arrow next to your name and select Edit Work Area Pages. You see the Edit Pages dialog. SelectJob Role and select a role. All of the changes you make in this sandbox once saved apply only to employeesassigned to the job role you choose. Click OK.



80

2. Click the arrow in the infolet and select Edit Tile and Views.3. The Edit Tiles and Views dialog appears. Select the size and shape of the infolet. Select Save and Close.

Edit Infolet ContentYou can change the analytics that show in any of your sales infolets.

1. Click the arrow next to your name and select Edit Work Area Pages. You see the Edit Pages dialog. SelectJob Role and select a role. All of the changes you make in this sandbox once saved apply only to employeesassigned to the job role you choose. Click OK.

2. Select the infolet you want to change and from the list select Edit Content. The Edit Content Dialog appears.Select Add Content.

3. The reports directories appear. Navigate to Reports and Analytics > BI Presentation Server > Shared Folders >Sales > Embedded Content. Select the report to add to that infolet and select Add. Publish your sandbox whenyou're nished with your changes.

Add an InfoletYou can add infolets to your Sales and Sales Infolet pages.

1. In your sandbox, click the arrow next to your name and select Edit Work Area Pages. You see the Edit Pagesdialog. Select Job Role and select a role. All of the changes you make in this sandbox once saved apply only toemployees assigned to the job role you choose. Click OK.

2. On the page where you want to add the infolet, select the documents icon.3. Select Create Infolet.4. Name your infolet and click Save.

Your new infolet appears on your Sales Infolet Page. You still must add content by following the steps in Editing InfoletContent.

Delete an Infolet

1. In your sandbox, click the arrow next to your name and select Edit Work Area Pages. You see the Edit Pagesdialog. Select Job Role and select a role. All of the changes you make in this sandbox once saved apply only toemployees assigned to the job role you choose. Click OK.

2. Select the menu on the infolet you're deleting and click Delete.

Analytics on Object Pages

Analytics on Object PagesAdministrators can add analytics to object landing and edit pages. The object landing pages are the pages sales teamsinteract with every day like the Opportunities, Accounts, or Contacts pages. When you add analytics to the tabs in thesepages users can see analytics specic to the record they select.

For the object landing pages there are two steps:

1. Enable the Analytics tab.2. Add an analytic to the enabled tab.

For the edit object pages, there are three steps:

1. Set the "Is "Prompted" lter on the analytic in BI.



81

2. Enable the Analytics tab.3. Add the analytic to the enabled tab.

Note: The Service Request and Work Order landing pages don't have the option for adding analytics.

Enable Analytics Tabs for Object Landing PagesThe analytics tabs on your object pages don't show by default. Administrators must enable the tabs before they can addanalytics to object pages.

Enable Landing Page Analytics TabsThis uses the Opportunities object landing page as an example. The steps are the same for all of the object landingpages.

1. In Navigator click Structure.2. Choose Opportunities.3. On the analytics row, change the value for visible column to "Yes."4. Click Save and Close.

Add an Analysis to the Object Landing PageAfter the analytics tab is enabled, administrators add the analytic to the landing page tab. This procedure uses theOpportunity landing page as an example. The procedure is the same for all object edit and landing pages.

Add an Analysis to the Opportunity Landing Page Tab

1. In a specic opportunity, select the Analytics tab. You enabled this tab in the previous section.2. At the top of the Home Page click the arrow next to your name and select Edit Pages.3. Select Job Role and choose the role to which your change should apply. Any analytics you add in this context

apply only to the role you dene here.4. In Opportunities on the analytics tab click Add Content and navigate to the analysis you want to show on the

Opportunity page.5. Click Add next to the analysis and close the dialog. The analysis is now added to the Analytics tab.

Enable Sub Tabs and Add Analytics to Object Edit PagesThere are three steps to adding analytics to object edit pages.

1. Set the "Is Prompted" lter in the analytic in Business Intelligence. This step is used when the requirement is toview contextual data specic to the record selected.

2. Enable the sub tab on the object page.3. Add the analysis to the sub tab on the object page.

All of these steps are done using the Opportunities landing and edit pages. You can use these same steps for any of theobject pages listed as analytics work areas in the sub table at the start of this section.

For service, the Service, Work Order, and Queue pages use the same procedures.



82

Set the "Is Prompted" FilterFor analytics to show on your user Opportunity pages you enable the "Is Prompted" lter on the name or object IDfor the analysis. Adding this lter adds an analytic with data that relates only to the opportunity your user is currentlyviewing.

1. Open an existing analysis, or create a new analysis in BI.2. In the report Criteria sub tab, select the Filter icon for the appropriate column. Under Operator, select is

prompted. Leave the other options blank.3. Click OK.

Enable Object Edit Page Analytics Sub TabsThis procedure uses the Opportunity object landing page as an example. The procedure is the same for all object editpages.

1. In Navigator click Application Composer.2. Select Sales from the Application drop-down list.3. Expand Standard Objects and go to Opportunity.4. Under Opportunity click Pages.5. Under Detail Page Layouts copy the standard layout or select an existing created layout where the Analytics

sub tab is added.6. Click the Reorder sub tab.

This shows the Congure sub tab option for the edit object page.

7. Click OK.8. Click Done. The Analytics sub tab now shows on the Edit Opportunity page.

Add Analytics to Edit Object Sub TabsThe nal step is to add an analysis to the Edit Object sub tab you have just enabled. When an analysis is added to theobject page, it shows data specic to the signed in user's transaction record. The specic data shows because of the



83

"is prompted" lter being set in the analytic which passes parameters from the transaction record to the analytic. Aparameter is visible in the analytic when a lter prompt is added.

1. At the top of the Home Page click the arrow next to your name and select Edit Pages. The Edit Pages dialogappears.

2. Select Job Role and choose the role to which your change should apply. Any analytics you add in this contextapply only to the role you dene here.

3. In Opportunities on the analytics sub tab click Add Content and navigate to the analysis you want to show onthe Opportunity page.

4. Click Add next to the analysis and close the dialog. The analysis is now added to the Analytics sub tab.5. Next step you want to either save the default parameters, or add parameters specic the object your are

working with.

Click Parameters.

This shows the Parameters buon on the Edit Opportunity analytic.

Parameter Button

6. The parameter used is pageFlowScope variable and is set by default for Opportunity, Leads,Partners and custom object pages. For example, in the case of Opportunity the parameter is#pageFLowScope.biFilterName_OpportunityOpportunityId. To use the default parameter, in the Parametersdialog, click Save. Parameters can be changed by updating the parameter values after clicking Parameterbuon in the eld.



84

This shows the parameter value of #pageFLowScope.biFilterName_OpportunityOpportunityId on an EditOpportunity ID analytic column.

Parameters

7. For the objects that aren't pre-populated with the pageFlowScope parameters, you can use one of thesesessionScope variables depending on which object page you're on, and the columns available in the analytic.

◦ Customer ID: #{sessionScope.zcmAnalyticsCustomerId}

◦ Contact ID: #{sessionScope.hzAnalyticsContactPartyId}

◦ Contact Name: #{sessionScope.hzAnalyticsContactName}

◦ Lead ID: #{sessionScope.mklAnalyticsLeadId}

◦ Opportunity ID: #{sessionScope.mooAnalyticsOpportunityId}

◦ Partner ID:#{sessionScope.zpmAnalyticsPartnerId}

For the Service Request detail page, we use pageFlowScope variables not sessionFlowScope variables.

Expose the Refresh, Export, and Print Links on TabsWhen you're working with analytics on tabs on your interface objects, you have the option of exposing the Print, Export,or Refresh links for the analytics you add to the tabs. This provides your users with handy tools for managing analyticson their object pages.



85

This shows the Refresh, Print, and Export links on an analytic from a tab on the Analytics page.

How to Expose the Refresh, Export and Print LinksTo expose the links for refresh, export, and print on analytics from object tabs, you modify the component properties inPage Composer.

1. Highlight the analytics tab and click the Edit Component Properties wrench icon.

This shows the Page Composer option to modify component properties for a analytics tab.

2. In Component Properties dialog, go to View Report Links.3. In the View Report Links eld,, the following values can be entered:

◦ Add "r" to expose the Refresh link.

◦ Add "f" to expose the Print link.



86

◦ Add "d" to expose the Export link.

◦ Add more than one of these options separated by a comma: r,f,d.

This shows the View Report Links option.

Direct LinkingDirect page linking lets your users drill down on a record without leaving the page. You can add direct page linkingfor records in most custom objects in Engagement. When users click the custom object name, or any record with anassociated ID value, it opens up a separate window to provide further detail on that record.

There are three parts to direct page linking:

1. Dening an action link.2. Constructing the direct link URL.3. Updating the direct link URL and parameters to navigate to a selected record.

Dene an Action LinkYou can add a direct page URL to any column of an analysis created for a custom object by adding an action link fromcolumn properties. Note that the analysis must have a column that holds the identication of the record, such as RecordID in the case of a custom object.

1. Create or open an analytic that contains a column for the name of the document. Select the gear icon on thecolumn and then from the drop-down list choose Column Properties.



87

As an example of this, say there is a custom object called Product Documents. For direct page linking, we wantto add the direct URL/deep link to the column that holds the identication of the record. In the following gure,since there is a Product Document column, it would be the Document name that holds the ID of that record.

2. In Column Properties, select the Interaction tab.3. Under Value, for Primary Interaction choose Action Links from the drop-down list.4. Click the + icon to add an action link.

This shows the New Action, Navigate to a Web Page option.

5. Click Create New Action and then from the drop-down list select Navigate to a Web Page.



88

This shows the Create New Action for a direct page link.

Construct the Direct Link URLYou add your specic URL to the action eld. These steps show you how to determine the correct URL for yourenvironment. These URLs are examples only.

1. Add the direct link URL to the Create New Action eld. There are direct page links paerns available for objectswhich can be found by going to Related Topics at the boom of this section and clicking Direct Page Links:Explained. In this example, you take the direct URL paern for the Custom Object, which in this case is calledProduct Docs. To create a direct link to a default summary page tab for a custom object use the direct link URLpaern in the following example:

https://<hostname>:<port>/<application>/faces/FuseOverview?

fndGlobalItemNodeId=CRM_CUSTOM_CARD_<XXXX>&fndTaskItemNodeId=CRM_CUSTOM_TAB_<XXXX>&fnd=%3BsubTabName

%253DSUMMARY%253BObjectId%253D<YYYY>%253B%3B%3B%3Bfalse%3B256%3B%3B%3B

Replace XXXX with the custom object's API name, for example, ProductDocs_c. Obtain the API name from theobject overview page (click the object's node in the Custom Objects tree in Application Composer).

Replace the YYYY with the custom object's primary key in the database. In this case, the custom object primarykey .comes from the Record_Id column, as shown in the following example:


fndGlobalItemNodeId=CRM_CUSTOM_CARD_ProductDocs_c&fndTaskItemNodeId=CRM_CUSTOM_TAB_ ProductDocs_c&fnd=

%3BsubTabName%253DSUMMARY%253BObjectId%253D300100057476089%253B%3B%3B%3Bfalse%3B256%3B%3B%3B



89

Note that you can test the URL by replacing the host name with your actual host name and using a valid recordvalue in place of <YYYY>. Put the URL in a browser to see if the record details page appears and the URL isvalid.

2. Once you have determined that the URL is valid, the next step is to embed this URL in the analytic and ensurethat the object ID, represented in these instructions as <YYYY> is dynamically retrieved from the analyticwhenever the Product Docs name is clicked. When you have added the URL click Dene Parameters. The nextpart of these instructions is to construct the direct link URL.

Update the Direct Link URL and ParametersThe dene parameters elds are populated with some prompts and values already. The purpose of these steps is toensure that the object ID is dened as a parameter.This shows some Prompt and Value elds on the Create New Action page.

To update the direct link URL and parameters:

1. Because you're changing the value of the ID only, delete the default parameters and leave only one parametermapped to the ID.

2. Update the rst parameter by renaming the Prompt value to ObjectId and set the value to a column value byselecting the record ID from the drop-down list. For example ProductDocs_c.Id.

3. Paste the URL again in the URL eld and replace the ID of <YYYY> value with @{1} as shown in the followingexample:


fndGlobalItemNodeId=CRM_CUSTOM_CARD_ProductDocs_c&fndTaskItemNodeId=CRM_CUSTOM_TAB_ ProductDocs_c&fnd=

%3BsubTabName%253DSUMMARY%253BObjectId%253D@{1}%253B%3B%3B%3Bfalse%3B256%



90

This shows the result of the Edit Action page when the correct values are added.

4. Check Hidden.5. Click Ok.6. Click OK to edit the Action Link window. The Column Properties window appears.7. Click the Data Format tab.8. Check the Override Default Data Format and select Number for Treat Number As.9. Click OK and save.

10. Select the Results tab. Now the document name column shows the link. When users click the link, they're takento that record detail in simplied page.



91

This shows an analysis with direct links from the document name column. This analysis with links to drill-downdetail can be viewed on the Analytics page or any analytics tab.

These same steps can be performed for any of the standard objects for sales and service using the direct link formatand embedding links in the BI analyses.

Related Topics• Direct Page Links

Paths and Links to AnalyticsYour analytics are stored in BI. You are expressing that analytic that's stored in BI in a dierent location. So when youadd an analytic to an infolet, you need to dene that path to the analytic. Navigating away from the page takes you outof editing mode, so it makes sense to get the pathway before you add it to the infolet.

Find Analytic Pathways1. From the Navigator, click Reports and Analytics.2. Click the directory icon on the Reports and Analytics page.3. Go to Sales, Embedded Content, and navigate to the analytic.4. Highlight the analytic you want, right-click and click More.5. Under your analytic name, click More, then Properties.6. From the General area, go to Location and copy the path.

The path is your report location for your sales infolets.7. Click OK.

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=A25465A2EEAC9DA4E040D30A6881471F



92

Repeat the steps 1 through 6 to nd your tile analytics.

ADF Contextual Event ActionAdministrators can set the ADF Contextual Event action on the object name or other aribute columns of an objectin the analysis to enable drilling down to sales objects. When this action is set, the drilling down feature works on theanalytics you add to the object tabs, Sales Infolet pages, sales pages or Analytic page. User can click the column nameand see the details for that particular record.

Several objects are available for drilling down to object details once the ADF Contextual Event is set. The following arethe Engagement objects available:

• Opportunity

• Contact

• Account

• Activity

• Partner

• Deal

• MDF Budget

• MDF Request

• MDF Claim

• Business Plan

• Business Plan Objective

• Leads

• Queues

• Work Orders

• Service Requests

• Assets

Set the ADF Contextual EventYou can add this behavior to any analytic you build as long as it has an identier for the record, in this case the identieris Customer ID. In this example you're going to build an analytic that shows Account and Opportunity details.

1. Create a new analysis from the subject area Sales-CRM Pipeline. (See Chapter 5, Creating and Editing Analytics).2. From the Subject Area pane, drag the following columns onto the Selected Columns editing palee:

◦ From the Customer dimension, select "Name".

◦ From the Customer dimension, select "Customer Row ID".

◦ From the Opportunity dimension select "Name".

◦ From the Opportunity dimension select "Opportunity ID".

◦ From the Facts folder, under Pipeline Facts, select "Opportunity Revenue".

3. Click the seings gear icon for Customer Name.4. Choose Column Properties.



93

5. Choose the Interaction tab.6. Under Value, Primary Interaction, choose Action Links.7. Click the + icon to add a new action.8. Click the running man action icon with the + on it. A list of actions comes up.9. Choose ADF Contextual Event. Click OK.

This gure shows the ADF Contextual Event option.

10. In the Column Properties dialog, check Do not display in a dialog if only one action link is available atruntime.This gure shows the ADF Contextual Event action link dialog.



94

11. Click OK.12. Repeat steps 3 through 9 for the Opportunity Name column.

Viewing the ADF Contextual Event ActionThe analytic to which you added the ADF Contextual Event can be added on the interface. Using the ADF ContextualEvent action, users now have the option to view the additional details of a particular object, or make changes to detailson an object pages.

To set your analytic an edit object page, do the following:

1. Enable the analytic tab on the Accounts page and add the newly created analytic. See the section called"Adding Analytics to Object Pages."

2. Click the Customer Name from the BI report and it opens up the detail page for a particular customer as adialog box. You can close the dialog box and open up any customer name or opportunity name to get a detailpage dialog box.

This gure shows the drill-down detail for the Edit Account object when the ADF Contextual Event action is added.

USER_PARTY_ID Session VariableYou can congure analyses to show user-specic analytic data on user Analytics pages. This is done by adding sessionvariables to the analytic. Adding a session variable, such as USER_PARTY_ID tells the application to show only the datathat's specic to the signed in user. The variables exist for each user for the duration of a browsing session and expirewhen the user closes the browser or signs out. There are two types of session variable: system and non-system. Sessionvariables are primarily used when authenticating users against external sources such as database tables or LDAPservers. If a user is authenticated successfully, session variables can be used to set lters and permissions for thatsession.



95

Add USER_PARTY_IDTo add session variables you select the gear icon on the column name. Then you select New Filter. The USER_PARTY_IDis used on the Employee Login ID column since it tells the application to only show data in this analytic specic to thelogged in employee. There are several other session variables and you can choose from the options available when youclick in that eld.

This shows the New Filter option for adding a session variable that shows an analysis for a signed in user.

Embed Analyses and Dashboards

Whitelist Safe DomainsYou whitelist safe domains to approve access to specic content. For security reasons, external content can't be addedto reports and reports can't be embedded in other applications unless it's safe to do so. Only administrators can addsafe domains to the white list.



96

Only authorized users may access the content. Except in cases where Single Sign On (SSO) is enabled, users areprompted to sign in when they access content on safe domains. After you have added a safe domain to the white list,users need to sign out and sign back in to access content from that source.

1. Click Navigator > Reports and Analytics.2. Click Browse Catalog.3. Click the Administration link on the BI Home page.4. Click the Manage Safe Domains link.5. To allow users to embed their analyses in content located on other domains, enter the name of the safe domain

as well as the port. Here are a few formats you can use for port names:

◦ www.example.com:<port number>

◦ *.example.com:<port number>

◦ hps:

6. Select the types of resources you want to allow and block any resource types you think aren't safe. For example,to allow embedding, select Embedding.

Embed Your Content in Other ApplicationsYou can embed your reports in other non-Oracle applications and portals. This is a good way to share content and dataamong multiple systems. When other users click on embedded content, if you don't have single sign-on, they mighthave to sign in again to see the content.

Before you can embed a report in other applications or portals, your administrator must add the URL for the targetapplications or portal to the domain whitelist.

1. Obtain the URL of the analysis or dashboard you want to embed.

a. Go to the catalog and open the analysis or dashboard.b. In the URL displayed in the browser's address bar, delete "Portal", so that your URL resembles this

example, then copy the URL.

Content Example URL

Analyses

hp://example. com:<port number>/ analytics/ sawdllGoAction prompt&path=%2Fshared%2F<folder>%20<analysis name>

2. Sign in to the target application or portal, then embed the content inside an iFrame and use the copied URL.


Chapter 7Custom Subject Areas

97

7 Custom Subject Areas

About Custom Subject AreasWith Oracle Engagement Cloud, you get prebuilt analytics that answer typical business questions you might have. But incase your questions aren't answered, you can create your own analytics using prebuilt subject areas. And, if the prebuiltsubject areas don't cover what you need, then you can create your own custom subject areas to use to create analyticsthat do answer your questions. This feature is especially useful as you work through the process of conguring yourapplications. For example, if you create custom objects and want to report on them, then you will need to create customsubject areas.

Subject Areas and AnalyticsWhat's the relationship between subject areas and analytics?

A subject area is the starting point for building analytics. It's basically a collection of related information from yourdatabase. Analytics, meanwhile, are like snapshots of a subject area. They give you a focused view of that collection ofinformation, so you can get more meaningful insights from your data.

You can look at a subject area like a painter's palee and the resulting analytics are the completed paintings that youcreate. The subject area contains all the colors you need to paint one or more pieces of artwork. And your nishedartwork gives you the intelligence you need to beer understand and operate your business.

When to Create Custom Subject AreasCreating custom subject areas isn't required, and you do get prebuilt subject areas that contain a lot of information fromwhich you can build your own custom analytics. You will need to create custom subject areas, however, for two reasons:

• If you create custom objects and want to report on them

• If the existing prebuilt subject areas don't contain the measures (facts) you need for reporting

How to Create and Use Custom Subject AreasTo create a custom subject area, you're guided through the process step by step, but here's a quick overview:

1. Navigate to Application Composer.2. Click Custom Subject Areas on the Overview page of Application Composer.3. Select Create from the Actions menu.4. Complete the guided process.

Next, to actually build analytics from that subject area, use BI Composer. Using a custom subject area in BI Composer isthe same as using a prebuilt subject area.

1. From the Navigator menu, select Tools > Reports and Analytics.2. In the Contents pane, click Create.3. Select the published custom subject area and start creating your analytic, such as a report or an online analysis.



98

Things to RememberBefore you start creating custom subject areas, you should know the following:

• Tools: Use Application Composer to create custom subject areas. Then use BI Composer to create analyticsbased on those custom subject areas.

• Objects: A subject area is always built around a business object. That object is the focus of any reportingcreated using that subject area. You can add related objects to a subject area, but there is always a primaryobject and you can't change it.

• Dates and numbers:

◦ The real meaningful substance of any reporting is typically "how much" or "how many." You'remeasuring things to get insights into how well your business is doing. When creating a custom subjectarea, you can tag aributes of the custom subject area object as measures, which means you specifywhich date and number elds are measurable. You will use these measures when you later use thissubject area to create analytics.

◦ You can also enable date leveling, which means that you can group the data in your analytics by dierentcalendar aributes. You do this by mapping a date aribute to a calendar object, like Week Of the Year,Month of the Year, or Enterprise Quarter. This mapping lets you view data in your analytics by a specicquarter or year, for example.

• Publishing: Once you create a custom subject area, you can't actually use it in BI Composer until you publish it.

In the next few topics, we will review some of these key concepts. We will then talk in more detail about how to createcustom subject areas.

Custom Subject Area ObjectsWhen you create a custom subject area, one of the rst things you do is pick the primary object. The primary objectis the focus of any reporting created using that subject area. Does your subject area need more data to be helpful? Ifso, then just add child objects to the subject area. A subject area always has one primary object and, depending onyour reporting needs, could have one or more child objects. Still need more data? You can further expand the scope ofinformation by adding related objects as well. Let's look at these objects in more detail.

Primary ObjectYou pick a primary object during the rst train stop when creating a custom subject area. The list of available objectsincludes all standard objects as well as top-level custom objects. A top-level object is simply an object without a parent.

After you save your custom subject area, the primary object is frozen and can't be changed.

Note: You can't include Notes and Tasks in a custom subject area.

Child ObjectsTo expand the scope of information that you can report on, you can add one or more child objects during the secondtrain stop when creating a custom subject area. After adding child objects, you can include data from both the primaryobject and its children in the analytics you create from this subject area.



99

In a family, one parent can have many children; we call this a one-to-many relationship. In Application Composer,you create this type of relationship by creating a parent object with one or more children. So, if a parent object is theprimary object of a custom subject area, then you can add its children to the subject area, too. Note that in ApplicationComposer, you can't create a child object of a child object (grandchildren).

When you create custom subject areas, however, it's a lile dierent. Yes, you can add child objects to a subjectarea. But, you add child objects in sequential order. It's a single hierarchy of objects: parent-child-grandchild-great-grandchild.

Here's a screenshot of what the parent-child-grandchild-great-grandchild hierarchy looks like.

The parent-child-grandchild-great-grandchild hierarchy supports adding up to three levels of child objects with onechild object at each level; for example, parent-child1-child1.1-child1.1.1. If no child objects exist for the selected primaryobject, then you can't add child objects to a custom subject area.

After you publish a custom subject area, you can't add or remove child objects.

Related ObjectsIf you need still more data in your custom subject area, above and beyond what you can get from the primary objectand its child objects, then you can also include aributes (elds) from related objects. You do this during the third trainstop when creating a custom subject area.

Think of related objects like friends of the primary object. They aren't quite children, but they still have a relationshipwith the primary object. A related object doesn't have a parent and can exist on its own. In contrast, child objects can'texist without a parent. So, instead of the parent-child one-to-many relationship, related objects have a many-to-onerelationship with the primary object. You can think of that like many people can be friends with the same parent. InApplication Composer, you create this type of relationship by creating a many-to one relationship on the Relationshipspage.

After you publish a custom subject area, you can't remove related objects.



100

Related Topics

• Include Custom Field on Report

• Associate Custom and Standard Objects for Reporting

Custom Subject Area FieldsAfter you pick the primary object and add child objects to a custom subject area, the next train stop in the process is topick the elds (also called object aributes or just aributes). If you recall, a subject area is a collection of informationfrom your database, and analytics are snapshots and measurements of that information. Picking the elds is the part ofthe process where you build that collection of information in your subject area. When you're later using this subject areato design an analytic, you will be able to choose from the set of elds that you included in this step.

Where Fields Come FromThe elds that you can pick belong to the primary object and any child objects that you added in the previous train stop.You can also add elds from objects that are related to the primary object.

Types of Fields You Can AddThere are dierent types of elds in your applications. You can add most of these types to custom subject areas. Here'swhat you can add:

• Text

• Number

• Date

Keep an eye out for date elds that are canonical date candidates, which are predened for some standardobjects and subject areas, and display with a read-only check mark. Optionally add canonical date elds fromthe lowest standard object in your custom subject area. This means that, if you later join your custom subjectarea to a standard subject area in BI Composer, you can create analytics that can drill up and down the datehierarchy.

For example, maybe users want to see sales commission amounts on their closed opportunities for the quarter,and then drill down to view amounts by week. And maybe they also want to drill up to view amounts by year.This drill down is enabled because the canonical date eld in your custom subject area is automatically joined tothe standard Time dimension in the standard subject area.

• Percentage

• Date time

• Currency

• Check box

• Fixed choice list

In your analytics, only the actual user selections are displayed, as text strings.

It's a good idea to avoid adding multi-select xed choice list elds to your custom subject areas, since only therst selected values are displayed in analytics, not all selected values.

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=D02C95B13316B51FE040D30A688135CE

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=D2D949B3583578BFE040D30A68815F00



101

• Dynamic choice list

In your analytics, only the actual user selections are displayed, as text strings.

• Long text

Types of Fields That BI Composer SupportsMeanwhile, BI Composer supports a corresponding set of data types when creating analytics. It's basically the same asthe types of elds you can add to a custom subject area in Application Composer. But, there are slight dierences interms of how check box elds and choice list elds in a custom subject area are interpreted in BI Composer.

• Boolean

Note: Check box elds from your objects are interpreted as Boolean elds on the BI side. If you'reusing the Boolean data type for elds other than check boxes, then those elds are displayed aseither 0 or 1 in your analytics.

• Number

• Currency

• Date

• String

As mentioned above, xed choice list and dynamic choice list elds are interpreted as string elds on the BIside.

• Percentage

• Date time

• Long text

MeasuresWhen you want to see how your business is doing, you typically review analytics to nd out "how much" or "how many."Keeping on top of this kind of summary data helps you to evaluate your company's performance. To get the exactsummaries you need, you specify the date and number elds in your custom subject areas that you want to summarize,and you also specify how you want to summarize them. These elds are called measures.

What's a Measure?Measures are a set of functions applied to a date or number eld so that your users can see summaries in theiranalytics. Examples of typical measures include a SUM of the revenue in Euros, or a COUNT of the number ofopportunities worth over $500,000.

When you create a custom subject area, you pick the aggregation function (SUM, COUNT, and so on) for measures. Youcan apply these functions on elds of type Date, Numeric, or Currency. After you dene the measures for the requiredelds and publish the custom subject area, you can select these elds and the applied measures when creating analyticsin BI Composer.

Tip: The measures you dene in Application Composer display in the Facts folder in BI Composer.



102

Things to RememberYou can specify measures only when creating a custom subject area. You can't delete measures in an already publishedcustom subject area, but you can add new measures. You can't edit or add measures to a standard, prebuilt subjectarea.

If you don't dene a measure, then one will be automatically selected from the lowest object in the custom subject areawhen you submit the subject area for publication.

Measures and Field TypesSelect measures based on your reporting needs. For example, you can use measures to view product sales per store,state, or country. Or, use measures to view the number of support tickets opened or closed per day, week, or month,and so on. But keep in mind, the measures available for selection might dier depending on the eld type.

Here are some measures you can apply to elds of type Numeric, Currency, or Date.

• For Numeric and Currency elds, a measure can be:

◦ All

Note: All isn't a measure, but an option in the UI that selects all of the measures.

◦ Sum: Calculates the sum of the values.

◦ Average: Calculates the mean value.

◦ Count: Calculates the number of rows that aren't null.

◦ Count Distinct: Calculates the number of rows that aren't null. Each distinct occurrence of a row iscounted only once.

Note: Although Count Distinct is usually used in cases requiring a count on a foreign key(because a count of distinct rows is what's wanted), it's not required. If your requirements allowmultiple instances of the same foreign key value to be counted multiple times, you can useCount rather than Count Distinct.

◦ Maximum: Calculates the highest numeric value.

◦ Minimum: Calculates the lowest numeric value.

◦ First: Selects the rst occurrence of the item.

◦ Last: Selects the last occurrence of the item.

◦ Median: Calculates the middle value.

◦ Standard Deviation: Calculates the standard deviation to show the level of variation from the average.

◦ Standard Deviation Population: Calculates the standard deviation using the formula for populationvariance and standard deviation.

• For Date elds, a measure can be:

◦ All

◦ Maximum

◦ Minimum



103

Custom Subject Areas DatesOnce you pick the elds for your custom subject area, you can then review just the date elds for two additionalconguration steps: allowing date leveling and picking one canonical date eld. First, you can enable one or more eldsfor date leveling which enables the aggregation of report data over a period of time. You can also enable one eld tobe the canonical date which lets you join this custom subject area to the standard Time dimension. Using this commondate, your users can lter data across multiple subject areas in a single report, and drill up and down the date hierarchy.Let's look at date leveling and the concept of canonical date in more detail.

Why Date Leveling is UsefulDate leveling gives you additional date context about your transaction data, and enables the ltering of data by calendaraributes. Date leveling means that you're connecting (mapping) a date eld in your custom subject area to a very largecalendar object in BI Composer. Later, in BI Composer, that date eld will display with a series of calendar aributes.(The calendar object supports both the enterprise and scal calendar.) When you design your analytics, you pick thatdate eld plus the calendar aributes you're interested in, such as Day Name, Week of the Year, Month of the Year, orEnterprise Quarter. In your resulting analytic, transaction data displays along with the helpful date context that you haveadded.

For example, a report can display a set of opportunity records along with the enterprise quarter they were created in: Q1,Q2, and so on. That's date leveling. And, maybe you need to know which day the opportunity was created on, such as ona Monday or Wednesday. That's also date leveling.

Maybe you want to see a report of all orders entered, but you would like to know what enterprise quarters they wereentered in. If you enable date leveling on the creation date for your sales order object, then you can create analytics thatshow orders per enterprise quarter.

Let's rene that report a lile more. Maybe you want to see only orders created in 2019 Q1. When you design that report,add a lter on the enterprise quarter to display only records where the quarter is equal to 2019 Q1.

If you don't enable date leveling for a date eld, then later in BI Composer, that date eld will still display for inclusion inan analytic, but without the added calendar aributes that are so helpful.

Congure Date LevelingTo congure date leveling, use the Congure Dates step of the guided train process to either allow or disallow levelingfor a date eld. You might need to expand the eld list in the Date Field column to view the Allow Leveling check box.

Enable date leveling only for those dates that you want to report on. And, even after you publish the custom subjectarea, you can always come back and select additional dates for date leveling, and then republish.

Why the Canonical Date is UsefulA canonical date in a custom subject area is useful because, when you join your custom subject area to a standardsubject area in BI Composer, the canonical date automatically joins to the standard Time dimension. The Timedimension includes the date hierarchy, so this means that the analytics you create can drill up and down the datehierarchy.

But rst, let's understand where the canonical date comes from. Canonical dates are already dened for some standardobjects. You can see these elds in the Fields step when adding elds from standard objects to your custom subjectarea. (A date eld that's a canonical date will have a check mark in the Canonical Date Candidate column.) If you plan to



104

design a report that lets users drill up and down the date hierarchy, then include a canonical date eld in your customsubject area. But that's only the rst step.

In the next Congure Dates step, you must select the radio buon for that eld in the Canonical Date column. Do this forone eld only, and only for the lowest standard object in your custom subject area. Canonical dates are available onlyfor standard objects because custom objects don't have corresponding subject areas in BI Composer with the standardTime dimension to join to.

Let's look at an example of drilling up and down the date hierarchy. Maybe users want to see sales commissionamounts on their closed opportunities for the quarter, and then drill down to view amounts by week. Maybe they wantto drill up to view amounts by year. This is drilling up and down. To achieve this, you must do the following:

1. In Application Composer, create a custom subject area for opportunity and opportunity revenue, with the LineClose Date as the canonical date from the opportunity revenue object.

2. In BI Composer:

a. Create an analysis that includes both the custom subject area and a standard subject area, such as Sales -CRM Pipeline.

b. In addition to including at least the Sales Commission eld, include the date hierarchy in your analysis,such as Enterprise Time, from the Sales - CRM Pipeline's Time dimension folder.

Congure the Canonical DateTo indicate which date eld should be the canonical date, use the Congure Dates step of the guided train process.To enable a date eld as the one canonical date for a custom subject area, view the date elds for the lowest standardobject in the custom subject area, and select the radio buon for the desired date eld in the Canonical Date column.You might need to expand the eld list in the Date Field column to view the Canonical Date radio buon.

You can add a canonical date to both new and existing custom subject areas.

If you publish a custom subject area without a canonical date, then you can always come back later and select acanonical date, and then republish.

Secure Custom Subject AreasYou can secure a custom subject area by granting or revoking access rights from the role names that access the customsubject area. You can add or delete role names, or grant or revoke access rights from those role names.

You can also add role names from a predened list and assign or revoke permissions.

Manage Role Names and Access RightsWhile dening a custom subject area using the train stops, you can use the Actions list in the Congure Security step tomanage role names and access rights as follows:

• Select and add role names for a custom subject area from a predened list of role names. This predened listalso provides the description for each role name. You can also select and add multiple role names from thispredened list using either the Shift or Ctrl keys. After you add a new role name, you can select appropriateaccess for that role name.

• Select and delete role names listed for a custom subject area. You can also select and delete multiple rolenames using either the Shift or Ctrl keys.



105

Note: You can't delete the role name listed as Everyone.

• Read access is granted by default to each role name you add. To revoke Read access from a listed role name,select No access for that role name.

Note: You can create custom subject areas even for the objects whose data you don't have access to. Thisway you build custom subject areas without compromising data security.

Create Custom Subject AreasCreating a subject area is simple. In Application Composer, just follow the train steps.

Tip: Before you create a custom subject area, review all the prebuilt subject areas to see if the one you want isalready available.

Creating a Custom Subject AreaTo create a custom subject area, you can't be in a sandbox.

1. Navigate to Application Composer.2. Click Custom Subject Areas on the Overview page of Application Composer.3. Select Create from the Actions menu.

Here are the steps in the train stops that you can use for conguring your custom subject area:

1. Dene Custom Subject Area

In this step, you provide the name for your subject area and select the primary object that is the basis forthe reports you create later using the custom subject area. Subject areas usually have names or labels thatcorrespond to the type of information they contain, such as service requests and orders. Display labels have theCustom: prex added automatically.

2. Select Child Objects

In this step, you select the child objects whose data you want to use in your reports. You can add child objectsonly if the primary object has child objects. Otherwise, the add icon is disabled. You can only add one childobject per level. The parent-child-grandchild-grand grandchild hierarchy supports adding up to three levels ofchild objects with one child object at each level, for example, parent-child1-child1.1-child1.1.1.

3. Congure Fields

In this step, you select the elds that you want to display on your reports. You typically add at least one eldfrom each of the objects that you have selected for your custom subject area.

Select the desired measures to generate for number, date, or currency elds from all the available objects sothat the subject area includes only those measures that you want to analyze. Also, dene at least one measure.

In the Measure Aggregations column, select an option from the list of predened formulas that you can applyto the Measure eld. When you select the formula, the application applies the selected formulas to the selectedeld as measures.



106

Note: You can choose measures only for the lowest child. For example, if only a primaryobject exists with no children, you can select measures for the primary object. Otherwise, ifany child objects exist, you can select measures only at the lowest child object level, not forthe parent object.

In the Canonical Date Candidate column, notice which standard object date elds are already denedas canonical dates. Canonical dates are already dened for some standard objects that support the Timedimension in standard subject areas, and display with a read-only check mark. Optionally add this eld fromthe lowest object in your custom subject area. This means that you can later join your custom subject area to astandard subject area in BI Composer, and create analytics that can drill up and down the date hierarchy.

You can change the display labels of the elds that you select in this step. Additionally, you can use the SelectFields dialog to remove elds that belong to the primary object, or add elds from the related objects. TheSelect Fields dialog appears when you click Select Fields when conguring elds for your custom subject area.

After you publish your custom subject area, the elds you have selected for your subject area are automaticallyadded to their owning object's folder. If you have also dened measures, those elds are automatically addedto the Facts folder. If you didn't dene a measure, then one is automatically created for the custom subjectarea.

4. Congure Dates

If required, select one or more Date columns for date leveling. Date leveling lets you add calendar aributes toyour analytics, which provide beer context to your transaction data.

You can also optionally select one date eld to be the canonical date for the custom subject area. Do this if youwant to create analytics that can drill up and down the date hierarchy.

For more information on conguring date elds in a custom subject area, see Custom Subject Area Dates.5. Congure Security

Select the required security level for the Everyone Role Name, which is added by default, or add additional RoleNames by clicking in the + icon and dene the security level for each one of them.

The security denition here only controls who can access the custom subject area denition to create reports. Itdoesn't control data visibility which is automatically controlled based on the user running the reports.

For more information on securing custom subject areas, see Secure Custom Subject Areas.6. Review and Submit

Review the custom subject area conguration for all added objects, aributes, and measures, and if satised,click Submit. If changes are required click Back to navigate back to the required screen.



107

This gure shows the custom subject area conguration.

After you submit, the custom subject area conguration is prepared for publishing. You can create and submita custom subject area either immediately or save and close the custom subject area at any point and submit itlater. You must rst submit a custom subject area for publishing before you can select it from within Oracle BIComposer. After you save or submit a custom subject area, you can't modify its primary object.

To access the published custom subject area in BI:

◦ From the Navigator menu, select Tools > Reports and Analytics.

◦ In the Contents pane, click Create.

◦ Select the published custom subject area and start creating your report.

Editing Custom Subject AreasYou can edit a published or saved custom subject area and then republish it when your changes are done. Modifying acustom subject area doesn't aect the reports that you had created using that custom subject area before making thechanges. You can use the modied custom subject area if you need to enhance existing reports.

To edit a custom subject area:

1. On the Overview page of the Application Composer, click Custom Subject Areas.2. Locate the custom subject area that you want to edit, and click the Edit icon.

You can lter out inactive custom subject areas in Application Composer by viewing custom subject areas inActive status. This is safer than deleting them, because the inactive subject areas are still available and can befound by searching.



108

3. Make the desired changes and then click Submit to republish the custom subject area.

While you can edit a custom subject area in any status, there are considerations on what you can or can't do whenediting. When editing a published custom subject area, it's not possible to:

• Change the primary object.

• Add or remove child and related objects.

• Remove elds.

• Remove previously added measures, date levels, and canonical dates.

• Add more aggregation types for measures that are already published.

Note: You can't modify a predened, standard subject area. Instead, you must create separate custom subjectareas to meet your reporting needs. Before you create a custom subject area, be sure to review all the includedsubject areas to see if the one you want is already available.

Activating or Inactivating Custom Subject AreasWhen editing custom subject areas, you can activate or inactivate custom subject areas when your reporting or businessrequirements change. This step enables you to control what information is displayed on the reports that use theinformation from custom subject areas.

You can inactivate only those custom subject areas that are published and have a status of OK, and can activate onlypreviously inactivated custom subject areas.

To inactivate a custom subject area, select it in the list and then click the Inactivate buon. To activate an inactivecustom subject area, select it and click Activate. Note that if no custom subject area is selected in the list, the buondoesn't appear.

This graphic shows an active custom subject area selected, and the Inactivate buon.

When searching for custom subject areas, you can lter out inactive custom subject areas in Application Composerby viewing only those in Active status. Inactivating a custom subject area is safer than deleting it, because the inactivesubject areas are still available and can be found by searching.



109

Publication Statuses of Custom Subject AreasAfter you create a custom subject area, you must publish it so that it's available for use in BI Composer. A customsubject area can have a few dierent publication statuses. Let's look at each one.

What Happens When You Submit for PublishingBut rst, let's understand the publication process. When you submit a custom subject area for publishing, two processesoccur in the background. The rst process is synchronous and creates Oracle Applications Development Framework(Oracle ADF) artifacts. You must wait until this rst process is over. The second process is asynchronous and createscentralized metadata repository (RPD) fragments and submits them to the Oracle BI server.

If you're working on multiple custom subject areas at once, then be sure to publish them one at a time. The rst customsubject area might publish successfully, but subsequent custom subject areas could result in publish failures.

Publication StatusesA custom subject area can have one of the following statuses:

• Pending: This status indicates either of the following:

◦ You saved and closed the conguration process for a custom subject area before submiing it forpublishing.

◦ A failure occurred in the background processes when creating Oracle ADF and RPD artifacts.

• In Process: This status indicates that the data is in the process of being published to Oracle BI.

Note: If the in-process status doesn't change to OK, even after multiple refresh aempts, thenthere could be an error in publishing. If an error occurs, then the details are displayed as well asinformation about how to x problems, where applicable. Use these error status details to pinpointand x problems quickly.

• OK: This status indicates that the custom subject area has been published successfully. You can use BIComposer to create reports using the objects, aributes, and measures that you have congured in the subjectarea.

Note: You must refresh the status to know whether the custom subject area was submied successfully. Youmight have to refresh the status multiple times because it could take a while to create the Oracle ADF and RPDartifacts.

How to Report on Custom FieldsIf you add custom elds to certain key Sales objects, then you don't have to create a custom subject area just to reporton those new elds. Actually, key Sales objects come with predened extension dimensions. Extension dimensions existin certain standard subject areas in BI Composer and conveniently hold all your custom elds. This means that if youcreate a custom eld for Opportunity, for example, then you don't have to do anything to report on it. Simply go to your



110

favorite standard subject area for Opportunity; your custom eld automatically appears in the extension dimension,ready for inclusion in analytics.

Create Analytics Using Extension FieldsHere's how to create analytics using extension dimension elds:

1. In Application Composer, create custom elds for standard objects, and add those custom elds to the userinterface.

2. Publish the sandbox.3. From the navigator, select Reports and Analytics under Tools to navigate to BI Composer.4. Select a standard subject area whose primary object is the object that you created custom elds for.5. Create your analytic.

When you specify the columns to include, you can select the extension elds from the extension dimensionfolder, which appears as the <Object Name> Extension folder. For example, Opportunity Extension.

The extension elds available for reporting vary by object type.

Hierarchies in AnalyticsSome prebuilt, standard subject areas include hierarchies, such as a customer or territory hierarchy. When you designanalytics with a hierarchy, users can drill up and down that hierarchy to view data grouped at dierent levels. Forexample, with a territory hierarchy, users can drill up and down their data to look at information grouped by region,state, and city. Hierarchies are delivered with standard subject areas only; you can't add them to custom subject areas.What you can do, however, is join your custom subject area with a standard subject area that has the hierarchy youneed. This lets you create analytics with a hierarchy using data pulled from your custom subject area.

Supported HierarchiesThe following hierarchies are supported in some standard subject areas, such as Sales - CRM Pipeline:

• Resource

• Territory

• Customer

• Partner

Example of Adding a Hierarchy to AnalyticsIf you want to create analytics that include a hierarchy, and also pull data from a custom subject area, then here's howyou do it.

Let's say you have a custom object named Ticket that you want to report on. The Ticket object includes the Accounteld as a dynamic choice list. This means at runtime, your users can create tickets and assign accounts (customers) tothem.

Now you have 1,000 tickets in your database and it's time to report on them. Your users would like to view total numberof tickets up and down their customer hierarchy.



111

Here's how you can create a report to meet this need:

1. Create a custom subject area for Ticket and publish it.2. Create a report using a standard subject area, such as Sales - CRM Customer or Contacts Real Time. These

subject areas include the customer hierarchy.3. Add the account hierarchy from the subject area to your report.4. Next, add your Ticket custom subject area to the report. This "joins" the two subject areas.5. Finally, add the metric, such as Number of Tickets, from the custom subject area to your report.

Related Topics

• Multiple Subject Areas in a Single Analytic

Custom Subject Areas: Frequently Asked Questions

Can I change a custom subject area's primary object?No. Once you save a custom subject area, you can't change its primary object. You can, however, create a new customsubject area with a dierent primary object.

What happens if I change a custom subject area after it ispublished?You can edit a published custom subject area and then republish it after your changes are done. Modifying a customsubject area does not aect the reports that you created using that custom subject area before making the changes.You can use the modied custom subject area should you need to enhance existing reports.

Note: You cannot edit a primary object when you modify a custom subject area. Should you need to do so,create a new custom subject area using a dierent (new) primary object.



112


Chapter 8Schedule and Share Analytics

113

8 Schedule and Share Analytics

Create Brieng BooksUse brieng books to hold a collection of analytic snapshots. These snapshots give you a picture of what's going onat the time the analytic is added, or downloaded or reran. You can download brieng books as PDFs or MHTML toview, print, or share. The PDF le includes a table of contents. Brieng books are stored in the business intelligence (BI)catalog.

Add Content to New Brieng Books1. Open the Reports and Analytics work area.2. Click Browse Catalog.3. Select your analytic, then click More and select Add to Brieng Book.

Or, nd your dashboard and click Open.

a. Go to the dashboard page you want to add.b. Click the Page Options buon and select Add to Brieng Book.

4. Indicate if you want the analytic results refreshed whenever the brieng book is downloaded or rerun.5. Click Browse.6. Name your brieng book and save it in My Folders.

Add Content to Existing Brieng Books

1. Open the Reports and Analytics work area.2. Click Browse Catalog.3. Select your analysis, then click More and select Add to Brieng Book.

Or, nd your dashboard and click Open.

a. Go to the dashboard page you want to add.b. Click the Page Options buon and select Add to Brieng Book.

4. Indicate if you want the analytic refreshed whenever the brieng book is downloaded or rerun.

Download and Edit Brieng Books

1. Open the Reports and Analytics work area.2. Click Browse Catalog to locate your brieng book.

Related Topics

• Reports and Analytics Work Area and Panel Tab




114

Schedule Analytics and Brieng BooksAnalytics and brieng books can be scheduled to run when you need them. You can also schedule other automatedtasks, for example to deliver results to specic recipients, send notications, or to generate a list of changesimplemented today using the CURRENT_DATE repository variable. You create what's called an agent to set this allup for an analysis, dashboard, or brieng book. The agent itself is saved as an object in the business intelligence (BI)catalog. Agents can

Create an Agent1. Open the Reports and Analytics work area, or the Reports and Analytics panel tab if available in other work

areas.2. Click the Browse Catalog buon.3. Click New and select Agent in the Actionable Intelligence section.4. Ensure that you enter information on the Delivery Content tab to specify the analysis, dashboard, or brieng

book to run.5. Save the agent in My Folders.

Note: To edit an agent, browse the BI catalog to nd the agent.

Related Topics• Reports and Analytics Work Area and Panel Tab• Schedule Reports

Schedule Snapshots of Your Sales Historical PipelineKeep an eye on your boom line using the Generates Sales Historical Snapshots scheduling process. You get dailysnapshots of your sales pipeline as well as snapshots of opportunity and revenue trends over time.

Snapshots are designed to work only when your enterprise calendar is congured to be either Monthly or Weekly. Soyou need to be sure to set up your calendar to be weekly or monthly before you start using snapshots.

The Generates Sales Historical Snapshots feature uses the Sales - CRM Historical Pipeline subject area to cullinformation on your key pipeline data.

Congure Historical SnapshotsThe Generates Sales Historical Snapshots scheduled process captures opportunity and revenue snapshots for openopportunities and opportunities closed within the time period you specify. You can set up a snapshot to run once, orset it up to run daily, weekly, monthly, yearly, or on your own time frame. You can also choose the number of days afterwhich opportunities have been closed to continue to take a snapshot of the opportunity and its corresponding revenueinformation.

To congure your Sales Historical Snapshots scheduled process:

1. Navigate to Setup and Maintenance, All Tasks.2. Under Name, search for Manage Opportunity Prole Options.


http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=F7188994E936578CE043B69BF40ACBDD



115

The search results returns the Manage Opportunity Prole Option in the boom of the window.3. Click Go to Task on the row that holds the Manage Opportunity Prole Options search result. The Manage

Opportunity Prole Options page appears.4. Under Prole Option Code, enter MOO_MANAGE_SALES_HISTORICAL_SNAPSHOT_CONFIGURATION. Search for that prole.5. Under Prole Values on the right ensure that the value are C=120,D=120,W=58,M=14,Q=5.

The Prole Values are dened the following ways:

◦ C is number of create snapshots for closed opportunities closed within the last C days. This value must begreater than zero.

◦ D is number of days to retain daily snapshots. This value must be greater than zero.

◦ W is umber of weeks to retain weekly snapshots if the enterprise calendar is a week based calendar.

◦ M is number of months to retain monthly snapshots if the enterprise calendar is a month based calendar.

◦ Q is number of quarters to retain a quarterly snapshot.

Note: An upper limit of 10M snapshot records (opportunity and revenue records combined) is supported andonce the record limit is reached, the snapshot process automatically purges records by oldest snapshot dateuntil the record count is brought under the limit. The snapshot process only supports capturing snapshots ifthe enterprise calendar is congured to be either a Month or Week based calendar. No other calendar periodfrequencies are supported. To use the snapshot feature you must congure your calendar rst.

Schedule Historical SnapshotsYou can schedule your Sales Historical Snapshots processes either from the SUI, or from the desktop UI.

To schedule your sales historical snapshots processes:

1. From the menu options choose More then Scheduled Processes.2. Click the Schedule New Process tab.

This gure shows the Schedule New Process option from the Scheduled Process window.

3. If you haven't already run this process, in which case it will show under the search results on the ScheduledProcesses starting page, then you will search in the Scheduled New Process dialog. Click to view all of the



116

choices. At the boom there is a Search option. Click Search and enter Generates Sales Historical Snapshots.In Search Results highlight Generates Sales Historical Snapshots and click OK. The Schedule New Processdialog appears. Click OK again.

This gure shows the Search and Select dialog for choosing your Generate Sales Historical Snapshots process.

4. In the Process Detail dialog click the Advanced tab.

Here you set set when your process runs,, whether it is daily, weekly, or monthly. You will also set the start andend date.



117

This gure shows the scheduling options for your Sales Historical Snapshots processes.

5. Click the Notication tab and dene whom you want to be notied if the process run is successful, if itgenerates an error, or if there are warnings.

6. When you're nished with your scheduling process details for times, frequency, and notications, click Submit.Your Generate Sales Historical Snapshot is now completed.



118


Chapter 9Analytics Folders

119

9 Analytics Folders

Where to Save Analytics and ReportsYou save analyses, dashboards, and reports in the business intelligence (BI) catalog, along with other objects, includingprompts and lters. The catalog has a hierarchy of folders, starting with My Folders and Shared Folders. One importantfolder is Custom, which you nd in Shared Folders and use to store your modied analytics and reports.

My FoldersYou're the only one who can access anything that you save in My Folders. You can see your saved items in My Folderson the Reports and Analytics work area, but not in My Folders in the Reports and Analytics panel tab on any other workarea. The only exception is when you create an analysis using the wizard in the Reports and Analytics work area, andsave it in My Folders. In this case, the analysis is available in any panel tab on all work areas.

Shared FoldersIf you have the appropriate roles, you can also save in Shared Folders so that your modied analytics or reports areavailable to anyone with the correct access. You should save objects in the Custom subfolder, which has subfoldersorganized by product family.

Regarding predened analytics and reports in Shared Folders:

• You should save a copy of the predened analysis or dashboard in the corresponding product family subfolderin the Custom folder, and edit only the copy. Directly edit predened analytics only when necessary, to makesure that any references to the analysis or dashboard still work properly.

• For predened reports only, you can use a special Customize option to copy the report and also the folderstructure and permissions. The copy is linked to the original, so editing the copy is like directly editing theoriginal.

Custom FolderKeep all modied analytics and reports in the Custom folder so that:

• You ensure that modied copies of those objects are not aected during upgrades, which can changepredened analytics and reports outside the Custom folder. You might lose changes saved outside the Customfolder during upgrades.

• You can easily nd modied objects.

• You can edit objects in the Custom folder without compromising security on the original objects.

When you copy an object into the Custom folder, the copied object inherits the permission seings of the Customfolder. An administrator can reset the permissions on the object and the folder that it's in.

Related Topics• Reports and Analytics Work Area and Panel Tab• How You Create and Edit Reports• Overview of Analytics Creation and Modication


http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=EA4F15C5956C3372E040D30A68810C03

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=E8682379C32BD037E040D30A68815E74



120

• How You Modify Copies of Predened Reports

Manage Predened Catalog PermissionYou may want to remove access to predened catalog folders so that those associated with oerings you don't usearen't displayed. You can hide the entire predened catalog or selectively display root catalog folders for oerings,which are controlled by the Custom BI Web cat Reporting Duty role and associated roles for each oering.

Using roles, you can manage folder access in a number of ways, depending on requirements and previousmodications you have made.

• Remove duty roles for top-level folders from the Custom BI Web cat Reporting Duty role so that all users see asubset of the predened catalog. Leave roles only for the oerings you want to retain access for.

• Delete all catalog reporting duty roles from the Custom BI Web cat Reporting Duty role to hide the entirepredened catalog and display only /Shared/Custom folders. For example, you can remove BI catalog accessfor external users such as partners who have no access to reporting.

• Delete all catalog reporting duty roles from the Custom BI Web cat Reporting Duty role. Also, add catalogreporting duty roles to a new or existing job role to allow job roles with BI access to have default access to thepredened catalog. For example, by default, Financial job roles have access to Financial reporting content butHuman Capital Management job roles don't have access to the predened HCM BI catalog. You can grant theHuman Capital Management Folder Reporting Duty role to new job roles to allow access to predened HCMreports.

Hide Predened Catalog FoldersAll authenticated users have the Custom BI Web cat Reporting Duty role, which inherits all of the folder reporting rolesthat determine access and visibility of root level catalog folders. Administrators with IT Security Manager privileges canhide predened folders by removing their associated roles from the duty role.

1. Open the Security Console.2. Search for Custom BI Web cat Reporting Duty.3. In the search results, click Actions > Edit Role.4. Click Next to navigate to the Role Hierarchy step.5. To hide all folders, remove all of the roles from the hierarchy. Leave any roles for oerings you want to retain

access for.6. Synchronize security changes. Click Navigator > Scheduled Processes in the Navigator and submit the

Import User and Role Application Security Data process.7. Go to Oracle BI and click Administration. In the Maintenance and Troubleshooting section, select Reload Files

and Metadata to refresh the the BI cache.

BI Reporting RolesThis table shows the mapping between shared root catalog folders, folder reporting roles, and job roles.

Catalog Folder Duty Role Duty Role Name Associated Job Roles

/Shared/Common Content

BI_ COMMON_ CONTENT_REPORTING_ DUTY

Common Content FolderReporting Duty

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=EA5FE97DEFD866A4E040D30A68817FCD



121


/ Shared/ Customer DataManagement

BI_ CDM_ REPORTING_ DUTY

Customer Data ManagementFolder Reporting Duty

/ Shared/ EnterpriseContracts

BI_ OKC_ REPORTING_ DUTY

Enterprise Contracts FolderReporting Duty

ORA_ OKC_ CUSTOMER_CONTRACT_ADMINISTRATOR_JOB ORA_ OKC_CUSTOMER_ CONTRACT_MANAGER_JOB ORA_ OKC_CUSTOMER_ CONTRACT_TEAM_ MEMBER_ABSTRACT ORA_ OKC_ENTERPRISE_ CONTRACT_ADMINISTRATOR_ JOBORA_ OKC_ ENTERPRISE_CONTRACT_ MANAGER_JOBORA_ OKC_ ENTERPRISE_CONTRACT_ TEAM_MEMBER_ ABSTRACT ORA_OKC_ SUPPLIER_ CONTRACT_ADMINISTRATOR_ JOB ORA_OKC_ SUPPLIER_ CONTRACT_MANAGER_ JOB ORA_ OKC_SUPPLIER_ CONTRACT_TEAM_ MEMBER_ ABSTRACT

/ Shared/ Extension

BI_ EXT_ REPORTING_ DUTY

Extension Folder ReportingDuty

/ Shared/ Financials

BI_ FIN_ REPORTING_ DUTY

Financials Folder ReportingDuty

ORA_ AP_ ACCOUNTS_PAYABLE_ INVOICE_SUPERVISOR_JOB ORA_AP_ ACCOUNTS_ PAYABLE_MANAGER_JOB ORA_ AP_ACCOUNTS_ PAYABLE_PAYMENT_ SUPERVISOR_JOBORA_ AP_ ACCOUNTS_PAYABLE_ SPECIALIST_JOBORA_ AP_ ACCOUNTS_PAYABLE_ SUPERVISOR_JOBORA_ AR_ ACCOUNTS_RECEIVABLE_ MANAGER_JOBORA_ AR_ ACCOUNTS_RECEIVABLE_ MANAGER_SOD_JOB ORA_ AR_ACCOUNTS_ RECEIVABLE_SPECIALIST_JOB ORA_ AR_ACCOUNTS_ RECEIVABLE_SPECIALIST_ SOD_JOBORA_ AR_ BILLING_MANAGER_JOB ORA_ AR_BILLING_ SPECIALIST_JOBORA_ CE_ CASH_MANAGER_JOB ORA_ EXM_EXPENSE_ MANAGER_JOBORA_ FA_ ASSET_ACCOUNTANT_JOB ORA_FA_ ASSET_ ACCOUNTING_



122


MANAGER_JOB ORA_FUN_ INTERCOMPANY_ACCOUNTANT_JOB ORA_ GL_FINANCIAL_ ANALYST_JOBORA_ VRM_ REVENUE_ANALYST_JOB ORA_ VRM_REVENUE_ MANAGER_JOBORA_ XCC_ BUDGET_MANAGER_JOB

/Shared/Higher Education

BI_ HED_ REPORTING_ DUTY

Higher Education FolderReporting Duty

ORA_ HEQ_ ADMISSIONS_COORDINATOR_ JOBORA_ HEQ_ ADMISSIONS_MANAGER_JOB ORA_HER_ ACADEMIC_COORDINATOR_ JOB ORA_HER_ REGISTRAR_JOB ORA_HES_BURSAR_JOB ORA_HEY_ STUDENT_ SERVICES_MANAGER_JOB ORA_ HEY_STUDENT_ SUPPORT_ADVISOR_JOB

/Shared/Human CapitalManagement

BI_ HCM_ REPORTING_ DUTY

Human Capital ManagementFolder Reporting Duty

By default, predened HCMjob roles have no access to thethe predened content.

/ Shared/ IncentiveCompensation

BI_ IC_ REPORTING_ DUTY

Incentive CompensationFolder Reporting Duty

ORA_ CN_ INCENTIVE_COMPENSATION_ANALYST_JOB ORA_CN_ INCENTIVE_COMPENSATION_MANAGER_JOB ORA_CN_ INCENTIVE_COMPENSATION_PARTICIPANT_ ABSTRACTORA_ CN_ INCENTIVE_COMPENSATION_PARTICIPANT_ MANAGER_ABSTRACT ORA_CN_ INCENTIVE_COMPENSATION_ PLAN_ADMINISTRATOR_ JOB

/ Shared/ Loyalty

BI_ LOY_ REPORTING_ DUTY

Loyalty Folder Reporting Duty

ORA_ LOY_ LOYALTY_MARKETING_MANAGER_JOB ORA_ LOY_LOYALTY_ PROGRAM_ADMINISTRATOR_ JOB

/ Shared/ Manufacturing

BI_ MFG_ REPORTING_ DUTY

Manufacturing FolderReporting Duty

ORA_ CSE_ ASSET_ADMINISTRATOR_ JOB

/ Shared/ Marketing

BI_ MKT_ REPORTING_ DUTY

Marketing Folder ReportingDuty

ORA_ MKL_ SALES_ LEAD_QUALIFIER_JOB ORA_ MKT_



123


CORPORATE_ MARKETING_MANAGER_JOB ORA_ MKT_MARKETING_ ANALYST_JOBORA_ MKT_ MARKETING_MANAGER_JOB ORA_ MKT_MARKETING_ OPERATIONS_MANAGER_ JOB ORA_ MKT_MARKETING_ VP_JOB

/ Shared/ Partner

BI_ ZPM_ REPORTING_ DUTY

Partner Folder Reporting Duty

ORA_ ZPM_ CHANNEL_ACCOUNT_ MANAGER_JOBORA_ ZPM_ CHANNEL_ADMINISTRATOR_JOB ORA_ ZPM_CHANNEL_ OPERATIONS_MANAGER_JOB ORA_ ZPM_CHANNEL_ PARTNER_MANAGER_JOB ORA_ ZPM_CHANNEL_ PARTNER_PORTAL_ ADMINISTRATOR_JOB ORA_ ZPM_ CHANNEL_SALES_ DIRECTOR_ JOB ORA_ZPM_ CHANNEL_ SALES_MANAGER_JOB

/ Shared/ Procurement

BI_ PRC_ REPORTING_ DUTY

Procurement Folder ReportingDuty

ORA_ AP_ ACCOUNTS_PAYABLE_ MANAGER_JOBORA_ AP_ ACCOUNTS_PAYABLE_ SPECIALIST_JOBORA_ AP_ ACCOUNTS_PAYABLE_ SUPERVISOR_JOBORA_ PO_BUYER_JOBORA_ PO_ PROCUREMENT_APPLICATION_ ADMIN_JOBORA_ PO_ PROCUREMENT_INTEGRATION_SPECIALIST_JOB ORA_ PO_PURCHASE_ ANALYSIS_ABSTRACT ORA_ POQ_SUPPLIER_ QUALIFICATION_DISCRETIONARY ORA_POR_ PROCUREMENT_REQUESTER_ ABSTRACTORA_ POZ_ SUPPLIER_ADMINISTRATOR_ ABSTRACTORA_ POZ_ SUPPLIER_MANAGER_ ABSTRACT

/ Shared/ Projects

BI_ PRJ_ REPORTING_ DUTY

Projects Folder Reporting Duty

ORA_ OKC_ CUSTOMER_CONTRACT_ADMINISTRATOR_JOB ORA_ OKC_CUSTOMER_ CONTRACT_MANAGER_JOB ORA_ OKC_CUSTOMER_ CONTRACT_TEAM_ MEMBER_ABSTRACT ORA_ OKC_ENTERPRISE_ CONTRACT_ADMINISTRATOR_ JOB



124


ORA_ OKC_ ENTERPRISE_CONTRACT_ MANAGER_JOBORA_ OKC_ ENTERPRISE_CONTRACT_ TEAM_MEMBER_ ABSTRACTORA_ PJF_ GRANTS_ACCOUNTANT_JOBORA_ PJF_ GRANTS_ADMINISTRATOR_ JOBORA_ PJF_ GRANTS_DEPARTMENT_ADMINISTRATOR_ JOBORA_ PJF_ PROJECT_ACCOUNTANT_JOBORA_ PJF_ PROJECT_ADMINISTRATOR_ JOBORA_ PJF_ PROJECT_BILLING_ SPECIALIST_JOBORA_ PJF_ PROJECT_EXECUTION_ ABSTRACTORA_ PJF_ PROJECT_EXECUTIVE_JOB ORA_ PJF_PROJECT_ INTEGRATION_SPECIALIST_JOB ORA_ PJF_PROJECT_ MANAGEMENT_DUTY_ABSTRACT ORA_ PJF_PROJECT_ MANAGER_JOBORA_ PJF_ PROJECT_TEAM_ MEMBER_ABSTRACT ORA_ PJF_PROJECTS_ APPLICATION_ADMINISTRATOR_ JOBORA_ PJF_ RESOURCE_MANAGER_JOB ORA_ PJF_TEAM_ COLLABORATOR_ABSTRACT

/Shared/Public Sector

BI_ PSC_ REPORTING_ DUTY

Public Sector Folder ReportingDuty

ORA_ PSC_ AGENCY_STAFF_ABSTRACT ORA_ PSC_BUILDING_ INSPECTOR_JOBORA_ PSC_ BUSINESS_ANALYST_JOB ORA_PSC_ CHIEF_ BUILDING_OFFICER_JOB ORA_PSC_ ECONOMIC_ DEV_OFFICER_JOB ORA_ PSC_FINANCE_ ADMIN_JOBORA_ PSC_ INSPECTIONS_SUPERVISOR_JOBORA_ PSC_ PERMIT_TECHNICIAN_JOB ORA_ PSC_PERMITS_ APPLICATION_ADMINISTRATOR_ JOBORA_ PSC_ PERMITS_SUPERVISOR_JOB ORA_PSC_ PLAN_ COORDINATOR_JOB ORA_ PSC_ PLAN_REVIEWER_JOB ORA_ PSC_PRINCIPAL_ PLANNER_JOBORA_ PSC_ SYSTEM_ADMINISTRATOR_ JOB



125


/Shared/Risk Management

BI_ GRC_ REPORTING_ DUTY

Risk Management FolderReporting Duty

ORA_ GTG_ APPLICATION_ACCESS_ AUDITOR_JOBORA_ GTG_ APPLICATION_CONTROL_ MANAGER_JOBORA_ GTG_ COMPLIANCE_MANAGER_JOB ORA_GTG_ ENTERPRISE_RISK_ AND_ CONTROL_MANAGER_JOB ORA_ GTG_RISK_ MANAGEMENT_AUDITOR_JOB ORA_GTR_ USER_ ACCESS_CERTIFICATION_MANAGER_JOB

/Shared/Sales

BI_ ZBS_ REPORTING_ DUTY

Sales Folder Reporting Duty

ORA_ ZBS_ SALES_ADMINISTRATOR_ JOB ORA_ZBS_ SALES_ MANAGER_JOBORA_ ZBS_ SALES_REPRESENTATIVE_ JOB ORA_ZBS_ SALES_ RESTRICTED_USER_JOB ORA_ ZBS_SALES_VP_JOB ORA_ ZPM_CHANNEL_ ACCOUNT_MANAGER_JOB ORA_ ZPM_CHANNEL_ ADMINISTRATOR_JOB ORA_ ZPM_CHANNEL_ OPERATIONS_MANAGER_JOB ORA_ ZPM_CHANNEL_ PARTNER_MANAGER_JOB ORA_ ZPM_CHANNEL_ PARTNER_PORTAL_ ADMINISTRATOR_JOB ORA_ ZPM_ CHANNEL_SALES_ DIRECTOR_JOB ORA_ZPM_ CHANNEL_ SALES_MANAGER_JOB ORA_ ZSP_SALES_ ANALYST_JOB

/ Shared/ Service

BI_ SVC_ REPORTING_ DUTY

Service Folder Reporting Duty

ORA_ CSO_ KNOWLEDGE_ANALYST_JOB ORA_CSO_ KNOWLEDGE_MANAGER_JOB ORA_ SVC_CUSTOMER_ SERVICE_MANAGER_JOB ORA_ SVC_CUSTOMER_ SERVICE_REPRESENTATIVE_ JOBORA_ SVC_ HUMAN_RESOURCE_ HELP_ DESK_ADMINISTRATOR_ JOB ORA_SVC_ HUMAN_ RESOURCE_HELP_ DESK_AGENT_JOBORA_ SVC_ HUMAN_RESOURCE_ HELP_ DESK_MANAGER_JOB ORA_ SVC_INTERNAL_ HELP_ DESK_ADMINISTRATOR_ JOB ORA_SVC_ INTERNAL_ HELP_



126


DESK_AGENT_JOB ORA_SVC_ INTERNAL_ HELP_DESK_ MANAGER_JOBORA_ ZBS_ SALES_ADMINISTRATOR_ JOBORA_ ZCA_ CUSTOMER_RELATIONSHIP_MANAGEMENT_APPLICATION_ADMINISTRATOR_ JOB

/ Shared/ SubscriptionManagement

BI_ OSS_ REPORTING_ DUTY

Subscription ManagementFolder Reporting Duty

ORA_ OSS_ SUBSCRIPTION_SPECIALIST_ JOB

/Shared/Supply ChainManagement

BI_ SCM_ REPORTING_ DUTY

Supply Chain ManagementFolder Reporting Duty

ORA_ ACD_ PRODUCT_DESIGN_ ENGINEER_JOBORA_ ACD_ PRODUCT_DESIGN_ MANAGER_JOBORA_ ACE_ PRODUCT_MANAGEMENT_VP_JOB ORA_ ACE_PRODUCT_ PORTFOLIO_MANAGER_JOB ORA_ CMF_FISCAL_ DOCUMENT_SPECIALIST_JOB ORA_CMF_ RECEIVING_SPECIALIST_JOB ORA_ CMR_RECEIPT_ ACCOUNTING_DISCRETIONARY ORA_ CSE_ASSET_ ADMINISTRATOR_JOB ORA_ CST_ COST_ACCOUNTANT_JOBORA_ DOO_ ORDER_ADMINISTRATOR_ JOBORA_ DOO_ ORDER_MANAGER_JOB ORA_EGI_ PRODUCT_ DATA_STEWARD_JOB ORA_ EGP_PRODUCT_ MANAGER_JOBORA_ ENQ_ QUALITY_ANALYST_JOB ORA_ ENQ_QUALITY_ ENGINEER_JOBORA_ FOS_ SUPPLY_CHAIN_ CONTROLLER_JOBORA_ INV_ INVENTORY_MANAGER_JOB ORA_INV_ WAREHOUSE_MANAGER_JOB ORA_MNT_ MAINTENANCE_MANAGER_JOB ORA_MNT_ MAINTENANCE_TECHNICIAN_JOB ORA_ MSC_BACKLOG_ MANAGER_JOBORA_ MSC_ DEMAND_ AND_SUPPLY_ PLANNER_JOBORA_ MSC_ DEMAND_PLANNER_JOB ORA_MSC_ MATERIALS_PLANNER_JOB ORA_MSC_ REPLENISHMENT_



127


PLANNER_JOB ORA_ MSC_SALES_ AND_ OPERATIONS_PLANNER_JOB ORA_MSC_ SUPPLY_ CHAIN_PLANNER_JOB ORA_RCL_ FIELD_ SERVICE_ADMINISTRATOR_ JOBORA_ VCS_ SUPPLY_CHAIN_ COLLABORATION_PLANNER_ JOB ORA_ WSH_SHIPPING_ MANAGER_JOB

/ Shared/ Functional Setup

BI_ FSM_ REPORTING_ DUTY

Functional Setups FolderReporting Duty *Not inheritedby Custom BI Web catReporting Duty

ORA_ ASM_ APPLICATION_IMPLEMENTATION_CONSULTANT_ JOB

/ Shared/ Security

FBI_ SECURITY_TRANSACTION_ANALYSIS_DUTY

Security Transaction AnalysisDuty *Not inherited byCustom BI Web cat ReportingDuty

ORA_ FND_ IT_ SECURITY_MANAGER_JOB

Predened Catalog LockdownIf you try to modify the predened catalog content including folder permissions, you get an alert indicating that you'renot allowed to modify content and asking that you save your own content in the /Shared/Custom folder.

Here are a few things to know about catalog folders:

• You must save all modied content in the /Shared/Custom folder or in new folders under the /Shared folder.

• Existing modied content in the /Shared/Custom folder or custom folders under the /Shared folder and theirsubfolders is preserved. If you have modied the content in the predened catalog folders, all changes are lostduring any upgrade. To preserve content, archive your catalog content and unarchive it in the Shared/Customfolder after upgrade.

• All existing content in top-level folders under the /Shared folder is preserved.

• You can't change folder or object permissions on the predened catalog folders or content. For example, youcan't change folder permissions to hide folders or objects.

Related Topics

• Business Intelligence Catalog

• Role Inheritance

How to Create FoldersYou manage analyses and reports in the business intelligence catalog, where you create folders to organize them.

http://www.oracle.com/pls/topic/lookup?ctx=fa19d&id=5B285D48C7A50ADDE05362C3F00A12B5



128

To create folders:

1. In the catalog, navigate to the desired location of the new folder in the Folders pane.2. In the catalog toolbar, click New, and select Folder.3. In the New Folder dialog box, enter the folder name, and click OK.

Automatically Created FoldersIf conicts are detected during upgrade, folders named backup_nnn are automatically created in the catalog. Afterreviewing and resolving any conicts, Oracle recommends that you manually delete the backup folders from thecatalog. You can contact your help desk to request an automated removal if you have a large number of folders todelete.

Set Folder Permissions and AributesBusiness intelligence catalog folder properties control folder permissions and other aributes. You can access theproperties of user objects or the Custom folder and any of its subfolders in the catalog to perform tasks such as viewingsystem information or changing aributes or ownership. All other users can only access and modify the properties ofthe objects that they create or own.

Set Folder PropertiesFollow these steps:

1. In the catalog, select the Shared Folders > Custom folder or its subfolder you want to assign properties to.

Caution: Don't modify permissions on predened catalog objects. Saving content in theCustom folder is the only way to ensure that the content is maintained upon upgrade.

2. In the Tasks pane, click Properties.3. In the Properties dialog box, select any of the options in the Aributes section:

◦ Hidden: Species that the object is hidden.

◦ System: Species that the object is a system object.

◦ Read Only: Species that the object is read-only.

◦ Do Not Index: Excludes the object from the index used by the full-text catalog search. Excluded objectsdo not display in the results of any full-text catalog search; the object can still be found using the basiccatalog search.

4. Use the Ownership section to take ownership of a folder or object in the catalog. This area displays only if theproper privileges were assigned to the user, group, or role. Note that the owner of an object or folder can'tautomatically access the object or folder.

◦ Set ownership of this item: Click to become the owner of the folder or object.

◦ Set ownership of this item and all sub items: Click to become the owner of the folder and any sub foldersor sub items contained within the item. For example, if you click this link for a dashboard folder, then youtake ownership of all of the dashboard's components.



129

Set Folder PermissionsYou can assign permissions on folders and other objects.

Access and Set PermissionsYou can set permissions or change ownership for any catalog object or folder. Nonadministrative users can access andmodify the permissions of the objects that they create or own.

To set folder permissions:

1. In the catalog, select the folder or object.2. In the Tasks pane click Permissions.3. In the Permissions dialog box, the owner and any other users, roles, or groups with permissions are listed in the

Permissions list. To add a user or role, click Add users/roles in the toolbar and search for users or roles to addthem to the Selected Members list in the Add Application Roles, Catalog Groups and Users dialog box. To deletea user or role, select the account or role in the Permissions list and click Delete selected users/roles.

4. In the Permissions list, to set ownership for a user, select Custom in the Permissions list for the account, thenselect Set Ownership in the Custom Permissions dialog box and click OK. You can also select the Owner optionfor the user or role.

5. Use the Permissions list to set permissions for the object. Object permissions vary by object.6. Use the Apply permissions to sub-folders option to assign permissions to the folder's subfolders, and the Apply

permissions to items within a folder to assign them to objects in the folder but not to subfolders.

Archive and Move AnalyticsYou can move your analytic objects by archiving them and the moving them to a new location. You can bundle theentire catalog, specic folders, or multi-component objects as a .catalog le and upload the catalog le to unarchive thedata to another location in the catalog.

Create an Archive

To create an archive le:

1. Locate the object in the catalog.2. Select More and then select Archive.3. In the Archive dialog box, select one or more of the following options:

◦ Keep Permissions: Maintain the object or folder's existing permissions. If you do not select this option,then the archiving process does not include any permissions. Upon unarchiving, the parent folder'spermissions are assigned to all of the objects and folders.

◦ Keep Time stamps: Maintain the Creation Time, Last Modied, and Last Accessed times assigned tothe object or folder. Upon unarchiving, the LastModied time is updated to indicate the time at whichthe object or folder is unarchived. If you select this option, the Old option in the Paste Overview area ofthe Preferences dialog box is available when unarchiving. You use the Old option to overwrite existingcatalog items that are older than the catalog items in the archive.



130

If you do not select this option, then the archiving process does not include time information and the Oldoption in the Paste Overview area of the Preferences dialog box is not available.

4. Click OK to download the archive le.

Move an Archived Object to a New LocationTo unarchive a le:

1. Select the folder in the catalog where you want to upload the archived le.2. In the Tasks pane click Unarchive.3. In the Unarchive dialog box, browse for and select the archive le.4. Use the Replace option to specify whether to replace an existing folder or object with the same name.

◦ All: Select this option to replace any existing folders or objects with the same names as folders or objectsincluded in the archive le that you are uploading.

◦ Old: Select this option to replace folders or objects except those folders or objects that exist, unless theyare older than the source.

◦ None: Select this option to add any new folders or objects, but preserve any existing folders or objects.

◦ Force: Select this option to add and replace all folders or objects.5. Use the Access Control Lists option to specify how the folders or objects are assigned permissions using Access

Control Lists Access when unarchived.◦ Inherit: Inherits the folder or object's permissions from its new parent folder.

◦ Preserve: Preserves the folder or object's permissions as it was in the original, mapping accounts asnecessary.

◦ Create: Preserves the folder or object's permissions as it was in the original, creating and mappingaccounts as necessary.

6. Click OK.

What happens to modied analytics and reports when anupdate is applied?When saved in the Custom subfolder within Shared Folders, or in My Folders in the business intelligence (BI) catalog,modied analytics and reports are preserved during an update. Any modied objects in the Custom folder are preservedin any update. Changes to existing analytics and reports outside the Custom folder, including those you create, arepreserved only if the update doesn't include a new version of those BI objects. If the update includes a new version of apredened object that you edited outside the Custom folder, then:

• The new version overwrites the existing predened object.

• A copy of the existing object (with your edits) is automatically created in the same folder, with a new name thatindicates it's a new version.

If the update includes a new version of both the predened object and a folder in its le path, then:

• The new folder, along with the new version of the object, overwrites the existing predened folder and object.

• A copy of the existing folder (along with your edited object) is automatically created. The folder is renamed toindicate that it's a new version, but your edited object is not renamed.



131

Note: Future updates won't aect renamed objects or anything within a renamed folder.



132


Glossary

133

Glossary

analysis

A selection of data displayed in one or more views, such as a table or chart, to provide answers to business questions.

analytics

Business intelligence objects such as analyses and dashboards that provide meaningful data to help with decisionmaking.

briefing book

A collection of static or updatable analyses or dashboard pages that you can download, print, and share with others.

business intelligence catalog

The repository where all business intelligence objects, including analyses, reports, briefing books, and agents, arestored. The catalog contains separate folders for personal, shared, and modified objects.

dashboard

A collection of analyses and other content that gives in-depth insight to help with business decisions.

global header

The uppermost region in the user interface that remains the same no matter which page you're on.

mainline metadata

The primary branch of metadata that a sandbox is published to. Once published, changes made in the sandbox becomeavailable to all users.

prompt

A parameter that you set when you use analytics, limiting the data in the analysis or in all analyses on the dashboard ordashboard page (tab).

report

An output of select data in a predefined format that's optimized for printing.

role

Controls access to application functions and data.

sandbox

A testing environment that isolates untested code changes from the mainline environment so that these changes don'taffect the mainline metadata or other sandboxes.


Glossary

134

subject area

A set of columns, or pieces of data, related to a specific business object or area.

view

A specific way to present the results of an analysis, for example as a table or graph. Other types of views, such as thetitle view, show other components of the analysis.

work area

A set of pages containing the tasks, searches, and other content you need to accomplish a business goal.

Cloud Oracle Engagement · Oracle Engagement Cloud Creating and Administering Analytics Preface ii...

Documents

Transcript of Cloud Oracle Engagement · Oracle Engagement Cloud Creating and Administering Analytics Preface ii...