APEX 5 Interactive Reports: Guts and PErformance
Download as PPTX, PDF3 likes2,216 views
This document presents an in-depth discussion on the features and performance optimization of Oracle Application Express (APEX) 5's interactive reports. It covers topics such as CSS and JavaScript changes, tuning SQL queries, and practical settings for improved report performance. It also highlights the expected transition to interactive grids in future versions, suggesting enhancements in user experience and customization options.
![TH Technology
Drills, Passing Parameters
• 1 IR ~ Same Syntax for Passing Parameters
IREQ_<column_name>
• Multi IRs on Same Page
IREQ[IR Static Id]_<column_name>
• IR w Multiple Saved Reports
IREQ[IR Static Id] _<Saved Report Id>_<column_name>
• ‘’|| column_name||’’ if values contain , : ; %](https://image.slidesharecdn.com/kcannell-160628182003/85/APEX-5-Interactive-Reports-Guts-and-PErformance-40-320.jpg)
![TH Technology
Referencing IR Columns & Filter Values
• IREQ_[Static Id]_<column_alias> Equals
• IR [Static Id]_< <column_alias> Equals
• IRLT[Static Id]_< <column_alias> <
• IRLTE[Static Id]_< <column_alias> <=
• IRGT[Static Id]_< <column_alias> >
• IRGTE[Static Id]_< <column_alias> >=
• IRLIKE[Static Id]_< <column_alias> SQL LIKE
• IRN[Static Id]_ <column_alias> NULL
• IRNN[Static Id]_< <column_alias> NOT NULL
• IRC[Static Id]_< <column_alias> Contains
• IRNC[Static Id_]< <column_alias> Not Contains
No BETWEEN, IN, NOT IN](https://image.slidesharecdn.com/kcannell-160628182003/85/APEX-5-Interactive-Reports-Guts-and-PErformance-41-320.jpg)
APEX 5 Interactive Reports: Guts and PErformance
- 1. APEX 5 IR Guts & Performance Karen Cannell TH Technology kcannell@thtechnology.com
- 4. TH Technology About Me … Karen Cannell ~ TH Technology • Mechanical/SW Engineer - Analyzed, designed, developed, converted, upgraded, enhanced legacy & database applications for 25+ years • Building Oracle –based Web solutions for government, medical, engineering industries, APEX since HTMLDB • Leveraging the Oracle 10g,11g, 12c suite of tools • Oracle Ace Associate • Editor Emeritus Technical Journal
- 5. TH Technology We Have Books … Expert Oracle Application Express, APress 2015 Report Printing Beginning Application Express 4.2, APress, 2013 Agile Oracle Application Express APress, 2012
- 6. TH Technology About You … New to APEX? APEX Experience? APEX Versions? IR Habits? IR Customizations? New Stuff or Old? APEX5 Ready?
- 7. TH Technology NOTE TO EARLY SLIDE DOWNLOADERS • Many of these slides HAVE CHANGED as I find more neat stuff to add for you every day. • Please download the updated slides from the Kscope16 site or www.thtechnology.com or email kcannell@thtechnology.com
- 8. TH Technology Agenda ~ Guts and Performance • Guts ~ Inside and Outside • CSS • JS • Performance • The Real Query(ies) • Declarative Settings • Drills & Parameters • Extra Boost • Questions
- 9. TH Technology Developer & User Team “APEX IR give the end user great power to format and arrange reports to their needs, the developer needs to be aware of the end user needs to prepare and deliver the appropriate IR query to support them.” Know Your Users Know What Your Users Do Train Your Users to Maximize IR Use
- 10. APEX 5 Interactive Reports: Guts CSS and JavaScript
- 11. TH Technology Guts ~ CSS • APEX 5 - All New CSS apexir_<element> ids are replaced by a-IRR-<component> classes and <Static Id>_... id names
- 15. TH Technology Why Do We Care About the CSS? • Customizations • Color • Style • Use in ThemeRoller Custom CSS • Use in Custom Dyn Actions
- 16. TH Technology
- 17. TH Technology Guts ~ JavaScript • All Changed APEX 4.2 to APEX 5 • Locked Down (relatively) • No gReport • No API in Sight • Lots of Refactoring for Customizations …
- 18. TH Technology IF You Need To Customize / Refactor • See jQuery Widgets <base_dir>/i/libraries/apex/minified /widget.interactiveReport.js /widget.menu.js • Read http://hardlikesoftware.com/weblog/2015/ 05/12/apex-5-0-interactive-report- customization/
- 19. TH Technology Widgets 101 • $(selector).widgetName("method"); • Ex: $("#DEMO_IR_ir").interactiveReport("option“); $("#DEMO_IR_actions_menu").menu("option"); $("#DEMO_IR_actions_menu").menu("find", "irDownload").action(); $("#DEMO_IR_actions_menu").menu("find", "irReset").action();
- 20. TH Technology Reset IR – Dynamic Actions • PL/SQL call to APEX_IR.RESET $("#DEMO_IR_actions_menu").menu("find", "irReset").action(); Same Result as the other, but the JS approach is Unsupported
- 21. TH Technology More UnSupported Customizations • Download an IR: $("#DEMO_IR_actions_menu").menu("find","irDownload").action(); • Get the Current Rows Per Page: $("#DEMO_IR_ir”).interactiveReport("option","currentRowsPerPage”); • Set the Current Rows Per Page: $("#DEMO_IR_ir”).interactiveReport("option","currentRowsPerPage”, 50); This approach is Unsupported and Subject to Change
- 22. TH Technology Caveats We Can Extend Things, But Before I/We/You Do • Caveat 1 – Things May Change • Caveat 2 – APEX 5.1 Multi Edit Grid • WILL Supercede IRs • May (will probably) Have an API
- 23. APEX 5 Interactive Reports: Performance The Real Query, Declarative Settings, Drills & Parameters, Extras
- 24. TH Technology The Basic Interactive Report • Few(er) Rows < 1000000 • Good Performance • Defaults Are Fine • Larger, More Complex • Know Your Options • Use Them!
- 25. TH Technology The Pitifully Slow IR • Slow IR performance Magnifies ... • Wait for First Display … • Wait for Col Heading Filters … • Wait for Pivot … • Wait for Chart …
- 26. Demo of Pitifully Slow IR
- 27. TH Technology IR Performance 1-2-3 • Tune the Real SQL Query • Optimze IR Settings • Train Users in IR Behavior
- 28. TH Technology The SQL Query • Tune The Real Query. • Slow Performance Magnifies • Tune the Query for How Users Retrieve Data • Debug to ExposeThe Real Query • Tune Outside of APEX • Explain Plan • Indexes
- 29. TH Technology The Real Query • Changes w Filters • Search Filter • Col Heading Filter • Changes w Views • Table • Group By • Chart • Pivot
- 30. TH Technology Let’s See The Real Query • Table View • Max Row Count • Pagination “of Z “ • Tabular w Filters • Group By • Chart • Pivot
- 31. TH Technology
- 32. TH Technology Declarative Settings • Lots of IR Settings • Developer Controls These (That’s You!) Defaults Aren’t The Best For Every IR
- 33. TH Technology MaxRowCount • Small as Practical • What Is Practical? • 1000000 default • Depends on Your Data • Test ~ Timing ~ Debug • For “Download It All” Users • Offer a Separate Download Page • Avoid High Max Row Count for All Users
- 34. TH Technology Impact of Max Row Count Demo • Default Max Row Count • High Max Row Count • Low Max Row Count • NULL Max Row Count Your Mileage Will Vary Know Your Data ~ Know Your Users
- 35. TH Technology Max Rows Per Page • Be Practical • Higher Longer Page Load • 5000? • Always Set Max Rows Per Page • Use Header Float Settings • None • Page • Region • Inform Users of Tradeoffs Train Your Users to Maximize IR Use
- 36. TH Technology Pagination • Avoid X to Y of Z • Z Gets Determined Every Time • “of Z” is Expensive! • Alternative for “of Z” – Set Count • Lose Count w Filters • Pagination Plugins • Show Pagination Query, Timing, Impact
- 37. TH Technology Column Heading Menus • Column Filter ~ Based on Subset, Not All Rows!! • “My Data is Not There!” • Contents based on 1st 1000 Rows • Search Fields Work on the Full Result Set
- 38. TH Technology Column Filter • ‘A’O, ‘Ahinahina through … Zygodon • By Default, LOV Contents based on 1st 1000 Rows
- 39. TH Technology Column Filter Options • IF you Set LOV Choose LOV Carefully • Goal is to Display All ... Faster • Exact Match vs Contains … controls filters relative to Result Set • Search Still Works on the Full Result Set
- 40. TH Technology Drills, Passing Parameters • 1 IR ~ Same Syntax for Passing Parameters IREQ_<column_name> • Multi IRs on Same Page IREQ[IR Static Id]_<column_name> • IR w Multiple Saved Reports IREQ[IR Static Id] _<Saved Report Id>_<column_name> • ‘’|| column_name||’’ if values contain , : ; %
- 41. TH Technology Referencing IR Columns & Filter Values • IREQ_[Static Id]_<column_alias> Equals • IR [Static Id]_< <column_alias> Equals • IRLT[Static Id]_< <column_alias> < • IRLTE[Static Id]_< <column_alias> <= • IRGT[Static Id]_< <column_alias> > • IRGTE[Static Id]_< <column_alias> >= • IRLIKE[Static Id]_< <column_alias> SQL LIKE • IRN[Static Id]_ <column_alias> NULL • IRNN[Static Id]_< <column_alias> NOT NULL • IRC[Static Id]_< <column_alias> Contains • IRNC[Static Id_]< <column_alias> Not Contains No BETWEEN, IN, NOT IN
- 42. TH Technology Syntax for IR Links / Drills • Look at Saved Report attributes • Gives you the exact syntax to reference each saved report
- 43. TH Technology Syntax for IR Links / Drills • Can Edit the Alias
- 44. Still Slow? OR … Need Dynamic SQL?
- 45. TH Technology Extra Power ~ Pipelined Table Functions • Performance Boost • More Work • May Be Viable Option For • Complex Queries • High Volume Data • Option when Q Must be Dynamic SQL • Delivers Rows Faster? …. Let’s see.
- 46. TH Technology IR From Pipelined Table Function • Create SQL Type (Row Type) for the Report Columns • CREATE TYPE • Create Table Type of the Row Type • Create Function PIPELINED • Dyn SQL • Create IR Using • SELECT <col name list> FROM TABLE( pipelined_function (<parameters>));
- 47. TH Technology Code Examples for Pipelined Function Option • CREATE FUNCTION inter_rpt_pipelined ( …) RETURN your_tbl_type PIPELINED IS TYPE rc IS REF_CURSOR; l_rc rc; v_your_type your_rec_type; … …
- 48. TH Technology Query Example for Pipelined Function Option • SQL that uses the function … SELECT harvest_id, harvest_Date, sector_id … FROM TABLE ( INTER_RPT_PIPELINED);
- 50. TH Technology SQL Query vs Pipelined Table Function • SQL Query • Traditional IR • Pipelined Table Function • Straight Table Slower • Complex Query Faster for first rows • Cut is on Processing Time
- 51. TH Technology SQL Query Not Enough? • Query From a Collection • Heading Names via Query • Function to build SQL • APEX_COLLECTION.CREATE_COLLECTION_FRO M_QUERY_B SELECT c001, c002, … FROM apex_collections WHERE collection_name = ‘YOUR_COLLECTION’;
- 52. Recap Guts • New CSS • New JavaScript • Refactoring Performance • Tune The Real Query • Settings • Max Row Count • Pagination • Rows Per Page • Alternatives • Pipelined Table Function • Collection
- 53. TH Technology The Future Interactive Grid WILL Replace IR • Upgrade Wizard • Lazy Loading • Endless Scroll - Buffers Next Fetch • Require Filter • Performance Options (Contains, Starts, REGEXP, CASE) • JavaScript API (Maybe/Probably)
- 54. TH Technology The Future Interactive Grid WILL Replace IR • Guts • Anticipate a JS API • JavaScript Code region for Customizing • Performance • AJAX/JSON • Show Total Row Count • Fewer, Wiser Parameters • Better Performance, More Controls
- 55. APEX 5 IR Guts & Performance Questions ? Karen Cannell TH Technology kcannell@thtechnology.com
- 58. TH Technology References • Jari Laine Pagination Option http://jaris.blogsite.org/apex/f?p=BLOG:READ:0::::ARTICLE:41900346 848694 • JSnyder Blog Hard Like Software http://hardlikesoftware.com/weblog/2015/05/12/apex-5-0-interactive- report-customization/ • Vishal Blog Post re Table Functions http://obiee-oracledb.blogspot.com/2011/07/performance-enhancing- drug-called-table.html • Sample App • apex.oracle.com THUNTER kscope16/demo • APEX 5.1 Early Adopter • Sample Interactive Grid App $("#DEMO_IR_ir").interactiveReport("refresh");$("#DEMO_IR_ir").interactiveReport("refresh");