Oracle Cloud Administering Transactional Analyses Release

Transcription

1 Oracle Cloud Administering Transactional Analyses Release E July 2015 This guide describes administrative procedures and concepts for reports and analytics.

2 Oracle Cloud Administering Transactional Analyses Release E Copyright 2014, 2015, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate failsafe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

3 Contents Preface... Audience... Documentation Accessibility... Related Documents... Conventions... vii vii vii vii vii 1 Introduction Reports and Analytics in Oracle Fusion Applications Tools for Administering Reports and Analytics Business Intelligence Presentation Catalog: Where You Maintain Your Reports and Analytics Identifying Objects in the Catalog Functional Setup Tasks for Transactional Business Intelligence Displaying Tasks in the Functional Setup Manager Completing Required Tasks in the Functional Setup Manager Assigning Security Profiles to Job Roles Configuring Flexfields for Business Intelligence Configuring Key Flexfields for Transactional Business Intelligence Enabling Key Flexfields for Business Intelligence Reporting Mapping Non-Qualified Segments to BI Objects Identifying Supported Key Flexfields Setting up the GL Accounting Flexfields Understanding Accounting Key Flexfields Identifying Accounting Key Flexfield Segments Assigning Unique Segment Labels Performing Column Flattening Designating GL Accounting Segment Instances as BI-Enabled Deploying Accounting Key Flexfields Configuring Descriptive Flexfields for Transactional Business Intelligence Configuring Descriptive Flexfield Segments Designating Descriptive Flexfields as BI-Enabled Configuring Extensible Flexfields for HCM Designating Extensible Flexfields as BI-Enabled iii

4 Essbase Rule File and Cubes Importing Changes to Flexfields Automatically Overview of Importing Flexfield Changes Running the Import Job Disabling Flexfields as BI-Enabled Disabling Key Flexfields as BI-Enabled Disabling Descriptive Flexfields as BI-Enabled Disabling Extensible Flexfields as BI-Enabled Managing Report Availability Managing Catalog Folders Creating Folders Setting Folder Properties Mapping Reports to Work Areas Moving Reports and Analytics Securing Reports and Analytics Security Levels in Reports and Analytics About Object-Level Security About Roles in Reports and Analytics About Security Configuration Tools in Reports and Analytics Using Oracle Identity to Manage Users and Enterprise Roles Using Oracle Authorization Policy Manager to Configure Roles and Privileges Using the Oracle BI Administration Page to Configure Duty Role Privileges Securing Analytics Creating Users and Assigning Them to Job Roles Assigning Enterprise Roles (or Job Roles) to Duty Roles Creating Duty Roles Assigning Duty Role Privileges to Oracle BI Presentation Catalog Objects Securing BI Publisher Reports and Related Components Setting Catalog Permissions Granting Permissions to the Oracle Enterprise Scheduler Job Definition Managing Reports Managing Report Delivery Servers Navigating to the Oracle BI Publisher Administration Page Configuring Report Delivery Servers Understanding the Report and Delivery Processors Managing Report Processing and Delivery Server Load Diagnosing Report Processing Issues Configuring System Properties for Reporting iv

5 A Mapping Between Oracle Fusion Offerings and Transactional Business Intelligence Subject Areas B C Supported Descriptive Flexfields Creating a Report of Fusion User Accounts v

6 vi

7 Preface Administering Transactional Analyses explains how to administer Oracle Transactional Business Intelligence, a real time, self service analysis and reporting solution offered to Oracle Fusion application users to create ad hoc analyses and analyze them for daily decision-making. Audience Administering Transactional Analyses is intended for Administrators who are responsible for configuring and maintaining Oracle Transactional Business Intelligence. Documentation Accessibility Oracle is committed to accessibility. For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at Access to Oracle Support Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit or visit if you are hearing impaired. Related Documents Additional resources are available for more information. See these Oracle resources: Oracle Public Cloud For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at Getting Started with Oracle Cloud Conventions The text conventions used in this document are described in this topic: vii

8 Convention boldface italic monospace Meaning Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary. Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values. Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter. viii

9 1 1Introduction [1]Oracle Transactional Business Intelligence is a real time, self service analysis and reporting solution offered to Oracle Fusion application users to create ad hoc analyses and analyze them for daily decision-making. Topics: Reports and Analytics in Oracle Fusion Applications Tools for Administering Reports and Analytics Business Intelligence Presentation Catalog: Where You Maintain Your Reports and Analytics Reports and Analytics in Oracle Fusion Applications Reports and analytics in Oracle Fusion Applications are built using Oracle Business Intelligence tools and technologies. When you installed and configured Oracle Fusion Applications you installed the Oracle Business Intelligence components to enable the reporting and analytical features of your applications. Oracle Fusion applications provide different report types to satisfy different reporting requirements. Oracle Business Intelligence provides several tools to meet the various reporting requirements in Oracle Fusion Applications. Analytics (analyses or analytical reports) are visualizations (such as charts and tables) of a specific set of data. An analysis can be embedded into an application page, or included as a component of a dashboard. Analyses are generally interactive and provide ad hoc analysis capabilities to enable the user to customize the presentation of the data in real time. Dashboards are a collection of analyses grouped together to return data. Some examples include: Absence and Accrual dashboard in Oracle Employee Expenses dashboard in Oracle Fusion Financials Project dashboard in Oracle Project Portfolio The analyses and dashboards embedded in your applications can report on real-time transactional data or on historical data. Reports based on real-time data use Oracle Transactional Business Intelligence. Reports based on historical data use Oracle Business Intelligence Applications. Oracle Transactional Business Intelligence reports are constructed queries and reports executed in real time against the transactional schema supported by a layer of view objects. These are configured and deployed during provisioning. Introduction 1-1

