Embed Size (px)
Citation preview
1 1
Go Beyond the Basics with
PeopleSoft nVision/Query
Stephen Kelly • SpearMC Consulting
www.spearmc.com
2
• SpearMC Solutions Overview
• PeopleSoft nVision
‒ 9.1 nVision Highlights
‒ nVision - Beyond the Basics
• PeopleSoft Query
‒ 9.1 Query Highlights
‒ Query - Beyond the Basics
Agenda
3
SPEARMC SOLUTIONS OVERVIEW
4
About SpearMC
• SpearMC is a full-service consulting and technology services firm with specific focus on
PeopleSoft Financials
• Our consultants and network of PeopleSoft Analysts, Technical Leads and Project
Managers average fifteen years of PeopleSoft experience
• We are North America’s leading provider of custom-tailored PeopleSoft Financial training
solutions and educational content development.
• It is our mission to provide the highest levels of professional service at competitive rates
5
In 2012, SpearMC was recognized by Inc.
Magazine as one of the Inc. 500|5000 Fastest-
Growing Private Companies in America
and by the San Francisco Business Times one of the
100 Fastest-Growing Companies in the Bay
Area
Slide 5 About SpearMC
6
Financial Services PeopleSoft Financials v8.9 Upgrade
PeopleSoft Project Costing v8.9 Implementation
Technology Ubisoft: PeopleSoft Financials v9.0 Upgrade
NetApp: Oracle Data Warehouse & Reporting
Consumer Products Financials v8.8 Global Implementation
PeopleSoft Financials Long-Term Support
Retail & Logistics 24 Hr Fitness: PeopleSoft Reporting Strategy
Bekins: PeopleSoft Billing v8.9 Implementation
Higher Ed & Government
Art Institute: PeopleSoft Financials Training
City of Seattle: Chart of Accounts Redesign
SpearMC delivers Oracle/PeopleSoft services across numerous industry domains and markets
About SpearMC
7
Our Expertise…
Personal Service
Professional
Results
Project Management
Operations
Improvement
Business Intelligence
Education
IT Strategy/
Architecture
Application
Development
ERP Integration
Recruiting/Support
8
PEOPLESOFT – NVISION
9
• Allows end users to retrieve information from the PeopleSoft database using ledgers, trees, and queries and to place it into an Excel spreadsheet
• Has been the reporting product of choice for financial reporting, but also used frequently with other modules, including HR
• nVision Bursting
‒ Delivered Security template and scopes in nVision
‒ Custom programmatic generation of rules
o Scopes and report requests
o Layouts and report requests
nVision
nVision is a good tool for reporting data from PeopleSoft in an end user 'usable' format
10
nVision Components
nVision Scopes
Report Requests
nVision Layouts
CFs & Trees
Ledger Structure
Ledger Data
End-User Reports
Report Books
11
Slide 19
Component Definition
Chartfields • Accounts, Project ID, Cost Centers (DeptID)
Trees • Graphical representation of chartfields • Trees are used to present chartfield hierarchy via nodes, roll-ups and detail values
Ledger Structure & Data
• Store GL summary balances by accounting period at the chartfield level • Structure dictates how the ledger will store USD and Local currencies
Layouts • Excel-based templates that contain the “rules” or “instructions” that tell PeopleSoft how to retrieve and present ledger data
• All report formatting is done within the layouts
Scopes • Used to narrow or filter the amount of data that a report request retrieves • Scopes allow for a limited set of layouts to be used repeatedly without having to go into the layout
and hard-code criteria
Report Requests • Contain the report generation criteria such as Report Name, Report Layout, Scope, Reporting Date, Business Unit, Variables and Distribution
Report Books • Allow for several report requests to be grouped together and run at the same time. • Report Books are run via the PeopleSoft Process Scheduler either on an ad-hoc or scheduled basis
End-User Reports • Excel worksheets that are distributed to Financial end-users
nVision Components
12
9.1 NVISION HIGHLIGHTS
13
• Accepting tree effective-date at the time of criteria definition
• Supporting not-in criteria
• Ability to define the types of report requests
• Restoring query prompts to web version of nVision
• Drilling down PS/nVision reports using web services (nVisionDrill VSTO add-in)
Enhancements
14
The PeopleSoft nVision Filter Criteria dialog in nVision client is enhanced to
include an As of Date field along with the tree name
If this checkbox is selected, the As of Date for Trees specified in layout definition is
overridden at the time of Report Request
These changes will affect only matrix layouts, as only in matrix layouts we have an option of selecting trees — Tabular layouts are not affected
Accepting Tree Effective-Date
15
nVision
Beside adding, modifying, and deleting the nodes from the
criteria, the PS/nVision Layout designer now includes a new
feature called “Not in Criteria”, which allows Layout designers to
include fields for building negative criteria; for example,
selecting nodes for not-in clause part of the Query
Supporting “Not in Criteria”
16
• The Define Report Request page of PS/nVision will include
a new sub page called Query Prompts
• Prompts, where you are able to add all the required parameters for queries in that given report
• These parameters are stored as records in a new table called Query Parameters; and these records are identified by the Query name, report ID, and
Business Unit as a primary key
Restoring Query Prompts to Web Version of nVision
17
• nVision Designer recognizes the
concept of public and private
report requests
• Currently, only the web-based
version honors the public or
private report requests security
• This enhancement enables the
users of the Windows client of
PS/nVision to:
– Have the flexibility of making report
request either public or private
– Define whether to share the report
with other users
Select nVision, Share Report Request from the nVision menu…..
Select Users / Roles to share your report
Ability to Define the Types of Report Requests
18
NVISION - BEYOND THE BASICS
19
Key differences between tabular layouts, matrix layouts, and Query:
Feature / Function Matrix Layout Tabular Layout Query
Data Sources Multiple queries and ledgers, labels
Single query Single query
Data Numbers in matrix, text in labels and variables
Text and numbers Text and numbers
Data delivery Matrix intersections of field criteria and queries (amounts) of label and field criteria (text)
Selected query result columns, one data row per spreadsheet row
All query result columns, one data row per spreadsheet row
Layouts One per workbook, but can have multiple tabular layouts in same workbook.
Multiple worksheets per workbook
None: produces one sheet in template workbook
Selection criteria Scope, Business Unit, Effective Dates, Query Ledger, TimeSpan, Field, Label, String
Scope, Query Query
PS nVision variables Yes No (but can put in matrix layout)
No
Scope Multiple instances from the layout workbook
Multiple instances from the layout workbook
None
nPlosion Rows and columns None None
Drilldown from instance Yes No No
TimeSpans Yes, with data keyed by year, period
No No
nVision Layout Comparison
20
nVision places code in Column A and Row 1. For more experienced users, that code can be added or modified without using the layout definition box.
Code Meaning
%, The start of an nVision command
S TimeSpan
L Ledger
F Chartfield
T Select Tree Nodes
M Selected Summary Chartfield Node
V Select Detail Values
_ All Detail Values
R Reverse Sign
N Tree Node
X nPlode
C Copy Formula for nPlosion
Q Query
C Column (Aggregate field from Query)
nVision Codes
21
• Extend nVision Reporting to Non-Ledger Tables
• Multiple Queries in 1 Layout
• Filter Query Data By Using Scopes
• Include Excel Features in Layout
‒ Formatting and Formulas
‒ Pivot Tables
‒ Macros
• Schedule by Using Report Books
• Use Selected Fields From Queries The nVision GUI was designed to prompt against Financial Ledger based tables, but can be used to pull data from any PeopleSoft table via a predefined query.
You must know your field names and type them in instead of picking them from a prompt list.
Tabular Layout Benefits
22
• The query must include at least one aggregate (i.e. sum or count) column.
• You must include the aggregate as part of the query.
• The aggregate column much have a heading for identification (i.e. Sum Total Amount).
• Generally speaking, queries used in matrix reporting should not contain much criteria, as the matrix layout will limit the information returned in the results. This allows you to reuse a shell query for many different layouts.
Queries Used in Matrix Layout
23
The FISCAL_YEAR and ACCOUNTING_PERIOD
requirement can be a problem for non-ledger PeopleSoft tables.
However, this requirement can
be fulfilled by joining an accounting date field to the
calendar table and/or by creating a table view.
Combination of query data and time spans populate the report….
Queries Used in Matrix Layout
24
PS/nVision normally produces a report instance for each
combination of the selected nodes or detail values for all specified
fields.
If you specify a field combination table, PS/nVision generates an instance of the report for only
those field values that are listed as valid combinations on the
table.
Note: You can also create a dynamic record that is populated by a query and includes only the combinations of field values that actually have data for that reporting period.
How to Limit Report Instances when using Multiple Scope Fields?
25
• Create in out-of-view area
• Put in all the nVision Variables you might want and label them
• Name the cell for each Variable using Formulas > Create from Selection
Using Variables
26
• In out of view area, set up 4 QTD columns
• Use OFFSET formula in visible part of report to pick up correct Quarter
Example: =OFFSET(U10,0,QTR)
Working with Functions
27
Sample of names that can be inserted into cells on report layouts
Name Description
NvsElapsedTime Indicates the elapsed time to produce this instance. To see this elapsed time in the instance, enter the formula =NvsElapsedTime in a cell and format the cell with a time format.
NvsEndTime Indicates the time this instance was saved. To see this time in the instance, enter the formula =NvsEndTime in a cell and format the cell with a date or date/time format.
NvsHiddenSheet Used on hidden layout sheets only to enable data retrieval on the sheet. By default, nVision will not process hidden layout sheets.
NvsInstanceHook Indicates the name or reference of the macro to be run on completion of the instance.
NvsTreeASD Stores the tree as of date from the report request.
NvsQueryName Stores the name of the query that provides the data for this tabular layout or instance.
PS/nVision - Defined Names
28
• Different ledgers cannot be combined in one field.
• Different TimeSpans cannot be combined in one field.
• nPloded rows or columns cannot be combined with non-nPloded rows or columns.
• If any field criteria are specified in an individual cell, all field criteria should be specified in the cell, no field criteria will be inherited from the row, column, or worksheet.
• Take advantage of report variables and relative timespans to minimize layout maintenance.
• The XLS output is generated in the format of the Excel version on the Report Server. As a rule, you need to make sure your end-users have compatible versions of Excel to open the XLS output generated from the Report Server.
nVision Design Tips
29
PEOPLESOFT QUERY
30
• Ad-Hoc & Simple Tabular Reporting Capability
• Quickly puts operational information in the hands of decision makers
• Schedulable
Continues to have benefits…
• Power of SQL
• Database Platform Independence
• Introduced Web Service for Query in PeopleTools 8.48
• Output to Excel, HTML
Query
31
9.1 QUERY HIGHLIGHTS
32
Enhancements
• New connected query
• Ability to develop in-tree criteria prompts
• Ability to email application engine results
• Drilling URL in PSQUERY
PeopleSoft Query
33
Connected Query provides the ability to create a single XML file based on a set of queries with parent-child relationships
A new folder for Connected Query has
been added under Reporting Tools
• A Connected Query is a hierarchical object built with existing PeopleSoft Queries
• A parent query can nest “n” levels of child queries and any child query can have “m” sibling queries within a hierarchy
• The output for connected query is always an XML file
• Connected Query can be used as a data source for XML Publisher reports
Connected Query
34
You are able to add in-tree criteria prompts to your queries, and define tree option in Expression 2 Type
You can schedule queries that have in-tree prompts using the Schedule Query component or using the Schedule links in the Query Manager and Query Viewer
Ability to Add an In-Tree Criteria Prompt
35
When you access the Run page of a query that has a Drilling URL defined, its query results are shown as links
Clicking these result links either: • Runs the destination query
with prompt key values if the source query has prompt criteria defined and prompt keys are mapped to source query result columns
• Launches the component with the search key values if the source query has search keys defined and search keys are mapped to source query result columns
• Redirects the external URL
Querying Results with Drilling URLs
36
Query URL
Create a prompt for Business Unit and
Project and map the values from your one query to incorporate into your new query
Drilling URL Example
37
Scheduled Query
• You are able to add email as an output type for scheduled query (any Application Engine program) results
• With this option, you can schedule queries to run and have the results emailed directly to recipients (not just a link to the Report Manager)
Ability to Email Application Engine Results
Email Query Results
38
• With PeopleTools 8.5, users now have the ability to subscribe to application data and get told when something they care about changed.
Users just want to be told when something that's important to them changed
Why is RSS so Important?
39
QUERY – BEYOND THE BASICS
40
Union
• Use to join separate queries.
Left Outer Joins
• Retrieves all the data in the first record and only matching data from the second record.
• SQL: D.VOUCHER_ID(+)
Subquery
• Subset of data used by a main query for data comparisons
Expressions
• SQL Expressions Used in Query Two Ways:
‒ As comparison values in selection criteria
‒ As columns in the query output
Advanced Features
41
• Expressions will vary based on database platform being utilized
• You can create thousands of different expressions using a combination of the following:
‒ Database Hints (must begin with /*+)
‒ SQL Functions (ABD, TRIM, CURRENT_DATE)
‒ Operators (+, -, *, /, <, >, AND, OR, etc.)
‒ Values (4, A, False, True, INV_AMT, DISC_AMT)
Expressions are calculations that PeopleSoft Query can perform as part of a query when PS Query doesn’t provide a way by default to calculate a value.
Query Expressions
42
• LTRIM(E.INV_ITEM_ID,'0') – trims leading zeros off item id
• TO_NUMBER(LTRIM(A.PO_ID,'0')) – once the leading zeros have been trimmed off the PO_ID, the value is change to a number.
• TO_NUMBER(LTRIM(F.VENDOR_ID,'0')) – once the leading zeros have been trimmed off the VENDOR_ID, the value is changed to a number.
• SUBSTR(A.ACCOUNTING_DT,1,4) – takes accounting date, (2007-01-01) goes to position 1 and picks up positions 1 thru 4, which ends up being the 4 digit year 2007.
• DECODE(A.ERNCD,'120',A.OTH_EARNS,0) – if the earning code is equal to 120 then return OTH_EARNS, otherwise return a value 0.
• A.QTY_ONHAND-B.QTY – simple equation that subtracts the 2 quantity fields to make sure they always return a zero.
Query Expressions Examples
43
Write an expression that looks between two dates:
•First, if the Hire Date is between the two prompt dates, it will return "New Hire"
•Second, if the Termination Date is between the two dates, it will return "New Term"
•Third, if those two conditions are not met, it will simply need to return "Existing"
CASE statements
Create a prompt based
on HIRE_DT
Using Expressions
44
• User can either provide the prompt value to return results for a specific
value or leave it blank to return rows for all values.
Optional Prompts Using Prompts
45
• For example: In a query that pulls project attributes, you may want to pull specific project team member roles into the query as columns:
Note: Different database platforms use different syntax
How to Filter on a Field from Outer Joined Record
46
• Type the following in Edit Expression:
• Replace :1 with the actual prompt value. You must first create this prompt.
• Now you need to pass 01/01/1900 as an input parameter if you want to run the query for current date. Passing any other values will make the query run for that date.
• This way you can achieve both (run the query for a user selected date or run a query for current date which can be used to schedule).
Type Default Date Expression
Criteria current date decode(:1,TO_DATE('1900-01-01','YYYY-MM-DD'),
trunc(sysdate),:1)
current date - 1 decode(:1,TO_DATE('1900-01-01','YYYY-MM-DD'),
trunc(sysdate)-1,:1)
current date + 1 decode(:1,TO_DATE('1900-01-01','YYYY-MM-DD'),
trunc(sysdate)+1,:1)
Note: Different database platforms use different functions (e.g. MSSQL uses “getdate” instead of “sysdate”)
How to Default Current Date in a Query Prompt Automatically
47 47
Questions? Comments?
48
• www.SpearMC.com
SpearMC Tools & Resources
49
SpearMC Education Sessions • The Eight Essentials for Planning & Budgeting
Session ID: 100480
Date: Wed, April 10th
Time: 3:00 p.m. – 4:00 p.m.
Track: C-Level Development
• How to make PeopleSoft Multi-Currency Work for You
Session ID: 100460
Date: Wed, April 10th
Time: 4:15 p.m. – 5:15 p.m.
Track: Financial Modules
50
Contact Information • Stephen Kelly, Enterprise Systems Consultant
• Millie Babicz, Financials Solution Architect
• Marcus Bode, Principal
• David Pigman, Technical Architect
• Keith Harper, SCM Solution Architect
51
A PeopleSoft Modular Deep-Dive Event
July 23-25, 2013 Rosemont, Illinois
A JD Edwards EnterpriseOne Deep-Dive Event December 2-4, 2013 Denver, Colorado
Mark Your Calendar!
52
Online Series Offerings for 2013
Series Month
Professional Development Series June
Executive Series June
HCM Series July
Upgrades Series August
Mobility Series September
Financials Series October
JD Edwards World Series November
Tools & Technology Series November
Take advantage of these improved series offerings for 2013,
featuring Oracle sessions, vendor sessions and some of the
best customer sessions from the Quest community. Train from
the comfort of your desk!
