Discoverer-Viewer-Reference-Guide.pdf
-
Upload
balaji-shinde -
Category
Documents
-
view
9 -
download
0
description
Transcript of Discoverer-Viewer-Reference-Guide.pdf
Page 1 of 14
Oracle Financials Reporting: Discoverer Viewer Reference Guide
Contents Discoverer Viewer ‐ Creating & Managing Connections................................................................................. 2
Logging In .................................................................................................................................................. 2 Creating Discoverer Connections.............................................................................................................. 2 Launching a Discoverer Connection ......................................................................................................... 4 Editing or Updating Discoverer Connections ........................................................................................... 5 Points to Note ........................................................................................................................................... 6
Discoverer Viewer – Running Workbooks....................................................................................................... 7 Logging In .................................................................................................................................................. 7 Launching a Discoverer Connection ......................................................................................................... 7 Opening a Discoverer Workbook.............................................................................................................. 8 Running a Discoverer Workbook .............................................................................................................. 9 Points to Note ......................................................................................................................................... 10
Discoverer Viewer – Exporting Data from Discoverer Workbooks ............................................................... 11 Running a Discoverer Workbook ............................................................................................................ 11 Exporting Worksheet Data (Export to Excel).......................................................................................... 12 Points to Note ......................................................................................................................................... 14
Page 2 of 14
Discoverer Viewer ‐ Creating & Managing Connections Logging In • Launch your web browser. • Navigate to the ‘Sign In’ page using the link
provided below. • Enter your User Name & Password and then click
on the ‘Login’ button.
� Discoverer production URL is http://discprod.mrshmc.com:7798/discoverer/viewer
Creating Discoverer Connections In order to use the Discoverer application, each user must first create their individual link(s) to the tool. This setup is performed once per responsibility. Each connection will allow a different level of access and output. To create your permanent connection, click on the ‘Create Connection’ button. Discoverer login details are saved automatically when you create a connection. From then on, you can start Discoverer simply by clicking on a connection name in the Discoverer connections list that is displayed when you run Discoverer.
Page 3 of 14
To create a connection, you must enter specific information in order to access the database and run reports. • ‘Connect To’ field pertains to the type of data
you would like to access. Select ‘Oracle Applications’ as all reports run off the Oracle Application modules.
• Enter a connection name by which you want to identify the new connection in the ‘Name’ field. E.g. MARSH UK DISCOVERER GL.
• (Optional) Enter a description of the connection in the ‘Description’ field.
• Select the language that you want to use from the ‘Locale’ drop down list. Default is ‘Local retrieved from browser’.
• Specify the ‘user name’, ‘password’ & ‘database’ details for the connection that you want to create
• Click on ‘Apply’ button.
�� Database name is ‘OLTP11’
The ‘Select Oracle Applications Responsibility’ page is now launched. Discoverer reports are linked to Oracle responsibilities. You must enter specific information in order to access the database in order to run reports: by country or region (US, EMEA); by business area (T&E, General Ledger). In this screen, Discoverer confirms the parameters previously entered and requires you to select a Responsibility. • Select a ‘Responsibility’ from the drop down list. • Click on ‘Continue’ button.
�� Discoverer responsibilities follow a standard naming convention that contains:
• Company name; • Country or Region; • Type of data
E.g.: MAR GBL DISCOVERER GL USER or GC GBL DISCOVERER AP USER If you do not find the relevant Discoverer responsibility, please follow your local support procedure and contact the Service Desk.
Page 4 of 14
If the user name has access to more than one End User Layer, the ‘Select End User Layer’ page is displayed. • Select an ‘End User Layer’ from the drop down
list. • Click on the ‘Continue’ button.
�� All new Discoverer reports that have been delivered as part of the Phase II project are located within the ‘MMCEULGBL’ End User Layer. If you do not know which EUL to select, please follow your local support procedure and contact the Service Desk.
�� Your connection has been created and you will be prompted back to the Discoverer connection workbench. You will now be able to see all connections you have created.
Launching a Discoverer Connection • Click the ‘Connection’ hyperlink to launch the
Discoverer application.
� If this is the first time you are connecting to Discoverer on the PC, Java (software for running Discoverer Plus) will be automatically downloaded onto the PC. This may take a couple of minutes. • Click the ‘Always’ button when asked.
Page 5 of 14
Editing or Updating Discoverer Connections You can edit a Discoverer connection when you want to change the login details stored for that connection. For example, as per SOX requirements, your Oracle password expires every 90 days and needs to be changed. Once you have performed this change within Oracle you will also need to update it within the Discoverer application. • Click the pencil icon in the ‘Update’ column next
to the name of the connection that you want to edit.
� The Edit Connection page is displayed. • Change the connection details as required (e.g.
password) • Click on ‘Apply’ button • Select again the ‘Responsibility’ attached to the
connection you are updating. • Click on ‘Apply’ button • Select again the ‘End User Layer’ attached to the
connection you are updating.
� You should now be prompted back to the Discoverer connections workbench.
Page 6 of 14
Points to Note Sometimes, when launching an Oracle Discoverer connection, you may face the error message illustrated in the screenshot below. The error message indicates that your login details are invalid (username/password). In most cases, it is related to the fact that your password in Oracle has either expired or has been changed recently. • Click the pencil icon in the ‘Update’ column next
to the name of the connection that you want to edit. .
�� The Edit Connection page is displayed. • Change the connection details as required
(password) Cf. Step 4 • Remember to apply the same changes to ALL
connections.
Sometimes, after launching a discoverer connection, no reports are available for the user to run. This is normally due to an incorrect setup of the connection: invalid responsibility or invalid EUL selected during the connection setup. • Click ‘Show’ in the Details column to display
more information about the connection you want to check.
• Check that the following information is accurate:
• ‘Connect To’: ‘Oracle Applications’ • ‘EUL’: MMCEULGBL • ‘Responsibility’
Page 7 of 14
Discoverer Viewer – Running Workbooks Pre‐requisites: Creating & Managing Discoverer connections: Pages 2 ‐ 6 Logging In • Launch your web browser. • Navigate to the ‘Sign In’ page using the link
provided below. • Enter your User Name & Password and then click
on the ‘Login’ button.
� Discoverer Production URL: http://discprod.mrshmc.com:7798/discoverer/viewer
Launching a Discoverer Connection Access to Discoverer reports is achieved through connections. Each connection provides access to reports split by:
• Business Area: General Ledger, T&E… • Geography: Region, Country, Set Of Books
• Click on the ‘Connection’ you want to launch. The Discoverer Viewer application is launched as a new web browser window.
�� The list of Discoverer workbooks per Business Area is available through the Discoverer Reports Listing document.
Page 8 of 14
Opening a Discoverer Workbook • Query/Select a report through the ‘Name
contains’ field to reduce the criteria or open up the workbooks directly.
• Point your cursor on the report you want to run
and click on the ‘Open’ button. Remarks:
• Workbooks are Discoverer files that contain worksheets displaying data retrieved from the database. Worksheets contain the data that you want to analyze, together with a number of Discoverer components to help you analyze the data. If you are familiar with spreadsheet applications (e.g. Microsoft Excel), think of a workbook as a spreadsheet file and worksheets as different sheets in that spreadsheet file.
• If a workbook contains multiple
worksheets, you can directly open the worksheet you want to run by using the ‘+’ symbol.
�� Discoverer viewer is configured in a way that offers the user a list of all workbooks available in the responsibility associated with the selected connection.
Page 9 of 14
Running a Discoverer Workbook Before a Discoverer workbook can run, input parameters need to be specified to define the scope of the query. Note: Some reports may not require any input parameters to be specified. The query will be submitted to the database once the workbook is opened. • Complete all required parameters fields
(followed by the ‘*’ symbol). • The ‘Flashlight’ icon indicates that a list of values
is available for the parameter. (See Points to Note Section on Page 9).
• The parameter description box provides
guidelines on the parameter (e.g. specific date format).
• Click on the ‘GO’ button to submit the query
against the database.
Page 10 of 14
Points to Note
Selecting parameter values within a list Discoverer users can select input parameter value(s) from a list of pre‐defined values. Launch the ‘Select Value(s)’ dialog box by clicking the ‘Flashlight’ icon (when available)
• Move value(s) from the ‘Displayed values’ to the
‘Selected values’ list if you can see the value(s) you want to use
• If you cannot see the values that you want in the
‘Displayed values’ list, do one of the following: (1) Use the scroll bar to navigate up and
down the values in the current group (2) Use the ‘Next’ and ‘Previous’ buttons
to display the next or previous group of values.
• Limit the values in the ‘Displayed values’ list
using the ‘Search by’ and ‘Search for’ fields, as follows:
(3) Use the ‘Search by’ drop down list to specify how you want to match values.
(4) Enter a search term in the ‘Search for’ field.
(5) Select the ‘Case‐sensitive’ check box to match upper and lower case letters exactly.
(6) Click ’Go’ to start the search. (7) Move values from the ‘Available’ to
the ‘Selected’ list to select them.
• Click ‘Select’ to choose the selected List of Values (LOV) and close the dialog.
Page 11 of 14
Discoverer Viewer – Exporting Data from Discoverer Workbooks
Pre‐requisites: • Creating & Managing Discoverer Connections: Pages 2 ‐ 6 • Running Discoverer Workbooks: Pages 7 ‐ 10
Running a Discoverer Workbook • Login to Oracle Discoverer Viewer. • Launch a Discoverer connection. • Open a Discoverer workbook. • Fill in workbook parameters and submit the report to run. • Get query results on the Discoverer Viewer application page.
• Use the Actions menu located on the left hand side of the Discoverer Viewer window to export data using the defaults settings:
Page 12 of 14
Exporting Worksheet Data (Export to Excel) • Click on ‘Export’ and follow the ensuing prompts.
• Select the Export type from the dropdown list and click on ‘Export’ as shown below.
Page 13 of 14
• Click on ‘Click to View or Save’ in the Export Ready window
• Click on ‘Save’ in the File Download window.
� Note: • The default destination path of exported Discoverer workbooks is: C:\Documents and Settings\ [user LAN id].
Page 14 of 14
Exported Discoverer files have the same name as the Discoverer workbook followed by the file type (e.g. ’.xls’;’.htm’).
• When opening the Microsoft Excel file, the ‘Security Warning’ dialog box appears and asks the users what to do
with the macros included in the file. Select the ‘Disable Macros’ option.
• Once the Excel worksheet is displayed, click on File and save the worksheet in the desired location.
Points to Note Sometimes, when exporting Discoverer workbook data, certain messages popup. These usually refer to files with identical filenames already in existence within the directory selected. • Click on ‘Yes’ to overwrite the existing file with the new one.
Note: If you get the following message after selecting the ‘Yes’ option, it means that the existing file is currently open. Close it and restart the export process again.