10 Tools for Administering Reports and Analytics Operational reports are static reports that meet operational and statutory reporting requirements. Operational reporting includes the generation of high-volume business documents such as payroll and invoices. Oracle Business Intelligence Publisher is the tool that provides this functionality within Oracle Fusion Applications. Many reports are delivered with your applications. Examples include: Total Compensation Statement Report ( ) Purchase Agreement Report (Procurement/Purchasing) Journals Check Report (Financials/General Ledger) Tools for Administering Reports and Analytics Oracle Business Intelligence includes several components, each providing specific functionality that enables you to modify and administer your Oracle Fusion Applications reports and analytics. The Oracle BI Presentation Catalog is where you interact directly with your Oracle Fusion Applications reports and analyses. Use this interface to manage permissions, properties, and organization of your reporting components. Use the Oracle Business Intelligence Publisher administration pages to configure settings specific to the running and scheduling of BI Publisher reports, such as setting up your delivery servers, managing scheduler work load, and setting run-time properties for reports. Business Intelligence Presentation Catalog: Where You Maintain Your Reports and Analytics Reports, analyses, and dashboards used in Oracle Fusion applications pages are stored in the Business Intelligence Presentation catalog. The Oracle BI Presentation Catalog stores the applications content in a directory structure of individual files. To administer reports in Oracle Fusion applications you must understand how to navigate and identify object in the catalog. To navigate the BI catalog: 1. On the Navigator, under Tools, click Reports and Analytics. 2. In the Reports and Analytics pane, click Browse Catalog. You are redirected to the Oracle BI Catalog within Oracle Business Intelligence. 1-2 Administering Transactional Analyses

11 Business Intelligence Presentation Catalog: Where You Maintain Your Reports and Analytics Identifying Objects in the Catalog Oracle Fusion Applications reporting objects are organized by product family in the catalog typically as follows: Top Level: Shared Folders Product Family Folder (example: Financials) Product folder (example: Payables) --Report group folders (example: Invoices) -- Dashboard Report Folders -- Data Models folder - Report Components folders - BI Publisher Reports Introduction 1-3

12 Business Intelligence Presentation Catalog: Where You Maintain Your Reports and Analytics The following table describes the common reporting components that you find in the catalog: Catalog Object Description Located in the Report Components folder. Analyses are used primarily by dashboards. Dashboard folder Located in the reporting group folder Dashboard Prompt Located in the Prompts folder Used in dashboards Filter Located in Prompts folder Used in dashboards and analyses Report (Operational report created by Business Intelligence Publisher) Located in the reporting group folder Data Model Located in the Data Models folder Used by reports created with Business Intelligence Publisher Subtemplate Located in the reporting group folder Used by reports created with Business Intelligence Publisher 1-4 Administering Transactional Analyses

13 2 2Functional Setup Tasks for Transactional Business Intelligence [2]Some configuration tasks may be required after you install Oracle Fusion Applications. Topics: Displaying Tasks in the Functional Setup Manager Completing Required Tasks in the Functional Setup Manager Assigning Security Profiles to Job Roles Displaying Tasks in the Functional Setup Manager After you install Oracle Fusion Applications, go to the Setup and Maintenance page to view tasks for Oracle Transactional Business Intelligence. To view the tasks in the Setup and Maintenance page: 1. Click the Navigator and from the Tools menu, select Setup and Maintenance. 2. In the Setup and Maintenance page, search for Transactional Business Intelligence. Completing Required Tasks in the Functional Setup Manager The following tasks are automated during provisioning. No further action is required to configure your system: Optimization is automated during the provisioning process. No further action is required to configure the system. Manage Transactional Business Intelligence Connections. Functional Setup Tasks for Transactional Business Intelligence 2-1

14 Assigning Security Profiles to Job Roles Connections are set up as part of the provisioning process. No Further action is required to configure the system. Manage Security for Transactional Business Intelligence. To change the default security configuration, see Securing BI Publisher Reports and Related Components. Configure Key Flexfields for Transactional Business Intelligence. See Configuring Key Flexfields for Transactional Business Intelligence. Configure Descriptive Flexfields for Transactional Business Intelligence. See Configuring Descriptive Flexfields for Transactional Business Intelligence. Assigning Security Profiles to Job Roles Default security is configured automatically. To make changes to the default security configuration, see Securing Reports and Analytics. Users of Transactional Business Intelligence must access some person data to successfully run certain reports. To provide this access, assign a predefined security profile to the relevant job or abstract roles. Use the Oracle setup task Manage Data Role and Security Profiles in the Setup and Maintenance work area. For more information, see Oracle Cloud Securing Oracle HCM Cloud. The following example shows how to assign a security profile to a job or abstract role to enable users with that role to access person data. This task is required for users of Transactional Business Intelligence who do not also use Oracle (HCM). Prerequisite: You must have the IT Security Manager role. 1. Select Navigator. 2. Under Tools, select Setup and Maintenance. 3. On the Overview page, search for the task Manage Data Role and Security Profiles. 4. Search for the job or abstract role. 5. Assign the relevant security profile to the job or abstract role. 6. On the Manage HCM Data Roles page, enter the job name (for example, Warehouse Manager) in the Role field and click Search. 7. In the search results, select the job role (for example, Warehouse Manager) and click Edit. 8. On the Edit Data Role: Role Details page, click Next. 9. In the Person Security Profile field on the Edit Data Role: Security Criteria page, select the security profile View All Workers. 10. Click Review. 11. On the Edit Data Role: Review page, click Submit. Upon completion of this task, Oracle Fusion Data Security is updated automatically for roles being used to access Transactional Business Intelligence. The following table identifies, by Oracle Fusion product, the roles that access person data and the predefined security profile that you assign to each role. 2-2 Administering Transactional Analyses

15 Assigning Security Profiles to Job Roles Product Job or Abstract Role Security Profile Assets Asset Accountant View All Workers Assets Accounting Manager View All Workers Enterprise Planning and Budgeting Enterprise Planning and Budgeting Budget Analyst Budget Manager View All Workers View All Workers Financial Consolidation Hub Consolidation Accountant View All Workers Financial Consolidation Hub Consolidation Manager View All Workers Financials Common Module Intercompany Accountant View All Workers General Ledger Financial Analyst View All Workers General Ledger General Accountant View All Workers General Ledger General Accounting Manager View All Workers Incentive Compensation Incentive Compensation Participant Manager View Manager Hierarchy Inventory Warehouse Manager View All Workers Project Foundation Project Accountant View All Workers Project Foundation Project Administrator View All Workers Project Foundation Project Billing Specialist View All Workers Purchasing Buyer View All Workers Sourcing Category Manager View All Workers Sourcing Sourcing Project Collaborator View All Workers For example, as part of their Transactional Business Intelligence setup: Oracle Assets implementers must assign the predefined security profile View All Workers to the Asset Accountant and Asset Accounting Manager job roles. Oracle Incentive Compensation implementers must assign the predefined security profile View Manager Hierarchy to the Incentive Compensation Participant Manager abstract role. Note: The security profiles that Oracle roles use to access Transactional Business Intelligence are assigned during the setup of Oracle data security. No additional setup is required for Transactional Business Intelligence purposes. Functional Setup Tasks for Transactional Business Intelligence 2-3

16 Assigning Security Profiles to Job Roles 2-4 Administering Transactional Analyses

17 3 3Configuring Flexfields for Business Intelligence [3]To include flexfields in Transactional Business Intelligence reporting, you must enable them and import them into Oracle Business Intelligence. Topics: Configuring Key Flexfields for Transactional Business Intelligence Setting up the GL Accounting Flexfields Configuring Descriptive Flexfields for Transactional Business Intelligence Configuring Extensible Flexfields for HCM Essbase Rule File and Cubes Importing Changes to Flexfields Automatically Disabling Flexfields as BI-Enabled Configuring Key Flexfields for Transactional Business Intelligence To include flexfields in your Transactional Business Intelligence reporting, you must enable them for Business Intelligence. Topics: Enabling Key Flexfields for Business Intelligence Reporting Mapping Non-Qualified Segments to BI Objects Identifying Supported Key Flexfields Enabling Key Flexfields for Business Intelligence Reporting Enable key flexfields as BI-enabled so you can include them in your BI reports. To designate the key flexfields as BI-enabled: 1. Navigate to Manage Key Flexfields in Oracle Fusion Applications. 2. Enter your search value in Key Flexfield Code. 3. Click the Manage Structure Instances button. 4. Enter your search value in Structure Instance Code. 5. Click Edit to display the Edit Key Flexfield Structure Instance dialog box. Configuring Flexfields for Business Intelligence 3-1

18 Configuring Key Flexfields for Transactional Business Intelligence 6. Select the BI Enabled option. 7. Click OK. 8. For each flexfield segment instance, repeat steps 5 through Click Save. 10. Populate the BI Object Name for each of the segment labels: a. Query the Key Flexfield Code in the Manage Key Flexfields window. b. From the Actions menu, select Manage Segment Labels. c. Populate the BI Object Name for each segment label to be mapped. The BI Object Name for the following qualified segment labels should not be modified: Segment Label Code FA_COST_CTR GL_BALANCING GL_ACCOUNT BI Object Name Dim - Cost Center Dim - Balancing Segment Dim - Natural Account Segment 3-2 Administering Transactional Analyses

19 Configuring Key Flexfields for Transactional Business Intelligence Note: Before you deploy a flexfield, you must access the Chart of Accounts Instance and assign the newly created segment label to the appropriate segment in the Chart of Accounts. For more information, see Assigning Unique Segment Labels. d. Click Deploy Flexfield. e. Click Save and Close. Mapping Non-Qualified Segments to BI Objects For non-qualified segments that need to be mapped and used in Oracle Transactional Business Intelligence, create a new label and associate a BI object with the label. Associate this new segment label with the segment code. To map non-qualified segments to BI Objects: 1. From Manage Key Flexfields, search for the appropriate key flexfield code. 2. From the Actions menu, select Manage Segment Labels. 3. Click the Add Row icon (green plus sign). 4. Enter the details for the Segment Label Code, including name, description, and BI Object name. Key Flexfield BI Object Name Accounting (GL) Dim - GL Segment1 through Dim - GL Segment10 Budgetary Control (XCC) Dim - XCC Segment1 through Dim - XCC Segment10 Revenue (VRM) Dim - VRM Segment 1 through Dim - VRM Segment 10 Note: Enter the BI Object names carefully and note whether there is a space between "Segment" and the number. 5. Complete the mapping by Assigning Unique Segment Labels to the key flexfields. Identifying Supported Key Flexfields Key flexfields are used to store internally defined codes unique to a particular business. These codes specify part numbers, general ledger accounts, and other business entities. Configuring Flexfields for Business Intelligence 3-3

20 Setting up the GL Accounting Flexfields Supported Descriptive Flexfields provides a list of supported key flexfields and their corresponding key flexfield dimensions. Product Area Key Flexfield Dimension Fixed Assets Category (CAT#) Dim - Asset Category Fixed Assets Location (LOC#) Dim - Asset Location General Ledger Accounting (GL#) Dim - Balancing Segment Dim - Cost Center Dim - Natural Account Payroll Costing Dim - Costing Segments Supply Chain Locator Dim - Inventory Org Supply Chain Item Category Dim - Item Revenue Pricing Dimensions (VRM) Dim - VRM Segment Budgetary Control Budgeting (XCC) Dim - XCC Segment Setting up the GL Accounting Flexfields This is the work flow for setting up Accounting key flexfields but these steps also apply for other key flexfields. Topics: Understanding Accounting Key Flexfields Identifying Accounting Key Flexfield Segments Assigning Unique Segment Labels Performing Column Flattening Deploying Accounting Key Flexfields Understanding Accounting Key Flexfields The Accounting Key Flexfield is used to identify GL accounts. A chart of accounts segment is a component of the Accounting Key Flexfield. Each segment has a value set attached to it to provide formatting and validation of the set of values used with that segment. The combination of segments creates the account combination used for recording and analyzing financial transactions. Note: You must set up your Chart of Accounts (COA) as part of implementing Oracle Fusion Applications or Oracle Fusion Accounting Hub. Examples of segments that may be found in a chart of accounts structure include Company, Cost Center, Department, Division, Region, Account, Product, Program, and Location. The Natural Account segment of the General Ledger Accounting Key Flexfield defines the account used in the account combination to record transactions. The logical segment dimensions in the Oracle BI metadata are Dim Cost Center, Dim Balancing Segment, Dim Natural Account Segment and all Dim GL Segmentn 3-4 Administering Transactional Analyses

21 Setting up the GL Accounting Flexfields dimensions. These dimension tables are populated from a Tree value object or from a Value Set value object depending on whether a tree was associated with the segment in the Fusion Applications setup: For each segment associated with trees, two value objects are generated (Tree and TreeCode) with the following naming structure: FscmTopModelAM.AccountBIAM.FLEX_TREE_VS_segmentlabel_VI & FscmTopModelAM.AccountBIAM.FLEX_TREECODE_VS_segmentlabel_VI For each segment without trees, one view object are generated with the following naming structure: FscmTopModelAM.AccountBIAM.FLEX_VS_ XXX_VI In addition to the segment dimension tables, the BI Extension process also extends Flex BI Flattened VO; FscmTopModelAM.AccountBIAM.FLEX_BI_Account_VI. This view object has a pair of columns for each segment; segmentlabel _ and segmentlabel _c. For example, for your Cost Center segment which has the segment label FA_COST_CTR, there are two columns in this view object, named FA_COST_CTR_ and FA_COST_ CTR_c. Identifying Accounting Key Flexfield Segments For each Chart of Accounts (Accounting Key Flexfield) used to analyze Transactional Business Intelligence facts, identify the segments of the chart of accounts and map them to the Transactional Business Intelligence GL Accounting Segment logical dimensions. Accounting Key Flexfield Segment Segment Label Transactional Business Intelligence GL Accounting Segment Logical Dimension Balancing GL_BALANCING Dim Balancing Segment Natural Account GL_ACCOUNT Dim Natural Account Segment Cost Center FA_COST_CTR Dim Cost Center Other segments to be equalized across the charts of accounts Assigning Unique Segment Labels Other unique segment label Dim GL Segment n where n is an integer from 1 to 10 You must assign a unique segment label to the charts of accounts segments that are the balancing segments or the natural account segments, and that are used for specific purposes. For example, assign the Primary Balancing segment label to the segment used for your company or legal entities in order to provide a correct recording of intercompany transactions and company analysis. Other segment labels are optional and can be assigned as needed. To assign unique segment labels to charts of accounts segments: 1. Launch the Manage Charts of Accounts task and then navigate to the Manage Chart of Accounts window. 2. In the Search section, enter the GL# for the Key Flexfield Code and then click the Search button. 3. In the Search Results section, select Accounting Flexfield and then click the Manage Structures button to navigate to Manage Key Flexfield Structures. Configuring Flexfields for Business Intelligence 3-5

22 Setting up the GL Accounting Flexfields 4. In the Search section, enter the chart of accounts code or the name for Structure Code or Name, and then click the Search button. 5. In the Search Results section, select the chart of accounts and then click Edit to navigate to the Edit Key Flexfield Structure window. 6. Select the Enabled check box to code-enable the Structure code. 7. In the Segments section, select the applicable segments and then click Edit to navigate to the Edit Key Flexfield Segment window. 8. Select the Enabled check box to enable the segments. 9. In the Segment Labels section, select the unique segment labels to equalize the segments across the charts of accounts, and then click the right arrow to move the segments to the selected list. 10. Click Save and Close to return to the Edit Key Flexfield Structure window. 11. Click Done to return to the Manage Key Flexfields window. Performing Column Flattening Perform column flattening for the account hierarchies needed for analysis in Transactional Business Intelligence. Column flattening of Trees is required in order for OTBI hierarchy analyses to be populated with correct data. To flatten columns for account hierarchies: 1. Launch Manage Trees and Tree Versions and navigate to the Manage Trees and Tree Versions window. 2. In the Search section, enter GL_ACCT_FLEX for the Tree Structure Code and the involved tree code or name, and click Search. 3. In the Search Results section, select the tree version you want to flatten. If the status of the Tree Version is Draft, to make the Tree Version active, select Actions, then Status, and then Active. 4. (Optional): After the tree version is specified, perform an audit on the Tree Version to ensure its integrity before launching the flattening job. Select Actions and then Audit. See the section on working with Trees in the Oracle Fusion Application Developer's Guide. 5. Choose Column Flattening from the Actions drop-down menu. 6. Click the Online Flattening button to launch the flattening job immediately or click the Schedule Flattening button to schedule the flattening job according to your requirements. Designating GL Accounting Segment Instances as BI-Enabled Specify the applicable chart of accounts segment instances that are BI-enabled to make them available for use in Transactional Business Intelligence. To specify the chart of accounts segment instances as BI-enabled: 1. In the Search Results section of the Manage Key Flexfields window, select Accounting Flexfield, and then click the Manage Structure Instances button to navigate to the Manage Key Flexfield Structure Instances window. 2. In the Search section, select the chart of accounts for Structure Name and click the Search button. 3-6 Administering Transactional Analyses

23 Setting up the GL Accounting Flexfields 3. In the Search Results section, select the structure instance and click Edit to navigate to the Edit Key Flexfield Structure Instance window. 4. Check the Enabled check box to code-enable the structure instance. 5. In the Segment Instances section, select the segment instances and click Edit to update. Note: Each segment instances must be selected individually. 6. Check the Business Intelligence enabled check box in the Edit Key Flexfield Segment pop-up window and click OK to return to Edit Key Flexfield Structure Instance window. 7. After you have enabled all applicable segment instances for Business Intelligence, click Save and Close to save the changes and return to the Edit Key Flexfield Structure Instance window. 8. Repeat steps 2-6foreach chart of accounts to enable all the applicable segment instances for Business Intelligence. 9. Click Done to return to the Manage Key Flexfields window. 10. After you have configured all the charts of accounts, click the Deploy Flexfield button to deploy Accounting Flexfield and make the latest definition available for use. Deploying Accounting Key Flexfields After you have set up accounting key flexfields, you must deploy them. To deploy accounting key flexfields: 1. Access Manage Chart of Accounts from Setup and Maintenance. 2. Click Search. 3. Use the horizontal scroll bar (if necessary) to find the column Deployment Status. 4. Click the icon under the heading. 5. Select Edited. 6. Click Deploy Flexfield. 7. Monitor the Deployment Status. 8. When 100% is reached in the deployment status, click OK. 9. Verify that a green check mark displays under the Deployment Status column. 10. Click Done. Deployment Status Accounting key flexfields have one of the following statuses: Edited The flexfield definition has not been deployed or changes have been made to the structure, the structure instances, or the value sets. Patched The flexfield definition has been modified through a patch, but the flexfield has not yet been deployed so the patched definition is not reflected. Deployed to Sandbox The flexfield is deployed and available in a flexfield-enabled sandbox. Configuring Flexfields for Business Intelligence 3-7

24 Configuring Descriptive Flexfields for Transactional Business Intelligence Deployed The flexfield definition is deployed and available to end users. Error The deployment attempt failed. Configuring Descriptive Flexfields for Transactional Business Intelligence Descriptive flexfields are used to track unique information not typically found on business forms. The descriptive flexfields capture details that are vital, yet would clutter a form if present. For example, an asset form could become unwieldy if it contained many specific details about the asset, yet the user still needs access to the details. Descriptive flexfields provide a place to store these details. Descriptive flexfields provide a way for you to add custom attributes to entities and to define validation and display properties for them. A descriptive flexfield is a logical grouping of attributes (segments) that are mapped to a set of extension columns which are shipped as part of Oracle Fusion Applications tables. For a list of supported descriptive flexfields, see Supported Descriptive Flexfields. Topics: Configuring Descriptive Flexfield Segments Designating Descriptive Flexfields as BI-Enabled Configuring Descriptive Flexfield Segments If a descriptive flexfield is enabled for Oracle Business Intelligence, you can enable global and context segments for Oracle Business Intelligence, and you can select segment labels. To configure descriptive flexfield segments: 1. Navigate to the Setup and Maintenance window. 2. Navigate to the Manage Descriptive Flexfields window. 3. If the BI Enabled option is cleared, select it. 4. Select the options for deployment of the descriptive flexfields. 3-8 Administering Transactional Analyses

25 Configuring Extensible Flexfields for HCM Designating Descriptive Flexfields as BI-Enabled If a descriptive flexfield is already defined, you can enable it for use in Business Intelligence reports. To designate descriptive flexfields as BI-enabled: 1. Access Oracle Fusion Applications. 2. Navigate to Setup and Maintenance. 3. Navigate to the Edit Descriptive Flexfields window. 4. Enter the Descriptive Flexfield Name. 5. Optional: Enter a Description. 6. Check the BI Enabled check box on the desired descriptive flexfields. 7. Click OK. 8. Click Save. Configuring Extensible Flexfields for HCM An extensible flexfield is similar to a descriptive flexfield in that it provides a customizable expansion space that implementation team, such as Oracle Fusion Applications customers, can use to configure additional attributes (segments) without additional programming. As with descriptive flexfields, each segment is represented Configuring Flexfields for Business Intelligence 3-9

26 Configuring Extensible Flexfields for HCM in the database as a single column. However, with extensible flexfields, the context values and context-sensitive segments are stored in an extension table. Categories and Contexts Implementation team can combine and arrange the segments into attribute groups that are tailored to a customer's specific needs. For example, they can group related segments so that they appear together on the page. The attribute groups are referred to as contexts. You can optionally set up an extensible flexfield to enable implementation team to group contexts into categories. For more information, please refer to Using Extensible Flexfields in Oracle Fusion Applications Developer s Guide. List of EFFs in HCM (CoreHR and Payroll) EFF Number of Categories Number of Contexts PER_JOBS_EIT_EFF 1 0 (none seeded) PER_LOCATION_INFORMATION_EFF 1 5 (none are multi-row context) PER_POSITIONS_EIT_EFF 1 0 (none seeded) PER_PERSON_EIT_EFF 1 9 (2 multi-row contexts) PER_ASSIGNMENT_EIT_EFF 1 0 PAY_ELEMENT_INFORMATION_EFF 1 0 PER_JOBS_LEG_EFF 1 1 PER_LOCATION_LEG_EFF 1 5 PER_POSITIONS_LEG_EFF 1 0 PER_ORGANIZATION_INFORMATION_ EFF Category - Department 4 (1 multi-row context) Category - Enterprise 4 (no multi-row contexts) Category - Disability Organization 0 Category - Division 1 Category - Legal Employer 16 (2 multi-row contexts) Category - Professional Body 0 Category - Payroll Statutory Unit 76 (1 multi-row context) Category - Reporting Establishment 1 Category - Tax Reporting Unit 98 (3 multi-row contexts) 9 You can add contexts and segments to EFFs just like the DFFs. To see the EFFs in OTBI Answers, they need to be deployed and followed by a BI Extender Essbase job. To configure extensible flexfields: 1. Launch the Manage Extensible Flexfield task Administering Transactional Analyses

27 Configuring Extensible Flexfields for HCM 2. Search for the EFF you want to configure, then highlight it and click the Edit icon. 3. In the Edit Extensible Flexfield dialog, highlight the category Display Name, then select Manage Contexts. Configuring Flexfields for Business Intelligence 3-11

28 Configuring Extensible Flexfields for HCM 4. In the Manage Context dialog, search for the context that contains the segment you want to configure, highlight it, then click the Edit icon. 5. In the Edit Context dialog, click the Edit icon. 6. Edit the segment, as required, then click Save Administering Transactional Analyses

29 Configuring Extensible Flexfields for HCM Designating Extensible Flexfields as BI-Enabled Extensible flexfields are BI enabled if at least one segment in a context is BI enabled. To designate extensible flexfields as BI-enabled: 1. Access Oracle Fusion Applications. 2. Navigate to Setup and Maintenance. 3. Navigate to Manage Extensible Flexfields. 4. Enter the extensible flexfield Name; for example, "Organization Information EFF." 5. Select the applicable extensible flexfield, and then click Edit to navigate to Edit Extensible Flexfield. 6. Select the applicable Category. The category contexts are populated automatically. 7. Click Manage Contexts to navigate to Manage Contexts. 8. Select the applicable Context, and then click Edit to navigate to Edit Context. Configuring Flexfields for Business Intelligence 3-13

30 Essbase Rule File and Cubes 9. Select the applicable Segment, and then click Edit to navigate to Edit Segment. 10. Check the BI Enabled check box displayed at the bottom of the screen. 11. Click Save. Essbase Rule File and Cubes Generate the Essbase rule file by running the Fusion Applications job Create Rules XML File for BI Extender Automation. Note: The Essbase rule file must be generated for all Oracle Essbase cubes mapped in the repository file (RPD). To generate the ESSBASE rule: 1. In Fusion Applications, access the Scheduled Processes window: 3-14 Administering Transactional Analyses

31 Importing Changes to Flexfields Automatically 2. Select Search and Select: Name. 3. Highlight Create Rules XML File for BI Extender Automation. 4. Click OK. 5. Schedule the job. Job Status Conditions The job status displays one of these conditions. INIT: The job has just begun and is waiting for the extender command line JAR to update the status with more details. COMPLETED_NO_EXTENSION_NEEDED: No new Flex changes were detected in any of the fusion sources; because the RPD is already synchronized with all FLEX changes, no changes were made in the RPD. COMPLETED: The RPD was successfully updated with Flex changes and uploaded into the Oracle Business Intelligence server. FAILED: Error conditions exist which require manual intervention. Importing Changes to Flexfields Automatically You can automate the process for importing flexfield changes. Configuring Flexfields for Business Intelligence 3-15

32 Importing Changes to Flexfields Automatically Topics: Overview of Importing Flexfield Changes Running the Import Job Overview of Importing Flexfield Changes Use the "Import Oracle Fusion Data Extensions for Transactional Business Intelligence" job to automatically import the following types of changes: Key Flexfield changes Descriptive Flexfield changes Extensible Flexfield changes The Import Oracle Fusion Data Extensions for Transactional Business Intelligence job imports extensible data, including data in descriptive flexfield segments, key flexfield segments, and General Ledger balances in Essbase cubes, into Transactional Business Intelligence. If you have changes to key flexfields and descriptive flexfields, you can import all the changes in the same job. Caution: We strongly recommend that you backup the Oracle Business Intelligence Enterprise Edition prior to importing any flexfield changes. Caution: Running the Import Oracle Fusion Data Extensions for Transactional Business Intelligence job disconnects all users from the server. You should not run this job when maintenance operations or system updates are being performed on the server. Note: The Import Oracle Fusion Data Extensions for Transactional Business Intelligence job is an Oracle Fusion Applications job; it is not a BI Applications job. Detailed information on this job can be found in Oracle Cloud Applications documentation. Running the Import Job Run the Import Oracle Fusion Data Extensions for Transactional Business Intelligence job in Fusion Applications. 1. In Fusion Applications, access the Scheduled Processes window: 3-16 Administering Transactional Analyses

33 Importing Changes to Flexfields Automatically 2. Select Search and Select: Name. 3. Highlight Import Oracle Fusion Data Extensions for Transactional Business Intelligence. 4. Click OK. 5. Schedule the job. Job Status Conditions When the job is finished, the biextendercmdutility.jar writes the status of the job into the JNDI file ess_biextenderessjob_jobstatus, which can be viewed in Oracle WebLogic Server: The job status displays one of the following conditions: INIT The job has just begun and is waiting for the extender command line JAR to update the status with more details. COMPLETED_NO_EXTENSION_NEEDED No new Flex changes were detected in any of the fusion sources; because the Oracle Business Intelligence is already synchronized with all FLEX changes, no changes were made in the Oracle Business Intelligence. COMPLETED Oracle Business Intelligence was successfully updated with Flex changes and uploaded into the Oracle Business Intelligence server. Configuring Flexfields for Business Intelligence 3-17

34 Disabling Flexfields as BI-Enabled COMPLETED: PROCESS_ERRORS Oracle Business Intelligence was updated with the Flex changes but with some warnings that require manual intervention. FAILED Error conditions exist that require manual intervention. Successful Import Job If the Import Job is successful, you can perform the following actions: Query subject areas by segment dimensions such as Balancing Segment and Cost Center. Access DFF attributes for analyses. Use the General Ledger - Balances subject area to query Essbase cubes. Disabling Flexfields as BI-Enabled There may be times (such as during development phases) when you try using a flexfield and later determine it is no longer needed. If you created a flexfield that you no longer want to use or report against, you can disable the flexfield as BI-enabled. Note: If you are considering disabling flexfields, keep in mind that any flexfields created in Oracle Fusion Applications must be designated as BI-enabled to be exposed in Transactional Business Intelligence. If you disable a flexfield, it cannot be deployed. Also, error conditions may occur if you disable a descriptive flexfield that has been implemented in BI Applications. Caution: If error conditions arise from disabling flexfields as BI-enabled, troubleshooting the errors can be difficult and time-consuming. Topics: Disabling Key Flexfields as BI-Enabled Disabling Descriptive Flexfields as BI-Enabled Disabling Extensible Flexfields as BI-Enabled Disabling Key Flexfields as BI-Enabled If you are considering disabling key flexfields, keep in mind that any flexfields created in Oracle Fusion Applications must be designated as BI-enabled to be exposed in Transactional Business Intelligence. To disable key flexfields as BI-enabled: 1. Navigate to Manage Key Flexfields in Oracle Fusion Applications. 2. Enter your search value in Key Flexfield Code. 3. Click the Manage Structure Instances button. 4. Enter your search value in Structure Instance Code. 5. Click Edit. The Edit Key Flexfield Structure Instance dialog box displays Administering Transactional Analyses

35 Disabling Flexfields as BI-Enabled 6. In Edit Key Flexfield Segment Instance, deselect the BI Enabled check box. 7. Click OK. 8. Click Save. Disabling Descriptive Flexfields as BI-Enabled If you are considering disabling descriptive flexfields, keep in mind that any flexfields created in Oracle Fusion Applications must be designated as BI-enabled to be exposed in Transactional Business Intelligence. To disable descriptive flexfields as BI-enabled: 1. Access Oracle Fusion Applications. 2. Navigate to Setup and Maintenance. 3. Navigate to the Edit Descriptive Flexfields window. 4. Enter the Descriptive Flexfield Name. 5. Deselect the BI Enabled check box on the desired descriptive flexfields. 6. Click OK. 7. Click Save. Disabling Extensible Flexfields as BI-Enabled If you are considering disabling extensible flexfields, keep in mind that any flexfields created in Oracle Fusion Applications must be designated as BI-enabled to be exposed in Transactional Business Intelligence. To disable extensible flexfields as BI-enabled: 1. Access Oracle Fusion Applications. 2. Navigate to Setup and Maintenance. Configuring Flexfields for Business Intelligence 3-19

36 Disabling Flexfields as BI-Enabled 3. Navigate to Manage Extensible Flexfields. 4. Enter the extensible flexfield Name; for example, "Organization Information EFF." 5. Select the applicable extensible flexfield, and then and Edit to navigate to Edit Extensible Flexfield. 6. Select the applicable Category. The category contexts are populated automatically. 7. Click Manage Contexts to navigate to Manage Contexts. 8. Select the applicable Context and click Edit to navigate to Edit Context. 9. Select the applicable Segment and click Edit to navigate to Edit Segment Administering Transactional Analyses

37 Disabling Flexfields as BI-Enabled 10. Clear the BI Enabled option displayed at the bottom of the screen. 11. Click Save. Configuring Flexfields for Business Intelligence 3-21

38 Disabling Flexfields as BI-Enabled 3-22 Administering Transactional Analyses

39 4 4Managing Report Availability [4]A key administration task is managing the organization and availability of your reports. Reports reside in the Business Intelligence catalog, but are typically accessed through the reporting pane. Topics: Managing Catalog Folders Mapping Reports to Work Areas Moving Reports and Analytics Managing Catalog Folders Creating Folders The catalog is organized into folders that are either shared or personal. Topics: Creating Folders Setting Folder Properties Create a folder to organize reports. To create a folder: 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, enter the folder name, and click OK. Note: "If you upgrade or patch Oracle Business Intelligence, and conflicts are detected during those processes, the system creates backup_nnn folders in the BI Catalog. After reviewing and resolving any conflicts found in the backup_nnn folders, Oracle recommends that you manually delete the folders from the catalog. You can contact Oracle support to request an automated removal if you have a large number of folders to delete. Managing Report Availability 4-1

40 Managing Catalog Folders Setting Folder Properties You can access the properties of any object or folder to perform tasks such as viewing system information or changing ownership. All other users can only access and modify the properties of the objects that they create or own. To set folder properties: 1. In the catalog, select the folder to which you want to assign properties. 2. In the Tasks pane click Properties. 3. In the Properties dialog, select these field values: Attributes Hidden Specifies that the object is hidden. System Specifies that the object is a system object. Read Only Specifies that the object is read-only. Do not Index Excludes the object from the index used by the full-text catalog search. Excluded objects do not display in the results of any full-text catalog search; the object can still be found using the basic catalog search. Ownership Use this area in the Properties dialog to take ownership of a folder or object in the catalog. This area displays only if the proper privileges were assigned to the user, group, or role. Note that the owner of an object or folder cannot automatically access the object or folder. Set Ownership of this item Click to become the owner of the folder. Set Ownership of this item and all subitems Click to become the owner of the folder and any sub folders or sub items contained within the item. For example, if you click this link for a dashboard folder, then you take ownership of all of the dashboard's components. 4-2 Administering Transactional Analyses